介绍

ATT，Attribute Protocol，用于发现、读、写对端设备的协议(针对BLE设备)
ATT允许蓝牙远程设备（比如遥控器）作为服务端提供拥有关联值的属性集，让作为客户端的设备（比如手机、电视）来发现、读、写这些属性；同时服务端能主动通知客户端
ATT定义了两种角色: 服务端(Server)和客户端(Client)，一个设备可以同时拥有Server和Client；而一个Server可以支持多个Client。
ATT中的属性包含下面三个内容

- Attribute Type       : 由UUID(Universally Unique IDentifier)来定义 
- Attribute Handle     : 用来访问Attribute Value 
- A set of Permissions  : 控制是否该Attribute可读、可写、属性值是否通过加密链路发送

相关概念

Attribute Type

Attribute Type由UUID唯一指定，UUID是一个128-bit值。但在使用过程中，为了提高效率，使用的是16-bits Attribute UUID，其他bit都是固定值。

128-bit UUID        = 16-bit Attribute UUID*2^96 + Bluetooth_Base_UUID
Bluetooth_Base_UUID = 00000000-0000-1000-8000-00805F9B34FB

更简单的办法如下(xxxx代表十六进制的16-bit UUID)

0000xxxx-0000-1000-8000-00805F9B34FB

TIP: 16-bit Attribute UUIDs与SDP 16-bit UUIDs相同，参考《16-bit UUID Numbers Document.pdf》

Attribute Handle

Attribute Handle是由Server分配的一个唯一且非零16-bit值，用于检索Attribute。

0x0000 : 保留 
0xFFFF : 最大Attribute Handle

Attribute Handle Grouping

Attribute Handle Grouping是一组由高层协议定义的属性，他们位于其他属性之前。
可以这么理解：ATT只是提出Grouping概念，并没有具体说明他怎么实现，而它由高层协议来定义，作用是方便组织、管理、访问很多Attribute。

Attribute Value

Attribute Value以字节为最小单位，可以是1byte的数值，4byte数值、字符串等待，当属性值太长时，可通过多个PDUs发送

Attribute Permissions

属性都有一组与之相关联的Permission Values，一个属性的权限由高层协议定义，并对ATT不可见。也就是说ATT只说明了属性可以被附加上什么权限，而不针对具体某个Attribute需要某种权限。
当访问一个安全属性需要一个认证的链路，而Client没有足够的权限，Server则响应一个Error Code(Insufficient Authentication)，Client收到Error Code后应该尝试认证该链路，成功后即可访问该安全属性
当访问一个安全属性需要一个加密的链路，而链路没有加密，Server则响应一个Error Response(Insufficient Encryption)，Client收到Error Response后应该尝试加密该链路，成功后即可访问该安全属性
当访问一个安全属性需要一个加密的链路，链路有加密，但是对于所需要的安全级别来说加密Key Size太短
Server则响应一个Error Code(Insufficient Encryption Key Size)，Client收到Error Response后应该尝试使用更长的Key Size加密该链路，成功后即可访问该安全属性
Attribute Permissions由下列三个权限组合而成

- Access Permissions         : 决定Client是否可读、写属性值 ~ Readable ~ Writable ~ Readable and Writable 
- Authentication Permissions : 决定是否需要一个认证的物理链路(Authenticated Physical Link) ~ Authentication Required ~ No Authentication Required 
- Authorization Permssions   : 决定Client在访问属性值前是否需要授权 ~ Authorization Required ~ No Authorization Required

Control-Point Attribute

不可读、可写、可通知(Notified)和可指示(Indicated)的属性被称为Control-Point Attribute。高层协议可使用该属性来使能设备特定过程，比如设备上一个给定过程的命令或指示已经完成。

Exchanging MTU Size

ATT_MTU定义了Client和Server之间数据包的最大值；其默认值由高层协议来定义。Client和Server可通过Exchange MTU Request and Response PDUs来交换最大数据包，然后均使用交换值中的最小值进行通信，同时作为Server和Client的设备应该使用相同的Client Rx MTU和Server Rx MTU。

Long Attribute Value

