infineon CYW920721M2EVB-03 AIROC Bluetooth SDK Owner’s Manual

AIROC™ Bluetooth® SDK 4.6.3 release notes

About this document

Scope and purpose
This release is an update to AIROC™ Bluetooth® SDK 4.6.2.
AIROC™ Bluetooth® SDK 4.6.3 is targeted for the CYW20706, CYW20719B2, CYW20721B2, CYW20736, CYW20835B1, CYW20819, CYW20820, CYW20829, CYW89820, CYW43012 AIROC™ Wi-Fi & Bluetooth® combo chips (for embedded Bluetooth® development only), and CYW5557x AIROC™ Wi-Fi & Bluetooth® combo chips. ModusToolbox™ software with the Bluetooth® SDK software library provides a complete development environment to allow you to quickly create Bluetooth®-enabled IoT solutions such as smartwatches, medical devices, or home automation platforms. This document describes the features and known limitations of Bluetooth® SDK 4.6.3.

What’s changed

Features and Modifications
[1] Firmware updated to support Bluetooth® 5.4 certification of CYW43012 (ICWBTCOMBO-185).
[2] Firmware updated to support Bluetooth® 5.4 certification of CYW20706 (BTSDK-10481).
[3] Expose the internal symbols in ModusToolbox that are exposed in WICED Studio (BTSDK-9873).

Bug Fixes
[4] The correct (up to date) core Bluetooth® spec version Is now displayed, as observed in tools like Ellisys Bluetooth Analyzer and AIROC Bluetooth Test and Debug Tool (BTSDK-10617).
[5] [CYW920721M2EVB-03]:[Watch_Dual_A2DP] No audio was heard at the peer side when starting to stream mp3 and wav files (BTSDK-10565).
[6] [CYW20706] Fixed Undefined Reference Error while using wiced_hal_puart_synchronous_read()(BTSDK-10559).
[7] [CYW920706WCDEVAL] Watch app: Fixed a discrepancy between readme and makefile on supporting SPI transport mode targets (BTSDK-10478).
[8] [CYW920706WCDEVAL] Watch(peripheral) : Fixed an instability with simultaneous connection between iPhone and android (BTSDK-10456).
[9] [CYW920706WCDEVAL] Watch(multiple AMS/ANCS) : After ~2Hrs of idle connection, Peer1 got disconnected from watch with a reason of “LMP Response Timeout” (BTSDK-10454).
[10] [CYW920706WCDEVAL, CYW920819M2EVB-01, CYW943012BTEVK-01 & CYW920835M2EVB-01] BT version in OTA logs differed from BSP description in project creator window (BTSDK-9134).
[11] [CYW920706WCDEVAL] HAL_Low_Power_20706: Normal mode current values were not matching with the readme values (BTSDK-10214).
[12] Fixed I2S_word select polarity on CYW20706 (BTSDK-9927).
[13] Fixed OTA failure with IFXV remote control example project (BTSDK-10453).
[14] Fixed problem with incomplete IR data sent by IFXV remote control example (BTSDK-10452).
[15] BTM_SEC_SECURE_CONNECTION was not effective for Bluetooth® LE (BTSDK-10375).
[16] [CYW943012BTEVK-01][RFCOMM Serial Port][Android]: ‘Reached max tx retries’ message was observed on reconnection with DUT from peer device (BTSDK-10355).
[17] [CYW943012BTEVK-01][M2 Board-Without Rework][Pro_Headset_Standalone] On receiving incoming call to Peer device, DUT would get disconnected and become unresponsive (BTSDK-9253).
[18] [CYW920835REF-RCU-01][HID_LE_REMOTE_CONTROL]: Re-boot was not happening after OFU & Failed to notify the app logs were coming in teraterm. On Bluetooth® LE OTA app, still showing connected only (BTSDK-9959).
[19] API wiced_is_timer_in_use returned unexpected values (BTSDK-7316).
[20] GoPro was unable to connect to CYW20736: unsuccessful connecting with the camera (BCM20732A1- 2505)

What’s included

AIROC™ Bluetooth® SDK
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 connectivity APIs that allow for simplified programming of Bluetooth®/Bluetooth® LE connectivity
• Various sample applications that demonstrate how to use the Bluetooth®/Bluetooth® LE APIs
• More complex code examples that use various APIs and middleware to create a complete solution

