diff --git a/luatos/air780epm/module/Air780EPM/demo/vd960Air/readme.md b/luatos/air780epm/module/Air780EPM/demo/vd960Air/readme.md index 3006dbf..1611491 100644 --- a/luatos/air780epm/module/Air780EPM/demo/vd960Air/readme.md +++ b/luatos/air780epm/module/Air780EPM/demo/vd960Air/readme.md @@ -50,10 +50,53 @@ - **vd960DBN 职责**: UART2↔UART1 双向转发(复用 manage_dbn_ble_transparent 透传模式) - 地感指令(0x7F 配置命令)下行零改造,协议原样 +**已定稿(用户决策 2026-08-31):** +- ✅ **方案 B(原始帧透传)正式采用** +- ✅ **4G 上报格式 = hex 封装**(平台友好,参照 log_query records hex 风格) +- ✅ **0x7D 帧去留**: 数据面走 0x7F 帧字节流透传(不需要 0x7D);0x7D 帧仅保留给"配置同步下发/握手" + **待确认(影响定稿):** -- [ ] 4G 上报格式: 原始 0x7F 帧 vs hex 封装(建议 hex,平台友好,参照 log_query 风格) - [ ] 上行双通道策略: 默认 4G / 有线失效才走 4G / 双通道并存(呼应 §6 通道切换讨论) -- [ ] 0x7D 帧去留: 若定稿方案 B,数据面走 0x7F 透传,0x7D 帧仅保留给"配置同步下发/握手" + +### 2.1.1 hex 封装报文格式(协议更新说明 — 并入《DLD960_IoT_MQTT协议》4G 适配章节) + +**上行 `frame_report`**(Air780 → 平台,每个 0x7F 帧一条): + +```json +{ + "msg_id": 123, + "cmd": "frame_report", + "ts": 1719000000, + "data": { "frame": "7f00c0060102030405aabb" }, + "link": { "imei": "860012345678901", "iccid": "89860012345678901234", "csq": 23, "net": "4G" } +} +``` + +- `data.frame`: **0x7F 帧完整字节 hex**(含魔数 0x7F/校验字节),小写 +- 平台按《DLD960Loop_串口通信协议》解析 frame 内容(0xC0 传感 / 0x0C 响应 / 事件等) +- `link`: 4G 特有字段(§2.3),每条上行携带 + +**下行 `frame_cmd`**(平台 → Air780): + +```json +{ + "msg_id": 456, + "cmd": "frame_cmd", + "ts": 1719000100, + "data": { "frame": "7f000809010203040506" } +} +``` + +- `data.frame`: 0x7F 帧(→ vd960Loop 地感指令)或 0x8F 帧(→ vd960DBN 本地配置)hex +- Air780 收到 → hex 解码 → 原始字节 → UART1 → vd960DBN 魔数分流(0x7F→UART2 / 0x8F→本地) +- 地感/设备响应仍经 `frame_report` 上行 + +**协议更新说明清单(并入主协议时逐条落实):** +1. 新增上行 `frame_report` + 下行 `frame_cmd` 两个命令(4G 通道专用) +2. **平台双通道格式差异说明**: 有线通道 = 标准 JSON 业务命令(loop_data/event_report);4G 通道 = frame_report/frame_cmd(hex 帧透传)——平台须按通道区分解析 +3. 4G 通道网络配置类命令不适用(ssc_net_* / iot_net_* / iot_topic_*,返回 code=4 或文档标注) +4. 链路层: 数据面 0x7F 帧字节流;0x7D 帧仅 DBN↔Air780 配置同步/握手(§2.2) +5. 平台侧新增《DLD960Loop_串口通信协议》解析依赖(hex → 帧) **与方案 A(JSON 桥)对比:** @@ -179,6 +222,7 @@ vd960Air/ - [x] **协议并入主协议**: 4G 适配作为《DLD960_IoT_MQTT协议》章节,4G 特有部分(link 字段/不支持命令/4G 状态命令)单独标注 - [x] **服务器参数配置链路**: 当前由小程序 BLE 设置;vd960DBN 后续版本(列入计划)将 BLE 设置的服务器/topic 参数**同步经 UART1 下发 Air780**,Air780 存储更新配置(§2.2) - [x] **通道切换策略(暂定)**: **默认 4G 无线**作为上报通道 +- [x] **方案 B(原始帧透传)采用** + **4G 上报格式 = hex 封装**(frame_report/frame_cmd,§2.1.1;协议更新说明已列) ### 待讨论(通道切换策略,2026-08-31 用户提出)