在单一数据包中可发送最长的属性大小为[ATT_MTU –1] octets；但在一个Attribute PDU中至少包含Attribute Opcode等其他内容，如果属性值比[ATT_MTU-1] octets大则称为Long Attribute，对于Long Attribute

- 使用Read Blob Request来读取整个属性(Attribute > [ATT_MTU-1] octets) 
- 使用Prepare Write Request和Execute Write Request来写整个属性(Attribute > [ATT_MTU-3] octets)

ATT无法决定属性值是否大于[ATT_MTU] octets，但是高层协议Can Tell，最大的属性值为512 octets

Atomic Operation

Server应该将Client的每个请求或命令视为不受影像的原子操作。如果一个链路由于某种原因断开，高层协议应当对属性值的修改负责。

Attribute PDU

Attribute PDU格式如下

Opcode：每个Attribute PDU都有一个唯一的操作码，用于区分不同的PDU。
Authentication Signature Flag取值如下：

- 1: PDU包含Authentication Signature(12 octets), X为13 
- 0: PDU不包含Authentication Signature, X为1

当Attribute PDU包含Authentication Signature时，则该PDU不应该通过加密链路传输
Command Flag取值如下：

- 1: PDU为一个Command

注意: 只有Write Command可能包含一个Authentication Signature
Method：ATT使用Protocol Methods来发现、读、写、通知、指示属性，方法可分为如下几种。

 - Requests		: Client->Server, 请求回应 - Responses		: Server->Client, 响应请求. - Commands		: Client->Server, 命令 - Notifications 	: Server->Client, 服务端通知 - Indications		: Server->Client, 请求确认 - Confirmations 	: Client->Server, Ind确认

在下文的每个PDU的格式里面第一个域都是opcode。ATT只有十几个Opcode，所有没有必要为这些Opcode按6种Protocol Methods进行分类，只要知道它们有不同的用法。
ATT是一种Sequential Protocol，这意味着在执行下一个动作前应该得到相应的回应
ATT将Request-Response和Indication-Confirmation Pair看出一个单一的事务(Transaction)

常见的Attribute PDU

Error Handing

Error Response用来声明一个给定的请求无法完成，并给出原因

Error Code取值参考core_v4.2 Vol 3, Part F 3.4.1.1, 若Client无法理解(如ErrorCode为更新版本中定义), 则认为是未知原因。

MTU Exchange

1. Exchange MTU Request
   Client使用MTU Exchange Request来告知所支持的最大接收MTU size，同时请求Server回应Server所支持的最大接收MTU size。
   
   Client Rx MTU>= default ATT_MTU；
   该请求在一个连接中仅发送一次，Client Rx MTU应当设置为Client所能接收ATT PDU的最大值

2. Exchange MTU Response
   Server使用Exchange MTU Response来回应来自Client的Exchange MTU Request
   
   Server Rx MTU>= default ATT_MTU；Server Rx MTU应当设置为Server所能接收ATT PDU的最大值
   当完成Req-Rsp后，Server和Client将ATT_MTU均设置为Client Rx MTU和Server Rx MTU中的较小值
   ATT_MTU生效时机

 - Server : Response发送后、其他ATT PDU发送前 - Client : Response接收后、其他ATT PDU发送前

当其中任一值小于默认ATT_MTU大小时认为该值不正确，此时应当将ATT_MTU设置为默认值
当一个设备同时作为Client和Server，不同角色时ATT_MTU值应当相同(详细规则可参看规范)

3. Find Information
   A. Find Information Request
   Find Information Request被用来获取与Attribute Handles相关联的类型，Client使用该请求来发现Server上的Attribute-Type列表。
   
   读取所有Attributes

 - Starting Handle : 0x0001 - Ending Handle   : 0xFFFF

规则

 - Starting Handle <= Ending Handle : Response PDU或Error Response<Attribute Not Found> - Starting Handle  > Ending Handle : Server回应Error Response<Invalid Handle> - Starting Handle  = 0x0000        : Server回应Error Response<Invalid Handle>

