Skip to content

手把手教你:彻底搞懂BLE中服务,特征,特征声明,特征值声明,特征描述符,属性这些术语的含义 ​

一、前言

原本今天这篇文章是用来讲解如何建立私有服务的,不过考虑到建立私有服务需要涉及到蓝牙里面的一些官方术语,所以今天就先结合着代码,讲解下这些术语分别代表些什么

二、阅读说明

1、泰凌微芯片学习者,前期使用过该芯片。

2、能够知道怎么进行创建工程,下载代码。

3、有一块开发板,板上的芯片可以是8251,8253或者8258。

三、正文

1、使用的SDK

如何使用TLSR8258芯片进行蓝牙广播

使用的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)

markdown
{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、代码解释

cs
    // 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)
cs
    {0,ATT_PERMISSIONS_READ,2,sizeof(my_serviceChangeCharVal),(u8*)(&my_characterUUID),         (u8*)(my_serviceChangeCharVal), 0, 0},
  • 特征声明属性值代码
javascript
//// 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、代码解释

cs
{0,ATT_PERMISSIONS_READ,2,sizeof (serviceChangeVal), (u8*)(&serviceChangeUUID),    (u8*)(&serviceChangeVal), 0, 0},

可以看到上面的代码是和协议里面的描述一样

8、特征描述符(characteristic  descriptor)

特征描述有好多个,这里只列出一个客户描述符来做说明

8.1、蓝牙协议格式

8.2、代码解释

cs
{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中的服务,特征,特征声明,特征值声明,特征描述符,属性这些术语的含义,下一篇开始讲解如何建立一个私人服务。