diff --git a/README.md b/README.md index 3644ec1..fceb9c4 100644 --- a/README.md +++ b/README.md @@ -49,8 +49,8 @@ DLD960 是一款基于环形线圈检测原理的四通道车辆检测器，支 | 文档 | 版本 | 说明 | |------|------|------| -| [DLD960_产品手册.md](docs/DLD960_产品手册.md) | V1.02 | 面向安装调试与使用：接口、指示灯、线圈施工、配置、故障排查 | -| [DLD960_技术规格书.md](docs/DLD960_技术规格书.md) | V1.02 | 完整技术参数：检测规格、灵敏度、算法机制、接口、协议矩阵 | +| [DLD960_产品手册.md](docs/DLD960_产品手册.md) | V1.03 | 面向安装调试与使用：接口、指示灯、线圈施工、配置、故障排查 | +| [DLD960_技术规格书.md](docs/DLD960_技术规格书.md) | V1.03 | 完整技术参数：检测规格、灵敏度、算法机制、接口、协议矩阵 | ## 协议文档（docs/） diff --git a/docs/DLD960_产品手册.md b/docs/DLD960_产品手册.md index 6566133..8b05cf6 100644 --- a/docs/DLD960_产品手册.md +++ b/docs/DLD960_产品手册.md @@ -1,7 +1,7 @@ # DLD960 四通道车辆检测器 产品手册 > Product Manual · 产品型号：**DLD960GA** -> 文档版本 V1.02 · 2026-08-19 · 适用固件：整机 V1.02.04（Loop 1.0 + DBN 1.02.04） +> 文档版本 V1.03 · 2026-08-21 · 适用固件：整机 V1.02.05（Loop 1.0 + DBN 1.02.05） --- @@ -26,6 +26,8 @@ DLD960 是一款四通道环形线圈车辆检测器，一台设备即可覆盖 - 以太网双协议：TCP JSON（局域网对接）+ MQTT（云平台），关键事件确认送达 - 通信可靠性加固：串口硬件 DMA 接收 + 固件内存优化，长时间运行稳定不丢帧、不异常重启 - BLE OTA 升级链路加固：检测 MCU 升级响应帧（0x9F 协议）完整透传回小程序，停等 ACK 不再丢失，升级成功率提升 +- 网络上报携带地感版本：云平台可实时核对地感固件/硬件版本（MQTT `loop_version_query`，配合远程 OTA 升级前后版本核对） +- 联网稳定性加固：MQTT 发送退避与断连重连修复，长时间联网不掉线、不死循环 ## 2. 硬件说明 @@ -132,7 +134,7 @@ DLD960 是一款四通道环形线圈车辆检测器，一台设备即可覆盖 | 通信 MCU | 蓝牙 OTA | 小程序选择固件直接升级 | | 检测 MCU | ISP 透传 | 小程序经蓝牙→通信 MCU 串口透传升级 | -> ⚠ **双 MCU 固件必须使用同一发布包配套升级**（V1.0.0 起为强制要求），只升级一侧会导致内部通信数据错位。当前配套：Loop 1.0 + DBN 1.02.04。 +> ⚠ **双 MCU 固件必须使用同一发布包配套升级**（V1.0.0 起为强制要求），只升级一侧会导致内部通信数据错位。当前配套：Loop 1.0 + DBN 1.02.05。 > > ⚠ **检测 MCU 升级完成后，若小程序无响应，请将设备断电重启**（DBN OTA 透传模式需重启恢复，V1.02.03 已知约束）。 @@ -148,7 +150,7 @@ DLD960 是一款四通道环形线圈车辆检测器，一台设备即可覆盖 | 继电器输出正常但平台无数据 | 网络配置错误；MQTT Topic/序列码不符 | 查 IP/Broker 配置；核对 dev_serial 与 Topic | | 设备频繁自动重启 / 偶发数据丢失 | 通信 MCU 旧固件资源不足（V1.02.01 已修复） | 升级整机固件至 V1.02.01 及以上版本 | | BLE OTA 升级失败/进度卡住 | 通信 MCU 旧固件 0x9F 透传缺陷（V1.02.03 已修复） | 升级整机固件至 V1.02.03 及以上版本 | -| 配置无法保存/每次上电恢复出厂 | 旧固件 factory 写入被禁用；换新存储芯片后参数区无出厂配置（V1.02.04 已修复） | 升级整机固件至 V1.02.04 及以上版本 | +| 配置无法保存/每次上电恢复出厂 | 旧固件 factory 写入被禁用；换新存储芯片后参数区无出厂配置（V1.02.04 已修复） | 升级整机固件至 V1.02.05 及以上版本 | | 事件重复上报 | 平台未按协议应答 event_report | 平台须回显 msg_id 应答（先落库后应答） | | 线圈断开告警 | 线圈开路/引线断裂 | 万用表量线圈回路电阻（正常几欧姆以内） | @@ -168,7 +170,7 @@ DLD960 是一款四通道环形线圈车辆检测器，一台设备即可覆盖 | 《DLD960 技术规格书》 | 完整技术参数 | | 《DLD960 串口通信协议》V1.01 | 串口 对接开发 | | 《DLD960 TCP JSON 协议》V1.03 | 局域网对接开发 | -| 《DLD960 IoT MQTT 协议》V1.07 | 云平台对接开发 | +| 《DLD960 IoT MQTT 协议》V1.10 | 云平台对接开发（含 Loop 远程 OTA 与地感版本查询） | | 《DLD960 BLE 协议》V1.02 | 蓝牙小程序/APP 对接开发（脱机日志与传感快照读写） | | 《环路车辆检测器验收标准》 | 采购/部署验收 | @@ -178,6 +180,7 @@ DLD960 是一款四通道环形线圈车辆检测器，一台设备即可覆盖 | 版本 | 修订时间 | 修订说明 | 修订人 | |------|----------|----------|--------| +| V1.03 | 2026-08-21 | 配套整机发布 V1.02.04→V1.02.05：核心特性补网络上报携带地感版本 + 联网稳定性加固；相关文档表 MQTT 协议 V1.07→V1.10（修正滞后）；故障排查配置保存建议升至 V1.02.05 及以上 | wangfq | | V1.02 | 2026-08-19 | 配套整机发布 V1.02.03→V1.02.04：BLE OTA 升级链路加固说明（0x9F 响应帧透传，停等 ACK 完整）；故障排查新增 OTA 失败 + 配置无法保存条目；固件升级补断电重启提示；存储兼容适配（去厂商代码 + 恢复 factory 写入） | wangfq | | V1.01 | 2026-08-18 | 配套整机发布 V1.02.01：通信稳定性修复说明（UART2 DMA 防丢帧、异常重启修复）；新增 BLE 脱机日志/传感快照读写说明（§5.1） | wangfq | | V1.00 | 2026-07-16 | 初始版本，配套整机发布 V1.0.0 | wangfq | diff --git a/docs/DLD960_技术规格书.md b/docs/DLD960_技术规格书.md index ef033f4..ed15a9e 100644 --- a/docs/DLD960_技术规格书.md +++ b/docs/DLD960_技术规格书.md @@ -1,7 +1,7 @@ # DLD960 四通道车辆检测器 技术规格书 > Technical Specification · 产品型号：**DLD960GA** -> 文档版本 V1.02 · 2026-08-19 · 配套整机发布 V1.02.04 +> 文档版本 V1.03 · 2026-08-21 · 配套整机发布 V1.02.05 --- @@ -100,7 +100,7 @@ DLD960 是一款基于环形线圈（LC 振荡）检测原理的四通道车辆 | 外部存储 | SPI NOR Flash | 参数存储 + 日志存储 | | 按键 | K1 多功能按键 | 复位等 | -### 5.1 协议矩阵（V1.02.04 配套） +### 5.1 协议矩阵（V1.02.05 配套） | 协议 | 版本 | 通道 | 要点 | |------|------|------|------| @@ -166,19 +166,20 @@ DLD960 是一款基于环形线圈（LC 振荡）检测原理的四通道车辆 > ⚠ **自内部协议 V1.05 起，vd960Loop 与 vd960DBN 固件必须同版本配套刷写**（variation 字段 2B→3B 帧格式变更，混刷导致数据静默错位）。 -| 组件 | V1.02.04 配套版本 | +| 组件 | V1.02.05 配套版本 | |------|-------------------| | vd960Loop 固件 | 1.0（不变） | -| vd960DBN 固件 | 1.02.04 | +| vd960DBN 固件 | 1.02.05 | ### 10.1 已知约束（V1.02.01） -- 固件版本三段式：`FIRMWARE_VER="1.02.04"`（MAIN=1 / SUB=2 / SUBSUB=4）；BLE 上报仅 MAIN/SUB 两字节（1.02），SUBSUB 只体现在字符串上报（MQTT/TCP JSON）。 +- 固件版本三段式：`FIRMWARE_VER="1.02.05"`（MAIN=1 / SUB=2 / SUBSUB=5）；BLE 上报仅 MAIN/SUB 两字节（1.02），SUBSUB 只体现在字符串上报（MQTT/TCP JSON）。 - 设备无 RTC，时钟同步依赖平台下发（校准前 ts 为上电秒数）。 - CH32V208 RAM 预算：BLE 协议栈固定占用低 16KB（不可裁剪），用户可用 48KB；固件经 RAM 瘦身优化，栈余量约 6KB，现场升级务必使用 V1.02.01 及以上版本。 - 传感快照区延后 3s 初始化（开机 3s 内传感数据不落盘，设计接受）。 - UART2 RX DMA 占用 DMA1_Ch6（全工程唯一，无冲突）。 - **OTA 透传模式无自动退出机制**：进入 OTA 态（`g_flag_counter_ota.flag=1`）后需断电重启才恢复 0x7F 正常通信（V1.02.03 已知约束，升级完成后重启设备）。 +- **UART2 0x4A 版本查询与 `loop_data`/事件上报共用总线**：低频命令理论无冲突，时序待板上验证（V1.02.05）。 --- @@ -186,6 +187,7 @@ DLD960 是一款基于环形线圈（LC 振荡）检测原理的四通道车辆 | 版本 | 修订时间 | 修订说明 | 修订人 | |------|----------|----------|--------| +| V1.03 | 2026-08-21 | 配套整机发布 V1.02.04→V1.02.05：协议矩阵标题/版本配套矩阵/固件三段式版本同步；新增已知约束 UART2 0x4A 版本查询总线时序；MQTT V1.10 地感版本上报与 loop_version_query 说明 | wangfq | | V1.02 | 2026-08-19 | 配套整机发布 V1.02.03→V1.02.04：UART2 RX 0x9F OTA 透传机制说明（§2/§5/§7）、协议矩阵与版本配套矩阵更新、已知约束补充 OTA 无自动退出；存储适配（SPI 识别去厂商代码 + factory 写入恢复）；2026-08-20 协议矩阵 MQTT 同步 V1.08（Loop 远程 OTA 协议设计先行，固件待实现，Slot A/B 100KB） | wangfq | | V1.01 | 2026-08-18 | 配套整机发布 V1.02.01：版本矩阵更新、UART2 RX DMA 通信可靠性说明、已知约束补充 | wangfq | | V1.00 | 2026-07-16 | 初始版本，配套整机发布 V1.0.0 | wangfq |