From 1ff731c30987d71f490be0621b9c688fef2f1128 Mon Sep 17 00:00:00 2001
From: wangfq <wangfq@collectpublish.net>
Date: Thu, 9 Jul 2026 19:00:43 +0800
Subject: [PATCH] =?UTF-8?q?fix(docs):=20initialize=20=E6=B6=88=E6=81=AF?=
 =?UTF-8?q?=E7=BB=93=E6=9E=84=E4=BF=AE=E6=AD=A3=20=E2=80=94=20snake=5Fcase?=
 =?UTF-8?q?=20+=20data=E5=8C=85=E8=A3=85?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- extra_Info → extra_info（命名风格统一）
- 字段表加 data.extra_info.* 路径前缀
- JSON 结构统一为 data: {...} 包装，加 ts
---
 docs/DLD960_IoT_MQTT协议.md | 38 ++++++++++++++++++++++++++++++++++---
 1 file changed, 35 insertions(+), 3 deletions(-)

diff --git a/docs/DLD960_IoT_MQTT协议.md b/docs/DLD960_IoT_MQTT协议.md
index da96102..ab4f2ea 100644
--- a/docs/DLD960_IoT_MQTT协议.md
+++ b/docs/DLD960_IoT_MQTT协议.md
@@ -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 |