SimpleLink CC2640R2 SDK BLE Example Pack User's Guide

Table of Contents

Change Log

v1.35.00.37

v1.30.00.27

Introduction

The SimpleLink™ CC2640R2 SDK BLE Example Pack is a companion software package that provides additional sample applications to be used with the BLE5-Stack and BLE5-Stack components of the Simplelink CC2640R2 SDK. The BLE5-Stack component is for the development of Bluetooth® 5 examples whereas the BLE-Stack component is for development on Bluetooth® 4.2. This version of the example pack requires prior installation of simplelink_cc2640r2_1_35_00_33. Without this version of the SDK installed, the projects provided in this example pack will not build and run correctly. With the Simplelink CC2640R2 Example Pack installed, these projects can be used just like the ones provided with the Simplelink CC2640R2 SDK. More information on the provided Bluetooth 5 projects in the SDK can be found in the BLE5-Stack User’s Guide. More information on the provided Bluetooth 4.2 projects in the SDK can be found in the BLE-Stack Software Developer’s Guide.

This example pack contains project files for IAR Embedded Workbench and Code Composer Studio, application level source code, and documentation for each sample application.

The Example Pack sample applications were built & tested with the following Integrated Development Environments (IDEs) and listed components on Windows 7 SP1 and Windows 10 host build platforms. Using component versions other what are listed below may result in compatibility issues with this SDK release.

The following table provides a list of the sample applications provided in this example pack, along with descriptions and links to the detailed documentation on each sample application.

Sample Applications

Glucose Sensor

This sample application implements the Glucose Profile in a Bluetooth low energy peripheral device to provide an example glucose sensor using simulated measurement data. The application implements the Sensor role of the Glucose Profile.

Target Board: CC2640R2_LAUCHXL

Heart Rate

This sample application implements the Heart Rate and Battery profiles in a Bluetooth low energy peripheral device to provide an example heart rate sensor using simulated measurement data. The application implements the Sensor role of the Heart Rate profile and the Battery Reporter role of the Battery profile. The project is based on adopted profile and service specifications for Health Rate. The project also includes the Device Information Service.

Target Board: CC2640R2_LAUCHXL

Human Interface Device (HID) Keyboard Emulation

This sample application implements the HID-Over-GATT profile in a Bluetooth low energy peripheral device to provide an example of how a HID keyboard can be emulated with a simple four button remote control device. The project is based on adopted profile and service specifications for HID-Over-GATT and Scan Parameters. The project also includes the Device Information Service and Battery Service.

Target Board: CC2640R2_LAUCHXL

Human Interface Device (HID) Advance Remote

This sample application runs on the CC2650 Remote Control, with the CC2650 device swapped out for a CC2640R2F device. The application demonstrates the Remote Control’s voice capability using a BLE connection.

Target Board: CC2640R2RC

Using the IDE

Both Code Composer Studio and IAR Embedded Workbench can be used to run the sample applications in this example pack. This section will show how these sample apps are pulling in the Simplelink CC2640R2 SDK.

Code Composer Studio

The SimpleLink CC2640R2 SDK BLE Example Pack is designed to integrate seamlessly with the Code Composer Studio Integrated Development Environment (CCS) from Texas Instruments. After installing the example pack (it is recommended to use the default installation directory), CCS should automatically detect and install the example pack software package without any special interaction from the user. To check to see if the example pack has installed correctly, go to the Windows->Preferences menu item. Under the Code Composer Studio->Products item you should see “SimpleLink CC2640R2 SDK BLE Example Pack” installed (with a version number). If you have CCS open when the example pack is installed, you will need to restart CCS to have the new product installed.

To see the variables that are being pulled in from the SimpleLink CC2640R2 SDK, go to Project->Properites->Build. Under the Variables tab, select “Show system variables”:

Many variables will show up. The one of interest is SIMPLELINK_CORE_SDK_INSTALL_DIR and should contain a valid path to the SimpleLink CC2640R2 SDK.

Please see the respective Developing in CCS section for details on importing, building, and running BLE projects. This section also discusses how to install CCS.

IAR Embedded Workbench

Once the SimpleLink CC2640R2 SDK BLE Example Pack is installed, IAR Embedded Workbench (IAR) should immediately be ready to use. To see the variables that are being pulled in from the CC2640R2 SDK, go to Tools->Configure Custom Argument Variables:

If the CC2640R2 SDK is moved to somewhere other than the default install directory, these variables will have to be changed to work with the new path.

Please see the respective Developing in IAR section for details on opening, building, and running BLE projects. This section also discusses how to install IAR.

Using Bluetooth Developer Studio (BDS)

Create additional sample applications with support for automatic code generation of any adopted or custom Bluetooth GATT profile with TI’s plugin for Bluetooth Developer Studio (BDS). Developers can use this tool, developed by the Bluetooth Special Interest Group (SIG), with TI’s SimpleLink example pack to reduce development time by automatically generating compatible code for proprietary and adopted profiles running on the CC2640R2F. See SimpleLink Academy for instructions on integrating a BDS profile with a sample project.