通信协议与数据模型
协议设计要同时满足三个互相冲突的要求:省电(少发包)、可靠(不丢事件)、可追溯(能当证据)。 解法是:心跳极简、事件必达、字段冗余。
1. 设计原则
① 心跳轻、事件重
心跳只带必要的存活信息(60 s 一次,≤40 字节);事件带完整判定依据(≤200 字节),因为事件是证据。
② 序号 + 时戳双保险
每条上行消息带单调递增 seq 与设备时戳,云端据此去重与排序,解决断网补传的乱序问题。
③ 幂等
同一 event_id 重复上报不产生重复记录;云端按 (dev_id, event_id) 建唯一索引。
④ 向前兼容
Protobuf 字段只增不删;未知字段忽略而非报错,保证老固件与新平台的互操作。
2. 状态消息
| 字段 | 类型 | 含义 | 示例 |
|---|---|---|---|
| dev_id | string | 设备唯一编号(与安全带本体编号绑定) | SB01-2026-000123 |
| ts | uint64 | 设备时戳(Unix ms) | 1795321500000 |
| seq | uint32 | 单调递增序号,用于去重 | 10241 |
| fw | string | 固件版本 | 1.2.3+build45 |
| battery | uint8 | 电量百分比 | 76 |
| state | enum | S0~S4 状态机当前态 | S2_COMPLIANT |
| L / dh / d | int16 | 厘米为单位,避免浮点传输 | 120 / -85 / 12 |
| confidence | uint8 | 解算置信度 0~100 | 88 |
| buckle | uint16 | 4 个卡扣的状态位图(每卡 4 bit) | 0x1234 |
| profile_ver | string | 阈值配置版本 | Default-v1 |
| rssi | int8 | 4G 信号强度 | -87 |
3. 事件消息
| 字段 | 类型 | 含义 |
|---|---|---|
| event_id | string | 设备内唯一(dev_id + seq),用于幂等 |
| code | enum | 事件码(见下表) |
| level | uint8 | L0~L4 告警级别 |
| ts_start / ts_end | uint64 | 事件起止时间(持续性事件才有 end) |
| L / dh / d | int16 | 触发时刻的实测值(cm) |
| buckle | uint16 | 触发时的卡扣位图 |
| dur | uint16 | 持续时长(秒) |
| profile_ver | string | 判定所依据的阈值版本(用于事后复核) |
| ctx | bytes | 可选上下文:近 5 帧原始测距、姿态角、置信度序列 |
事件码表
| 码 | 名称 | 级别 | 触发条件 |
|---|---|---|---|
| E01 | 低挂高用 | L3 | Δh > −0.30 m 且持续 3 s |
| E02 | 双钩过近 | L2 | L < 0.60 m |
| E03 | 双钩过远 | L2 | L > 2.50 m |
| E04 | 水平偏移超限 | L2 | |d| > 0.50 m |
| E05 | 卡扣未锁闭 | L3 | 任一卡扣 state = HALF |
| E06 | 卡扣检测故障 | L2 | 任一路读数越界或自检失败 |
| E07 | 单钩超时 | L3 | 单钩状态 > 8 s |
| E08 | 未挂钩 | L2 | 进入作业区但无挂钩受力 |
| E09 | SOS | L4 | 长按 3 s |
| E10 | SOS 撤销 | 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 | 信号弱 | L0 | RSSI < −105 dBm 持续 1 min |
| E19 | OTA 进度 | 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 升级流程
- 任务下发
平台按设备型号/版本筛选目标,创建升级任务,写入
belt/{devId}/ota(含版本号、包大小、SHA-256、分片大小)。 - 设备预检
电量 ≥50%、未在告警中、未在对讲中,才允许开始;否则延后到下一个窗口。
- 分片下载
每片 4 KB,断点续传;下载到备用分区(B 分区),不覆盖运行分区。
- 校验与切换
整包 SHA-256 + 签名校验通过后,写 boot flag,重启进入新固件。
- 自检与回滚
新固件启动后自检传感器与通信,30 s 内未通过则自动回滚到 A 分区并上报 E19(回滚)。
- 灰度确认
平台统计升级成功率,<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 阈值下可能是"违规"。没有版本号,事后就无法解释"当时为什么没报警"——
这在事故调查与责任认定中会变成致命缺陷。