CC26xx BLE 添加indication属性的特征值

2020-9-15

Yan Zhang

摘要

CC26xx 是TI 提供的高性能2.4GHz射频SOC芯片。最新一代CC2652可以支持BLE，ZigBee，Thread，TI15.4以及私有协议。能以multi-protocol模式同时运行BLE+ZigBee ，BLE+TI15.4，或者BLE+2.4G 私有协议，任意两种组合。

TI提供CC26xx的SDK，SDK里面包含了各种协议支持，其中就包含BLE。BLE协议里，TI提供了很多例程。其中simple peripheral例程是最为广泛使用的一个，里面提供了BLE最基本的各种read， write，notify属性的特征值，唯独没有indication属性的特征值。Indication 属性和notify属性类似，但又不一样，它是需要BLE Client设备收到数据后回复确认的一种机制。

本文基于CC2652的SDK V3.30版本的simple peripheral 例程实现indication。本文提供的方式适用于所有CC26xx系列的芯片。

1. BLE 特征值的indication属性........................................................................................................... 2

2. CC2652 indication的实现................................................................................................................ 2

2.1 特征值2的定义............................................................................................................................. 2

2.1.1 特征值2 属性修改.................................................................................................................... 2

2.1.2 特征值2 的配置属性添加......................................................................................................... 3

2.2 特征值2的CCC值操作................................................................................................................. 4

2.3 特征值2的indication数据发送...................................................................................................... 4

2.3.1 调用GATTServApp_ProcessCharCfg()................................................................................... 4

2.3.2 调用GATT_Indication()............................................................................................................ 5

2.4 应用层代码添加........................................................................................................................... 6

3. Indication 测试................................................................................................................................ 7

4. 参考文献........................................................................................................................................... 9

图表

图1. BLE indication............................................................................................................................ 2

图2. 特征值2的属性.............................................................................................................................. 8

图3. 使能特征值2的indication............................................................................................................. 9

图4. Indication发送和确认................................................................................................................... 9

1 BLE 特征值的indication属性

BLE特征值的indication是由server端主动向client端发送数据的一种方式，和notification方式类似，但indication不一样的地方是需要client端收到数据后回复confirm包给server端。这些行为都是在GATT层完成，并可以通知client应用层对方成功接收数据。由于有自动确认机制，indication在很多应用层级的协议制定中有比较广泛应用。

图1. BLE indication

2 CC2652 indication的实现

本文基于CC2652的SDK V3.30版本的simple peripheral 例程实现indication，在simple GATT service中的特征值2上添加indication机制，特征值2将同时支持read和indication的属性。

2.1 特征值2的定义

2.1.1 特征值2 属性修改

在simple_gatt_profile.c中，给Characteristic 的属性添加indication 属性：

同时，在特征值定义表格中，特征值2的读写属性里，把GATT_PERMIT_READ这一定义去掉，完全交由前面定义的simpleProfileChar2Props来决定，不然该特征值还是会被认为只有read属性：

2.1.2 特征值2 的配置属性添加

就像带有notification属性的特征值一样，作为带有indication属性的特征值，也必须有一个CCC（Client Characteristic Configuration）紧随该特征值的value定义，将它添加在特征值2的value定义后面：

同时，我们需要在特征值定义表格中把这个CCC的定义attribute也添加进去，位置是在特征值2的value定义之后，该attribute的读写属性为可读+可写。

注意，由于在表格里添加了一个attribute，表格数组的尺寸定义也要加1，由17变为18：

在service初始化函数中，把特征值2的CCC值也进行初始化，位置在SimpleProfile_AddService() 函数：

特征值的定义部分完成。

2.2 特征值2的CCC值操作

Indication或者notification的CCC值是由client（通常是central设备，极个别profile可以是peripheral设备）来用来使能server端的indication或者notification。这个操作本质上是client对CCC值的一个写操作，而写操作的处理在simpleProfile_WriteAttrCB()函数里，区分和例程里特征值4的notification的CCC值，添加代码如下，替换原来的：

注意GATT_CLIENT_CFG_INDICATE和GATT_CLIENT_CFG_NOTIFY的区别，分别对应indication和notification。这里的添加，就会修改simpleProfileChar2Config值，并且使能或者关闭特征值2的indication功能。

另外注意simpleProfileChar2Config本质是一个指针，指向gattCharCfg_t结构体：

每一个CCC的value，对应一个connection handle，也就是对应一个BLE的连接。从其在SimpleProfile_AddService()函数里的初始化也可以看出，simpleProfileChar2Config被分配了MAX_NUM_BLE_CONNS个gattCharCfg_t尺寸的空间，这就为每个BLE连接都单独预留了indication的CCC的配置，每一个连上本设备的central设备都能单独开关特征值2的indication。

2.3 特征值2的indication数据发送

在CC26xx的SDK中，发送indication或者notification有两种方式，一种是调用封装的函数GATTServApp_ProcessCharCfg()，另一种是直接调用GATT的API函数GATT_Indication()和GATT_Notification()。

2.3.1 调用GATTServApp_ProcessCharCfg()

在SimpleProfile_SetParameter()中，应用层会调用该函数来做特征值操作，把对应的特征值2的部分修改如下：

这里把len的长度加1的目的是为了得到应用层的task ID。这就是indication和notification的区别之一，蓝牙协议规定indication发送后是需要对方回复confirm确认的，这个确认必须要有一个对应的实体也就是task去接收并且处理（也可以不处理，只是当作一个indication成功的通知，接收这个动作是必须的）。所以indication发送的时候必须要提前制定确认消息的接收task ID。这里就会通过SimpleProfile_SetParameter() 被应用层调用来指定发送的indication的值和接收确认消息的task ID，一般就由应用层task本身接收。

2.3.2 调用GATT_Indication()

另一种方法直接调用GATT层API GATT_Indication()，实现代码如下。由于CC26xx支持一从多主模式，所以有可能同时存在多条BLE链路，因此代码的实现也考虑到这一点，所有当前存在的BLE链路都要进行判断，根据CCC值的开关状态决定是否需要向对应的主机发送该特征值的indication。