Design impact

Updating from previous Bluetooth® SDK versions
AIROC™ Bluetooth® SDK 4.6.3 code examples can be acquired from the Infineon GitHub repository.
Note: If you must keep an earlier Bluetooth® SDK version, create a new workspace project to pull in the newest Bluetooth® SDK assets to avoid overwriting previous asset versions.
Do the following to create a new application using AIROC™ Bluetooth® SDK 4.6.3 with ModusToolbox™ software 3.x:

1. In the IDE, click the New Application link in the Quick Panel (or use File > New > ModusToolbox™ Application).
2. In Project Creator, click AIROC™ Bluetooth® BSPs.
3. Pick your board for Bluetooth® SDK.
4. Select a template application.
5. Click Create and wait for Project Creator to close.

Supported boards

Known issues/limitations

Table 1 Documentation

Various documents included with the release may contain incomplete information or may not have up- to-date screen captures or information.| New versions of documents, including these release notes, may be available online.

Table 2 Platform

ModusToolbox™ software 2.4, 3.x supports Arm® GCC, Arm® compiler v6, and IAR toolchain. The Bluetooth® SDK supports only Arm® GCC.| None.
The following kits have limited availability:
• CYW920819M2EVB-01
• CYW920820M2EVB-01
• CYW920829M2EVB-01
• CYW920835REF-RCU-01
• CYW920835M2EVB-01
• CYW920736M2EVB-01
• CYW920721M2EVK-01
• CYW920721M2EVK-02
• CYW920721M2EVB-03
• CYW989820M2EVB-01
• CYW943012BTEVK-01
• CYW9M2BASE-43012BT
• CYW955572BTEVK-01
• CYBLE-333074-EVAL-M2B
• CYBLE-343072-MESH| Contact Sales to request access.
CYW920820EVB-02 has limited availability. Note that support for this platform will be removed in a future Bluetooth® SDK release.| Contact sales to request access to the CYW920820M2EVB-01.
CYW989820EVB-01 has limited availability. Note that support for this platform will be removed in a future Bluetooth® SDK release.| Contact sales to request access to the CYW989820M2EVB-01
CYW920819EVB-02 has limited availability. Note that support for this platform will be removed in a future Bluetooth® SDK release and will be replaced by CYW920819M2EVB-01.| Contact sales to request access to the CYW920819M2EVB-01
iAP2 code examples are not included by default in Bluetooth® SDK.| Get the MFi license and contact Sales to request access to the additional code example.
PEPS code examples for the CYW89820 are not included by default in Bluetooth® SDK.| Contact Sales to request access to the additional code examples available for CYW89820.
BSPs using CYW20706 and CYW20736 chips do not support Device Configurator| Modify pin or peripheral configurations directly in wiced_platform.h, wiced_platform.c, or platform.h BSP files.

Table 3 Bluetooth® SDK

