Texas Instruments SimpleLink™ Bluetooth® low energy protocol stack

BLE-Stack 2.2.2

Release Notes

Mar 28, 2018

Introduction

This is version 2.2.2 of the TI Bluetooth® low energy protocol stack (BLE-Stack) Software Development Kit (SDK). The BLE-Stack SDK allows for the development of single-mode Bluetooth low energy (BLE) applications on TI’s first generation SimpleLink Bluetooth low energy CC2640 and Multi-Standard CC2650 wireless microcontroller units (MCUs) supporting version 4.2 of the Bluetooth specification. The CC26x0 family of wireless MCUs includes a 32-bit Arm® Cortex™-M3 as the main application CPU running at 48 MHz, a dedicated Cortex-M0 processor for the radio / Physical Layer (PHY), and an autonomous Sensor Controller Engine for low-power sensing applications. The BLE protocol stack is built on top of the TI Real-time Operating System (TI-RTOS) which provides advanced power management and flexible peripheral driver capabilities allowing the development of highly optimized & power efficient standalone or network processor applications. The TI-RTOS SDK is installed during the BLE-Stack SDK installation.

Version 2.2.2 of the BLE-Stack is a maintenance update to TI’s existing royalty-free Bluetooth low energy software protocol stack which includes support for all core specification version 4.2 Low Energy (LE) features as well as several development kits. This protocol stack update is in addition to support of all major Bluetooth LE core specification version 4.1 features, including support for up to 8 master or slave BLE connections. A few examples of what can be created using the sample applications in this SDK and/or the additional resources found in the Examples section below include Bluetooth beacons incorporating the popular Apple iBeacon® and Eddystone™ formats, glucose, heart rate and fitness monitors, dongles for cable replacement via a BLE Serial Port Bridge and industrial motor monitors.

See What's New below for an overview of new features in this release. The Bluetooth core specification version 4.2 features supported in this release allow development of the most secure and power efficient products incorporating the Bluetooth low energy specification.

This document is divided into the following sections:

Documentation & Layout

The BLE-Stack SDK contains the following components:

SDK Path

Description

blelib

BLE protocol stack code provided in library form (i.e. Host, Controller, etc.)

sap_3_01_00_01

Simple Application Processor (SAP) libraries & documentation for interfacing to the Simple Network Processor (SNP)

docs

Included documentation (see below)

examples\<kit>

Sample applications, organized by evaluation kit (see supported kits below)

examples\hex

Prebuilt hex firmware files for selected sample applications

examples\util

Boot Image Manager (BIM) sample applications for OAD

src

Source code used by sample application & stack projects

tools

Tools used for build and debug (libsearch, frontier, BTool)

 

The following documents are included in the ‘docs’ folder. Document links assume the SDK is installed locally at the default install path.

 

Document

Description

SWRU393_CC26x0_BLE_Software_Developer's_Guide.pdf

BLE Software Developer’s Guide for developing applications with this SDK. Newer version may be online by referencing the literature ID: SWRU393

CC26x0 Simple Network Processer API Guide.pdf

API Guide for interfacing to the Simple Network Processor (SNP). Located in the sap_3_00_01_07\docs folder.

CC2640 BLE OAD User's Guide.pdf

Reference guide for implementing firmware upgrade using the TI Over the Air Download (OAD) profile on supported applications

TI_BLE_Vendor_Specific_HCI_Guide.pdf

Network Processor Vendor Specific API reference guide for the HostTest project

TI-RTOS 2.21.01.08 Docs Overview

TI-RTOS Kernel & Driver documentation overview page (local installation)

What’s New

2.2.2

Fixed Issues

Revision History

This is a summary of previous BLE-Stack v2.x releases. To see the full release notes, refer to the Archived Releases section of the BLE-Stack download page: www.ti.com/ble-stack

2.2.1

2.2.0

2.1.1

2.1.0

2.0.0

Installation and Usage

The full procedure for building applications with this SDK is described in Section 2.6 Setting up the Development Environment of the included SWRU393_CC2640_BLE_Software_Developer’s_Guide. A supported IDE is required. Refer to the Dependencies section below for a list of supported IDEs.

Download and run the BLE-Stack V2.2.2 SDK installer on a Windows® 7, 8.1 or 10 host build platform machine: ble_sdk_2_02_02_xx_setup.exe, where ‘xx’ is the build revision number.  By default, the BLE-Stack SDK will be installed to:

 c:\ti\simplelink\ble_sdk_2_02_02_xx and referred to as $BLE_INSTALL$ in the documentation.

Changing the default installation path or drive may require a manual update to environment variables used by sample application projects; refer to the SWRU393_CC2640_BLE_Software_Developer’s_Guide for more details. TI recommends making a backup of the SDK installation prior to development. The above installer includes the TI-RTOS SDK installer which will be automatically launched during the installation process. The included TI-RTOS installation is required for developing applications with the BLE-Stack SDK.

Please see the available sample applications located in \examples\<kit> as a starting point for using the BLE-Stack SDK to develop a BLE application. The SWRU393_CC2640_BLE_Software_Developer’s_Guide uses the Simple BLE Peripheral (simple_peripheral) sample application found in \examples\cc2650lp\simple_peripheral as a guide. Additional software examples and getting started material are provided in the “Examples” section below.

TI-RTOS version 2.21.01.08 default installation path: C:\ti\tirtos_cc13xx_cc26xx_2_21_01_08

XDC Tools 3.32.00.06 default installation path: C:\ti\xdctools_3_32_00_06_core

Upgrade Information

The BLE-Stack 2.2.x SDK uses a new directory and file format from previous BLE-Stack 2.1.x and earlier SDK releases. Existing applications developed with earlier SDKs require porting to this release. Refer to the SWRU393_CC2640_BLE_Software_Developer’s_Guide and online porting guide on the TI BLE Wiki: www.ti.com/ble-wiki.

