gattAttribute_t 含义 中文解释

1、  gattAttribute_t   是一个结构体数据类型,里面存放了各种类型的数据。 现在 看看 TI  是怎么描述的,如下:

 1 /**
 2  * @brief GATT Attribute format.
 3  *
 4  * @note
 5  * The list must start with a Service attribute followed by
 6  * all attributes associated with this Service attribute.
 7  */
 8 typedef struct attAttribute_t
 9 {
10   gattAttrType_t type; //!< Attribute type (2 or 16 octet UUIDs)
11   uint8 permissions;    //!< Attribute permissions  
12   uint16 handle;       //!< Attribute handle - assigned internally by attribute server
13   uint8* const pValue; //!< Attribute value - encoding of the octet array is defined in
14                        //!< the applicable profile. The maximum length of an attribute
15                        //!< value shall be 512 octets.
16 } gattAttribute_t;

 成员分析  :

      

      表1-0

 

上面 解释的 第一个 成员可能 不是很详细,我们 来看下 源码:

/// @brief GATT Attribute Type format.
typedef struct
{
  uint8 len;         //!< Length of UUID (2 or 16)  长度是 两个字节 或者 16个字节
  const uint8 *uuid; //!< Pointer to UUID  指向 2个 或者 16个字节  buff 指针
} gattAttrType_t;
gattAttrType_t: Where length can be either ATT_BT_UUID_SIZE (2 bytes), or ATT_UUID_SIZE (16 bytes). The *uuid is a pointer to a
number either reserved by Bluetooth SIG (defined in gatt_uuid.c) or a custom UUID defined in the profile.

总结: 这个成员 实际含义 是 描述 服务的 类型, 服务类型 也是 UUID , 官方蓝牙组织 SIG 规定, UUID 值 0x2800 代表 主服务,
UUID 值 0x2803 代表 特征值, 详细看下表

表 1-1


 

 2、TI  在 simple_gatt_profile.c 文件中 利用 这个gattAttribute_t 数据类型  定义了一个  数组  simpleProfileAttrTbl  ,  这个数组 暂且理解为 存放 我们自定义的 蓝牙服务 以及该服务 拥有 的 特征值 。

/*********************************************************************
 * Profile Attributes - Table
 */

static gattAttribute_t simpleProfileAttrTbl[SERVAPP_NUM_ATTR_SUPPORTED];

 

那 这个 数组 放了 什么 东西 那 , 我 们 来 分析 分析 。

 

  • 这个 数组 的 第一个  元素  如下:(按照 上面 gattAttribute_t 结构体 中文 解释 分析 ,看下面注释)
  // Simple Profile Service,1 1
  { 
    { ATT_BT_UUID_SIZE, primaryServiceUUID }, /* type 值是0x2800,即属性类型是 主服务类型, 更多类型看 上面的 表1-1*/
    GATT_PERMIT_READ,                         /* permissions,权限为可读权限,意思是:允许GATT客户端在设置权限的情况下读取此服务 */
    0,                                        /* handle 默认为0,因为这个句柄是协议栈自动分配的,不可以自定义,因此默认初始化为0*/
    (uint8 *)&simpleProfileService            /* pValue: 是一个 gattAttrType_t 类型的值,即 {2,0xFFF0} */
  },

 总结:  该 元素是 一个 主服务类型, 服务的 UUID 的值 是 0xFFF0 ,该服务 具有 可读权限

 

UUID :   具有以下几种含义

  1. 服务或者特征值的 唯一ID 
  2. 用于 区分 是 服务 还是特征值 还是 …………具体 看 上面的  表 1-1
  •  这个数组的 第二个  元素如下:(注:我 的是这个 ,其他的我删除了,同个类型的 没啥 差别)
    // Characteristic 5 Declaration
    {
      { ATT_BT_UUID_SIZE, characterUUID },  /* type,属性类型 是特征值类型,详看 表1-1 */
      GATT_PERMIT_READ,             /* 可读  */        
      0,
      &simpleProfileChar5Props        /* 这个 查看定义是 uint8 simpleProfileChar5Props = GATT_PROP_WRITE; 应该理解为 特征值 具有可写的属性 */
    },

  总结  :  这里 有 歧义,   GATT_PERMIT_READ 这个描述的 是  数组 这个元素 具有的 权限 是 可读 或者 可写(详见表1-0),    simpleProfileChar5Props 这个变量 描述 的 是  该数组元素 代表的特征值 具有  可写 的属性 (详见表1-2) ,一个是权限 一个  是 属性。

    这个 元素  可以理解为 :  描述 特征值 uuid 为 0XFFF1 具有 写入的属性,即 手机APP 可以 往这个 特征值写入数据。

表 1-2

  •  该数组 第三个 元素 是 如
// Characteristic Value 5
      {
        { ATT_BT_UUID_SIZE, simpleProfilechar5UUID }, /* 该类型设置为自定义的simpleProfilechar1 UUID(0xFFF5)。 */
        GATT_PERMIT_WRITE,  /* 属性表中特征值的属性必须与特征值声明中的属性匹配,这里的意思是: 改特征值 具有 可以 写的权限 , 要和 第二元素  中 的uint8 simpleProfileChar5Props = GATT_PROP_WRITE 可写的 属性 必须保持一致,否则就会造成系统混乱 */
    
0,
    simpleProfileChar5 },

总结 :

/* 属性表中特征值的属性必须与特征值声明中的属性匹配,这里的意思是: 改特征值 具有 可以 写的权限 , 要和 第二元素  中 的uint8 simpleProfileChar5Props = GATT_PROP_WRITE 可写的 属性 必须保持一致,否则就会造成系统混乱 */


如果某个service是一个蓝牙联盟定义的标准服务,也可以称其为profile,比如HID/心率计/体温计/血糖仪等,都是标准蓝牙服务,因此都有相应的profile规格书。

由于一个service可以包含多个characteristic,characteristic declaration就是每个characteristic的分界符,解析时一旦遇到characteristic declaration,就可以认为接下来又是一个新的characteristic了,同时characteristic declaration还将包含value的读写属性等。Characteristic value就是数据的值了,这个比较好理解就不再说了。Characteristic descriptor就是数据的额外信息,比如温度的单位是什么,数据是用小数表示还是百分比表示等之类的数据描述信息。CCCD是一种特殊的characteristic descriptor,一般而言,都是client来访问server的characteristic,我们把这种操作称为读或者写。另外,server可以直接把自己的characteristic的值告诉client,我们称其为notify或者indicate,跟read操作相比,只有需要传输数据的时候或者说只有当数据有效时,server才开始notify或者indicate数据到client,因此这种操作方式可以大大节省server的功耗。有时候client不想监听characteristic notify或者indicate过来的数据,那么就可以使用CCCD来关闭characteristic的notify或者indicate功能;如果client又需要监听characteristic的notify或者indicate,那么它可以重新使能CCCD来打开相关操作。总结一下,当characteristic具有notify或者indicate操作功能时,那么必须为其添加相应CCCD,以方便client来使能或者禁止notify或者indicate功能。






 

posted on 2018-09-20 11:08  所长  阅读(756)  评论(0编辑  收藏  举报

导航