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

代码拉取完成,页面将自动刷新

richgiteeai

Watch

不关注关注所有动态仅关注版本发行动态关注但不提醒动态

1 Star 0 Fork 0

panguin/ble_examples

代码 Issues 0 Pull Requests 0 Wiki 统计流水线

服务

加入 Gitee

与超过 1400万开发者一起发现、参与优秀开源项目,私有仓库也完全免费 :)

免费加入

已有帐号? 立即登录

该仓库未声明开源许可证文件(LICENSE),使用请关注具体项目描述及其代码上游依赖。

项目仓库所选许可证以仓库主分支所使用许可证为准

克隆/下载

HTTPS SSH SVN SVN+SSH 下载ZIP

提示

下载代码请复制以下命令到终端执行

为确保你提交的代码身份被 Gitee 正确识别,请执行以下命令完成配置

git config --global user.name userName 
git config --global user.email userEmail

初次使用 SSH 协议进行代码克隆、推送等操作时,需按下述提示完成 SSH 配置

1 生成 RSA 密钥

2 获取 RSA 公钥内容,并配置到 SSH公钥中

在 Gitee 上使用 SVN,请访问使用指南

使用 HTTPS 协议时,命令行会出现如下账号密码验证步骤。基于安全考虑,Gitee 建议配置并使用私人令牌替代登录密码进行克隆、推送等操作

Username for 'https://gitee.com': userName

Password for 'https://userName@gitee.com': # 私人令牌

新建文件新建 Diagram 文件

新建子模块

上传文件

分支 14

标签 45

贡献代码

同步代码

创建 Pull Request

了解更多

对比差异通过 Pull Request 同步

同步更新到分支

通过 Pull Request 同步

将会在向当前分支创建一个 Pull
Request,合入后将完成同步

Marie Hernes Merge pull request #96 in SA/ble_examples ... d28eeff

304 次提交

docs

examples/rtos/CC2640R2_LAUNCHXL/bleapps

source/ti/blestack

.gitignore

README.md

ble_examples_X.X_manifest.html

README

## Table of Contents