Dependencies                                                                          

The SDK was built & tested with the following Integrated Development Environments (IDEs) and components on a Windows 7 host platform. Using another IDE version or TI-RTOS installation not listed below may result in compatibility issues with this SDK release.

TI-RTOS version 2.20.01.08

The following IDEs are supported by this SDK:

IDE

Version

Tool Chain

Notes

Code Composer Studio (CCS)

7.4.0 (Build 15 or later)

TI ARM Compiler 16.9.4.LTS

Other compiler versions may not compatible with this SDK. Refer to Section 2.6.3 Code Composer Studio in the SWRU393_CC2640_BLE_Software_Developer’s_Guide for the procedure to install TI ARM Compilers versions not included with CCS.

IAR Embedded Workbench for ARM

7.80.4

Included

A time limited evaluation version may be available. Please note the fully functional (non size-limited) version of IAR is required.

 

BTool is accessed at \tools\btool and can be launched from the SDK Start Menu (Start -> Texas Instruments -> SDK). The cc2650lp_host_test_rel.hex prebuilt firmware can be flashed to the CC2650 LaunchPad for use with the BTool PC application via the LaunchPad’s USB connection.

Device Support

This release supports Bluetooth low energy on the following SimpleLink CC26x0 wireless MCUs: CC2640 and CC2650 in all package configurations. The multi-standard CC2650 wireless MCU supports Bluetooth LE as well as other wireless protocols, such as ZigBee®, RF4CE and 6LoWPAN. The CC2640 supports Bluetooth LE only and is suitable for designs that only require Bluetooth LE connectivity. All code generated from the BLE-Stack v2.x SDK is binary compatible and exchangeable with both the CC2650 and CC2640 wireless MCUs in the same device package configuration. All TI CC26x0 development kits feature the CC2650 which can be used for development & prototyping of CC2640 based designs. No changes to the IDE project’s device CPU settings are required when using this SDK to generate code for the CC2640 or CC2650 wireless MCUs.

 

The following development kits are supported by this SDK release:

Kit Name

SDK Name

Description

CC2650 LaunchPad

cc2650lp

Full BLE evaluation, development & prototyping kit with integrated XDS110 debugger. Support for optional BoosterPack™ accessories, such as an LCD. Getting started demo with Project Zero. Can be used as a standalone debugger for custom board development.

CC2650 Module BoosterPack

cc2650bp

CC2650 Module BoosterPack plug-in module for evaluating the CC2650MODA BLE module in standalone or network processor applications. Compatible with the MSP432™ LaunchPad. Get started with network processor development using SimpleLink Academy.

CC2650 SensorTag

cc2650stk

IoT demonstration platform with multiple MEMS sensors. Some sample applications require the Debugger DevPack for programming. SensorTags produced after June 2017 do not include the TMP007 IR temperature sensor.

CC2650 Remote Control

cc2650rc

Voice remote control featuring a digital mic, IR emitter, MEMS motion sensor and more. Additional information can be found on TI’s Remote Control page.

SmartRF06 Development Kit

cc2650em

Development kit with integrated XDS100v3 debugger and support for pluggable CC2650EM evaluation modules. Includes LCD & buttons. Default module used for SDK sample applications is the CC2650EM_7ID (7x7 package).

 

Development kits not listed above are considered experimental.

 

Validation Information

This release is a production version. 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).

Upgrade and Compatibility Information

·         No support for pre-production silicon, minimum supported silicon revision:

o   CC26x0: PG2.2

·         Use of the 32 kHz crystal-less feature requires CC26x0 silicon revision D (PG2.3) or later. Refer to Application Note SWRA499 - Running Bluetooth low energy on CC2640 Without 32 kHz Crystal

·         SmartRF Flash Programmer 2 v1.7.5 or later is required

Examples                                                                                      

·         Sample applications are included in this SDK. Additional software examples, application notes, reference designs & guides may be found on the TI BLE Wiki and the SimpleLink GitHub page.

·         Use SimpleLink Academy workshops with Project Zero to quickly get started with BLE development, including creating your custom profile with TI’s plugin for Bluetooth Developer Studio

·         Sensor Controller Studio can be used to develop applications for the embedded Sensor Controller Engine.

·         TI Designs™ Reference library with complete Bluetooth low energy system designs, such as the UART to BLE Bridge.

Known Issues     

·         Use of other TI Compiler versions in CCS may not be compatible with this SDK. Refer to Section 2.6.3 “Code Composer Studio” in the SWRU393_CC2640_BLE_Software_Developer’s_Guide for the procedure to install TI ARM Compiler versions not included with CCS. Refer to the  Updating CCS wiki guide for additional details.

·         Use of a whitespace in a CCS workspace path will cause build failures

·         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.

·         Use of Privacy 1.2 features with legacy BT4.1 peer devices may cause connection stability issues


Versioning

This is SDK version 2.2.2. The included .revision file contains revision tracking identifiers.

Technical Support and Product Updates

Additional Resources

For more information, visit www.ti.com. Web links may not be valid after release.

LaunchPad, BoosterPack, TI Designs, SimpleLink, Code Composer Studio, SmartRF, BLE-Stack are trademarks of Texas Instruments.

ARM, Cortex are registered trademarks of ARM Limited.

CCS Cloud is a trademark of Apalia LLC.

iBeacon is a trademark of Apple Inc.

Bluetooth is a registered trademark of Bluetooth SIG.

Eddystone is a trademark of Google Inc.

Windows 7 is a registered trademark of Microsoft Inc.

Copyright 2010 – 2018 Texas Instruments, Inc.