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 : 具有以下几种含义

服务或者特征值的唯一ID
用于区分是服务还是特征值还是 …………具体看上面的表 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 可写的 属性 必须保持一致，否则就会造成系统混乱 */

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功能。

gattAttribute_t 含义 中文解释

gattAttribute_t 含义中文解释