TI BLE5-Stack 3.02.01.00 Release Notes
Table of Contents
- Introduction
- BLE5-Stack Documentation
- Installation and Usage
- What’s New
- Fixed Issues
- Known Issues and Limitations
- Upgrade and Compatibility Information
- Qualification
- Operating System Support
- Dependencies
- Device Support
- Development Board Support
- Validation
- Versioning
- Technical Support and Product Updates
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
- 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_10_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_10_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-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 |
- The SDK has been renamed from the SimpleLink™ CC23XX SDK to the SimpleLink™ Low Power F3 SDK. The documentation for this SDK still contains references to legacy name of the SDK.
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
- 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.16.1
- UniFlash: 8.2.0
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:
- 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.