Table of Contents

• Navigating the Repository
• Change Log
• Installation
• Required Tools
• Examples List
• Tools
• References
• FAQ
• Versioning BLE-Stack Projects

Introduction

These examples and demos are for TI SimpleLink CC26x2 SDK 1.60.00.43

This repository contains Bluetooth® 5 sample applications for Texas Instruments' SimpleLink CC2640R2 SDK. These examples have not been validated as production-ready.

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 CC26x2 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 CC26x2 SDK 1.60.00.43(current)	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.42	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.

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.

1.60.01.02

Maintenace update

• IAR fixes to i2secho example

1.60.01.01

Maintenace update

• Add SPP over BLE Agama support!
• Bugfixes on i2secho example

1.60.00.00

Initial offering of SimpleLink CC26x2 SDK 1.60.00.43 examples.

• Bidirectional Audio Demo (Central/Peripheral): now on BLE5-Stack
• Created i2secho application that demonstrates audio sampling and playback with the CC3200AUDBOOST

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 CC26x2 SDK install location.

By default the SimpleLink CC26x2 SDK will install to:

C:\ti\simplelink_cc26x2_sdk_1_60_00_43

If the SimpleLink CC26x2 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 CC26x2 SDK, the examples in this repository support the CCS and IAR toolchains. Please pay careful attention to versions of these tools, the supported version are listed below. Using a non supported version is untested and may result in unexpected behavior.

• CCS v7.04.00 with TI ARM Compiler v16.09.06LTS
• IAR for ARM v8.11.4

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

Full Duplex Bidirectional Audio Demo

Encode and transmit a full duplex bidirectional audio stream over BLE using two CC26x2 LaunchPads with CC3200AUDBOOST.

• central_bidirectional_audio

  • Documentation
  • CCS Project Files
  • IAR Project Files
  • Source

• peripheral_bidirectional_audio

  • Documentation
  • CCS Project Files
  • IAR Project Files
  • Source

I2S Echo

Read audio frames in from an external codec and loop them back using I2S.

• i2secho
  • Documentation
  • CCS Project Files
  • IAR Project Files
  • GCC Project Files
  • Source

Serial Port Profile (SPP)

Note: These examples will be deprecated as of the 2.20 SDKs. It will be replaced with the Simple Serial Socket

This is a UART to BLE bridge example where a spp_ble_client and spp_ble_server connect with one another and exchange UART data over the air.

The example also supports Bluetooth 5 demonstrating the BLE-Stack's support for different PHYs:

• spp_ble_client
  • Documentation
  • IAR Project Files
  • CCS Project Files
  • Source
• spp_ble_server
  • Documentation
  • IAR Project Files
  • CCS Project Files
  • Source

References

The following reference pages may be helpful during general Bluetooth Low Energy development. New users of the SimpleLink CC26x2 platform and Bluetooth 5 development are encouraged to read the BLE5-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