BT SDK2.1 Release Notes
Cypress
BT SDK2.1 Release Notes
BT SDK 2.1 Release Notes â218 KB
BT SDK 2.1 Release Notes - Infineon Developer Community
Not Your Device? Search For Manuals or Datasheets below:
File Info : application/pdf, 8 Pages, 217.17KB
Document DEVICE REPORTBT SDK 2.1 Release NotesBT SDK2.1 Release Notes
BT SDK 2.1 Release Notes
Overview
This release is an update to the BT SDK 2.0. The BT SDK 2.1 is targeted for the CYW20706, CYW20719B2, CYW20721B2, CYW20819, CYW20820, and CYW89820 Bluetooth 5.0 SoCs and the ModusToolboxTM IDE. ModusToolbox 2.0 with the Bluetooth SDK software library provides a complete development environment to allow you to quickly create Bluetooth enabled IoT solutions like smart watches, medical devices, or home automation platforms. This document describes the features and known limitations for the BT SDK 2.1.
Contents
Overview ..................................................................................................................................................... 1
Contents...................................................................................................................................................... 1
What's Changed ......................................................................................................................................... 1
What's Included .......................................................................................................................................... 2 Bluetooth SDK ...................................................................................................................................... 2
Design Impact ............................................................................................................................................. 2 Updating from BT SDK 2.0 ................................................................................................................... 2
Supported Boards ....................................................................................................................................... 3
Known Issue Fixes ...................................................................................................................................... 3
Known Issues/Limitations............................................................................................................................ 3 Documentation ..................................................................................................................................... 3 Platform ................................................................................................................................................ 4 Bluetooth SDK ...................................................................................................................................... 4
Open Source............................................................................................................................................... 7
Further Reading .......................................................................................................................................... 7
What's Changed
This section provides a high-level overview about what changed from BT SDK2.0 to BT SDK2.1. Added support for the CYW20706 device plus the CYW920706WCDEVAL and CYBT-353027EVAL platforms. Added support for the CYW920819KREF-KB-01 platform Added support for the CYW920721B2EVK-02 platform Added support for iAP2 to the CYW20819, CYW20830, and CYW20706 devices Added Bluetooth mesh support for the CYW20719B2 and CYW20721B2
January 12, 2020
Document Number: 002-29466 Rev. **
- 1 -
BT SDK2.1 Release Notes
Improved power consumption of the CYW920721B2EVK-03 platform Added audio record sample app with Opus encoding for the CYW920721B2EVK-01,
CYW920721B2EVK-02 and CYW920721B2EVK-03. Updated audio gateway code example to support audio gateway headset profile for the
CYW920721B2EVK-01, CYW920721B2EVK-02, and CYW920721B2EVK-03 Updated the Headset WASS sample app to support voice prompts for the CYW920721B2EVK-
01, CYW920721B2EVK-02, and CYW920721B2EVK-03.
What's Included
Bluetooth SDK The Bluetooth SDK is targeted for the CYW20706, CYW20719B2, CYW20721B2, CYW20819A1, CYW20820A1, and CYW89820 Bluetooth 5.0 SoC and the ModusToolbox 2.0 IDE. This SDK includes the following:
Bluetooth firmware Platform and board support packages Utilities including BTSpy trace, Manufacturing Bluetooth test tool, Client Control, and Mesh Client
control Peer apps for OTA and Mesh A rich set of WICED connectivity APIs that allow for simplified programming of BT/BLE
connectivity Various sample applications that serve as examples of how to utilize the BT/BLE APIs More complex code examples that utilize various APIs and middleware to create a more complete
solution
Design Impact
Updating from BT SDK 2.0
The BT SDK2.1 code examples can be acquired from the Cypress GitHub.
There are a couple of steps that must be done in the initial setup of the BT SDK2.1 with ModusToolbox 2.0:
· In the ModusToolbox IDE, click the "New Application" link in the Quick Panel (or, use "File > New > ModusToolbox IDE Application")
· Pick your board for BT SDK · First select "wiced-btsdk". This project contains the SDK. It is used by all BT SDK applications.
You will need to create this project just once in the working directory. Note: Do not change the name of this project. All BT SDK apps use this project name in application makefiles. This step can take up to 15 minutes but only needs to be done once.
January 12, 2020
Document Number: 002-29466 Rev. **
- 2 -
BT SDK2.1 Release Notes
· After the wiced_btsdk project is created, click the "New Application" link again, and select the board and application you want to use from the BT SDK.
Supported Boards
This release provides support for the following boards.
Board
MCU
Connectivity
CYW920819EVB-02
CYW20819
On-chip Bluetooth
CYBT-213043-MESH
CYW20819
On-chip Bluetooth
CYBT-213043-EVAL
CYW20819
On-chip Bluetooth
CYW920820EVB-02
CYW20820
On-chip Bluetooth
CYW920721B2EVK-01
CYW20721
On-chip Bluetooth
CYW920721B2EVK-02
CYW20721
On-chip Bluetooth
CYW920721B2EVK-03
CYW20721
On-chip Bluetooth
CYW920719B2Q40EVB-01 CYW20719
On-chip Bluetooth
CYW920706WCDEVAL
CYW20706
On-chip Bluetooth
CYBT-353027-EVAL
CYW20706
On-chip Bluetooth
CYW989820EVB-01
CYW89820
On-chip Bluetooth
Known Issue Fixes
This section lists the known issues from the BT SDK2.0 release that were fixed in this release.
Platform/BT Firmware/Application [CYW920721B2EVK-03] Power consumption [CYW920819EVB-02] PWM [CYW989820EVB-01] LED1 and LED2
[CYBT-213043-MESH] Android Mesh Controller app
Fix
Optimized FEM power consumption Fixed issue that the pwm hal app didn't use BSP configuration. Fixes issue that LED1 and LED2 are turned on after app programming is complete. Updated Android Mesh Controller app to fix DFU issue.
Known Issues/Limitations
This section lists the known issues/limitations of this release:
Documentation
Problem
Workaround
Various documents included with the release may contain incomplete information or may not contain up to date screen captures or information.
New versions of documents, including these release notes, may be available online at:
www.cypress.com/modustoolbox
January 12, 2020
Document Number: 002-29466 Rev. **
- 3 -
BT SDK2.1 Release Notes
Platform
Limitation
Workaround
ModusToolbox 2.0 supports Arm Gcc, Arm compiler v6 and IAR toolchain. The BT SDK only supports Arm GCC.
None.
hci_handsfree, a2dp_sink, headset, and hid code examples are not available for the CYW920706WCDEVAL
This limitation will be addressed in future BT SDK releases
CYW920820EVB-02 will be available soon.
Contact Cypress sales for availability.
CYW920721B2EVK-01, CYW920721B2EVK-02, and CYW920721B2EVK-03 have limited availability.
Contact Cypress sales to request access.
CYW920719B2Q40EVB-01 has limited availability.
Contact Cypress sales to request access.
CYW989820EVB-01 has limited availability.
Contact Cypress sales to request access.
Audio demo/snip/middleware code examples for the CYW20721B2 are not included by default in the BT SDK2.0
Contact Cypress sales to request access to the additional code examples available for the CYW20721B2.
Multi-point functionality for CYW20721B2 was only tested with the Headset Pro code example and the CYW920721B2EVK-03 platform
This limitation will be addressed in future BT SDK releases.
BT_AppleIAP2 code example for the CYW20719B2 and Get Mfi license and contact Cypress sales to request
CYW20721B2 is not included by default in the BT
access to the additional code example
SDK2.0
PEPS code examples for the CYW89820 are not included by default in the BT SDK2.0
Contact Cypress sales to request access to the additional code examples available for the CYW89820.
Bluetooth SDK
Problem
Workaround
[CYW920706WCDEVAL] pbap app: Phonebook This issue is targeted to be addressed in a future BT SDK
does not download for Android devices.
release.
[CYW920706WCDEVAL] Ble mesh
This issue is targeted to be addressed in a future BT SDK
conformance: First and Second heartbeat
release.
message difference is outside of expected value.
[CYW920706WCDEVAL] Ble mesh
This issue is targeted to be addressed in a future BT SDK
conformance: Expected value and received value release.
do not match for LC server PTS test cases
[CYW920706WCDEVAL] ANS: Header comments/readme.txt doesn't match the implementation.
This documentation issue will be addressed in a future BT SDK release.
[CYW920706WCDEVAL] Ble mesh: Not able to This documentation issue will be addressed in a future BT SDK
move the device in newly created group.
release.
[CYW920719B2Q40EVB-01] Ble mesh
This issue is targeted to be addressed in a future BT SDK
conformance: Provisioning failed for all
release.
configuration and health model testcases as PTS
is not advertising
January 12, 2020
Document Number: 002-29466 Rev. **
- 4 -
BT SDK2.1 Release Notes
Problem
Workaround
[CYW920719B2Q40EVB-01] Ble mesh conformance: MESH/NODE/CFG/NID/BV-02-C is failed because `The IUT is expected to advertise only on the network with index 0x1'
This issue is targeted to be addressed in a future BT SDK release.
[CYW920719B2Q40EVB-01] Ble mesh
This issue is targeted to be addressed in a future BT SDK
conformance: Command receive failed (timeout) release.
in MESH/NODE/RLY/BV-02-C
[CYW920719B2Q40EVB-01] Ble mesh
This issue is targeted to be addressed in a future BT SDK
conformance: Unable to initiated GATT
release.
connection, PTS is getting stuck in the pop up
message "Please let PB-GATT connection to the
PTS" for MESH/PVNR/MPS/BV-XX-C
[CYW920721B2EVB-02, CYBT-213043-MESH] iOS app has a prompt to tell the user how to successfully
BLE mesh iOS: OTA upgrade for second device upgrade the device when encountering this error. This issue will
is unsuccessful
be fixed in a future BT SDK release.
[CYW920721B2EVK-01, CYBT-213043-EVAL] This issue is targeted to be addressed in a future BT SDK
le_coc app: Not tuned for higher throughput
release.
[CYW920721B2EVK-01] MAP: There is no
This issue is targeted to be addressed in a future BT SDK
provision in client control UI to download e-mails release.
[CYW920721B2EVK-01] MAP: Contact number/name is not displayed for Unsaved contacts. This is an UI display issue; the trace shows the operation is working fine.
This issue is targeted to be addressed in a future BT SDK release.
[CYW920721B2EVK-02] Headset_wass: Glitches are heard on PRI and no audio on SEC during audio streaming when OTA upgrade through OTA SPP app is running.
This issue is targeted to be addressed in a future BT SDK release.
[CYW920721B2EVK-02] Headset_wass: Glitch is This issue is targeted to be addressed in a future BT SDK heard on headset when BLE connection from release. source2 during audio streaming from source 1
[CYW920721B2EVK-03] Headset_wass: `Ready This issue is targeted to be addressed in a future BT SDK to pair' voice prompt is not heard when DUT is in release. discoverable mode
[CYW920721B2EVK-02] Headset_wass: No
This issue is targeted to be addressed in a future BT SDK
voice prompt is working from the time, after SEC release.
is reset during headset re-connection from PRI
[CYW920721B2EVK-03] Headset_pro_aac: Held This issue is targeted to be addressed in a future BT SDK voice call on src2 is not coming to active state release. after declining incoming voice call on src1
[CYW920721B2EVK-03] Headset_pro_aac: Glitches are heard on headset during reconnection of src1, when audio streaming is running on src2.
This issue is targeted to be addressed in a future BT SDK release.
[CYW920721B2EVK-03] Headset_wass_aac: Media volume sync is disabled after reconnection from source during audio streaming
This issue is targeted to be addressed in a future BT SDK release.
[CYW920721B2EVK-03] Headset_wass_aac: This issue is targeted to be addressed in a future BT SDK Glitch is heard on headset when WASS BLE is release. connected from src2 during audio streaming from src1.
[CYW920819EVB-02] Directed advertisement not working after resetting the device
This issue is targeted to be addressed in a future BT SDK release.
January 12, 2020
Document Number: 002-29466 Rev. **
- 5 -
BT SDK2.1 Release Notes
Problem
Workaround
[CYW920819EVB-02] Low power: Entering HID- This issue will be addressed in a future BT SDK release. OFF trace messages are not printing
[CYW920819EVB-02] Configured GCI-SECI pins This issue will be addressed in a future BT SDK release. are not working.
[CYW920819EVB-02] wiced_hal_gpio.h: GPIO mapping isn't correct for WICED_GCI_GPIO_06 and WICED_GCI_GPIO_07.
This issue is targeted to be resolved in a future BT SDK release.
[CYW920819EVB-02] Watch: Observing current This issue is targeted to be resolved in a future BT SDK
spikes of 200uA on J15 (VDDIO)
release.
[CYW20819A1, CYW20820A1] BLE throughput This issue is targeted to be resolved in a future BT SDK
is not optimized.
release.
[CYW920820EVB-02] Spi_master functionality is Device configurator should only be used for reserving pins and
not working after changing pin configuration
not assigning functionality. This issue will not be fixed.
through device configurator
[CYW920820EVB-02] Spi_slave functionality is not working after changing pin configuration through device configurator
Device configurator should only be used for reserving pins and not assigning functionality. This issue will not be fixed.
[CYW920820EVB-02]
This issue will be addressed in a future BT SDK release.
Ble_keyboard/ble_mouse/ble_remote: Observing
CYW20819 as chip name instead of CYW20820.
[CYW989820EVB-01] Low power: While measuring power through VDDIO, getting the same current for all BT states.
Configure the unused pins as input disabled. This issue will be addressed in the next BT SDK release.
[CYBT-213043-EVAL] MC is receiving bad packets when HCI tracing is enabled due to low baud rate and buffer settings with Linux.
This issue can be worked around by decreasing the logging on the UART for Linux. This issue won't be fixed.
[CYBT-213043-EVAL] Lecoc: Intermittently observed bad packets
This issue is targeted to be resolved in a future BT SDK release.
[CYBT-213043-MESH, CYW920820EVB-02] Unable to do OTA upgrade for apps which does not have Proxy feature enabled (dimmer, on_off_switch)
This issue will be addressed in a future BT SDK release.
[CYBT-213043-MESH] After importing the
This issue will be addressed in a future BT SDK release.
network database, unable to perform node on/off
for color_light
[CYBT-213043-MESH] BLE MMDL Conformance: Did not receive all of the expected messages (expected message 2 of 2 at address 0xC001).
This issue will be addressed in a future BT SDK release.
Linker does not complain about duplicate objects This issue will be addressed in a future BT SDK release.
When using the ANS application, the UI does not This is a current UI limitation; the application can handle
allow generating all possible alerts
generating alerts. The UI can generate individual alerts.
simultaneously.
Unable to open multiple Client Control applications on Mac OS.
This is a limitation only if you use 2 or more boards on same Mac OS simultaneously and need to use Client Control for each app. In such a case, 2 different PCs will be needed.
sensor_motion example project does not fully
This issue will be addressed in a future BT SDK release.
support LPN functionality and cannot enter sleep
mode during operation.
January 12, 2020
Document Number: 002-29466 Rev. **
- 6 -
BT SDK2.1 Release Notes
Open Source
Portions of this software package are licensed under free and/or open source licenses such as the GNU General Public License. Such free and/or open source software is subject to the applicable license agreement and not the Cypress license agreement covering this software package. The applicable license agreements are available online:
http://www.cypress.com/documentation/software-and-drivers/free-and-open-source-softwaredownload-page
Further Reading
There are several related documents provided with ModusToolbox software. These documents include (but are not limited to):
ModusToolbox Installation Guide Bluetooth API Documentation ModusToolbox IDE Quick Start Guide ModusToolbox IDE User Guide ModusToolbox Configurator Guides (for each Configurator) Other documentation includes (but is not limited to): Device Datasheets Application Notes Training Contact your Cypress representative, as needed.
January 12, 2020
Document Number: 002-29466 Rev. **
- 7 -
BT SDK2.1 Release Notes
Cypress Semiconductor 198 Champion Ct.
San Jose, CA 95134-1709 USA www.cypress.com
© Cypress Semiconductor Corporation, 2020. This document is the property of Cypress Semiconductor Corporation and its subsidiaries, including Spansion LLC ("Cypress"). This document, including any software or firmware included or referenced in this document ("Software"), is owned by Cypress under the intellectual property laws and treaties of the United States and other countries worldwide. Cypress reserves all rights under such laws and treaties and does not, except as specifically stated in this paragraph, grant any license under its patents, copyrights, trademarks, or other intellectual property rights. If the Software is not accompanied by a license agreement and you do not otherwise have a written agreement with Cypress governing the use of the Software, then Cypress hereby grants you a personal, non-exclusive, nontransferable license (without the right to sublicense) (1) under its copyright rights in the Software (a) for Software provided in source code form, to modify and reproduce the Software solely for use with Cypress hardware products, only internally within your organization, and (b) to distribute the S oftware in binary code form externally to end users (either directly or indirectly through resellers and distributors), solely for use on Cypress har dware product units, and (2) under those claims of Cypress's patents that are infringed by the Software (as provided by Cypress, unmodified) to make, use, distribute, and import the Software solely for use with Cypress hardware products. Any other use, reproduction, modification, translation, or compilation of the Software is prohibited.
TO THE EXTENT PERMITTED BY APPLICABLE LAW, CYPRESS MAKES NO WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, WITH REGARD TO THIS DOCUMENT OR ANY SOFTWARE OR ACCOMPANYING HARDWARE, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. To the extent permitted by applicable law, Cypress reserves the right to make changes to this document without further notice. Cypress does not assume any liability arising out of the application or use of any product or circuit described in this document. Any information provided in this document, including any sample design information or programming code, is provided only for reference purposes. It is the responsibility of the user of this docum ent to properly design, program, and test the functionality and safety of any application made of this information and any resulting product. Cypress products are not designed, intended, or authorized for use as critical components in systems designed or intended for the operation of weapons , weapons systems, nuclear installations, life-support devices or systems, other medical devices or systems (including resuscitation equipment and surgical implants), pollution control or hazardous substances management, or other uses where the failure of the device or system could cause personal injury, death, or property damage ("Unintended Uses"). A critical component is any component of a device or system whose fai lure to perform can be reasonably expected to cause the failure of the device or system, or to affect its safety or effectivenes s. Cypress is not liable, in whole or in part, and you shall and hereby do release Cypress from any claim, damage, or other liability arising from or related to all Unintended Uses of Cypress products. You shall indemnify and hold Cypress harmless from and against all claims, costs, damages, and other liabilities, including claims for personal injury or death, arising from or related to any Unintended Uses of Cypress products.
Cypress, the Cypress logo, Spansion, the Spansion logo, and combinations thereof, ModusToolbox, WICED, PSoC, CapSense, EZ-USB, F-RAM, and Traveo are trademarks or registered trademarks of Cypress in the United States and other countries. For a more complete list of Cypress trademarks, visit cypress.com. Other names and brands may be claimed as property of their respective owners.
January 12, 2020
Document Number: 002-29466 Rev. **
- 8 -
Microsoft Word for Office 365