[CYW920721M2EVK-01] HAL_ADC: Incorrect voltage values are displayed when GPIO pin P0 is connected to 3.3V (CYW20739B2-963).| This issue is targeted to be addressed in a future Bluetooth® SDK release.
[CYW920721M2EVK-02] Headset_wass: Glitches are heard on PRI and no audio on SEC during audio streaming when OTA upgrade through the OTA SPP app is running (BTSDK-5256).| This issue is targeted to be addressed in a future Bluetooth® SDK release.
[CYW920721M2EVK-02] Headset_wass: No voice prompt is working when the time SEC is reset during headset reconnection from PRI (BTSDK-3044).| This issue is targeted to be addressed in a future Bluetooth® SDK release.
[CYW920721B2EVK-02][Headset_WASS_AMA]: DUT’s LE is not getting discoverable in Alexa App (BTSDK-6944).| This issue is targeted to be addressed in a future Bluetooth® SDK release.
[CYW920721M2EVK-02] Speaker Pro AMA: Need to put the DUT in discoverable mode to perform LE reconnection (BTSDK-3410).| This issue is targeted to be addressed in a future Bluetooth® SDK release.
[CYW55572BTEVK-01] Handsfree: Echo can be observed with high mic gains on eval kit (BTSDK-8015).| Customers should implement echo cancellation algorithms on the DSP audio hardware codec vendor of choice.
[CYW920736M2EVB-01] Downloads: Back-to-back download of applications is not supported (BTSDK-3330).| After downloading an application to a device, the reset recovery operation must be performed on the device before a new application can be downloaded.
[CYW920819EVB-02] Watch: Current spikes of 200 µA on J15 (VDDIO) (BTSDK-49)| This issue will not be fixed.
[CYW920820EVB-02] The Spi_master functionality does not work after changing the pin configuration through the Device Configurator (BTSDK-1093).| Device Configurator should be used only for reserving pins and not assigning functionality. This issue will not be fixed.
[CYW920820EVB-02] The Spi_slave functionality does not work after changing the pin configuration through the Device Configurator (BTSDK-1092).| Device Configurator should be used only for reserving pins and not assigning functionality. This issue will not be fixed.
[CYW920820EVB-02] homekit_lightbulb: Characteristics datatype is displayed as “unknown” (BTSDK-4296).| This issue will be addressed in a future Bluetooth® SDK release.
[CYW920835M2EVB-01] Mesh snip light LC server is advertising as SmartLight (BTSDK-8462).| This issue will not be fixed.
[CYBT-213043-EVAL] MC receives bad packets when HCI tracing is enabled due to the low baud rate and buffer settings with Linux (BTSDK-1908).| Decrease logging on the UART for Linux. This issue will not be fixed.
[CYBT-213043-EVAL] Lecoc: Intermittently observed bad packets (BTSDK-1852).| This issue is due to CY serial bridge software. This issue will not be fixed.
When using the ANS application, the UI does not allow generating all possible alerts simultaneously (BTSDK-145).| This is a current UI limitation; the application can handle generating alerts. The UI can generate individual alerts.
[CYW955572BTEVK-01] Watch [AVRC CT]: Only Title of the track is being displayed on the track details window in AVRC CT tab after playing a song (BTSDK-9250).| This is a current limitation. Only title of the track is visible on client control.
---|---
[CYW955572BTEVK-01][Audio_Watch] Unable to reconnect Airpods Pro with DUT after disconnection (BTSDK-9184).| This is a current limitation. Reconnection between Airpods Pro and DUT fails.
[CYW955572BTEVK-01][Audio_Watch] Unable to wake DUT from Sleep via CUSTOM Button or GPIO_Pin(wake_gpio) (BTSDK-9177).| This is a current limitation. Client Control does not list the tabs supported by the embedded application and is unable to perform operations like BR/EDR or LE Discovery.
[CYW920719B2Q40EVB-01] [Watch-SPI-Transport-Mode] Unable to stop A2DP SRC Sine wave streaming via SPI (BTSDK-9157).| This is a current limitation. On clicking “Stop Streaming” button, the Sine wave sampling streaming does not stop.
[CYW920706WCDEVAL] Headset: Call audio from third party phone to DUT is not audible in wired headset connected to DUT (BTSDK-9146).| This is a current limitation. Call audio spoken from third party phone is not audible at DUT (wired headset connected to DUT).
[CYW920706WCDEVAL] A2dp_Sink: During streaming audio from peer, minor glitch/ pop sound heard randomly (BTSDK-9135).| This is a current limitation. Some minor pop sound/ glitch is observed randomly in audio.
[CYW920835M2EVB-01] After setting the Dimmable brightness 0 using Dimmer, unable to turn On/Off using peer app until it turn on again using dimmer (BTSDK-8873).| This is a current limitation. After setting the Dimmable brightness 0 using Dimmer, unable to turn On/Off using peerapp until it turn on again using dimmer.
[CYW920721B2EVK-02/CYW920721M2EVB-03] HCI_LOOP_BACK : Not getting any traces /logs in BTSPY for STOP Test (CYW20739B2-922).| This is a current limitation.
[CYW955572BTEVK-01] Audio_Gateway app: eSCO connection active even after unbond button press (BTSDK-9338).| This is a current limitation.
WsOtaUpgrade failed with Win11 (BTSDK-9243).| This is a current limitation.
[CYW955572BTEVK-01][Headset_Speaker]: AVRC CT state is not getting updated few times when play/pause is performed from peer device after re-connection from DUT (BTSDK-7092).| This is a current limitation and was determined to be a problem with the peer device.
[IOP][CYW920721M2EVK-02][Headset_Speaker]: Audio streaming is not resuming after ending an outgoing active voice call, which is initiated during audio streaming (BTSDK-5206).| This is a current limitation and was determined to be IOP issue with a specific phone.
[CYW920719B2Q40EVB-01] Hello-Sensor: Reconnection failed with Honor 8/ Honor Play phone randomly (CYW20739B2-1119)| This is a current limitation.
[CYW920721B2EVK-02/CYW920721M2EVB- 03]HCI_LOOP_BACK : Not getting any traces /logs in BTSPY for STOP Test (CYW20739B2-922)| This is a current limitation.
Data_out line goes low in HFP and audio is not heard in the right channel (BTSDK-9785)| This is a current limitation.
---|---
[CYW920721M2EVB-03][Watch- AV Source ( mp3)]: “Mono” Radio button is not enabled while testing Watch AV Source MP3 (BTSDK-9750)| This is a current limitation.
[CYW955572BTEVK-01][Headset-Speaker][IOP]: Disconnection observed when making outgoing call from Honor 8 during A2dp streaming and DUT goes in unresponsive state (BTSDK-9739)| This issue is targeted to be addressed in a future Bluetooth® SDK release.
LPN doesn’t go in sleep after pressing the reset button (BTSDK-9733)| This issue is targeted to be addressed in a future Bluetooth® SDK release.
[CYW955572BTEVK-01][Headset-Speaker][IOP]: A2dp reconnection failed with iPhone12 Pro (BTSDK-9600)| This issue is targeted to be addressed in a future Bluetooth® SDK release.

