feat(vd960DBN)+fix(DBNMQTTool): log_query 改 hex 原始字节上报 (2026-08-18)

背景: MQTT 快照流实测 MQTTSerialize_publish failed — JSON 化快照记录 ~810B/条超 800B 发送缓冲方案(用户拍板): 对齐 BLE 通道, 原始字节 hex 上报固件 (V4.3): - offlog.c/h: 新增 offlog_evt_to_hex() (32B→64 hex) - snapshot.c/h: 新增 snap_rec_to_hex() (64B→128 hex); 删 SNAP_MAX_QUERY_JSON, 恢复 count=2 - tcp_json_srv.c / iot_mqtt_srv.c: log_query 改 {"seq":N,"hex":"..."}; SEND_BUF 保持 800 - 2 条快照 hex 响应 406B < 800B 文档: TCP JSON V1.03 / MQTT V1.07 §4.17 records 改 hex + 解析表引用 BLE §6.4/§7 工具: parse_offlog_hex/parse_snap_hex/offlog_payload_desc + hex 展示; 验证: gcc 9 断言 + 工具解析全过 + offscreen UI
2026-08-18 14:04:26 +08:00
parent 5e9b188c6a
commit 5a1893cd1c
15 changed files with 331 additions and 180 deletions
@@ -714,8 +714,9 @@ dld960/{dev_serial}/{direction}
 ## 4.17 分页拉取脱机日志 `log_query`

 > Topic: `dld960/{sn}/srv`
-> **分页按全局序号，不按时间**（未同步段时间不可靠）。`count` 上限按流区分：事件流 **4**（受 MQTT 发布 ≤500B 限制，MSS=576 教训）/ 快照流 **2**（64B×2 记录）。
+> **分页按全局序号，不按时间**（未同步段时间不可靠）。`count` 上限按流区分：事件流 **4** / 快照流 **2**（hex 原始字节上报，体积可控）。
 > 通过 `data.stream` 区分日志流：`event`（缺省）/ `snapshot`。
+> **记录格式为存储原始字节的小写 hex 字符串**（与 BLE 通道直传的二进制同源同语义），平台按《DLD960 BLE 协议》字段表解析。

 **请求：**

@@ -738,7 +739,7 @@ dld960/{dev_serial}/{direction}
 | `start_seq` | uint32 | 起始全局序号（含）；越界（< `seq_first` 或 > `seq_last`）返回空 `records` |
 | `count` | uint8 | 拉取条数；事件流上限 **4**、快照流上限 **2**，超限按各自上限处理；0 按上限处理 |

