TI BLE5-Stack Release Notes

Table of Contents


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™ CC13x2 and CC26x2 family of wireless MCUs. This Bluetooth 5 (BLE5-Stack) release includes support to enable development of applications using the following Bluetooth 5 LE features: High Speed, Long Range (LE Coded PHYs), Advertisement Extensions as well as all existing Bluetooth 4.0, 4.1 and 4.2 LE features.

As with all Bluetooth core specifications that support the Low Energy (LE) feature, devices implementing the LE feature of Bluetooth 5 are backward compatible with Bluetooth 4.2, 4.1 and 4.0 LE capable devices.

BLE5-Stack has been Bluetooth 5 qualified and is available for production use.

Key features of BLE5-Stack :

Additional information about TI’s Bluetooth Low Energy solutions can be found at www.ti.com/ble

BLE5-Stack Documentation

The SimpleLink CC13x2 and CC26x2 Software Development Kit(SDK) allows easier product development by combining TI-RTOS and the BLE protocol stack in one unified SDK. All BLE5-Stack sample applications are based off the TI-RTOS Kernel. Key documents needed for BLE application development include:

Installation and Usage

What’s New

ID Summary
BLE_AGAMA-1850 [RTLS] Remove ToF support from SDK
BLE_AGAMA-1793 Added 1/3 wire Wi-Fi CoEx interface support
BLE_AGAMA-1781 Added an indication to the application when a Connection Parameter Update has been rejected
BLE_AGAMA-667 Added support for notification of Channel Map update in BLE application
BLE_AGAMA-116 Enhance The AE Advertisment Set Scheduling Algorithm

Fixed Issues

ID Summary
BLE_AGAMA-1887 Fixed a specification incompliance where the DH Key check was skipped on the device in the peripheral role if a central device attempted to start encryption before it sends a DH Key check value to the peripheral
BLE_AGAMA-1708 [RTLS] AoA multiple connection: When>4 slaves are connected, the master node might disconnect after aoa_start command is sent. WA requires delaying the aoa_start command for a few seconds after the connection is established.
BLE_AGAMA-1707 Fixed a BLE Stack DoS (crash) vulnerability caused by invalid connection PDU parameters
BLE_AGAMA-1692 Radio quits transmitting and receiving when enabling 3+ connections and advertising and scanning at the same time.
BLE_AGAMA-1613 Sending connection update request fails when the device has previously been rejected
BLE_AGAMA-1597 [RTLS] AoA Master sometimes get stuck in multiple connections scenario
BLE_AGAMA-1587 Receiving a connection request packet with transmit window offset = 0 will fail.
BLE_AGAMA-1573 [SYSCFG] Custom Board configuration in sysconfig is not supported
BLE_AGAMA-1448 When using slave latency, the connection is often dropped with 1 phone, and sometimes dropped with multiple phones connected to central device

Known Issues and Limitations

ID Summary
BLE_AGAMA-2033 [RTLS] Passive Application is not functioning well in Debug configuration. WA: Change the optimization in Debug configuration to High (as in Release)
BLE_AGAMA-2010 [Multi-Sensor] Updating Report Interval Have no effect
BLE_AGAMA-1974 [RTLS] Sometimes there are no Angle reports for all connections when configured to 4-1-1 [aoa_sample_rate-aoa_slot_durations-aoa_sample_size], when working with CCS
BLE_AGAMA-1970 [Multi-Sensor] Some of the Multi Sensor services fail to initiate or open when loading up
BLE_AGAMA-1675 IOP: Device fails to pair with Meizu Pro 7
BLE_AGAMA-1652 [RTLS] AoA multiple connection: When>4 slaves are connected, the passive node sometimes fails to track some of the connections.
BLE_AGAMA-1441 [RTLS] AoA angle calculation is deviated for boundary angles
BLE_AGAMA-1435 [Multi-Sensor] Accelerometer Service Disappears After First Connection
BLE_AGAMA-1416 OAD offchip examples needs additional reset to load Factory Image
BLE_AGAMA-1370 CC13x2-P2 persistent app failed to compile in debug configuration
BLE_AGAMA-546 Central applications do not receive timeout when connection fails
BLE_AGAMA-273 [Known Limitation] SC can't save Bond data for more than 10 devices to NV
BLE_AGAMA-139 When using multi-role, the random address will display in the serial terminal, instead of the “Work With” selection
BLE_AGAMA-80 The NVS Driver is now used for bond storage. It is not possible to retain OSAL_SNV contents when upgrading from earlier BLE5 1.1.x releases.

Upgrade and Compatibility Information

The BLE5-Stack only supports SimpleLink CC13x2 and CC26x2 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.

As a supplier of Bluetooth® Low Energy (BLE) solutions with a focus on interoperability and broad market adoption, we recommend to transition from proprietary Real Time Localization Toolbox (RTLS) software examples to the new RTLS software examples based on the Bluetooth 5.1 specification. These examples are included in this software development kit. For further information please contact your local TI sales representative.


The Bluetooth low energy software stack (BLE-Stack) for CC13x2_26x2 BLE 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). This SDK release is covered by QDID 135969 with expiration date 2022-09-19 and TCRL 2018-2. For more information please refer to the application report SWRA601 - How to Qualify Your Bluetooth Low Energy Product.

Operating System Support


The BLE5-Stack sample applications were built & tested with the Integrated Development Environments (IDEs) and listed in the top-level SDK release notes.

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 and multi-band 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 and multi-band wireless MCU development kits listed in the top-level SDK release notes


The BLE5-Stack sample applications were built & tested with versions of the following Integrated Development Environments (IDEs) and tool chains listed in the top-level SDK release notes:


This product follows a version format, M.mm.pp.bb, where:

Technical Support and Product Updates