TI BLE5-Stack 3.03.04.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 and CC27xx families of wireless MCUs.

Key features overview of BLE5-Stack 3.03.04.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
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 (cc23xx) Description
basic_ble Example project where the device can be configured to operate as a Bluetooth LE peripheral, central, or both.
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 Permanently resident application that implements OAD profile.
ble_controller Example project that implements the Bluetooth LE controller layer.
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.
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_dual_image Same as basic_ble 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.
ble_controller Example project that implements the Bluetooth LE controller layer.
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 licence 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

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-2553 [CC27XX] Add OAD (Onchip and Dual-image) support for CC27xx device and use ROM Secure Boot as the bootloader
BLE_LOKI-2550 [QUAL] CC27XX Qualification
BLE_LOKI-2478 [Connection Handover] Support Handover including L2CAP layer
BLE_LOKI-2450 Controller-Only example release
BLE_LOKI-2401 Support 50 bonds as Multirole with limitation on Initiator/Central/Scanner

Fixed Issues

ID Summary
BLE_LOKI-2511 [Multi Connect][Stability] CC2340R53 Coded PHY Links Terminate when Hold More Than 8 Multiple Connections and Switching Connection PHY Between Coded to 1M/2M PHY`s
BLE_LOKI-2500 Scan Response not received from a bonded device after advertising burst
BLE_LOKI-2484 Setting data length to 0 in GapAdv_loadByHandle causes SW to enter hard fault
BLE_LOKI-2472 [Documentation] Incorrect doxygen for HCI_EXT_SetMaxDtmTxPowerDbmCmd and HCI_EXT_SetTxPowerDbmCmd
BLE_LOKI-2459 [Documentation] HCI_LE_EnhancedTxTestCmd and HCI_LE_TransmitterTestCmd incorrectly state that dataLen is between 0 and 37
BLE_LOKI-2417 Advertising Disabled Unexpectedly when using GAP_ADV_ENABLE_OPTIONS_USE_DURATION
BLE_LOKI-2352 Infrequently, peripheral does not send out peripheral security request and gapbondmgr_pair returns 0x1C
BLE_LOKI-2080 Doxygen for HCIEXT_EnhancedModemTestTxCmd() modified to specify a way to modify the TxPower used
BLE_LOKI-1990 GAP_CB_PHY_UPDATE event is not returned for event: GAP_CB_CONN_ESTABLISHED
BLE_LOKI-1674 Connection Monitor failed to start monitoring after about 6 hours
BLE_LOKI-1661 [SWAT][Dual ADV] Peripheral fails to enable legacy adv set 2 after create connection to adv set 1 if they are using different address types.

Known Issues and Limitations

ID Summary
BLE_LOKI-2650 [Multi Connect][Stability] CC2745R10Q1 Central Role Fails to Switch Connection PHY Between Coded to 2M PHY While Holding 16 Connections
BLE_LOKI-2648 [Peripheral][CC23XX] Connection may be unstable with Coded PHY when Access Address has high cross-correlation with the preamble
BLE_LOKI-2373 [PADV][Configuration] CC2340 MAX periodic adv list size is hard coded and can't be configure by SYSconfig
BLE_LOKI-2358 [Stability] cc2340r5 Basic MR printed peripheral initial RPA after bond and pair, instead of its Public Address
BLE_LOKI-2108 [IOP] IOS device doesn't find peer running extended ADV with secondary PHY of 1M
BLE_LOKI-1630 [SCAN_PARAM_FLT_DUP] Extended Advertisement Reports Are Not Filtered When SCAN_PARAM_FLT_DUP is Enabled

Upgrade and Compatibility Information

The BLE5-Stack 3.03.04.00 supports the following devices:

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):

Qualification

The applicable Design Number for this release is Design Number Q301991 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:

Product Security Vulnerabilities

Technical Support and Product Updates