SimpleLink CC2640R2 SDK BLE Example Pack User's Guide

Table of Contents

Change Log

v1.30.00.27 - 3/7/2017

Introduction

The SimpleLink CC2640R2 SDK BLE Example Pack is a companion software package that provides additonal sample applications to be used with the BLE-stack component of the CC2640R2 SDK. This version of the example pack requires prior installation of simplelink_cc2640r2_1_30_00_25. Without this version of the SDK installed, the projects provided in this example pack will not build and run correctly. With the CC2640R2 SDK installed, these projects can be used just like the ones provided with the CC2640R2 SDK. More information on running these projects can be found in the Bluetooth low energy 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 BLE-Stack 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 a toolchain version or TI-RTOS version not 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

Sample Application Target Board Description
glucose_sensor CC2640R2_LAUCHXL 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.
heart_rate CC2640R2_LAUCHXL 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.
hid_emu_kbd CC2640R2_LAUCHXL 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.
hid_adv_remote CC2640R2_RC 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.

Using the IDE

Both Code Composer Studio and IAR Embedded Workbench can be used to run the sample applications in this example pack. They use the CC2640R2 SDK, so that must be installed. This section will show how these sample apps are pulling in the 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 CC2640R2 SDK, go to Project->Properites->Build. Under the Variables tab, select “Show system variables”:

Many variables will show up. The ones of interest are:

These use relative paths and thus do not need to be updated if the CC2640R2 SDK directory location differs from the default.

Please see the Developing with CCS section of the Bluetooth low energy Software Developer’s Guide for details on importing, building, and running the projects. This section also discusses how to install CCS.

IAR Embedded Workbench

Once the example pack is installed, IAR Embedded Workbench (IAR) should immediately be ready to use with the sample applications in the example pack. 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 Developing with IAR section of the Bluetooth low energy Software Developer’s Guide for details on importing, building, and running the 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.