failed and DUT going in unresponsive state when performing disconnection and reconnecting during a active call (BTSDK-9593)| This issue is targeted to be addressed in a future Bluetooth® SDK release.
[CYW955572BTEVK-01][Headset-Speaker] [IOP]: Disconnection observed when connecting to DUT from Pixel 7 Pro (BTSDK-9592)| This issue is targeted to be addressed in a future Bluetooth® SDK release.
[CYW920820M2EVB-01] [Watch: A2dp-Source] Bad media packet observed in BTSpy logs randomly (BTSDK-9588)| This issue is targeted to be addressed in a future Bluetooth® SDK release.
[CYW920820M2EVB-01] [Watch: A2dp-Source] [IOP]: Distorted audio is heard on Samsung Galaxy Buds2 Pro with SBC Mono configuration (BTSDK-9587)| This issue is targeted to be addressed in a future Bluetooth® SDK release.
[CYW920820M2EVB-01] [Watch: A2dp-Source] [IOP]: Beep sound is heard on OnePlus Buds Pro 2 with SBC Mono configuration (BTSDK-9586)| This issue is targeted to be addressed in a future Bluetooth® SDK release.
L2CAP_ROLE_DISALLOW_SWITCH doesn’t work (BTSDK-9501)| This is a current limitation.
CYW920819EVB-02: debug sticks to breakpoint (J-Link probe) (BTSDK-9487)| This issue is targeted to be addressed in a future Bluetooth® SDK release.
CYW943012BTEVK-01: board doesn’t build with BT_GPIO_3 io and BT_GPIO_5 io (BTSDK-9452)| This is a current limitation.
Need to re-configure device class after wake-up from ePDS mode (BTSDK-9442)| This is a current limitation.
Cannot pull contacts that are categorized as “Favourites” in the phonebook using the PBAP client (BTSDK-9364)| This issue is targeted to be addressed in a future Bluetooth® SDK release.
SensorTemperature node publishing the data 2 times faster even after selecting 4times fast cadence (BTSDK- 9900).| This issue is targeted to be addressed in a future Bluetooth® SDK release.
In win MeshClient Provision UUID field, some time devices are listed without app name, after performing Scan Unprovisioned (BTSDK-9889).| This issue is targeted to be addressed in a future Bluetooth® SDK release.
---|---
OTA doesn’t start on first click in MeshClient (BTSDK- 9888).| This issue is targeted to be addressed in a future Bluetooth® SDK release.
While performing Groupcast Level Get, inappropriate devices are shown in MeshClient traces, which doesn’t exist (BTSDK-9887).| This issue is targeted to be addressed in a future Bluetooth® SDK release.
[CYW920835M2EVB-01/CYW920835REF-RCU-01] HID_LE_Remote/HID_LE_Remote_Control: AUTO_RECONNECT is not happening against NVIDIA shield tv pro (BTSDK-10097).| This issue is targeted to be addressed in a future Bluetooth® SDK release.
[CYW920835M2EVB-01] Hello_client/Hello_sensor apps have connection issues when programmed with DIRECT_LOAD=1 (RAM download) (BTSDK-10094)| This issue is targeted to be addressed in a future Bluetooth® SDK release.
[CYW920719B2Q40EVB-01][Audio_Gateway]: unstable SCO connection with some devices (BTSDK-10055)| This issue is targeted to be addressed in a future Bluetooth® SDK release.
[CYW920736M2EVB-01][OTA-FW-Upgrade]:Observing disconnection on next consecutive firmware upgrade after a successful upgrade (BTSDK-10154).| This issue will not be fixed. The workaround is to try again after the disconnect.
[CYW920721M2EVB-03 : IFXV-Host][CYW920835M2EVB- 01 : IFXV-Remote][MAC OS] Audio Playback is not proper when playing recorded audio via Client control (BTSDK-10129).| This issue is targeted to be addressed in a future Bluetooth® SDK release.
[CYW920819M2EVB-01][btsdk-host-apps-bt- ble][ClientControl][MAC_OS] AV Source Tab is not responding (BTSDK-10430)| This issue is targeted to be addressed in a future Bluetooth® SDK release.
[CYW20819A1] Device wakes up twice from HID OFF (BTSDK-10426)| This issue is targeted to be addressed in a future Bluetooth® SDK release.
I2S L/R inverted on A2DP SR (BTSDK-10093)| This issue is targeted to be addressed in a future Bluetooth® SDK release.
SDS keyscan wake up intermittent issue with mtb- example-btsdk-hid-ifxv-remote (BTSDK-10421)| This issue is targeted to be addressed in a future Bluetooth® SDK release.
Shutdown Sleep not working in BTSDK version 4.4 and above (BTSDK-10429).| This issue is targeted to be addressed in a future Bluetooth® SDK release.
IFXV remote control example project:: link params update / SDS issue (BTSDK-10457).| This issue is targeted to be addressed in a future Bluetooth® SDK release.
CYW20819/CYW20820 devices may report incorrect wakeup reason in application traces when waking from HIDOFF mode for timed wakeup vs. GPIO wakeup, due to a problem with device API wiced_sleep_hid_off_wake_reason() (BTSDK-10434).| This issue is targeted to be addressed in a future Bluetooth® SDK release.
IFXV remote control example project :: exit pairing mode issue wake from SDS from GPIO input (power key) (BTSDK-10490)| This issue is targeted to be addressed in a future Bluetooth® SDK release.
---|---
[CYW920835REF-RCU- 01](HID_LE_Remote_Control/HID_IFXV- Remote_Control) Device does not reboot after OTA FW upgrade if the device PUART is connected. (BTSDK- 10513)| This issue is targeted to be addressed in a future Bluetooth® SDK release.
[BTSpy] Auto scroll does not work and “bt_spy has stopped working” when tried to save the logs and the tool has already ~50K lines of log. (BTSDK-10117)| This issue is targeted to be addressed in a future Bluetooth® SDK release.
[CYW20706 CYW20819 CYW20820 CYW20736 CYW20835 CYW20721] Web pages list out of date qualification versions instead of 5.4 (BTSDK-10521 BTSDK-10518 BTSDK-10510 BTSDK-10465 BTSDK-10573)| This issue is targeted to be addressed in a future Bluetooth® SDK release.
[CYW20719] wiced_bt_dev_force_update_tx_power_table symbol not available for CYW20719 (BTSDK-7736).| This API is not supported in CYW20719, the prototype will be removed from the header in a future release.
Need to update wiced_bt_dev_read_rssi() API documentation (BTSTACK-5537).| This issue is targeted to be addressed in a future Bluetooth® SDK release.
Vela-IF820-EXT-ANT-DVK and Vela-IF820-INT-ANT-DVK has invalid URL (BTSDK-10619).| This issue is targeted to be addressed.
wiced_bt_dev_read_rssi() API always returns 0 value for RSSI in 20721 (Audio watch) (BTSDK-10584).| This issue is targeted to be addressed in a future Bluetooth® SDK release.
[CYW920706WCDEVAL][Firmware_Upgrade_via_OTA] Firmware Upgrade is not successful when Smartphones with Android OS v14 as peer device (BTSDK-10583).| This issue is targeted to be addressed in a future Bluetooth® SDK release.
IFXV remote control example project :: DBFW_ASSERT_TYPE_FATAL!!! module_id: 0, id: 13b00 (BTSDK-10535).| This issue is targeted to be addressed in a future Bluetooth® SDK release.
Core Dump and Build Error on CYW920820M2EVB-01 and CYBT-243053-EVAL for Audio Gateway Profile with watch app (BTSDK-10488).| This issue is targeted to be addressed in a future Bluetooth® SDK release.
[BTSPY] Crash observed within 5 to 10 mins of duration with 2 instances running (BTSDK-10329).| This issue is targeted to be addressed in a future Bluetooth® SDK release.
BLE 2M PHY throughput decreases for CYW989820M2EVB-01 (BTSDK-10257).| This issue is targeted to be addressed in a future Bluetooth® SDK release.

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 Infineon license agreement covering this software package. The appropriate license agreements are available online.

