ble_examples icon indicating copy to clipboard operation
ble_examples copied to clipboard

Additional examples to compliment TI's Bluetooth Low Energy Stack offerings.

Table of Contents

  • Navigating the Repository
  • Change Log
  • Installation
  • Required Tools
  • Examples List
  • Tools
  • References
  • FAQ
  • Suggested Work Flow

Introduction

These examples and demos are for TI SimpleLink CC2640R2 SDK 4.10.00.00

This repository contains Bluetooth® Low Energy sample applications for Texas Instruments' SimpleLink CC2640R2 SDK. These examples have not been validated as production-ready. Services and profiles in this repository have not been validated or certified.

Do not use GitHub's bug tracking feature for support. For inquiries, see the Bluetooth® low energy Forum.

To use the examples and tools in this repository, please download and install the SimpleLink CC2640R2 SDK first, and if necessary buy an evaluation kit.

If you have any questions please refer to the FAQ page.

For examples for other SDK versions and platforms, see table below.

SDK Examples
TI SimpleLink CC2640R2 SDK 4.10.00.00 (current)
  • Heart Rate Sensor
  • Glucose Sensor
  • Blood Pressure Monitor
TI SimpleLink CC13x2 / CC26x2 SDK 4.10.00.00
  • Simple Serial Socket
  • Bluetooth 5 Throughput Demo
TI SimpleLink CC2640R2 SDK 3.40.00.10
  • Simple Serial Socket
  • Bluetooth 5 Simple Serial Socket
  • Simple Peripheral Observer
  • Blood Pressure Monitor
TI SimpleLink CC2640R2 SDK 3.30.00.20
  • Simple Serial Socket
  • Bluetooth 5 Simple Serial Socket
TI SimpleLink CC13x2 / CC26x2 SDK 3.20.00.67
  • Simple Serial Socket
  • Bluetooth 5 Throughput Demo
  • Tree Structure Network
TI SimpleLink CC13x2 / CC26x2 SDK 2.40.00.81
  • Simple Serial Socket
TI SimpleLink CC26x2 SDK 2.30.00.34
  • Full Duplex Bidirectional Audio Demo (Central/Peripheral)
  • I2S Echo
  • Serial Port Profile
  • Bluetooth 5 Throughput Demo
  • Tree Structure Network
TI SimpleLink CC26x2 SDK 2.10.00.44
  • Full Duplex Bidirectional Audio Demo (Central/Peripheral)
  • I2S Echo
  • Serial Port Profile
TI SimpleLink CC26x2 SDK 1.60.00.43
  • Full Duplex Bidirectional Audio Demo (Central/Peripheral)
  • I2S Echo
  • Serial Port Profile
TI SimpleLink CC2640R2 SDK 2.20.00.49
  • Simple Serial Socket
  • Micro BLE Stack Broadcaster Observer
  • Bidirectional Audio
  • Simple Peripheral Observer
  • Apple Notification Center Service
TI SimpleLink CC2640R2 SDK 1.50.00.58
  • Micro BLE Stack Broadcaster + Observer
  • Full Duplex Bidirectional Audio Demo
  • Serial Port Profile
  • Simple Peripheral Observer BLE
  • Apple Notification Center Service
TI SimpleLink CC2640R2 SDK 1.40.00.45
  • Full Duplex Bidirectional Audio Demo
  • Bluetooth 5 Throughput Demo
  • Bluetooth 5 Long Range Demo
  • Serial Port Profile
  • Simple Peripheral Observer BLE
  • Apple Notification Center Service
TI SimpleLink CC2640R2 SDK 1.35.00.33
  • Bluetooth 5 Throughput Demo
  • Bluetooth 5 Long Range Demo
  • Serial Port Profile
TI BLE-Stack SDK v2.2.x
  • beacon_rfdriver
  • hid_adv_remote_privacy
  • hid_emu_kbd
  • multi_role
  • security_examples
  • simple_beacon
  • simple_central_lp
  • simple_central_audio_receiver
  • simple_peripheral_audio_transmitter
  • simple_eddystone
  • simple_peripheral_observer
  • simple_proprietary_beacon
  • spp_over_ble
  • throughput_example
  • serial_bootloader
  • central_to_multiperipheral
