【ATT】规范精讲[8]:配置要确认、灌包要速度、多字段要原子——BLE 写入的四重选择

在一次真实的手机给手表推送表盘资源的空口记录里,有一组数字我盯着看了很久:整个传输过程中,手机朝手表的 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 是完工证明而非收条,规范要求它在服务器完成写入后才发出,客户端据此即可确认值已落位并释放待确认状态,可安全依赖于持久化配置、触发硬件动作等场景。


相关推荐
AAA修煤气灶刘哥20 分钟前
Agent 都能干活了,软件还需要那么多按钮吗?
人工智能·后端·架构
Purple Coder42 分钟前
开题报告学习
人工智能
狂师1 小时前
牛逼!谷歌亲自下场开源的AI自动化神器!
人工智能·开源·测试
金融小师妹2 小时前
多因子关联模型:黄金与铜价同步回落背后的金融变量及PPI传导分析
大数据·人工智能·金融
ZhengEnCi2 小时前
中美AI竞赛之外其他国家在干什么:算力5%的欧洲、买卡的沙特与做场景的日韩
人工智能·gpu·nvidia
对你无可奈何10 小时前
给 ComfyUI 做了一个手机助手
人工智能
feasibility.11 小时前
英伟达把物理AI的3D模型“应用商店”开放了:2575个SimReady仿真资产,总计约472GB,可让agent装配机器人训练场景
人工智能·3d·机器人·仿真·建模·具身智能·英伟达
智联视频超融合平台12 小时前
消防宣传月过半,“AI+消防“给视频平台换了张考卷
人工智能·边缘计算·视频监控·安防·视频联网
冬奇Lab12 小时前
一天一个开源项目(第262篇):AG-UI —— 把 AI Agent 接进前端的开放协议,和 MCP、A2A 并列的第三块拼图
人工智能·开源