Further reading

See ModusToolbox™ software documents (including but not limited to the following):

• ModusToolbox™ software installation guide
• Bluetooth® API documentation
• Eclipse IDE for ModusToolbox™ software quick start guide
• Eclipse IDE for ModusToolbox™ software user guide
• ModusToolbox™ software configurator guides (for each configurator)

Other documentation includes (but is not limited to):

• Device datasheets
• Application notes
• Training

Contact your sales representative as needed.

Trademarks
All referenced product or service names and trademarks are the property of their respective owners.
The Bluetooth® word mark and logos are registered trademarks owned by Bluetooth SIG, Inc., and any use of such marks by Infineon is under license.

IMPORTANT NOTICE
The information contained in this document is given as a hint for the implementation of the product only and shall in no event be regarded as a description or warranty of a certain functionality, condition or quality of the product. Before implementation of the product, the recipient of this document must verify any function and other technical information given herein in the real application. Infineon Technologies hereby disclaims any and all warranties and liabilities of any kind (including without limitation warranties of non-infringement of intellectual property rights of any third party) with respect to any and all information given in this document.
The data contained in this document is exclusively intended for technically trained staff. It is the responsibility of customer’s technical departments to evaluate the suitability of the product for the intended application and the completeness of the product information given in this document with respect to such application.