TI BLE-Stack SDK v2.1.x
  • SimpleAP
  • SimpleNP
  • MultiRole
  • SimpleBLEPeripheral: LCD to UART
  • SimpleBLEPeripheral: porting to TI-RTOS 2.15
  • Apple Notification Center Service

Navigating the Repository

The examples provided on this GitHub page serve as a plugin to a corresponding BLE-Stack SDK release. The master branch will always point to the latest release.

Older releases can be accessed by checking out/downloading their corresponding branch. For more information on supported examples please consult the readme.md of the desired branch/release.

For for more information about different SDK components, please consult the BLE-stack User's Guide.

Change Log

Note: The version numbers below are related to GitHub ble_examples releases. The numbering scheme is in the form of M.mm.pp.bb. The fields pp.bb are incremented as GitHub examples are released, M.mm will map a GitHub release to a SimpleLink SDK release.

4.10.00.00

Initial offering of select SimpleLink CC2640R2 SDK 4.10.00.00 examples.

3.40.00.00

Initial offering of select SimpleLink CC2640R2 SDK 3.40.00.10 examples and one new example added:

  • Blood Pressure Monitor: This sample project implements the Blood Pressure profiles in a Bluetooth Low Energy peripheral device to provide an example blood pressure monitor (BPM) using simulated measurement data.

3.30.00.00

Initial offering of select SimpleLink CC2640R2 SDK 3.30.00.20 examples.

3.20.00.00

Initial offering of SimpleLink CC13x2 / CC26x2 SDK 3.20.00.67 examples supporting the rev. E of the SimpleLinkCC26x2 and CC13x2 MCUs.

2.40.00.00

Initial offering of SimpleLink CC13x2 / CC26x2 SDK 2.40.00.81 examples.

2.20.00.00

New examples added.

  • BLE-Stack: Simple Serial Socket Server/Client added

SPP over BLE is now deprecated and replaced by Simple Serial Socket

Installation

This repository can be cloned and tracked using Git. For instructions on how to clone a repository from Github please refer to this guide: Clone from Github

For users who are unfamiliar with Git, there is the option of downloading the contents of the repository as a zip file. See instructions below.

  1. Click the green "Clone or download" button
  2. Select "Download ZIP" option
  3. Zip folder will appear in your Downloads folder

This repository can be cloned/download anywhere on your computer. There is a dependency between this repository and the SimpleLink CC2640R2 SDK install location.

By default the SimpleLink CC2640R2 SDK will install to:

C:\ti\simplelink_cc2640r2_sdk_x_xx_xx_xx

If the SimpleLink CC2640R2 SDK must be installed to a different location, then see the FAQ page for IDE specific instructions for changing environment variables.

Required Tools

Similar to the SimpleLink CC2640R2 SDK, the examples in this repository support the CCS and IAR toolchains. Please refer to the release notes for the supported versions of each toolcahin. Using a non supported version is untested and may result in unexpected behavior.

For more information on toolchain setup, please refer to our FAQ page.

FAQ

The FAQ page will try to address some of the common questions related to the ble_examples repo.

Examples / Demo List

Glucose Sensor

This sample project implements the Glucose Sensor profiles in a Bluetooth low energy peripheral device to provide an example of a glucose level monitor using simulated measurement data. The application implements the Sensor role of the glucose sensor profile. The project is based on the adopted profile and service specifications for glucose sensor.

  • glucose_sensor
    • BLE 4.2
      • Documentation
      • CCS Project Files
      • Source
    • BLE 5.0
      • Documentation
      • CCS Project Files
      • Source

Heart Rate Sensor

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

  • heart_rate
    • BLE 4.2
      • Documentation
      • CCS Project Files
      • Source
    • BLE 5.0
      • Documentation
      • CCS Project Files
      • Source

Blood Pressure Monitor

This sample project implements the Blood Pressure profiles in a Bluetooth low energy peripheral device to provide an example blood pressure monitor (BPM) using simulated measurement data. The application implements the Sensor role of the blood pressure profile. The project is based on the adopted profile and service specifications for blood pressure.

  • blood_pressure
    • Documentation
    • CCS Project Files
    • Source

References

The following reference pages may be helpful during general Bluetooth Low Energy development. Users developing Bluetooth applications are encouraged to read the BLE-Stack User's Guide.

As an additional resource, users are encouraged to complete the SimpleLink Academy training.

Other resources can be found below:

  • BLE E2E Page