手把手教你:彻底搞懂BLE中服务,特征,特征声明,特征值声明,特征描述符,属性这些术语的含义
一、前言
原本今天这篇文章是用来讲解如何建立私有服务的,不过考虑到建立私有服务需要涉及到蓝牙里面的一些官方术语,所以今天就先结合着代码,讲解下这些术语分别代表些什么
二、阅读说明
1、泰凌微芯片学习者,前期使用过该芯片。
2、能够知道怎么进行创建工程,下载代码。
3、有一块开发板,板上的芯片可以是8251,8253或者8258。
三、正文
1、使用的SDK
使用的SDK为该篇文章描述的
2、配置文件(Profile)术语的解释
2.1、蓝牙协议官方解释


profile就是一个数据结构,将里面的一些数据给集合起来,里面主要包含的是一些服务(Service)
2.2、代码解释
理论上来说,这个数组就是一个配置文件(profile),里面包含了一些服务

3、服务(Service)
3.1、蓝牙协议官方解释

上述图片是对服务(Service)的描述,服务里面有包含服务(Include Service),一个强制的特征,和可选的特征。
然后服务有两种类型,一种是首要服务(primary service),一种是次要服务(secondary service)。

这上面是对服务定义的描述,里面应该包含一个服务声明(Service declaration)和包含定义(可以没有)还有特征定义(characteristic definitions)。
其中包含定义(include definitions)我在下面这两篇文章中有讲过
手把手教你:BLE Include服务查询与ATT 0x2802属性解析
手把手教你:BLE Include嵌套服务代码与抓包实战解析
3.2、代码解释

- 1代表服务(Service)
- 2代表服务声明(Service declaration)
- 3、4、5代表特征定义(characteristic definitions)
4、服务声明(Service declaration)

{7,ATT_PERMISSIONS_READ,2,2,(u8*)(&my_primaryServiceUUID), (u8*)(&my_gapServiceUUID), 0, 0},- 权限:只读
- 属性UUID:0x2800
- 属性值UUID:Gap的UUID,具体看另外一份文档“Assigned_Numbers”
5、特征定义
5.1、特征定义的拆解

特征定义必须包含两部分,第一是特征声明(characteristic declaration),第二是特征值声明(characteristic value declaration),还有一个可选为特征描述符(characteristic descriptor)
5.2、代码解释

// 0x0008 - 0x000B GATT
{4,ATT_PERMISSIONS_READ,2,2,(u8*)(&my_primaryServiceUUID), (u8*)(&my_gattServiceUUID), 0, 0},
{0,ATT_PERMISSIONS_READ,2,sizeof(my_serviceChangeCharVal),(u8*)(&my_characterUUID), (u8*)(my_serviceChangeCharVal), 0, 0},
{0,ATT_PERMISSIONS_READ,2,sizeof (serviceChangeVal), (u8*)(&serviceChangeUUID), (u8*)(&serviceChangeVal), 0, 0},
{0,ATT_PERMISSIONS_RDWR,2,sizeof (serviceChangeCCC),(u8*)(&clientCharacterCfgUUID), (u8*)(serviceChangeCCC), 0, 0},- 特征定义:图片中的1
- 特征声明(characteristic declaration):图片中的2
- 特征值声明(characteristic value declaration):图片中的3
- 特征描述符(characteristic descriptor):图片中的4
6、特征声明(characteristic declaration)
6.1、蓝牙协议格式

6.2、代码解释

- 特征声明代码(characteristic declaration)
{0,ATT_PERMISSIONS_READ,2,sizeof(my_serviceChangeCharVal),(u8*)(&my_characterUUID), (u8*)(my_serviceChangeCharVal), 0, 0},- 特征声明属性值代码
//// GATT attribute values
static const u8 my_serviceChangeCharVal[5] = {
CHAR_PROP_INDICATE,
U16_LO(GenericAttribute_ServiceChanged_DP_H), U16_HI(GenericAttribute_ServiceChanged_DP_H),
U16_LO(GATT_UUID_SERVICE_CHANGE), U16_HI(GATT_UUID_SERVICE_CHANGE)
};可以看到上面的代码是和协议里面的描述一样
7、特征值声明(characteristic value declaration)
7.1、蓝牙协议格式

7.2、代码解释

{0,ATT_PERMISSIONS_READ,2,sizeof (serviceChangeVal), (u8*)(&serviceChangeUUID), (u8*)(&serviceChangeVal), 0, 0},可以看到上面的代码是和协议里面的描述一样
8、特征描述符(characteristic descriptor)
特征描述有好多个,这里只列出一个客户描述符来做说明
8.1、蓝牙协议格式

8.2、代码解释

{0,ATT_PERMISSIONS_RDWR,2,sizeof (serviceChangeCCC),(u8*)(&clientCharacterCfgUUID), (u8*)(serviceChangeCCC), 0, 0},可以看到上面的代码是和协议里面的描述一样
9、属性(Attribute)

在这个服务当中,每一个数字都代表一个属性,如上面的图片当中我圈出来的就代表属性,而其中的叫法各不相同,有的叫做属性类型,有的叫做属性值,有的叫做属性特性,可以说属性是蓝牙协议当中的最小单元。
下面我以服务声明为例说明一下:
- ATT_PERMISSIONS_READ:这个是属性特性,代表只读
- my_primaryServiceUUID:这个是属性类型,代表首要服务的UUID
- my_gattServiceUUID:这个是属性值,代表服务的UUID,这里代表的gatt服务
四、结尾
本篇结合蓝牙协议,代码讲解了BLE中的服务,特征,特征声明,特征值声明,特征描述符,属性这些术语的含义,下一篇开始讲解如何建立一个私人服务。