TI BLE-Stack 3.03.04.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 CC2640R2 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.04.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)
- 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-5375 | All examples support CC2640R2L |
| BLESTACK-5348 | Provide the ability to choose what channel to scan on |
Fixed Issues
| ID | Summary |
|---|---|
| BLESTACK-5222 | Host test with broadcaster configuration is unresponsive |
| BLESTACK-4909 | No L2CAP connection parameter update request sent when peer device does not support LL |
| BLESTACK-4849 | simple_peripheral.c: Incorrect placement of GAPRole_StartDevice in SimplePeripheral_init |
Known Issues and Limitations
| ID | Summary |
|---|---|
| BLESTACK-5152 | Multi Role with Cache as RAM app fails to pair to 8 devices |
| BLESTACK-5149 | [RTLS Passive] AoA angle calculation is deviated for boundary angles |
| BLESTACK-5009 | Peer's RPA is not re-generated on address resolution timeout when local IRK is all zeros |
| 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_4_20_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_4_20_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
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.
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 the SimpleLink™ CC13x2 and CC26x2 software development kit 3.40 or later. For further information please contact your local TI sales representative.
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
- Microsoft Windows® 7 SP1, Windows 8.1 or Windows 10
- Ubuntu 14.04 64-bit, Ubuntu 16.04 64-bit
- macOS Mojave
Device Support
This release supports single-mode Bluetooth LE on the wireless MCUs listed in the top-level SDK release notes
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.