fix(docs): initialize 消息结构修正 — snake_case + data包装
- extra_Info → extra_info(命名风格统一)
- 字段表加 data.extra_info.* 路径前缀
- JSON 结构统一为 data: {...} 包装,加 ts
This commit is contained in:
@@ -117,6 +117,7 @@ dld960/{dev_serial}/{direction}
|
||||
| `loop_param_set` | 设置车检器多路参数 | srv→dev | 0x63 |
|
||||
| `loop_param_query` | 读取车检器多路参数 | srv→dev | 0x64 |
|
||||
| `report_config` | 设置主动上报 | srv→dev | 0xC5 |
|
||||
| `initialize` | 设备上电初始化登陆 | dev→srv | — |
|
||||
| `loop_data` | 线圈传感数据上报 | dev→srv | 0xC0 |
|
||||
| `event_report` | 事件上报 | dev→srv | — |
|
||||
| `heartbeat` | 设备心跳 | dev→srv | — |
|
||||
@@ -625,7 +626,37 @@ dld960/{dev_serial}/{direction}
|
||||
|
||||
# 5 设备主动上报
|
||||
|
||||
## 5.1 线圈传感数据 `loop_data`
|
||||
## 5.1 设备上电登陆信息 `initialize`
|
||||
> Topic: `dld960/{sn}/dev`
|
||||
> QoS: 0/1
|
||||
|
||||
```json
|
||||
{
|
||||
"msg_id": 1,
|
||||
"cmd": "initialize",
|
||||
"ts": 1719000000,
|
||||
"data": {
|
||||
"dev_serial":"A1B2C3D4E5F6",
|
||||
"extra_info": {
|
||||
"code": "869756049404948",
|
||||
"csq": "21",
|
||||
"location": "113.9237976,022.6400375",
|
||||
"version": "1.0.1"
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
| 字段 | 类型 | 说明 |
|
||||
|------|------|------|
|
||||
| `data.dev_serial` | string | 设备序列码 |
|
||||
| `data.extra_info.code` | string | 可选,设备代码如IMSI/ICCID |
|
||||
| `data.extra_info.csq` | string | 可选,当前信号强度 |
|
||||
| `data.extra_info.location` | string | 可选,经纬度(经度,纬度) |
|
||||
| `data.extra_info.version` | string | 版本号 |
|
||||
|
||||
|
||||
## 5.2 线圈传感数据 `loop_data`
|
||||
|
||||
> Topic: `dld960/{sn}/dev`
|
||||
> QoS: 0/1
|
||||
@@ -711,7 +742,7 @@ dld960/{dev_serial}/{direction}
|
||||
| `misc.type` | string | `"time"`(时间量) / `"cut_count"`(断开次数) / `"flow_count"`(车流量) |
|
||||
| `misc.value` | uint32 | 杂项数值(时间量单位 50ms) |
|
||||
|
||||
## 5.2 事件上报 `event_report`
|
||||
## 5.3 事件上报 `event_report`
|
||||
|
||||
> Topic: `dld960/{sn}/dev`
|
||||
|
||||
@@ -751,7 +782,7 @@ dld960/{dev_serial}/{direction}
|
||||
| `loop_cut` | 线圈断开 | 0 |
|
||||
| `loop_restore` | 线圈恢复 | 断开持续时长 (×50ms) |
|
||||
|
||||
## 5.3 设备心跳 `heartbeat`
|
||||
## 5.4 设备心跳 `heartbeat`
|
||||
|
||||
> Topic: `dld960/{sn}/dev`
|
||||
> 周期:默认 60 秒
|
||||
@@ -786,4 +817,5 @@ dld960/{dev_serial}/{direction}
|
||||
| V1.00 | 2026-06-22 | 初始版本,基于串口协议 V1.01 | wangfq |
|
||||
| V1.01 | 2026-07-07 | Topic 压缩为双主题(`{sn}/srv` + `{sn}/dev`),消息类型由 `cmd` 字段区分 | wangfq |
|
||||
| V1.02 | 2026-07-09 | 缩写相关字段 | wangfq |
|
||||
| V1.03 | 2026-07-09 | 增加设备上电初始化指令 | wangfq |
|
||||
|
||||
|
||||
Reference in New Issue
Block a user