深度专题 D4 · 协议

通信协议与数据模型

协议设计要同时满足三个互相冲突的要求:省电(少发包)、可靠(不丢事件)、可追溯(能当证据)。 解法是:心跳极简、事件必达、字段冗余。

1. 设计原则

① 心跳轻、事件重

心跳只带必要的存活信息(60 s 一次,≤40 字节);事件带完整判定依据(≤200 字节),因为事件是证据。

② 序号 + 时戳双保险

每条上行消息带单调递增 seq 与设备时戳,云端据此去重与排序,解决断网补传的乱序问题。

③ 幂等

同一 event_id 重复上报不产生重复记录;云端按 (dev_id, event_id) 建唯一索引。

④ 向前兼容

Protobuf 字段只增不删;未知字段忽略而非报错,保证老固件与新平台的互操作。

2. 状态消息

表 D4-1 Status 消息字段(topic: belt/{devId}/status,QoS0,60 s)
字段类型含义示例
dev_idstring设备唯一编号(与安全带本体编号绑定)SB01-2026-000123
tsuint64设备时戳(Unix ms)1795321500000
sequint32单调递增序号,用于去重10241
fwstring固件版本1.2.3+build45
batteryuint8电量百分比76
stateenumS0~S4 状态机当前态S2_COMPLIANT
L / dh / dint16厘米为单位,避免浮点传输120 / -85 / 12
confidenceuint8解算置信度 0~10088
buckleuint164 个卡扣的状态位图(每卡 4 bit)0x1234
profile_verstring阈值配置版本Default-v1
rssiint84G 信号强度-87

3. 事件消息

表 D4-2 Event 消息字段(topic: belt/{devId}/event,QoS1)
字段类型含义
event_idstring设备内唯一(dev_id + seq),用于幂等
codeenum事件码(见下表)
leveluint8L0~L4 告警级别
ts_start / ts_enduint64事件起止时间(持续性事件才有 end)
L / dh / dint16触发时刻的实测值(cm)
buckleuint16触发时的卡扣位图
duruint16持续时长(秒)
profile_verstring判定所依据的阈值版本(用于事后复核)
ctxbytes可选上下文:近 5 帧原始测距、姿态角、置信度序列

事件码表

码名称级别触发条件
E01低挂高用L3Δh > −0.30 m 且持续 3 s
E02双钩过近L2L < 0.60 m
E03双钩过远L2L > 2.50 m
E04水平偏移超限L2|d| > 0.50 m
E05卡扣未锁闭L3任一卡扣 state = HALF
E06卡扣检测故障L2任一路读数越界或自检失败
E07单钩超时L3单钩状态 > 8 s
E08未挂钩L2进入作业区但无挂钩受力
E09SOSL4长按 3 s
E10SOS 撤销L1触发后 10 s 内再次按键
E11冲击检测L4合加速度 > 阈值且伴随自由落体特征
E12长时间静止L3姿态无变化 > 5 min 且处于悬挂态
E13低电L1电量 ≤20% / ≤10% / ≤5% 各报一次
E14充放电L0插入/拔出充电座
E15自检失败L3班前自检任一项不通过
E16疑似遮挡L2喇叭回采声压异常低
E17设备摘除L3防拆开关触发或心跳中断 > 10 min
E18信号弱L0RSSI < −105 dBm 持续 1 min
E19OTA 进度L0开始 / 完成 / 回滚
E20参数变更L1阈值配置下发成功

4. 断网补传

主控盒内置 512 KB 环形事件队列(NVS + LittleFS),可存约 2500 条事件,按每天 50 条估算可覆盖 50 天,远超 30 天要求。

阶段行为
检测到断网MQTT 断开 → 事件只写本地,标记 pending;每 30 s 尝试重连(指数退避,上限 5 min)
恢复联网先补传 pending 队列(按 seq 升序,每批 20 条),再发心跳
补传限速每秒 ≤5 条,避免弱网下拥塞;失败重试 3 次后保留
队列满覆盖最旧的 L0/L1 事件,永不覆盖 L3/L4;覆盖行为本身记一条 E13
云端去重按 (dev_id, event_id) 唯一索引,重复上报返回 200 但不重复入库

5. 时间同步

  • 设备开机后通过 MQTT 或 NTP 获取 UTC 时间,误差 <1 s 即可(事件排序用 seq 兜底);
  • UWB 测距帧内携带硬件时戳,保证同一轮三组测距在 30 ms 窗口内完成;
  • 云端同时存 device_ts 与 server_ts,便于分析设备时钟漂移;
  • 设备运行 30 天时钟漂移 >5 s 时,下次联网自动校正并记录。

6. OTA 升级流程

  1. 任务下发

    平台按设备型号/版本筛选目标,创建升级任务,写入 belt/{devId}/ota(含版本号、包大小、SHA-256、分片大小)。

  2. 设备预检

    电量 ≥50%、未在告警中、未在对讲中,才允许开始;否则延后到下一个窗口。

  3. 分片下载

    每片 4 KB,断点续传;下载到备用分区(B 分区),不覆盖运行分区。

  4. 校验与切换

    整包 SHA-256 + 签名校验通过后,写 boot flag,重启进入新固件。

  5. 自检与回滚

    新固件启动后自检传感器与通信,30 s 内未通过则自动回滚到 A 分区并上报 E19(回滚)。

  6. 灰度确认

    平台统计升级成功率,<98% 时暂停任务并告警。

7. 对讲信令

信令方向说明
JOIN上行设备请求加入班组频道(携带 dev_id、session)
PTT_DOWN上行按下 PTT,请求发言权;服务端做抢占仲裁
PTT_GRANT / DENY下行授予/拒绝发言权(有人说话时返回 DENY + 提示音)
PTT_UP上行松开 PTT,释放发言权
INVITE下行SOS 时平台主动拉设备入会(自动接听)
LEAVE双向退出频道 / 超时踢出

8. 安全

层面措施
传输TLS 1.2+(优先 1.3),双向证书认证,禁用弱套件
设备身份一机一证,私钥存于安全区;支持远程吊销
固件ECDSA 签名,启动时校验;调试接口量产熔断
数据语音与位置加密存储;导出需二次授权并留审计日志
指令下行指令带签名与时效(5 min 过期),防重放
一个容易被忽略的细节

事件消息里必须带 profile_ver。因为同一个 Δh 值,在 v1 阈值下是"合规", 在 v2 阈值下可能是"违规"。没有版本号,事后就无法解释"当时为什么没报警"—— 这在事故调查与责任认定中会变成致命缺陷。