TI BLE5-Stack 9.14.00 Release Notes
Table of Contents
- Introduction
- BLE-Stack Documentation
- Installation and Usage
- What’s New
- Fixed Issues
- Known Issues and Limitations
- Upgrade and Compatibility Information
- Qualification
- Dependencies
- Device Support
- Development Board Support
- Versioning
- Product Security Vulnerabilities
- Technical Support and Product Updates
Introduction
The BLE-Stack is a set of sample applications, tools, APIs and protocol stack libraries that enable engineers to develop Bluetooth ® LE standalone or network processor LE applications on the SimpleLink™ CC23xx family and the SimpleLink™ CC27xx family of wireless MCUs.
Key features overview of BLE-Stack 9.14.00:
| BLE Features | Support Status |
|---|---|
| Legacy advertising | Supported |
| Connection using the LE 1M PHY | Supported |
| Pairing and link encryption | Supported |
| Bonding | Supported |
| Accept list for advertiser | Supported |
| Direct Test Mode (DTM) | Supported |
| L2CAP Connection Oriented Channels (CoC) | Supported |
| Extended advertising | Supported |
| LE 2M and Coded PHYs | Supported |
| Privacy | Supported |
| Adjustable TX Power | Supported |
| RSSI Reading | Supported |
| Over The Air Download | Supported |
| LE Secure Connection | Supported |
| Data Length Extension (DLE) | Supported |
| Periodic Advertising | Supported |
| Periodic Scanning | Supported |
| Adaptivity | Supported (China MIIT and EU RED Regulation) |
| LE Power Control | Preview (Not yet certified) |
| Channel Sounding | Supported * |
| RAS/RAP Server/Client | Preview (Not yet certified) |
| Direction Finding (AoA) | Not Supported (Planned for a future release) |
- Channel Sounding accuracy measurement results will be further optimized in future releases.
The BLE-Stack provides a set of basic examples designed to accelerate customer product development providing easy-to-use, out-of-the-box demonstrations of the full hardware capabilities.
| Available Examples (CC23xx) | Description |
|---|---|
| basic_ble | Example project where the device can be configured to operate as a Bluetooth LE peripheral, central, or both. |
| basic_ble_extctrl | Example that implements connection handover used to control a device running basic_ble device through external commands sent over UART. |
| basic_ble_oad_offchip | Same as basic_ble with OAD off-chip functionality to enable wireless firmware updates. |
| basic_ble_oad_onchip | Same as basic_ble with OAD on-chip functionality to enable wireless firmware updates. |
| basic_ble_profiles | Same as basic_ble with additional custom profiles: Continuous Glucose Monitoring and Glucose Profile & Health Thermometer Profile. |
| basic_ble_ptm | Same as basic_ble with Production Test Mode (PTM) functionality. |
| basic_dual_image | Same as basic_ble with OAD dual image functionality. |
| basic_persistent | Example project that implements OAD profile. |
| ble_controller | Example project that implements the Bluetooth LE controller layer. |
| car_node | Example project to support Channel Sounding, BLE Handover, and Connection Monitor Role only available for CC2340R53 device. Used with key_node example project. |
| data_stream | Example project which implements data stream profile to enable UART over Bluetooth LE. |
| key_node | Example project to support Channel Sounding, used with car_node example project. |
| host_test | Example project which can be used with Bluetooth Tester through UART or SPI. |
| Available Examples (CC27xx) | Description |
|---|---|
| basic_ble | Example project where the device can be configured to operate as a Bluetooth LE peripheral, central, or both. |
| basic_ble_extctrl | Example that implements connection handover used to control a device running basic_ble device through external commands sent over UART. |
| basic_ble_oad_onchip | Same as basic_ble with OAD on-chip functionality to enable wireless firmware updates. |
| basic_ble_profiles | Same as basic_ble with additional custom profiles: Continuous Glucose Monitoring and Glucose Profile & Health Thermometer Profile. |
| basic_ble_oad_dual_image | Same as basic_ble with OAD dual image functionality. |
| basic_persistent | Example project that implements OAD profile. |
| data_stream | Example project which implements data stream profile to enable UART over Bluetooth LE. |
| ble_controller | Example project that implements the Bluetooth LE controller layer. |
| car_node | Example project to support Channel Sounding, BLE Handover, and Connection Monitor Role. Used with key_node example project. |
| key_node | Example project to support Channel Sounding, used with car_node example project. |
| host_test | Example project which can be used with Bluetooth Tester through UART or SPI. |
Examples showcasing support for Apple® Find My® Network are available in the Find My Network Accessory Protocol (FMNAP) Plugin for SimpleLink devices (SIMPLELINK-LOWPOWER-FMNAP). Access to the plugin requires an MFi license and a myTI account. Access requests should be filled through the online request form.
Additional information about TI’s Bluetooth Low Energy solutions can be found at www.ti.com/ble
BLE-Stack Documentation
The SimpleLink™ Low Power F3 Software Development Kit (SDK) allows easier product development by combining TI-drivers and the Bluetooth LE protocol stack in one unified SDK. All BLE-Stack sample applications are based off the FreeRTOS Kernel. Key documents needed for Bluetooth LE application development include:
Installation and Usage
- To build the sample applications with this SDK a supported Integrated Development Environment (IDE) must be installed (refer to Dependencies below)
- Install the simplelink_lowpower_f3_sdk_9_14_00_xx installer package on a supported host operating system build machine with Administrator privileges
- The default install path for Windows is C:\ti\simplelink_lowpower_f3_sdk_9_14_00_xx
- Changing the default install path and/or drive letter may require updating project variables. Do not use a space in the install path
- It is recommended to make a backup of the installation in order to revert modifications to the SDK
What’s New
- Connection Monitor Role and GapBondMgr functions have changed. Please reference the 9.11 to 9.14 migration guide for more information.
| ID | Summary |
|---|---|
| BLE_LOKI-3603 | Add support for LP-EM-C2755R10-BG for BLE examples |
| BLE_LOKI-3600 | Allow Configuration of Number of Thread Priorities with BLE Thread Defaulting to Highest Priority |
| BLE_LOKI-1945 | L2CAP to Signal application When Peer sends L2CAP Credits |
Fixed Issues
| ID | Summary |
|---|---|
| BLE_LOKI-3773 | ICALL Thread Task Priority Adjustment |
| BLE_LOKI-3768 | Timer Double Abort Potential Issue within Car Node Example Project |
| BLE_LOKI-3757 | Connection handover data size is abnormally large on SDK 9.14 |
| BLE_LOKI-3755 | Channel Sounding Repetition Termination Mechanism Fixes |
| BLE_LOKI-3723 | Wrong Result Format due to Memory Corruption when using Channel Sounding Repeat Procedures |
| BLE_LOKI-3716 | Channel Sounding Procedure Enable Fails for Coded Phy in all Modes |
| BLE_LOKI-3657 | Unexpected Behavior in First Channel Sounding Distance Events Following Reconnection |
| BLE_LOKI-3330 | Channel Sounding Procedure Repetition Termination is not supported |
| BLE_LOKI-3224 | CS TPM is limited to 40us and offset is increased to 1.5ms |
| BLE_LOKI-3209 | Potential Memory Leak while Running Fuzz Test with L2CAP Connection, Configuration and Disconnection Packets |
| BLE_LOKI-3172 | L2CAP Channel is not established after connection is handed over backwards, when devices are not Paired |
| BLE_LOKI-3154 | Channel Sounding Procedure Repetitions stops if connection event fails |
Known Issues and Limitations
- Increase FLASH and RAM consumption which will be addressed in the next release.
| ID | Summary |
|---|---|
| BLE_LOKI-3724 | IAR Compiler Error when Compiling Basic_persistent on CC2340 Devices |
| BLE_LOKI-3676 | Channel Sounding Timeout Distance Events for Mode 3 with 2x2 Antennas |
| BLE_LOKI-3536 | If parameter update or channel map update w/ CSA#1 is from the past - Connection Monitor will terminate |
| BLE_LOKI-3535 | Connection Monitor Cannot properly track connection on Coded PHY |
| BLE_LOKI-3473 | IAR Compiled Car Node and Key Node Executing Channel Sounding in Loops Causes GAP Link Termination |
| BLE_LOKI-3429 | No Distance is Received after 160 to 255 CS Procedures using RAS over Indications |
| BLE_LOKI-3389 | CS procedure must be complete before starting the next one |
| BLE_LOKI-3236 | Calling HCI_ResetCmd Causes Program to Crash |
| BLE_LOKI-3208 | BLE Agent GUI not able to calculate time offset correctly when running connection handover demo which causes frequent unsuccessful handover sessions |
| BLE_LOKI-3177 | [SWAT] Observer failed to receive GAP_EVT_SCAN_DISABLED event |
| BLE_LOKI-3097 | After changing PHY both devices continue to send Power Reporting events |
| BLE_LOKI-2978 | Connnection Handover AuthenticationComplete Event Received after Handover When Candidate Configured To Initiate Pairing Request |
| BLE_LOKI-2842 | CC23XX and CC27XX family of devices rounds down Tx power values that are not in the power table |
| BLE_LOKI-2650 | CC2745R10Q1 Central Role Fails to Switch Connection PHY to Coded While Holding 16 Connections |
| BLE_LOKI-2648 | Connection may be unstable with Coded PHY when Access Address has high cross-correlation with the preamble |
| BLE_LOKI-2373 | CC2340R5 MAX periodic adv list size is hard coded and can't be configure by SysConfig |
| BLE_LOKI-2358 | CC2340R5 Basic MR printed peripheral initial RPA after bond and pair, instead of its Public Address |
| BLE_LOKI-2108 | Specific smart phone doesn't find peer running extended ADV with secondary PHY of 1M |
| BLE_LOKI-1630 | Extended Advertisement Reports Are Not Filtered When SCAN_PARAM_FLT_DUP is Enabled |
Upgrade and Compatibility Information
No support for previous silicon revisions or LaunchPad™ development kits using earlier silicon revision. If you’re unsure of the revision number of your device, please see the Package Symbolization and Revision Identification section of the Errata Note.
The following compilers are supported (see the SDK release notes for specific version numbers):
- TI ARM Clang Compiler
- IAR Embedded Workbench
Qualification
The applicable Design Number for this release is for CC23XX Design Number Q301991 and for CC27XX Design Number Q371076
Please take a look at the following application note for further details on How to Certify Your Bluetooth Product.
Dependencies
The correct dependencies for this SDK release must be used to ensure proper functionality of the software and compatibility with the hardware. Using incorrect dependencies will very likely lead to unintended and unexpected behavior. See top-level release notes for overall SDK dependencies.
Device Support
This release supports development of single-mode Bluetooth LE applications on 2.4 GHz wireless MCUs listed in the top-level SDK release.
Development Board Support
This release supports development of single-mode Bluetooth LE on 2.4 GHz wireless MCU development kits listed in the top-level SDK release notes.
Versioning
This product follows a version format, M.mm.pp.bb, where:
- M is a 1 digit major number,
- mm is a 2 digit minor number,
- pp is a 2 digit patch number,
- bb is a 2 digit incrementing build counter.
Product Security Vulnerabilities
- Vulnerability reports and mitigations can be found on https://www.ti.com/PSIRT