TI BLE-Stack 3.01.00.45 Release Notes
Table of Contents
Introduction
The BLE-Stack 3.01.00.45 is a set of sample applications, tools and protocol stack libraries that enable engineers to develop embedded Bluetooth® 4.2 LE single-mode standalone or network processor applications on the SimpleLink™ CC2640R2F Bluetooth low energy (BLE) wireless MCU.
BLE-Stack 3.01.00.45 is an update to BLE-Stack 3.0.1
Key features of BLE-Stack 3.01.00.45 :
- Fully qualified, royalty-free Bluetooth 4.2 protocol stack with support for all single-mode BLE roles: Peripheral, Central, Broadcaster and Observer
- Support for all Bluetooth 4.2 LE features including Secure Connections, Data Length Extension and Privacy 1.2
- Integrated BLE Host and Controller supporting System-on-chip (SoC) standalone or network processor dual-device configurations
- Full integration with TI-RTOS for real-time scheduling, automatic power management and utilizing peripheral device drivers
- Multi-role support for up to eight simultaneous connections in any supported role configuration
- Flexible Over-the-Air Download (OAD) device firmware upgrade options using on-chip or off-chip memory
- Support for developing applications on all QFN and WCSP CC2640R2F device package options
- Includes BT SIG adopted profiles for HID over GATT (HOGP), Glucose and Heart Rate as well as custom TI Audio and firmware update (OAD) profiles
- Support for automatic code generation of any adopted or custom Bluetooth GATT profile with TI’s plugin for Bluetooth Developer Studio (BDS)
- Ability to support additional sample applications using the CC2640R2 BLE Sample Applications Plugin
- Microstack configuration for broadcast-only and LE connection monitoring applications
- Free code generation option with Code Composer Studio™ (CCS) v7.2
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
- Enhancements to OAD to allow for faster firmware downloads and the option to update the BLE protocol stack image in on-chip OAD configurations
- LE Connection Monitor configuration in microstack to track specified BLE connections
- Secure Firmware option to enable authorized firmware execution (Note: Does not support OAD)
- Application support for using ECC Sign / Verify ROM APIs and SHA-2 flash library
- Added enhanced heap memory configurations allowing for optimized RAM usage with a shared RTOS and protocol stack heap
- Refer to the included SW User’s Guide for details on using these features with the BLE-Stack
Installation and Usage
- To build the sample applications with this SDK a supported IDE and toolchain must be installed (refer to Dependencies below)
- Install the simplelink_cc2640r2_sdk_1_40_00_45.exe package on a Windows® 7 SP1 or later machine with Administrator privileges
- The default install path is C:\ti\simplelink_cc2640r2_sdk_1_40_00_45 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
Fixed Issues
- Crash when re-pairing with a peer device that lost or removed its bonding keys
- HCI_EXT_GAP_LINK_PARAM_UPDATE_REQ_EVENT description missing from Vendor Specific HCI Guide to handle remote Link Parameter Update Request
- Split placement operator usage in linker command files to prevents using C++ code in project
- SimpleNP fails to perform GATT_ReadUsingCharUUID on certain UUID values
- Enabling SharpDisplay causes linker errors in CCS
Upgrade and Compatibility Information
The BLE-Stack 3.01.00.45 maintains BLE API compatibility with BLE-Stack 3.0.1. Changes to SDK directory structure and TI-RTOS drivers may require updates to existing applications developed with previous BLE-Stack component releases.
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 additional details.
Operating System Support
The BLE-Stack sample applications in the CC2640R2 SDK are supported on the Microsoft Windows® 7 SP1 or later build platform.
Dependencies
The BLE-Stack sample applications were built & tested with the following Integrated Development Environments (IDEs) and tools on Windows 7 SP1 and Windows 10 build platforms. All Bluetooth low energy applications must be developed using the components, such as the CoreSDK, within this SDK or with approved plugins. Using an IDE or toolchain version not listed below may result in compatibility issues with this SDK release.
- IAR Embedded Workbench: EWARM-8.11.1
- TI Code Composer Studio: CCS-7.02.00.00013
- C Compiler for ARM: 16.09.03.LTS
- XDCTools: 3.50.02.20
Note: Earlier IDE/toolchain versions are not supported and compatibility with newer versions of supported IDEs is not assured.
Device Support
This release supports single-mode Bluetooth 4.2 LE on the following SimpleLink wireless MCU: CC2640R2F
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
Known Issues and Limitations
- Number of simultaneous connections may be limited when attempting concurrent LE Secure Connections pairings. Suggested workaround is to perform LE Secure Connections pairing on an individual connection basis.
- L2CAP Connection Oriented Channels are not available in multi-role configurations
- BTool: Responses to connection parameter updates must manually sent within 30 seconds using HCI_LERemoteConnectionParameterRequestReply under the Adv.Commands -> HCI menu
- Link Layer Connection Parameters Request Procedure is disabled on most peripheral applications to improve connection parameter request compatibility with smart phone devices. L2CAP LE Signaling will be used instead. Define USE_LL_CONN_PARAM_UPDATE in application project to override this behavior
- RTOS Object Viewer (ROV) in IAR is not available when using autosized heap configuration. See the TI BLE Wiki for workaround
- Projects imported from TI Resource Explorer into Desktop CCS installations will not build if the default build configuration is changed. Workaround is to manually import project using Project -> Import CCS Project wizard
- Post-release updates to Known Issues will be posted on the TI BLE Wiki
Validation
TI BLE-Stack 3.01.00.45 was tested using the following components:
- TI Code Generation Tools for ARM: 16.09.03.LTS
- XDCTools: 3.50.02.20
- CC2640R2 LaunchPad
Refer to the TI BLE Wiki How to certify your product page for details regarding Bluetooth certification and how to reduce Bluetooth certification time by using TI’s Qualified Design ID (QDID).
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.