* [Navigating the Repository](#navigating-the-repository)
* [Change Log](#change-log)
* [Installation](#installation)
* [Required Tools](#required-tools)
* [Examples List](#examples--demo-list)
* [Tools](#tools)
* [References](#references)
* [FAQ](docs/faq.md)
* [Versioning BLE-Stack Projects](docs/suggested_workflow.md)

# Introduction

These examples and demos are for **TI SimpleLink CC2640R2 SDK 3.30.00.20**

This repository contains *Bluetooth&reg;* Low Energy 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&reg; low energy Forum](https://e2e.ti.com/support/wireless_connectivity/bluetooth_low_energy/f/538).

To use the examples and tools in this repository, please download and install
the [SimpleLink CC2640R2 SDK](http://www.ti.com/ble-stack) **first**, and if
necessary [buy an evaluation kit](http://www.ti.com/tool/launchxl-cc2640r2).

If you have any questions please refer to the [FAQ page](docs/faq.md).

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

<table>
 <tbody>
 <tr>
 <th width = 50%>SDK</th>
 <th>Examples</th>
 </tr>
 <tr>
 <td>
	<a href = "https://github.com/ti-simplelink/ble_examples/tree/simplelink_cc2640r2_sdk-3.30">TI SimpleLink CC2640R2 SDK 3.30.00.20 (current)</a>
 </td>
 <td>
 <ul>
 <li><a href="#simple-serial-socket">Simple Serial Socket</a></li>
 </ul>
 </td>
 </tr>
 <tr>
 <td>
 <a href = "https://github.com/ti-simplelink/ble_examples/tree/simplelink_sdk-3.20">TI SimpleLink CC13x2 / CC26x2 SDK 3.20.00.67</a>
 </td>
 <td>
 <ul>
 <li>Simple Serial Socket</li>
 <li>Bluetooth 5 Throughput Demo</li>
 <li>Tree Structure Network</li>
 </ul>
 </td>
 </tr>
 <tr>
 <td>
 <a href = "https://github.com/ti-simplelink/ble_examples/tree/simplelink_sdk-2.40">TI SimpleLink CC13x2 / CC26x2 SDK 2.40.00.81</a>
 </td>
 <td>
 <ul>
 <li>Simple Serial Socket</li>
 </ul>
 </td>
 </tr>
 <tr>
 <td>
 <a href = "https://github.com/ti-simplelink/ble_examples/tree/simplelink_sdk-2.30">TI SimpleLink CC26x2 SDK 2.30.00.34</a>
 </td>
 <td>
 <ul>
 <li>Full Duplex Bidirectional Audio Demo (Central/Peripheral)</li>
 <li>I2S Echo</li>
 <li>Serial Port Profile</li>
 <li>Bluetooth 5 Throughput Demo</li>
 <li>Tree Structure Network</li>
 </ul>
 </td>
 </tr>
 <tr>
 <td>
 <a href = "https://github.com/ti-simplelink/ble_examples/tree/simplelink_sdk-2.10">TI SimpleLink CC26x2 SDK 2.10.00.44</a>
 </td>
 <td>
 <ul>
 <li>Full Duplex Bidirectional Audio Demo (Central/Peripheral)</li>
 <li>I2S Echo</li>
 <li>Serial Port Profile</li>
 </ul>
 </td>
 </tr>
 <tr>
 <td>
 <a href = "https://github.com/ti-simplelink/ble_examples/tree/simplelink_sdk-1.60">TI SimpleLink CC26x2 SDK 1.60.00.43</a>
 </td>
 <td>
 <ul>
 <li>Full Duplex Bidirectional Audio Demo (Central/Peripheral)</li>
 <li>I2S Echo</li>
 <li>Serial Port Profile</li>
 </ul>
 </td>
 </tr>
 <tr>
 <td>
 <a href = "https://github.com/ti-simplelink/ble_examples/tree/simplelink_cc2640r2_sdk-2.20">TI SimpleLink CC2640R2 SDK 2.20.00.49</a>
 </td>
 <td>
 <ul>
 <li><a href="#simple-serial-socket">Simple Serial Socket</a></li>
 <li><a href="#micro-ble-stack-broadcaster-observer">Micro BLE Stack Broadcaster Observer</li>
 <li><a href="#bidirectional-audio">Bidirectional Audio</li>
 <li><a href="#simple-peripheral-observer">Simple Peripheral Observer</li>
 <li><a href="#apple-notification-center-service">Apple Notification Center Service</li>
 </ul>
 </td>
 </tr>
 <tr>
 <td>
 <a href = "https://github.com/ti-simplelink/ble_examples/tree/simplelink_sdk-1.50">TI SimpleLink CC2640R2 SDK 1.50.00.58</a>
 </td>
 <td>
 <ul>
 <li>Micro BLE Stack Broadcaster + Observer</li>
 <li>Full Duplex Bidirectional Audio Demo</li>
 <li>Serial Port Profile</li>
 <li>Simple Peripheral Observer BLE</li>
 <li>Apple Notification Center Service</li>
 </ul>
 </td>
 </tr>
 <tr>
 <td>
 <a href = "https://github.com/ti-simplelink/ble_examples/tree/simplelink_sdk-1.40">TI SimpleLink CC2640R2 SDK 1.40.00.45</a>
 </td>
 <td>
 <ul>
 <li>Full Duplex Bidirectional Audio Demo</li>
 <li>Bluetooth 5 Throughput Demo</li>
 <li>Bluetooth 5 Long Range Demo</li>
 <li>Serial Port Profile</li>
 <li>Simple Peripheral Observer BLE</li>
 <li>Apple Notification Center Service</li>
 </ul>
 </td>
 </tr>
 <tr>
 <td>
 <a href = "https://github.com/ti-simplelink/ble_examples/tree/simplelink_sdk-1.35">TI SimpleLink CC2640R2 SDK 1.35.00.33</a>
 </td>
 <td>
 <ul>
 <li>Bluetooth 5 Throughput Demo</li>
 <li>Bluetooth 5 Long Range Demo</li>
 <li>Serial Port Profile</li>
 </ul>
 </td>
 </tr>
 <tr>
 <td>
 <a href = "https://github.com/ti-simplelink/ble_examples/tree/ble_examples-2.2">TI BLE-Stack SDK v2.2.x</a>
 </td>
 <td>
 <ul>
 <li>beacon_rfdriver</li>
 <li>hid_adv_remote_privacy</li>
 <li>hid_emu_kbd</li>
 <li>multi_role</li>
 <li>security_examples</li>
 <li>simple_beacon</li>
 <li>simple_central_lp</li>
 <li>simple_central_audio_receiver</li>
 <li>simple_peripheral_audio_transmitter</li>
 <li>simple_eddystone</li>
 <li>simple_peripheral_observer</li>
 <li>simple_proprietary_beacon</li>
 <li>spp_over_ble</li>
 <li>throughput_example</li>
 <li>serial_bootloader</li>
 <li>central_to_multiperipheral</li>
 </ul>
 </td>
 </tr>
 <tr>
 <td>
 <a href = "https://github.com/ti-simplelink/ble_examples/tree/ble_examples-2.1">TI BLE-Stack SDK v2.1.x</a>
 </td>
 <td>
 <ul>
 <li>SimpleAP</li>
 <li>SimpleNP</li>
 <li>MultiRole</li>
 <li>SimpleBLEPeripheral: LCD to UART</li>
 <li>SimpleBLEPeripheral: porting to TI-RTOS 2.15</li>
 <li>Apple Notification Center Service</li>
 </ul>
 </td>
 </tr>
 </tbody>
</table>

# 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.

### 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](https://help.github.com/articles/cloning-a-repository/)

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
1. Select "Download ZIP" option
1. 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_2_20_00_49

If the Simplelink CC2640R2 SDK must be installed to a different location, then
see the [FAQ page](docs/faq.md) 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](docs/faq.md).

## FAQ

The [FAQ page](docs/faq.md) will try to address some of the common questions
related to the ble_examples repo.

## Examples / Demo List

### Simple Serial Socket

This is a UART over BLE bridge example where a Simple Serial Socket Client
(SSSC) and Simple Serial Socket Server (SSSS) connect with one another and
exchange UART data over the air. An generic Simple Stream Service is used
making it easy to exchange data sink and source to create a custom serial
socket over BLE implementation.

**Note: this example replaces the SPP over BLE example**

* Simple Serial Socket Client
 * [Documentation](examples/rtos/CC2640R2_LAUNCHXL/bleapps/simple_serial_socket_client/readme.md)
 * [IAR Project Files](examples/rtos/CC2640R2_LAUNCHXL/bleapps/simple_serial_socket_client/tirtos/iar)
 * [CCS Project Files](examples/rtos/CC2640R2_LAUNCHXL/bleapps/simple_serial_socket_client/tirtos/ccs)
 * [Source](examples/rtos/CC2640R2_LAUNCHXL/bleapps/simple_serial_socket_client/src)
* Simple Serial Socket Server
 * [Documentation](examples/rtos/CC2640R2_LAUNCHXL/bleapps/simple_serial_socket_server/readme.md)
 * [IAR Project Files](examples/rtos/CC2640R2_LAUNCHXL/bleapps/simple_serial_socket_server/tirtos/iar)
 * [CCS Project Files](examples/rtos/CC2640R2_LAUNCHXL/bleapps/simple_serial_socket_server/tirtos/ccs)
 * [Source](examples/rtos/CC2640R2_LAUNCHXL/bleapps/simple_serial_socket_server/src)

## 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](http://dev.ti.com/tirex/#/?link=Software%2FSimpleLink%20CC2640R2%20SDK%2FDocuments%2FBLE-Stack%2FBLE-Stack%20User's%20Guide).

As an additional resource, users are encouraged to complete the
[SimpleLink Academy](http://dev.ti.com/tirex/#/?link=Software%2FSimpleLink%20CC2640R2%20SDK%2FSimpleLink%20Academy)
training.

Other resources can be found below:

* [BLE E2E Page](www.ti.com/ble-forum)