-**响应 data（stream=event）：**
+**响应 data：**

 ```json
 {
@@ -746,11 +747,7 @@ dld960/{dev_serial}/{direction}
  "records": [
    {
      "seq": 1330,
-      "boot_seq": 2,
-      "ts_ms": 456789,
-      "unix_ts": 1784768575,
-      "type": "iot_ready",
-      "data": null
+      "hex": "a53200000200000001000000..."
    }
  ]
 }
@@ -758,88 +755,17 @@ dld960/{dev_serial}/{direction}

 | 字段 | 类型 | 说明 |
 |------|------|------|
-| `seq` | uint32 | 全局序号 |
-| `boot_seq` | uint16 | 所属启动段 |
-| `ts_ms` | uint32 | boot 内相对时间（ms，断电归零） |
-| `unix_ts` | uint32 | 已同步 Unix 秒；**0 = 未同步**（回算见 §2.3） |
-| `type` | string | 事件类型名（下表） |
-| `data` | object/null | 类型相关参数 |
+| `seq` | uint32 | 全局序号（与 hex 内 offset 4 字段一致，便于快速定位/排序） |
+| `hex` | string | 记录原始字节的小写 hex：事件流 **OfflogEvt 32B → 64 字符**；快照流 **SnapRec 64B → 128 字符**（flash 存储字节原样，小端） |

-**事件类型表：**
+**解析字段表（与 BLE 通道完全一致）：**

-| type | 含义 | data 字段 |
-|------|------|-----------|
-| `boot` | 上电/复位 | `{"rst": 复位原因寄存器原始值}`，位解析：bit31=IWDG(看门狗) bit30=WWDG bit29=LPWR bit26=NRST引脚 bit25=POR(真断电) bit24=软件复位 |
-| `iot_connect` | MQTT TCP 连接成功 | null |
-| `iot_ready` | MQTT 订阅完成 → 发 initialize | null |
-| `iot_disconnect` | MQTT 断连 | `{"reason": N}`，1=断开 2=超时 3=CONNACK拒绝 4=连接超时 |
-| `iot_reconn` | 重连退避 | `{"backoff_ms": 5000}` |
-| `evt_retry` | event_report ACK 超时重发 | `{"msg_id":5,"retry":2}` |
-| `evt_giveup` | event_report 重试耗尽挂起 | `{"msg_id":5}` |
-| `coil` | 线圈事件 | `{"sub":"car_enter","ch":1,"value":97}`；sub: car_enter/car_leave/loop_cut/loop_restore，value 为 50ms 单位时间量 |
-| `time_anchor` | 时钟同步锚点 | null（`unix_ts` 即平台下发值，严格一致） |
-| `log_clear` | 日志清除（审计） | null |
+| 流 | 结构 | 字段表 |
+|----|------|--------|
+| `event` | OfflogEvt 32B | 《DLD960 BLE 协议》§7：magic(0xA5)/type/len/flags/seq/ts_ms/unix_ts/boot_seq/payload(12B)，事件类型与 payload 定义同表 |
+| `snapshot` | SnapRec 64B | 《DLD960 BLE 协议》§6.4：magic(0xA6)/len/flags/seq/ts_ms/boot_seq/coils(4×12B，与 0xC0 线上格式一致) |

-**响应 data（stream=snapshot）：**
-
-```json
-{
-  "start_seq": 12345,
-  "records": [
-    {
-      "seq": 12345,
-      "boot_seq": 2,
-      "ts_ms": 456789,
-      "coil_count": 4,
-      "channels": [
-        {
-          "ch": 1,
-          "freq_level": "high",
-          "direction": 0,
-          "freq_type": 1,
-          "sensitivity": 2,
-          "condition": 0,
-          "loop_ok": true,
-          "has_car": false,
-          "misc_type": "time",
-          "freq": 69418,
-          "variation": 7,
-          "misc": 0
-        }
-      ]
-    }
-  ]
-}
-```
-
-快照记录为 64B 定长原始结构 `SnapRec`（与 0xC0 线上线圈单元逐字节一致，见《DLD960Loop 串口通信协议》§3.07），JSON 化后字段：
-
-| 记录字段 | 类型 | 说明 |
-|----------|------|------|
-| `seq` | uint32 | 全局序号（跨 boot 递增） |
-| `boot_seq` | uint16 | 所属启动段 |
-| `ts_ms` | uint32 | boot 内相对时间（ms，采集时刻） |
-| `coil_count` | uint8 | 本记录线圈数（SnapRec.len/12，1~4） |
-| `channels` | array | 线圈传感单元（每路 12B，与 0xC0 线上格式一致） |
-
-`channels[]` 单元字段（与 0xC0 传感单元一致）：
-
-| 字段 | 类型 | 说明 |
-|------|------|------|
-| `ch` | uint8 | 通道号 1~4 |
-| `freq_level` | string | 频率档位：`"high"`(33nF) / `"mid_high"`(43nF) / `"mid_low"`(66nF) / `"low"`(76nF) |
-| `direction` | uint8 | 0=触发模式 1=方向判别 |
-| `freq_type` | uint8 | 0=初始频率 1=当前实时频率 |
-| `sensitivity` | uint8 | 灵敏度等级（cfg 低四位） |
-| `condition` | uint8 | 环境评估值（cond 高四位，值越大干扰越大） |
-| `loop_ok` | bool | 线圈正常（SnapRec loop_state bit：0=正常→true，1=断开→false） |
-| `has_car` | bool | 有车（SnapRec car_state bit：1=有车） |
-| `misc_type` | string | `"time"` / `"cut_count"` / `"flow_count"` / `"relay_count"`（00 时间量 / 01 线圈断开次数 / 10 车流量 / 11 继电器输出次数） |
-| `freq` | uint32 | 线圈频率（Hz，3B LE 无符号） |
-| `variation` | int32 | 变化量（3B LE 有符号补码，`Origin − CAPVD`；正=车/裕量，负=反向漂移） |
-| `misc` | uint32 | 杂项值（misc_type=time 时 = 通过时间/车间距，**50ms 单位**） |
-
-> 绝对时间回算同事件流：用事件流 `time_anchor`（boot_seq ↔ unix_ts 映射）+ 本记录 `boot_seq`/`ts_ms`；未同步段仅相对时间。
+> 时间戳语义同事件流：`unix_ts` 为已同步 Unix 秒（0=未同步），绝对时间用事件流 `time_anchor` 锚点回算（见 §2.3）。

 ---

@@ -1127,5 +1053,5 @@ dld960/{dev_serial}/{direction}
 | V1.04 | 2026-07-15 | `event_report` 增加**平台必答**机制：应答格式（回显 `msg_id`）、设备 5s 超时重发（同 `msg_id`/`ts`，最多 3 次）、待发队列合并上报、平台去重与先落库后应答要求 | wangfq |
 | V1.05 | 2026-07-15 | 增加**设备时钟同步**（§2.3，方案B）：设备无 RTC，`initialize` 上线后平台经 `report_config` 命令下发 Unix `ts`，设备据此校准，之后上行 `ts` 为真实 Unix 时间；校准前为上电秒数 | wangfq |
 | V1.06 | 2026-08-04 | 增加**脱机事件日志**命令：`log_stat`（统计/分页定位）、`log_query`（按全局序号分页，count≤4）、`log_clear`（清除+审计留痕）；§2.3 补充日志双时间戳语义（`ts_ms` 相对 + `unix_ts` 已同步，0=未同步，锚点回算规则） | wangfq |
-| V1.07 | 2026-08-18 | `log_stat` / `log_query` / `log_clear` 增加**快照流**支持（`stream=snapshot`，与 BLE 0x28/0x29/0x2A 同语义）：快照统计 capacity 随芯片动态（48064~449472）、快照分页 count≤2（SnapRec 64B 原始结构 JSON 化）、快照清除审计留痕；`capacity`/`count` 类型修正为 uint32（W25Q256 事件流 130944 超 16bit） | wangfq |
+| V1.07 | 2026-08-18 | `log_stat` / `log_query` / `log_clear` 增加**快照流**支持（`stream=snapshot`，与 BLE 0x28/0x29/0x2A 同语义）：快照统计 capacity 随芯片动态（48064~449472）、快照分页 count≤1（4 通道记录 JSON ~810B 超发送缓冲，实测修正；BLE 原始通道仍 ≤2）、快照清除审计留痕；`capacity`/`count` 类型修正为 uint32（W25Q256 事件流 130944 超 16bit） | wangfq |