TI BLE5-Stack 3.02.02.00 Release Notes
Table of Contents
Introduction
The BLE5-Stack is a set of sample applications, tools, APIs and protocol stack libraries that enable engineers to develop Bluetooth ® 5 standalone or network processor LE applications on the SimpleLink™ CC23xx family of wireless MCUs.
Key features overview of BLE5-Stack 3.02.02.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 | Not Supported (Work ongoing) |
| 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 | Not Supported (Planned for a future release) |
| Direction Finding (AoA) | Not Supported (Planned for a future release) |
The BLE5-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 |
|---|---|
| basic_ble | Example project where device can be configured to operate as a Bluetooth LE peripheral, central, or both. |
| basic_ble_oad_offchip | Same as basic_ble above with OAD off-chip functionality to enable wireless firmware updates. |
| basic_ble_oad_onchip | Same as basic_ble above with OAD on-chip functionality to enable wireless firmware updates. |
| basic_ble_profiles | Same as basic_ble above with additional custom profiles included in project. Example currently contains Continuous Glucose Monitoring profile & Glucose profile. |
| basic_ble_ptm | Same as basic_ble above with Production Test Mode (PTM) functionality. |
| basic_dual_image | Same as basic_ble above with OAD dual image functionality. |
| basic_persistent | Permanently resident application that implements OAD profile |
| connection_monitor | Example project that implements high level connection tracking. |
| data_stream | Example project which implements data stream profile to enable UART over Bluetooth LE. |
| host_test | Example project which can be used with Bluetooth Tester through UART or SPI. |
Additional information about TI’s Bluetooth Low Energy solutions can be found at www.ti.com/ble
BLE5-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 BLE5-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_7_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_7_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
| ID | Summary |
|---|---|
| BLE_LOKI-794 | Introduced No Delay Advertising Feature |
| BLE_LOKI-709 | [BASIC BLE] [Profiles] Glucose Profile added to ble_basic profiles |
| BLE_LOKI-674 | Connection Monitor example introduced |
| BLE_LOKI-473 | [OAD] OAD Dual Image Support |
| BLE_LOKI-224 | Use RSSI/Channel/Timestamp reported by the RCL |
Fixed Issues
| ID | Summary |
|---|---|
| BLE_LOKI-848 | CC2340R5 basic_ble_oad_offchip_peripheral Link Terminate when start OAD using bTool |
| BLE_LOKI-756 | Tx Power value in advertisements is not updated after the advertisement are started |
| BLE_LOKI-755 | Bonding fails if LTK not updated in the linkDB |
| BLE_LOKI-754 | HCI_EXT_SetTxPowerDbmCmd() does not change txPower on CC23XX device |
| BLE_LOKI-721 | Repeatedly changing connection PHY sometimes causes connection timeout during long-term stability testing |
| BLE_LOKI-699 | [basic_ble_oad_onchip] GATT caching can cause OAD to fail |
| BLE_LOKI-698 | CC2340R5: Canceling ongoing OAD via BTool causes retryOAD to fail |
| BLE_LOKI-681 | [OAD] CC23xx device does not indicate to Android/ iOS device to not cache GATT table |
| BLE_LOKI-659 | [Basic BLE Profiles - CGM] Notifications are not sent after large amount of measurements are added |
| BLE_LOKI-657 | Basic BLE central device uses a peer's RP address after bonding |
| BLE_LOKI-656 | basic_ble not using SysConfig parameters for scan and connection parameters |
| BLE_LOKI-640 | HCI_LE_ReadRfPathCompCmd and HCI_LE_WriteRFPathCompCmd not supported |
| BLE_LOKI-639 | [Basic Example] Basic Broadcaster Doesn't Advertise |
| BLE_LOKI-477 | [SysConfig] Disable the display module checkbox is missing. |
Known Issues and Limitations
| ID | Summary |
|---|---|
| BLE_LOKI-939 | Fails to Change Connection PHY to Coded in multi-role with multiple connections |
| BLE_LOKI-872 | [Application] basic_ble_Central - Missing Addresses In Scan Results When Duplicate Filters Is Enable |
| BLE_LOKI-768 | Device stops responding after multiple connections |
| BLE_LOKI-694 | [GATT_WriteLongCharValue] Large data size (300 bytes) results in incomplete writes |
Upgrade and Compatibility Information
The BLE5-Stack 3.02.02.00 only supports SimpleLink CC23xx devices with silicon revision E. No support for previous silicon revisions or LaunchPad™ development kits using earlier silicon revisions. If you’re unsure of the revision number of your device, please see the Package Symbolization and Revision Identification section of the Errata Note.
Qualification
The Bluetooth Low Energy software stack (BLE5-Stack) for CC23xx Bluetooth LE-enabled wireless MCUs uses Bluetooth Qualified Components, which allow customers to substantially reduce the testing required to meet Bluetooth end product listing (EPL) qualification requirements while providing flexibility to the device configuration. Bluetooth SIG rules specify that Qualified Components have a validity period of three (3) years at which time they may not be available for new End Product Listings (EPLs). The applicable QDID for this release is QDID 201833
For information on the qualification process, please refer to https://www.ti.com/ble-qualification
Operating System Support
- Windows® 10
- Ubuntu 20.04 LTS 64-bit
- macOS Catalina
Dependencies
The BLE5-Stack sample applications were built & tested with the IDEs and listed below:
- TI Code Composer Studio: CCS-12.3.0
- TI ARM Clang Compiler: 2.1.2.LTS
- FreeRTOS: 202104.00
- SysConfig: 1.17.0
- UniFlash: 8.2.0
- IAR Embedded Workbench:: 9.32.1
Note: Earlier IDE/toolchain versions are not supported and compatibility with newer versions of supported IDEs is not assured.
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.