BLE-Stack 2.2 - wiki.tiprocessors.com

1 Texas Instruments SimpleLink Bluetooth low energy protocol stack BLE-Stack Release Notes June 16, 2016 Introduction This is version 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 SimpleLink Bluetooth low energy CC2640, multi-standard CC2650 and dual-band CC1350 wireless microcontrollers (MCUs) supporting version of the Bluetooth specification. The CC13xx and CC26xx 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. 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.

2 The TI-RTOS SDK is installed during the BLE-Stack SDK installation. Version of the BLE-Stack is a major update to TI s existing royalty-free Bluetooth low energy software protocol stack which adds support for all core specification version Low Energy (LE) features as well as new development kits. This protocol stack enhancement is in addition to support of all Bluetooth LE core specification version 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 features supported in this release allow development of the most secure and power efficient products incorporating the Bluetooth low energy specification.

3 This document is divided into the following sections: Documentation & Layout What's New Installation and Usage Dependencies Device Support Validation Information Examples Known Issues Versioning Technical Support and Product Updates Documentation & Layout The BLE-Stack SDK contains the following components: SDK Path Description blelib BLE protocol stack code provided in library form ( Host, Controller, etc.) sap_3_00_01_07 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.

4 Document links assume the SDK is installed locally at the default install path. Document Description SWRU393_CC2640_BLE_Software_Developer' BLE Software Developer s Guide for developing applications with this SDK. Newer version may be online by referencing the literature ID: SWRU393 CC2640 Simple Network Processer API 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 Reference guide for implementing firmware upgrade using the TI Over the Air Download (OAD) profile on supported applications Network Processor Vendor Specific API reference guide for the HostTest project TI-RTOS Docs Overview TI-RTOS Kernel & Driver documentation overview page (local installation) License Manifest What s New Support Bluetooth core specification features: LE Secure Connections, LE Data Length Extension and LE Privacy New Bluetooth Qualified Design ID (QDID) for the Bluetooth protocol stack , see the TI BLE Wiki: Ability operate without a 32 kHz crystal for BLE peripheral & broadcast applications on supported silicon Added support for new development kits.

5 CC2650 LaunchPad , CC2650 Remote Control kit and CC1350 Sub-1 GHz and BLE dual-band LaunchPad Support TI s BLE voice over GATT profile on CC2650 SensorTag and Remote Control development kits Simple Network Processor supports LE Secure Connections New SDK directory structure to permit easier revision control integration Streamlined application & stack project build procedure Added ability to support concurrent pairing & bonding with multiple simultaneous connections Fixed an issue in which a malformed connection request may lead to a CPU abort Fixed a BLE central issue in which the connection would drop during pairing while concurrently performing a scan Fixed an issue in simple_broadcaster in which the advertisement data was not updated properly Improved scanning, advertising and connection control when supporting multiple master & slave connections Uses latest TI-RTOS release for CC26xx & CC13xx wireless MCUs BTool version Revision History This is a summary of previous BLE-Stack releases.

6 To see the full release notes, refer to the Archived Releases section of the BLE-Stack download page: Maintenance release TI-RTOS Support Simple Network Processer Over the Air Download (OAD) support for external flash memory Bug fix & performance improvements Additional flash memory configuration options TI-RTOS Initial release featuring full support of Bluetooth LE core features and support for up to 8 master or slave connections Support CC2650 SensorTag and SmartRF06 Development Kit TI-RTOS Installation and Usage The full procedure for building applications with this SDK is described in Section 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 SDK installer on a Windows 7 or later host platform machine: , where xx is the build revision number.

7 By default, the BLE-Stack SDK will be installed to: c:\ti\simplelink\ble_sdk_2_02_00_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.

8 Additional software examples and getting started material are provided in the Examples section below. TI-RTOS version default installation path: C:\ti\tirtos_cc13xx_cc26xx_2_18_00_03 XDC Tools default installation path: C:\ti\xdctools_3_32_00_06_core Upgrade Information The SDK uses a new directory and file format from previous BLE-Stack 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: 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 The following IDEs are supported by this SDK: IDE Version Tool Chain Notes Code Composer Studio (CCS) (or later) TI ARM Compiler A free CCS v6 license is provided when used with a TI CC26xx or CC13xx development kit that includes an XDS100v3 or XDS110 debugger.

9 The LTS Compiler is not compatible with this SDK. Refer to Section Code Composer Studio in the SWRU393_CC2640_BLE_Software_Developer s_Guide for the procedure to install TI ARM Compiler version IAR Embedded Workbench for ARM 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 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 wireless MCUs: CC2640, CC2650 and CC1350 in all package configurations. The multi-standard CC2650 wireless MCU supports Bluetooth LE as well as other wireless protocols, such as ZigBee , RF4CE and 6 LoWPAN. The CC2640 supports Bluetooth LE only and is recommended for designs that only require Bluetooth LE connectivity.

10 All code generated from the BLE-Stack SDK is binary compatible and exchangeable with both the CC2650 and CC2640 wireless MCUs. All TI CC26xx 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 CC1350 sample applications in this SDK are for BLE-only operation in the ISM frequency band and are not targeted for concurrent dual-band operation. 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. CC1350 LaunchPad cc1350lp CC1350 Sub-1 GHz and BLE dual-band solution evaluation, development & prototyping kit with integrated XDS110 debugger.