wangfq/vd_960
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 4 Wiki Activity

docs(vd_960): 产品手册/技术规格书 V1.01→V1.02 配套 DBN V1.02.03

Browse Source 
- 产品手册: BLE OTA 升级链路加固说明 (0x9F 响应帧透传回小程序), 故障排查新增 OTA 失败条目, 固件升级补断电重启提示
- 技术规格书: UART2 RX 0x9F OTA 透传机制 (§2/§5/§7), 协议矩阵/版本配套矩阵更新, 已知约束补 OTA 无自动退出
- README 文档索引 V1.01→V1.02
This commit is contained in:
wangfq
2026-08-19 11:22:17 +08:00
parent 832d2953b0
commit 891ae0077a
3 changed files with 375 additions and 368 deletions
Download Patch File Download Diff File Expand all files Collapse all files
README.md
+2 -2
View File
@@ -49,8 +49,8 @@ DLD960 是一款基于环形线圈检测原理的四通道车辆检测器，支
| 文档 | 版本 | 说明 | | 文档 | 版本 | 说明 |
|------|------|------| |------|------|------|
| [DLD960_产品手册.md](docs/DLD960_产品手册.md) | V1.01 | 面向安装调试与使用：接口、指示灯、线圈施工、配置、故障排查 | | [DLD960_产品手册.md](docs/DLD960_产品手册.md) | V1.02 | 面向安装调试与使用：接口、指示灯、线圈施工、配置、故障排查 |
| [DLD960_技术规格书.md](docs/DLD960_技术规格书.md) | V1.01 | 完整技术参数：检测规格、灵敏度、算法机制、接口、协议矩阵 | | [DLD960_技术规格书.md](docs/DLD960_技术规格书.md) | V1.02 | 完整技术参数：检测规格、灵敏度、算法机制、接口、协议矩阵 |
## 协议文档（docs/） ## 协议文档（docs/）
docs/DLD960_产品手册.md
+7 -2
View File
@@ -1,7 +1,7 @@
# DLD960 四通道车辆检测器 产品手册 # DLD960 四通道车辆检测器 产品手册
> Product Manual · 产品型号：**DLD960GA** > Product Manual · 产品型号：**DLD960GA**
> 文档版本 V1.01 · 2026-08-18 · 适用固件：整机 V1.02.01（Loop 1.0 + DBN 1.02.01） > 文档版本 V1.02 · 2026-08-19 · 适用固件：整机 V1.02.03（Loop 1.0 + DBN 1.02.03）
--- ---
@@ -25,6 +25,7 @@ DLD960 是一款四通道环形线圈车辆检测器，一台设备即可覆盖
- 蓝牙小程序现场配置，双 MCU 均可无线升级（OTA/ISP 透传） - 蓝牙小程序现场配置，双 MCU 均可无线升级（OTA/ISP 透传）
- 以太网双协议：TCP JSON（局域网对接）+ MQTT（云平台），关键事件确认送达 - 以太网双协议：TCP JSON（局域网对接）+ MQTT（云平台），关键事件确认送达
- 通信可靠性加固：串口硬件 DMA 接收 + 固件内存优化，长时间运行稳定不丢帧、不异常重启 - 通信可靠性加固：串口硬件 DMA 接收 + 固件内存优化，长时间运行稳定不丢帧、不异常重启
- BLE OTA 升级链路加固：检测 MCU 升级响应帧（0x9F 协议）完整透传回小程序，停等 ACK 不再丢失，升级成功率提升
## 2. 硬件说明 ## 2. 硬件说明
@@ -131,7 +132,9 @@ DLD960 是一款四通道环形线圈车辆检测器，一台设备即可覆盖
| 通信 MCU | 蓝牙 OTA | 小程序选择固件直接升级 | | 通信 MCU | 蓝牙 OTA | 小程序选择固件直接升级 |
| 检测 MCU | ISP 透传 | 小程序经蓝牙→通信 MCU 串口透传升级 | | 检测 MCU | ISP 透传 | 小程序经蓝牙→通信 MCU 串口透传升级 |
> ⚠ **双 MCU 固件必须使用同一发布包配套升级**（V1.0.0 起为强制要求），只升级一侧会导致内部通信数据错位。当前配套：Loop 1.0 + DBN 1.02.01。 > ⚠ **双 MCU 固件必须使用同一发布包配套升级**（V1.0.0 起为强制要求），只升级一侧会导致内部通信数据错位。当前配套：Loop 1.0 + DBN 1.02.03。
>
> ⚠ **检测 MCU 升级完成后，若小程序无响应，请将设备断电重启**（DBN OTA 透传模式需重启恢复，V1.02.03 已知约束）。
## 7. 故障排查 ## 7. 故障排查
@@ -144,6 +147,7 @@ DLD960 是一款四通道环形线圈车辆检测器，一台设备即可覆盖
| 雨天频繁误报 | 线圈密封失效，频率漂移超阈值 | 基线自适应可吸收慢漂移；快速漂移需重新密封线圈 | | 雨天频繁误报 | 线圈密封失效，频率漂移超阈值 | 基线自适应可吸收慢漂移；快速漂移需重新密封线圈 |
| 继电器输出正常但平台无数据 | 网络配置错误；MQTT Topic/序列码不符 | 查 IP/Broker 配置；核对 dev_serial 与 Topic | | 继电器输出正常但平台无数据 | 网络配置错误；MQTT Topic/序列码不符 | 查 IP/Broker 配置；核对 dev_serial 与 Topic |
| 设备频繁自动重启 / 偶发数据丢失 | 通信 MCU 旧固件资源不足（V1.02.01 已修复） | 升级整机固件至 V1.02.01 及以上版本 | | 设备频繁自动重启 / 偶发数据丢失 | 通信 MCU 旧固件资源不足（V1.02.01 已修复） | 升级整机固件至 V1.02.01 及以上版本 |
| BLE OTA 升级失败/进度卡住 | 通信 MCU 旧固件 0x9F 透传缺陷（V1.02.03 已修复） | 升级整机固件至 V1.02.03 及以上版本 |
| 事件重复上报 | 平台未按协议应答 event_report | 平台须回显 msg_id 应答（先落库后应答） | | 事件重复上报 | 平台未按协议应答 event_report | 平台须回显 msg_id 应答（先落库后应答） |
| 线圈断开告警 | 线圈开路/引线断裂 | 万用表量线圈回路电阻（正常几欧姆以内） | | 线圈断开告警 | 线圈开路/引线断裂 | 万用表量线圈回路电阻（正常几欧姆以内） |
@@ -173,5 +177,6 @@ DLD960 是一款四通道环形线圈车辆检测器，一台设备即可覆盖
| 版本 | 修订时间 | 修订说明 | 修订人 | | 版本 | 修订时间 | 修订说明 | 修订人 |
|------|----------|----------|--------| |------|----------|----------|--------|
| V1.02 | 2026-08-19 | 配套整机发布 V1.02.03：BLE OTA 升级链路加固说明（检测 MCU 0x9F 响应帧透传回小程序，停等 ACK 完整）；故障排查新增 OTA 失败条目；固件升级章节补断电重启提示 | wangfq |
| V1.01 | 2026-08-18 | 配套整机发布 V1.02.01：通信稳定性修复说明（UART2 DMA 防丢帧、异常重启修复）；新增 BLE 脱机日志/传感快照读写说明（§5.1） | wangfq | | V1.01 | 2026-08-18 | 配套整机发布 V1.02.01：通信稳定性修复说明（UART2 DMA 防丢帧、异常重启修复）；新增 BLE 脱机日志/传感快照读写说明（§5.1） | wangfq |
| V1.00 | 2026-07-16 | 初始版本，配套整机发布 V1.0.0 | wangfq | | V1.00 | 2026-07-16 | 初始版本，配套整机发布 V1.0.0 | wangfq |
docs/DLD960_技术规格书.md
+10 -8
View File
@@ -1,7 +1,7 @@
# DLD960 四通道车辆检测器 技术规格书 # DLD960 四通道车辆检测器 技术规格书
> Technical Specification · 产品型号：**DLD960GA** > Technical Specification · 产品型号：**DLD960GA**
> 文档版本 V1.01 · 2026-08-18 · 配套整机发布 V1.02.01 > 文档版本 V1.02 · 2026-08-19 · 配套整机发布 V1.02.03
--- ---
@@ -26,7 +26,7 @@ DLD960 是一款基于环形线圈（LC 振荡）检测原理的四通道车辆
| 职责 | 四路线圈驱动、频率采样、车辆检测算法、继电器输出 | BLE、以太网（TCP JSON / MQTT）、UART TTL（RX DMA）、参数与日志外部存储 | | 职责 | 四路线圈驱动、频率采样、车辆检测算法、继电器输出 | BLE、以太网（TCP JSON / MQTT）、UART TTL（RX DMA）、参数与日志外部存储 |
| RTOS/协议栈 | FreeRTOS V10.4.3 | WCH BLE 协议栈 + WCHNET TCP/IP | | RTOS/协议栈 | FreeRTOS V10.4.3 | WCH BLE 协议栈 + WCHNET TCP/IP |
双 MCU 间通过 TTL 串口互联（0x7F 私有帧协议，波特率 192000bps，UART2 RX 硬件 DMA 循环接收，抗打印关中断丢帧），传感数据主动上推、配置命令透传。 双 MCU 间通过 TTL 串口互联（0x7F 私有帧协议，波特率 192000bps，UART2 RX 硬件 DMA 循环接收，抗打印关中断丢帧），传感数据主动上推、配置命令透传。OTA 升级时 UART2 RX 切换 0x9F 帧协议（DMA poll 按 `g_flag_counter_ota` 模式选择解析器），检测 MCU bootloader 的响应帧（pre_ok/addr_ok/data ACK）经 BLE 完整透传回小程序（V1.02.03）。
## 3. 检测规格 ## 3. 检测规格
@@ -95,12 +95,12 @@ DLD960 是一款基于环形线圈（LC 振荡）检测原理的四通道车辆
|------|------|------| |------|------|------|
| 以太网 | 10M（CH32V208 内置 PHY），支持 DHCP/静态 IP | TCP JSON 服务（默认端口 5960）、IoT MQTT 客户端 | | 以太网 | 10M（CH32V208 内置 PHY），支持 DHCP/静态 IP | TCP JSON 服务（默认端口 5960）、IoT MQTT 客户端 |
| 蓝牙 | BLE（WCH 低功耗蓝牙协议栈） | 小程序配置、OTA 升级、Loop MCU ISP 透传 | | 蓝牙 | BLE（WCH 低功耗蓝牙协议栈） | 小程序配置、OTA 升级、Loop MCU ISP 透传 |
| TTL 串口 | 1 路 | DLD960 内部两个MCU之间 的串口通信协议（Modbus 风格私有帧）；UART2 RX 硬件 DMA 循环接收（抗打印关中断丢帧） | | TTL 串口 | 1 路 | DLD960 内部两个MCU之间 的串口通信协议（Modbus 风格私有帧）；UART2 RX 硬件 DMA 循环接收（抗打印关中断丢帧）；OTA 升级态支持 0x9F 帧透传（V1.02.03） |
| TTL 串口 | 1 路（RFU） | 预留 4G 模块扩展 | | TTL 串口 | 1 路（RFU） | 预留 4G 模块扩展 |
| 外部存储 | SPI NOR Flash | 参数存储 + 日志存储 | | 外部存储 | SPI NOR Flash | 参数存储 + 日志存储 |
| 按键 | K1 多功能按键 | 复位等 | | 按键 | K1 多功能按键 | 复位等 |
### 5.1 协议矩阵（V1.02.01 配套） ### 5.1 协议矩阵（V1.02.03 配套）
| 协议 | 版本 | 通道 | 要点 | | 协议 | 版本 | 通道 | 要点 |
|------|------|------|------| |------|------|------|------|
@@ -141,7 +141,7 @@ DLD960 是一款基于环形线圈（LC 振荡）检测原理的四通道车辆
| 对象 | 方式 | 路径 | | 对象 | 方式 | 路径 |
|------|------|------| |------|------|------|
| 通信 MCU (CH32V208) | BLE OTA | 手机小程序直接升级 | | 通信 MCU (CH32V208) | BLE OTA | 手机小程序直接升级 |
| 检测 MCU (AT32F421) | ISP 透传 | 小程序 → BLE → CH32V208 → UART → AT32F421 | | 检测 MCU (AT32F421) | ISP 透传 | 小程序 → BLE → CH32V208 → UART → AT32F421；UART2 0x9F 停等协议（0xA7 每块必回 ACK），DBN 将 ACK 透传回小程序（V1.02.03） |
## 8. 电气与环境（待整机定型确认） ## 8. 电气与环境（待整机定型确认）
@@ -166,18 +166,19 @@ DLD960 是一款基于环形线圈（LC 振荡）检测原理的四通道车辆
> ⚠ **自内部协议 V1.05 起，vd960Loop 与 vd960DBN 固件必须同版本配套刷写**（variation 字段 2B→3B 帧格式变更，混刷导致数据静默错位）。 > ⚠ **自内部协议 V1.05 起，vd960Loop 与 vd960DBN 固件必须同版本配套刷写**（variation 字段 2B→3B 帧格式变更，混刷导致数据静默错位）。
| 组件 | V1.02.01 配套版本 | | 组件 | V1.02.03 配套版本 |
|------|-------------------| |------|-------------------|
| vd960Loop 固件 | 1.0（不变） | | vd960Loop 固件 | 1.0（不变） |
| vd960DBN 固件 | 1.02.01 | | vd960DBN 固件 | 1.02.03 |
### 10.1 已知约束（V1.02.01） ### 10.1 已知约束（V1.02.01）
- 固件版本三段式：`FIRMWARE_VER="1.02.01"`（MAIN=1 / SUB=2 / SUBSUB=1）；BLE 上报仅 MAIN/SUB 两字节（1.02），SUBSUB 只体现在字符串上报（MQTT/TCP JSON）。 - 固件版本三段式：`FIRMWARE_VER="1.02.03"`（MAIN=1 / SUB=2 / SUBSUB=3）；BLE 上报仅 MAIN/SUB 两字节（1.02），SUBSUB 只体现在字符串上报（MQTT/TCP JSON）。
- 设备无 RTC，时钟同步依赖平台下发（校准前 ts 为上电秒数）。 - 设备无 RTC，时钟同步依赖平台下发（校准前 ts 为上电秒数）。
- CH32V208 RAM 预算：BLE 协议栈固定占用低 16KB（不可裁剪），用户可用 48KB；固件经 RAM 瘦身优化，栈余量约 6KB，现场升级务必使用 V1.02.01 及以上版本。 - CH32V208 RAM 预算：BLE 协议栈固定占用低 16KB（不可裁剪），用户可用 48KB；固件经 RAM 瘦身优化，栈余量约 6KB，现场升级务必使用 V1.02.01 及以上版本。
- 传感快照区延后 3s 初始化（开机 3s 内传感数据不落盘，设计接受）。 - 传感快照区延后 3s 初始化（开机 3s 内传感数据不落盘，设计接受）。
- UART2 RX DMA 占用 DMA1_Ch6（全工程唯一，无冲突）。 - UART2 RX DMA 占用 DMA1_Ch6（全工程唯一，无冲突）。
- **OTA 透传模式无自动退出机制**：进入 OTA 态（`g_flag_counter_ota.flag=1`）后需断电重启才恢复 0x7F 正常通信（V1.02.03 已知约束，升级完成后重启设备）。
--- ---
@@ -185,5 +186,6 @@ DLD960 是一款基于环形线圈（LC 振荡）检测原理的四通道车辆
| 版本 | 修订时间 | 修订说明 | 修订人 | | 版本 | 修订时间 | 修订说明 | 修订人 |
|------|----------|----------|--------| |------|----------|----------|--------|
| V1.02 | 2026-08-19 | 配套整机发布 V1.02.03：UART2 RX 0x9F OTA 透传机制说明（§2/§5/§7）、协议矩阵与版本配套矩阵更新、已知约束补充 OTA 无自动退出 | wangfq |
| V1.01 | 2026-08-18 | 配套整机发布 V1.02.01：版本矩阵更新、UART2 RX DMA 通信可靠性说明、已知约束补充 | wangfq | | V1.01 | 2026-08-18 | 配套整机发布 V1.02.01：版本矩阵更新、UART2 RX DMA 通信可靠性说明、已知约束补充 | wangfq |
| V1.00 | 2026-07-16 | 初始版本，配套整机发布 V1.0.0 | wangfq | | V1.00 | 2026-07-16 | 初始版本，配套整机发布 V1.0.0 | wangfq |