TI BLE-Stack 3.03.01.00 Release Notes
Table of Contents
Introduction
SimpleLink™ CC2640R2 Software Development Kit (SDK) delivers components that enable engineers to develop applications on Texas Instruments SimpleLink Bluetooth® Low Energy CC2640R2F wireless MCU. This powerful software toolkit provides a cohesive and consistent software experience for all SimpleLink CC2640R2 users by packaging essential software components such as the Bluetooth 5.1 protocol stack (BLE-Stack), integrated real-time localization system (RTLS), TI-RTOS and peripheral drivers in one easy-to-use software package along with exhaustive documentation.
Key features of BLE-Stack 3.03.01.00 :
- Support for all Bluetooth 4.2 LE features including LE Secure Connections, Privacy 1.2 and Data Length Extension (DLE)
- Qualified under Bluetooth 5.1
- Integrated BLE Host and Controller supporting System-on-chip (SoC) standalone or network processor dual-device configurations
- Project Zero sample application demonstrates typical peripheral role operations such as controlling LEDs, identifying button states and sending strings of data from a smartphone to the LaunchPad™
- Standalone Peripheral, Broadcaster and Central sample applications to jump start development
- Full integration with TI-RTOS for real-time scheduling, automatic power management and utilizing peripheral device drivers
- Secure Over-the-Air Download (OAD) firmware upgrade support for updating device firmware wirelessly
- Free code development option with Code Composer Studio™ (CCS)
- Real Time Localization System integrated with Bluetooth Low Energy Stack
- Supports unlimited scan reporting to the application
As with all Bluetooth core specifications that support the Low Energy (LE) feature, devices implementing the LE specification of Bluetooth 5.1, are backward compatible with Bluetooth 4.2, 4.1 and 4.0 LE capable devices.
Additional information about TI’s Bluetooth Low Energy solutions can be found at www.ti.com/ble
BLE-Stack Documentation
The SimpleLink CC2640R2 SDK allows easier product development by combining the TI-RTOS and BLE protocol stack in one unified SDK. All BLE-Stack sample applications are based off the TI-RTOS Kernel. Key documents needed for BLE application development include:
What’s New
ID | Summary |
---|---|
BLESTACK-5067 | ToF security now uses TI AESCTRDRBG driver |
BLESTACK-5062 | [RTLS] Save ToF calibration to the NV |
BLESTACK-5061 | [RTLS] Added user configurable Link Quality Indication (LQI) and magnitude difference filter for ToF |
BLESTACK-5060 | [RTLS] Implemented Time of Flight role switching feature |
BLESTACK-5057 | Added RTLSCtrl API to dynamically alter connection parameters |
BLESTACK-5049 | Added feature to track ToF statistics when RTLS_TOF_DEBUG is set |
Fixed Issues
ID | Summary |
---|---|
BLESTACK-4958 | BIM reserves extra pages of flash when not using secure OAD |
BLESTACK-4842 | Fix issue with data alignment of RF buffers on connection monitor |
BLESTACK-4829 | [RTLS] rtls_passive won't re-sync when using TOF_MODE_AUTO run mode in Dynamic Sync-word mode |
BLESTACK-4793 | RTLS Passive sync issues: missing the first word will stop Passive ToF in Dynamic Sync-word mode |
BLESTACK-4550 | Fixed issue regarding PAGE_ALIGN section definition in OAD linker files |
BLESTACK-4357 | BLESTACK linker files have no .TI.noinit section, places in FLASH |
BLESTACK-3912 | Fixed issue where using autosized heap would break ROV for CCS. Changed IAR linker file to simplify workaround. |
Known Issues and Limitations
ID | Summary |
---|---|
BLETOOLS-14 | [BTool App] Discovered devices list is never cleared |
BLESTACK-5182 | [TOF] ToF Master/Slave may go out of sync when RSSI is below -60 |
BLESTACK-5181 | [RTLS] Angle performance is not stable when antenna array 2 is used |
BLESTACK-5152 | Multi Role with Cache as RAM app fails to pair to 8 devices |
BLESTACK-5149 | [RTLS Passive] AoA angle calculation is deviated in low angles (0-10 degrees) |
BLESTACK-5009 | Peer's RPA is not re-generated on address resolution timeout when local IRK is all zeros |
BLESTACK-4902 | [RTLS] TOF is not stable for connection interval greater than 1 second |
BLESTACK-4511 | CC2640R2 OAD target boots into user app after receiving reset command during unsecure on-chip OAD with a secure BLE connection |
BLESTACK-4505 | Enabling a specific off-chip image is not working for CC2640R2 |
BLESTACK-4459 | Revert to factory image not working for CC2640R2 off-chip OAD |
BLESTACK-4263 | BIM reserves extra pages of flash when not using secure OAD |
BLESTACK-4133 | Simple Observer: Cancel the discovery during discovery process received ERROR and need to reset the board |
BLESTACK-3934 | L2CAP recombination failing in some cases when data length update combines with L2CAP packet |
BLESTACK-3641 | L2CAP Connection Oriented Channels are not available in multi-role configurations |
BLESTACK-3640 | Number of simultaneous connections may be limited when attempting concurrent LE Secure Connections pairings |
BLESTACK-2706 | Multi-role incorrectly sets gapRole_AdvEnabled when enabling non-connectable advertisements. |
Installation and Usage
- To build the sample applications with this SDK a supported IDE must be installed (refer to Dependencies below)
- Install the simplelink_cc2640r2_sdk_3_30_00_xx.exe package on a Windows® 7 SP1, Windows 8.1 or Windows 10 machine with Administrator privileges
- The default install path is C:\ti\simplelink_cc2640r2_sdk_3_30_00_xx and is referenced as $BLE_INSTALL$ in the documentation
- 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
Upgrade and Compatibility Information
The CC2640R2 SDK uses a new directory & file format which differs from BLE-Stack 2.2.x and earlier SDK releases. Existing applications developed with earlier SDKs require porting to this release; however, most BLE APIs remain the same thus reducing the effort required to migrate to this release. Refer to the Migration Guide for details.
Qualification
The Bluetooth low energy software stack (BLE-Stack) for CC2640R2 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 135680 with expiration date 2022-07-08 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 BLE-Stack sample applications in the CC2640R2 SDK are supported on the Microsoft Windows® 7 SP1, Windows 8.1 or Windows 10 build platform.
Device Support
This release supports single-mode Bluetooth LE on the following SimpleLink wireless MCUs:
Note: This SDK does not support SimpleLink CC2640/CC2650/CC1350 devices or development kits with these devices.
Development Board Support
This release supports Bluetooth Low Energy applications on the following development kit: CC2640R2 LaunchPad
Validation
The BLE-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:
- Code Composer Studio using the TI C Compiler for Arm
- IAR Embedded Workbench for Arm
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.