docs(vd960Air): 方案B定稿 — hex 封装 + frame_report/frame_cmd 协议设计

用户决策 2026-08-31:
1. 4G 上报格式 = hex 封装
2. 方案 B(原始帧透传)正式采用
3. 0x7D 帧仅保留给配置同步/握手,数据面走 0x7F 帧字节流

新增 §2.1.1:
- 上行 frame_report: data.frame = 0x7F 帧 hex(含魔数/校验),携带 link
- 下行 frame_cmd: data.frame = 0x7F(→Loop)或 0x8F(→DBN 本地)hex
- 协议更新说明清单 5 条(并入《DLD960_IoT_MQTT协议》4G 章节时落实)

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 用户提出)