WARNINGS
Due to technical requirements products may contain dangerous substances. For information on the types in question please contact your nearest Infineon Technologies office.
Except as otherwise explicitly approved by Infineon Technologies in a written document signed by authorized representatives of Infineon Technologies, Infineon Technologies’ products may not be used in any applications where a failure of the product or any consequences of the use thereof can reasonably be expected to result in personal injury.

Edition 2024-03-29
Published by
Infineon Technologies AG
81726 Munich, Germany
© 2024 Infineon Technologies AG.
All Rights Reserved.
Do you have a question about this document?
Emailerratum@infineon.com
Document reference
002-39792 Rev. **

Documents / Resources

| infineon CYW920721M2EVB-03 AIROC Bluetooth SDK [pdf] Owner's Manual
CYW20706, CYW920706WCDEVAL, CYW920819M2EVB-01, CYW943012BTEVK-01, CYW920835M2EVB-01, CYW920721M2EVB-03 AIROC Bluetooth SDK, CYW920721M2EVB-03, AIROC Bluetooth SDK, Bluetooth SDK, SDK
---|---

References

• Semiconductor & System Solutions - Infineon Technologies
• Semiconductor & System Solutions - Infineon Technologies
• Infineon · GitHub
• Our Locations - Infineon Technologies
• Free and open-source Software (FOSS) - Infineon Technologies

Read User Manual Online (PDF format)

Read User Manual Online (PDF format)  >>

Download This Manual (PDF format)

Download this manual  >>