在一次真实的手机给手表推送表盘资源的空口记录里,有一组数字我盯着看了很久:整个传输过程中,手机朝手表的 OTA 数据通道甩出了 4253 条写命令 ,没有等过任何一条响应;而全程带响应的写,只有 7 行,还全是同一个动作------往 CCCD 里写一个两字节的订阅值。
4253 比 7,接近六百倍的悬殊。这不是随手为之,而是 ATT 写家族天生被设计成四种性格迥异的写法,工程师在每一个句柄面前都要做一次选择:我要的是确认、是速度、是身份,还是原子性?这一篇就把这件事讲透。

目录
[1.1 响应必须在真正写完之后发](#1.1 响应必须在真正写完之后发)
[1.2 变长值和定长值,写入语义完全不同](#1.2 变长值和定长值,写入语义完全不同)
[4.1 Prepare 阶段:只排队,不验货,逐笔回显](#4.1 Prepare 阶段:只排队,不验货,逐笔回显)
[4.2 Execute 阶段:0x01 原子提交,0x00 整单取消](#4.2 Execute 阶段:0x01 原子提交,0x00 整单取消)
一、可靠写:写进去了,服务器要亲口答应
最朴素的写法是 Write Request,opcode 0x12,服务器成功处理后回一个空的 Write Response,opcode 0x13。报文结构简单到只有两部分:两字节句柄加上要写入的值。

注意这个 -3:一个字节的 opcode 加两个字节的句柄已经占掉三字节,剩下的才是值的空间。所以 ATT_MTU 协商到多大,一次能写多少字节,是直接绑定的。这也是为什么后面我们在空口看到 495 字节的数据块------MTU 512,扣掉 L2CAP 的开销和 ATT 头,应用层能塞进单包的就这么多。

请求-响应模式意味着它是一个停等事务:客户端发出请求后,在响应或错误到达之前,不能在同一条 bearer 上再发新的请求。这条规则和读家族完全一致,是 ATT 顺序协议的根基。
1.1 响应必须在真正写完之后发
规范在这里的措辞很关键,值得逐字读:
The Write Response shall be sent after the attribute value has been written by the server.
意思是这个响应不是收条,不是我收到了你的请求,而是完工证明。服务器可以在收到写请求后先做持久化、先触发硬件动作、先通知上层 profile,等值真的落位了,才允许发出 0x13。对客户端来说,拿到响应的那一刻,就可以把这笔写从待确认清单里划掉。写固件、写校准参数这种场景,这条时序保证是能直接依赖的。
如果写不进去,服务器回 Error Response,可能出现的错误码包括:0x03 Write Not Permitted(这个属性不可写或需要加密/认证链路)、0x05 Insufficient Authentication、0x08 Insufficient Encryption、0x0C Application Error(高层 profile 定义的错误)、0x0F Write Request Rejected(应用层主动拒绝),以及最常被新手撞上的 0x0D Invalid Attribute Value Length。
1.2 变长值和定长值,写入语义完全不同
0x0D 的背后藏着一套极易被忽略的值长度语义,规范对两类属性分别立了规矩。

对于变长属性(比如字符串、自定义数据块),服务器把值截断或者加长到与参数等长。规范原话:
If the attribute value is variable length and the attribute value parameter length is 0, then the attribute value shall be truncated to zero length.
零长度参数不是什么都不做,而是清空。给一个字符串属性写 0 字节,等价于删除它当前的内容。这个语义在写设备名、写 URL 时经常用到,却也是不少人调试时的迷惑行为来源------我明明发了写,怎么值变空了?因为你发的就是空值。
对于定长属性(比如两字节的 CCCD、四字节的测量间隔),规则相反:当参数长度小于或等于属性值长度时,只把参数的这些字节写到属性开头,其余字节保持不变。只有参数超长,才回 0x0D。这条规则允许你只更新一个固定结构里的前几个字段而不动后半段,是一种很克制的局部写语义。
二、无响应写:发后即忘,把链路让给吞吐

第二种写法是 Write Command,opcode 0x52,结构和 0x12 一模一样,区别全在语义:它没有响应。
规范给它的定位写得很直白:
The Write Command is used to request the server to write the value of an attribute, typically into a control-point attribute.
控制点属性是典型例子------灯光开关、电机启停、OTA 数据灌包,每一笔都等一个确认是奢侈的。命令绕开了停等协议,不占用 outstanding request 的名额,客户端可以一包接一包地连续灌,链路的吞吐被压榨到极限。
代价是可靠性。规范对命令失败的处理只有一个动作:静默忽略。句柄不存在,忽略;没有写权限,忽略;值超长,忽略;服务器内部忙不过来,还是忽略。空口层面看不到任何错误,客户端对这笔写的命运一无所知。这不是缺陷而是契约:你选了速度,就等于签了免责书,可靠性要靠上层协议自己补。

空口数据通道就是活教材:每块 495 字节,全程命令模式,块与块的时间间隔压到 0.3 毫秒级。应用层在通知通道上另起了一套每若干块确认一次的批量 ACK 机制------传输层不保证,应用层自己保证,这是高吞吐 BLE 数据流的标准打法。
三、签名写:不加密,也能验明正身

第三种写法 opcode 0xD2,全称 Signed Write Command,本质仍是无响应命令,但报文尾巴上多了 12 字节的认证签名,值的容量因此变成 0 到 ATT_MTU-15。

它解决的是一个很具体的问题:两台设备已经通过绑定共享了密钥(LTK 派生的签名密钥),但当前连接没加密。如果允许任意主机直接写控制属性,旁边拿个抓包工具伪造一包就能乱动设备;可如果为了写一个开关就启动加密握手,开销又不值当。签名写给出折中------数据不加密,但是携带只有持有共享密钥的一方才算得出来的 CMAC,服务器验证通过才执行。
12 字节签名由两部分组成:4 字节的签名计数器(小端序)加上 8 字节的 AES-128-CMAC。CMAC 的计算输入是 opcode、句柄、值拼接后再追加计数器。规范给了一个完整的数值例子,可以直接用来验证自己的实现:
m = opcode + handle + value = D2 12 00 13 37
计数器 SignCounter = 0x00000001(追加时小端:01 00 00 00)
M = m + 计数器 = D21200133701000000
签名密钥 key = 611B64EBFBCD1FD372EC9196DF425E50
CMAC(padding 后计算) = F20F903C931E87F159B64F012574B4D0
入包签名 = 01000000 F1871E933C900FF2(计数器 + CMAC 前 8 字节小端)
最终报文 = D21200133701000000F1871E933C900FF2
计数器承担防重放职责。服务器为每个已绑定的对端记住最近见过的计数器值,收到一笔旧值或等价值的签名写,直接判定为重放攻击丢弃,连静默忽略都算客气的------这是明确的安全事件。
使用上有两条硬约束。其一,加密链路上每个数据包本身已经被认证,再叠签名纯属浪费;其二,规范明令禁止在 Enhanced ATT bearer(EATT 信用通道)上使用签名写。签名验证失败同样静默忽略,和普通命令一样不回任何东西,防止攻击者从错误响应里探测信息。
四、队列写:先排队验货,再一声令下原子提交
前三种写法都是一笔一笔独立生效的。但现实里有类需求它们都满足不了:我要同时改三个相互联动的参数,要么全改成,要么一个都别动;或者我要写一个远超单包容量的长值,还希望每个分片都有确认。这就是队列写存在的理由。
规范的动机说明是:
The queued write is used to write multiple attributes in a single operation, or to write a long attribute value reliably.
它用两组 PDU 完成一个两阶段事务:Prepare Write Request/Response(0x16/0x17)负责排队,Execute Write Request/Response(0x18/0x19)负责提交或取消。

4.1 Prepare 阶段:只排队,不验货,逐笔回显

Prepare 请求的参数是三要素:句柄、值偏移(2 字节)和本次分片的值(Part Value,0 到 ATT_MTU-5 字节)。偏移从 0 开始,写长值时按分片步进;写多个不同属性时各自带自己的句柄和偏移 0。

服务器收到后做两件事:把这一笔放进 FIFO 队列,然后立刻回 Prepare Response,把句柄、偏移、值原样回显。回显不是形式主义------客户端要逐笔比对响应里的三个字段,确认排队的内容和自己发出的一字不差。链路干扰、服务器异常截断都能在这一步暴露,这正是可靠长写和普通分片写的区别。
这里有个反直觉的设计:Prepare 阶段不做值合法性校验。值超长、偏移越界,排队时都不报错,规范明确说 0x07 Invalid Offset 和 0x0D Invalid Attribute Value Length 只在 Execute 的时候产生。排队就像自助餐把菜端到托盘,没人检查你拿没拿错,到结账那一刻才核对。
排队期间客户端可以继续发别的请求和命令,对同一属性的读、普通写都照常在当前值上发生,仿佛队列不存在。但队列也不受这些动作影响------哪怕期间值被别人改了,Execute 时队列里的旧值照样覆盖写入。同一句柄可以被多次 Prepare,提交时按接收顺序连续生效,等于对同一属性做多次写。
每个客户端在服务器上有一条独立队列,互不干扰;无论用了几条 bearer,同一个客户端只有一条队列。队列容量有限,排满了服务器在 Prepare 阶段就回 0x09 Prepare Queue Full。还有一个细节:如果某笔 Prepare 请求本身无效(比如句柄不存在、没有写权限),服务器回错误,这笔被当作从未收到,已排在队列里的内容不受牵连。
4.2 Execute 阶段:0x01 原子提交,0x00 整单取消

队列排好,客户端发 Execute Write Request,只有一个字节的 Flags:
0x01 :立即写入。服务器按 Prepare 接收顺序把全部队列项一次性写入,所有写动作原子完成,然后清空队列,回一个空的 Execute Response。空队列也回响应。
0x00:取消。队列整体清空,一个值都不写,回响应。这是数据库事务里 ROLLBACK 的味道。

原子性不是口号,规范给失败处理定了严格的全有或全无规则:提交时发现某个值超长,全部队列项丢弃、队列清空、回 0x0D;偏移非法,整批丢弃回 0x07;高层 profile 返回应用错误,清空队列回对应错误码,被写属性的最终状态未定义;如果队列挂着的属性所在的数据库发生了变化(服务表被改),清空队列回 0x12 Database Out Of Sync。一个失败,整批不写,绝不允许一半新一半旧的中间态。
队列的生命周期也值得记住:只有 Execute 能清空它(成功、取消或失败都清),另一条路是 bearer 全部断开------连接一没,队列静默清空且不执行,防止半套配置在重连后意外生效。另外规范坦言,多 bearer 并发 Prepare 的写入顺序不做规定也不通知;如果 Execute 在所有 Prepare Response 都回来之前就发出,尚未确认的那几笔有可能被算进下一批写。实际工程里老老实实等齐回显再提交,就不会踩这个边界。
写入触发的动作完成后,服务器可以用 Notification 或 Indication 通知客户端结果------这也自然引出了下一篇的推送家族。
五、两个可以直接抄走的代码骨架
可靠写配合超时重试,是配置类操作的标准姿势:
// 返回 0 成功;错误码原样上抛;超时才重试(命令类绝不能这么干)
static uint8_t reliable_write(uint16_t handle, const uint8_t *val, uint16_t len)
{
for (int attempt = 0; attempt < 3; attempt++) {
att_write_req(handle, val, len);
uint8_t rsp = wait_att_response(300); // 300ms 超时
if (rsp == ATT_RSP_WRITE) return 0; // 0x13,值已落盘
if (rsp == ATT_ERR_TIMEOUT) continue; // 丢包,可重试
if (rsp == ATT_ERR_PREPARE_QUEUE_FULL) // 0x09 属队列写,这里不会出现
continue;
return rsp; // 0x03/0x0D/0x0F 等重试无意义,直接上抛
}
return ATT_ERR_TIMEOUT;
}
两阶段事务写长值的骨架,注意必须等齐所有回显再提交:
static uint8_t queued_write_long(uint16_t handle, const uint8_t *data,
uint16_t total, uint16_t mtu)
{
uint16_t off = 0;
uint16_t chunk = mtu - 5;
while (off < total) {
uint16_t n = min(chunk, total - off);
att_prepare_write_req(handle, off, data + off, n);
rsp_t *r = wait_prepare_rsp(300);
if (!r || r->handle != handle || r->offset != off ||
r->len != n || memcmp(r->value, data + off, n)) {
att_execute_write_req(0x00); // 回显不符,先取消整单
return ERR_VERIFY;
}
off += n;
}
att_execute_write_req(0x01); // 全部核对通过,原子提交
return wait_execute_rsp(500); // 0x07/0x0D/0x12 都会在这里出现
}
六、回到空口:六千分之一背后的选型逻辑

连接建立后 20 秒,手机先做了两次带响应写:订阅 Service Changed 指示(Indications=Enabled)、订阅数据通道通知(Notifications=Enabled)。这两笔都是 CCCD 配置,必须确认生效------如果订阅没成功,后面的推送通道就是哑的,整个 OTA 无从谈起,所以宁可花一个停等往返。31 毫秒后服务器确认,通知通道开放,紧接着写命令洪流开始,495 字节一包、间隔 0.3 毫秒,4253 包全程不回头。

选型可以浓缩成一句话:配置要确认用 Request,灌数据要速度用 Command,未加密要身份用 Signed Write,多字段或长值要原子用 Queued Write。
写家族到此讲完。下一篇进入服务器主动开口的世界------Notification 为什么可以连发、Indication 为什么必须等 Confirmation、30 秒超时和 EATT 信用怎么改变推送节奏,最后汇总全部 opcode 总表。
七、测验
1.BLE ATT 中 Write Request、Write Command 和 Signed Write Command 的核心区别是什么?高吞吐 OTA 数据流应该选哪种,可靠性如何保证?
参考答案:
三者区别在确认机制与认证。Write Request(0x12)必须得到 Write Response(0x13),且响应在值真正写入后才发,失败有错误码,受停等协议约束;Write Command(0x52)无响应、无流控,任何失败静默忽略;Signed Write Command(0xD2)在命令基础上附加 12 字节 CMAC 签名(4 字节计数器+8 字节 CMAC),值容量为 ATT_MTU-15,禁止在 EATT bearer 上使用,用于已绑定但未加密的链路。OTA 数据流应选 Write Command 换取连续突发吞吐,可靠性由上层协议补偿------典型做法是应用层在通知通道上做周期性批量 ACK、丢块重传,而不是依赖 ATT 逐包确认。
2.(常见于芯片厂 BLE 协议栈岗位)描述 Prepare Write + Execute Write 的完整流程。Execute 返回 0x07 或 0x0D 时已经写入的值会怎样?队列在什么情况下会被清空?
参考答案:
客户端先发若干 Prepare Write Request(0x16),携带句柄、偏移、分片值;服务器把每项放入 FIFO 队列并原样回显(0x17)供逐笔校验,此阶段不校验值长度和偏移;全部排好后发 Execute Write Request(0x18),Flags=0x01 原子提交全部写入,Flags=0x00 取消。提交时若偏移非法回 0x07、值超长回 0x0D,处理方式都是全部队列项丢弃、队列清空、属性保持原状,一个值都不写;应用错误同理清空队列,数据库变化则回 0x12 Database Out Of Sync。队列清空时机:Execute 成功/取消/失败后、bearer 全部断链时。Prepare 阶段队列满回 0x09,单个无效 Prepare 不影响已排队内容。
3.向一个变长字符串属性写 0 字节,和向一个定长四字节属性写 2 字节,结果分别是什么?为什么 Write Response 必须在写入完成后发送?
参考答案:
变长属性写 0 字节,值被截断为零长度,即内容完全清空;定长属性写 2 字节,只覆盖前 2 字节,后 2 字节保持不变,只有参数超过 4 字节才回 0x0D Invalid Attribute Value Length。Write Response 是完工证明而非收条,规范要求它在服务器完成写入后才发出,客户端据此即可确认值已落位并释放待确认状态,可安全依赖于持久化配置、触发硬件动作等场景。