TI BLE5-Stack 3.02.01.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.01.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 Not Supported (Feature is under final test)
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.
basic_ble_ptm Same as basic_ble above with Production Test Mode (PTM) functionality.
basic_persistent Permanently resident application that implements OAD profile
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

What’s New

ID Summary
BLE_LOKI-576 Introduced Continuous Glucose Monitoring (CGM) Profile Example
BLE_LOKI-572 Two Button Menu functionality added for Basic BLE Example
BLE_LOKI-504 Added IAR Support for CC23XX platform
BLE_LOKI-470 Multi-connection Support
BLE_LOKI-465 [CC2340R5] Bluetooth LE Adjustable TX Power Support
BLE_LOKI-438 Data Stream profile over Basic Example
BLE_LOKI-316 Added support for all PHYs and PHY change

Fixed Issues

ID Summary
BLE_LOKI-494 Central failed to establish connectionWL to peer with RPA from white list
BLE_LOKI-436 Basic BLE project with multirole BLE role advertises intermittently
BLE_LOKI-435 [macOS Build] imgtool command not found - build post process step for OAD examples fails
BLE_LOKI-431 TERMINATION_IND sometimes missed when using ADV Interval < 100ms
BLE_LOKI-405 CC2340R5 current consumption increased by ~1uA due to longer duration of ‘IDLE’ state
BLE_LOKI-250 GAP_ADV_EVT_MASK_SCAN_REQ_NOTI is not processed in the controller
BLE_LOKI-225 CC23X0 hangs after calling scan_enable
BLE_AGAMA-4307 [PSIRT-145] Accepts PairConfirmSend with wrong values
BLE_AGAMA-4306 [PSIRT-144] Accepts PairRandomSend before exchanging public key
BLE_AGAMA-4305 [PSIRT-143] BLE secure pairing: Accepts DHKeyCheckSend with all fields zero

Known Issues and Limitations

ID Summary
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-639 [Basic Example] Basic Broadcaster Doesn't Advertise
BLE_LOKI-448 Pairing issue when working as peripheral device on CC23xx with Central device on CC26X2R1 device

Upgrade and Compatibility Information

The BLE5-Stack 3.02.01.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

Dependencies

The BLE5-Stack sample applications were built & tested with the IDEs and listed below:

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.

Validation

The BLE5-Stack sample applications were built & tested with the IDE’s and toolchains mentioned in the SDK release notes.

Versioning

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

Technical Support and Product Updates