TI BLE-Stack 9.20.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.20.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 | Supported |
| Channel Sounding | Supported |
| RAS/RAP Server/Client | Preview (Not yet certified) |
| Direction Finding (AoA) | Not Supported (Planned for a future release) |
| Periodic Advertising with Response (PAwR) | Supported |
| Periodic Advertising Sync Transfer | Supported |
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 | Description | Device(s) Supported |
|---|---|---|
| basic_ble | Example project where the device can be configured to operate as a Bluetooth LE peripheral, central, or both. | CC23xx and CC27xx |
| basic_ble_extctrl | Example that implements connection handover used to control a device running basic_ble device through external commands sent over UART. | CC23xx and CC27xx |
| basic_ble_multistep_oad | Example that implements a half-image architecture that maximizes flash utilization for application code. | CC23xx |
| basic_ble_oad_offchip | Same as basic_ble with OAD off-chip functionality to enable wireless firmware updates. | CC23xx |
| basic_ble_oad_onchip | Same as basic_ble with OAD on-chip functionality to enable wireless firmware updates. | CC23xx and CC27xx |
| basic_ble_profiles | Same as basic_ble with additional custom profiles: Continuous Glucose Monitoring and Glucose Profile & Health Thermometer Profile. | CC23xx and CC27xx |
| basic_ble_ptm | Same as basic_ble with Production Test Mode (PTM) functionality. | CC23xx |
| basic_ble_oad_dual_image | Same as basic_ble with OAD dual image functionality. | CC23xx and CC27xx |
| basic_persistent | Example project that implements OAD profile. | CC23xx and CC27xx |
| ble_controller | Example project that implements the Bluetooth LE controller layer. This project can be used to interface with the bluetooth tester device. | CC23xx and CC27xx |
| car_node | Example project to support Channel Sounding, BLE Handover, and Connection Monitor Role. Used with key_node example project. | CC2340R53* and CC27xx (see note below) |
| data_stream | Example project which implements data stream profile to enable UART over Bluetooth LE. | CC23xx and CC27xx |
| key_node | Example project to support Channel Sounding, used with car_node example project. | CC2340R53* and CC27xx (see note below) |
| host_test | Example project which can be used with Bluetooth Tester through UART or SPI. | CC23xx and CC27xx |
*The car_node and key_node Channel Sounding examples are only available on the CC2340R53 device in the CC23xx family and all CC27xx devices.
The basic_persistent slot has been extended up to address 0x34000 for CC23xx and CC27xx devices. As a result, the application start address (e.g., basic_ble_onchip example) is now aligned to start from 0x34000.
Examples showcasing support for Apple® Find My® Network (is a trademark of Apple Inc.) are available in the Find My Network Accessory Protocol (FMNAP) Plugin for SimpleLink devices (SIMPLELINK-LOWPOWER-FMNAP) for CC23xx devices. 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
The mobile app used for testing this release can be found at SIMPLELINK-CONNECT-SW-MOBILE-APP.
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_20_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_20_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
- Bluetooth 6.2 Qualified for CC23xx Devices
- Periodic Advertising with Response (PAwR) and Periodic Advertising Sync Transfer (PAST)
- Certified at controller and host level
- Early evaluation at application level
- Supports scanner and advertiser
- Power Control with Channel Sounding
- Channel Sounding Connection Handover with RAS (early evaluation)
- Channel Sounding improvements
- Optimized air time usage in multi-role and multi-connection scenarios
- Broader interoperability with phones and more accurate localization
- Multi-step Over Air Download (OAD) for CC23xx, offering reduced Flash footprint firmware
- Bluetooth Low Energy (BLE) / Wi-Fi Coexistence (early evaluation)
- Power optimization for BLE connection events
- Scheduler optimization – enabling optimal air time usage in multi-role and multi-connection scenarios
| ID | Summary |
|---|---|
| BLE_LOKI-3902 | Add CC2340R5MODA Support in BLE Examples and SysConfig |
| BLE_LOKI-3900 | BLE 6.2 Qualification - PAwR, PAST, Power Control |
| BLE_LOKI-3898 | Periodic Advertisements with Responses - Advertiser |
| BLE_LOKI-3886 | Provide Examples for the LP_EM_CC2755P20 Board |
| BLE_LOKI-3010 | Multistep OAD |
| BLE_LOKI-2753 | Periodic Advertising Sync Transfer (PAST) support |
| BLE_LOKI-2723 | Periodic Advertisements with Responses - Scanner |
| BLE_LOKI-407 | 3 Wire CoEx Support |
| BLE_LOKI-406 | 1 Wire CoEx Support |
Fixed Issues
| ID | Summary |
|---|---|
| BLE_LOKI-4073 | [CS] Fix CS Request offsetMax validation to comply with BLE Spec |
| BLE_LOKI-4008 | CC2745 CS Precal task causing hard fault |
| BLE_LOKI-3992 | LL_ReadTxPowerLevel returns SUCCESS for inactive connection handles instead of Unknown Connection Identifier error |
| BLE_LOKI-3872 | [CS][Multi Connect]Distance not Reported for One or More Keys During Multiple Connections |
| BLE_LOKI-3860 | Adv Status not displayed on Broadcaster device role |
| BLE_LOKI-3429 | No Distance is Received after 160 to 255 CS Procedures using RAS over Indications |
| BLE_LOKI-2842 | CC23XX and CC27XX family of devices rounds down Tx power values that are not in the power table |
| BLE_LOKI-1380 | Device name is limited to 21 bytes |
| BLE_LOKI-1057 | [basic_ble][SysConfig] Observer's RSSI filter cannot be configured |
Known Issues and Limitations
| ID | Summary |
|---|---|
| BLE_LOKI-4183 | CC27xx Fail to Complete Dual Image OAD with Coded PHY on IAR |
| BLE_LOKI-3724 | IAR Compiler Error when Compiling Basic_persistent on CC2340 Devices |
| 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-3389 | CS procedure must be complete before starting the next one |
| 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 | Observer Fails to Receive GAP_EVT_SCAN_DISABLED |
| 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-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
Please take a look at the following application note for 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, MM.mm.pp.bb, where:
- MM is a 2 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