gattAttribute_t 含义 中文解释

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

 /**
  * @brief GATT Attribute format.
  *
  * @note
  * The list must start with a Service attribute followed by
  * all attributes associated with this Service attribute.
  */
 typedef struct attAttribute_t
 {
   gattAttrType_t type; //!< Attribute type (2 or 16 octet UUIDs)
   uint8 permissions;    //!< Attribute permissions
   uint16 handle;       //!< Attribute handle - assigned internally by attribute server
   uint8* const pValue; //!< Attribute value - encoding of the octet array is defined in
                        //!< the applicable profile. The maximum length of an attribute
                        //!< value shall be 512 octets.
 } 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客户端在设置权限的情况下读取此服务 */
    ,                                        /* 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,　　　　　　　　　　　　 /* 可读  */　　　　　　　　
      ,
      &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 可写的 属性 必须保持一致，否则就会造成系统混乱 */
　　　　 , 
　　　　simpleProfileChar5 },

总结 ：

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

 BLE采用了client/server (C/S)架构来进行数据交互，C/S架构是一种非常常见的架构，在我们身边随处可见，比如我们经常用到的浏览器和服务器也是一种C/S架构，这其中浏览器是客户端client，服务器是服务端server，server比如淘宝服务器，提供商品信息，广告，社交等服务，而浏览器，比如微软的IE，就可以用来请求这些服务，并使用server提供的服务。BLE与此类似，一般而言设备提供服务，因此设备是server，手机使用设备提供的服务，因此手机是client。比如蓝牙体温计，它可以提供“体温”数据服务，因此是一个server，而手机则可以请求“体温”数据以显示在手机上，因此手机是一个client。

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

 Server是通过characteristic来表示数据的，虽然一条数据最有价值的部分是它的值（value），但是仅有value是不够，比如27，到底是表示27°温度还是27%湿度；如果表示的是温度，那么它的单位是摄氏度还是华氏度。同时每个value还有相应的读写属性以及权限属性，因此一个characteristic包含三种条目：characteristic声明，characteristic的值以及characteristic的描述符（可以有多个描述符）

由于一个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功能。