Skip to content

手把手教你:建立BLE从机私有服务 ​

一、前言

本篇开始讲解如何建立BLE从机的私有服务

二、阅读说明

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

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

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

三、正文

1、使用的SDK

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

使用的SDK为该篇文章描述的

2、服务的结构

2.1、服务结构介绍

要建立自己的私有服务首先要了解一个服务的内容是怎么构成的,如下表格所示,总共有四层,关于里面的名词解释,请看我的这篇文章手把手教你:彻底搞懂BLE中服务,特征,特征声明,特征值声明,特征描述符,属性这些术语的含义

1首要服务声明
2特征声明
3特征值声明
4特征描述符

2.2、服务结构举例

上面是一个电池服务,可以看到和2.1小杰中描述的是一样的

3、确定私有服务的UUID

3.1、UUID简单说明

私有服务的UUID可以采用128bit,也可以采用简单的16bit的,其实我们定义的16bit的UUID,最后也是会转变成128bit的,其中在转换关系如下

Bluetooth_Base_UUID为00000000-0000-1000-8000-00805F9B34FB

结合转换关系,最后16bit的UUID会填充到红色区域里面

00000000-0000-1000-8000-00805F9B34FB

备注:我们确定的UUID不能是蓝牙官方的UUID重名,详细的请看蓝牙协议文件,其中“Assigned_Numbers”里面有对UUID进行说明

3.2、服务声明的属性值UUID、

先指定改属性值的UUID为0xFF00

3.3、特征值的UUID

先指定特征值的UUID为0xFF01

4、代码总览

4.1、变量的定义

ruby
//////////////////////// One Self /////////////////////////////////////////////////
#define SERVICE_UUID_MY                                     0xff00
#define CHARACTERISTIC_UUID_MY_VALUE                        0xff01
static const u16 my_oneSelf_ServiceUUID        = SERVICE_UUID_MY;
static const u16 my_oneSelf_CharUUID          = CHARACTERISTIC_UUID_MY_VALUE;
_attribute_data_retention_  static u8 oneSelfValueInCCC[2] = {0,0};
_attribute_data_retention_  static u8 my_oneSelfVal[1]  = {99};
static const u8 my_oneSelf_CharVal[5] = {
    CHAR_PROP_READ | CHAR_PROP_NOTIFY | CHAR_PROP_INDICATE,
    U16_LO(ONE_SELF_LEVEL_INPUT_DP_H), U16_HI(ONE_SELF_LEVEL_INPUT_DP_H),
    U16_LO(CHARACTERISTIC_UUID_MY_VALUE), U16_HI(CHARACTERISTIC_UUID_MY_VALUE)
};

此次代码需定义在app_att.c中

  • SERVICE_UUID_MY:我的服务声明中的属性值的UUID,一般习惯称呼为服务UUID,值为0xff00
  • CHARACTERISTIC_UUID_MY_VALUE:特征值的UUID,一般习惯称呼为特征UUID,值为0xff01
  • my_oneSelf_ServiceUUID:服务UUID,值为0xff00
  • my_oneSelf_CharUUID:特征UUID,值为0xff01
  • oneSelfValueInCCC:描述符属性值
  • my_oneSelfVal:特征值属性值
  • my_oneSelf_CharVal:特征声明的属性值,里面存放在特征值的特性(允许读,通知和指示),特征值声明句柄信息,特征值声明的UUID

解释比较拗口,大家多看几遍,多理解几遍就好,习惯了就行

4.2、属性表代码添加

ruby
    ////////////////////////////////////// One Self Service /////////////////////////////////////////////////////
    {4,ATT_PERMISSIONS_READ,2,2,(u8*)(&my_primaryServiceUUID),  (u8*)(&my_oneSelf_ServiceUUID), 0, 0},
    {0,ATT_PERMISSIONS_READ,2,sizeof(my_oneSelf_CharVal),(u8*)(&my_characterUUID), (u8*)(my_oneSelf_CharVal), 0, 0},                //prop
    {0,ATT_PERMISSIONS_READ,2,sizeof(my_oneSelfVal),(u8*)(&my_oneSelf_CharUUID),    (u8*)(my_oneSelfVal), 0, 0},    //value
    {0,ATT_PERMISSIONS_RDWR,2,sizeof(oneSelfValueInCCC),(u8*)(&clientCharacterCfgUUID),     (u8*)(oneSelfValueInCCC), 0, 0},    //value

该代码需添加到my_Attributes表格里面,my_Attributes表格同样在app_att.c中

  • 第一行代码:服务声明
  • 第二行代码:特征声明
  • 第三行代码:特征值声明
  • 第四行代码:描述符

4.3、句柄添加

javascript
    ONE_SELF_PS_H,                              //UUID: 2800,   VALUE: uuid fe00
    ONE_SELF_LEVEL_INPUT_CD_H,                  //UUID: 2803,   VALUE:              Prop: Read | Notify | Indicate
    ONE_SELF_LEVEL_INPUT_DP_H,                  //UUID: 0xff01, VALUE: 
    ONE_SELF_LEVEL_INPUT_CCB_H,                 //UUID: 2902,   VALUE:

该代码需添加到ATT_HANDLE枚举里面,ATT_HANDLE枚举在app_att.h中

备注:句柄的顺序和属性表格里面代码的位置要一一对应

  • ONE_SELF_PS_H:服务声明句柄
  • ONE_SELF_LEVEL_INPUT_CD_H:特征声明句柄
  • ONE_SELF_LEVEL_INPUT_DP_H:特征值声明句柄
  • ONE_SELF_LEVEL_INPUT_CCB_H:描述符句柄

5、连接服务显示

用nRF Connect软件扫描到蓝牙广播名之后,点击连接,然后可以看到服务表格,如下图所示,多了一个服务,且能看到UUID和我们定义的是一样的。