Server不应该回应以下Error Code的Error Response

 - <Insufficient Authentication> - <Insufficient Authorization> - <Insufficient Encryption Key Size> - <Application Error>

B. Find Information Response

Response PDU中应当包含完整的Handle-UUID对；这意味着Handle-UUID对应该在单一的回应报文中；同时Response PDU按照Handle的升序回应。
Format参数有两个可能值


当一个Response PDU无法装下所有的Handle-UUID对时；Client以新的Starting Handle发起另一个Find Information Request来获取未回应的信息。
C. Find By Type Value Request
该Req用来获取指定16-bit UUID Attribute Type和Attribute Value的Attribute Handles

读取所有Attributes

- Starting Handle : 0x0001 
- Ending Handle   : 0xFFFF

其他规则与Find Information Request相似
D. Find by Type Value Response

Handles Information List包含一个或多个Handle Information列表

规则与Find Information Response相似

4. Reading Attributes
   A. Read By Type Request
   Read By Type Request用来获取Attribute Values(Client已知Attribute Type但不知Attribute Handle)
   
   查找所有Attributes

- Starting Handle : 0x0001 
- Ending Handle   : 0xFFFF
TIP : 所有的Attribute Type通过128-bit UUID进行比较，即使提供的是16-bit UUID

规则

- Starting Handle <= Ending Handle : Response PDU或Error Response<Attribute Not Found> 
- Starting Handle  > Ending Handle : Server回应Error Response<Invalid Handle> 
- Starting Handle  = 0x0000        : Server回应Error Response<Invalid Handle>

该报文中Attribute Type的长度应当相同，否则需要重新发起另一次请求
当Client因为安全原因无法访问时，Server应该回应Error Response

- <Insufficient Authentication> 
- <Insufficient Authorization> 
- <Insufficient Encryption Key Size> 
- <Insufficient Encryption>

一些其他权限原因导致无法读时，则回应

- <Read Not Permitted>

B. Read By Type Response

Attribute Data Field字段是Attribute Handle-Value列表

Read By Type Response包含完整的Handle-Value对；这意味着Handle-Value对应该在单一的回应报文中；同时Response PDU按照Handle的升序回应
Handle-Value对的最大长度为255 octets，即Length参数；故最大的Attribute Value为(Length-2)=253 octets
在回应的Handle-Value列表中

- Attribute Value  > (ATT_MTU-4)/253 octets部分 : Client重新请求Read Blob Request来获取 
- Attribute Value <= (ATT_MTU-4)/253 octets部分 : Rsp PDU中回应

C. Read Request
Read Request用来请求Attribute Value

Attribute Handle应该为一个有效的Handle；否则回应Error Response；因安全问题无法访问的回应同Read By Type Request。
D. Read Response

当Attribute Value长度超过(ATT_MTU-1)时，前(ATT_MTU-1) octets应该被回应；Client发起Read Blob Request来获取剩下数据
E. Read Blob Request

用来获取Handle指定Offset的Attribute Value
F. Read Blob Response

当Value Offset等于Attribute Value的长度时，回应0；当Attribute Value大于(Value Offset + ATT_MTU-1)时，回应Attribute Value从Value Offset开始的(ATT_MTU-1)个octets
G. Read Multiple Request
用来请求两个或更多的属性集的值

H. Read Multiple Response

I. Read by Group Type Request
用来请求已知Attribute Type的属性值

J. Read by Group Type Response

Attribute Data格式如下

5. Writing Attributes
   A. Write Request
   用来写属性值
   
   B. Write Response
   用来通知Client属性值已成功写入
   
   C. Write Command
   用来写属性值，通常为Control-Point Attribute
   
   D. Signed Write Command
   用来写属性值，包含一个Authentication Signature，通常为Control-Point Attribute

6. Queued Writes
   将多个属性值写操作以FIFO方式入队，然后再一个原子操作中进行。
   省略。。。。

7. Server Initiated
   A. Handle Value Notification
   Server可以在任何时候向Client发送Attribute Value的通知

B. Handle Value Indication
Server可以发送Attribute Value的指示(Indication)

C. Handle Value Confirmation
用来回应Handle Value Indication，确认Ind已接收