Files
vd_960/README.md
T
wangfq 51298693da fix(vd960DBN): OTA 刷写成功误判未启动 — 状态回 idle + 补 ota_report 主动上报
现场: 远程平台发起 OTA, 设备物理刷写成功 (70块全ACK, flash DONE),
但平台 ota_status 轮询只见 state=ready → 误判'刷写未启动'。

根因:
1. ota_flash_done 刷写成功后台侧状态置 READY (与协议状态机
   'FLASHING──成功──▶IDLE(清槽/保留)' 不符), 平台无法区分
   '待刷 ready' 与 '已刷完' → 持续 ready 判未启动
2. 固件漏实现协议 §5.5 ota_report 主动上报 (done/failed 重发 3次×5s),
   平台收不到成功信号, 只能靠 ota_status 轮询兜底

修复 (协议 V1.09 + 固件):
- 协议: 刷写成功状态明确回 idle (镜像保留, last_result=0, 可重刷);
  ota_report 升级为刷写结果主依据; 平台判定指引 (idle+size>0+last_result=0
  =成功; 不得以轮询未见 flashing 或持续 ready 判未启动)
- ota_srv.c: ota_flash_done → OTA_STATE_IDLE (镜像保留) + 上报 done;
  ota_flash_fail → 补 ota_report failed (保留 event_report 告警);
  ota_cmd_begin 兼容 idle+size/crc32 一致 → 直接回 ready (免下载重刷)
- iot_mqtt_srv.c: 新增 ota_report 上报状态机 (立即首发 + 5s×3 重发,
  同 msg_id/ts), 共享 _iot_pub_payload (event_report 复用, RAM 零新增)
- 单测: test_flash_flow/test_flash_ready_timeout 断言 ota_report 上报,
  state 断言 READY→IDLE; 新增 test_begin_reflash; 10/10 全过 + 22 py 断言
2026-08-20 18:56:21 +08:00

6.2 KiB
Raw Blame History

vd_960 — DLD960 四通道车辆检测器(双 MCU 架构)

当前发布:vd960DBN V1.02.042026-08-19,DBN 单侧更新)· 完整版本见 CHANGELOG.md

产品概述

DLD960 是一款基于环形线圈检测原理的四通道车辆检测器,支持网口(TCP JSON / IoT MQTT)、蓝牙(小程序配置 + OTA)、4G 扩展(RFU),面向停车场出入口控制、流量计数、会车控制等场景。

产品型号:DLD960GA

硬件架构(双 MCU

                    ┌─────────────────────────────────────────┐
  线圈1~4 ──────────►  AT32F421 (vd960Loop)                    │
  (TMR3 输入捕获)    │  · 四路线圈驱动/频率采样                  │
  继电器1~4 ◄───────│  · 车辆检测算法(IIR/斜率限幅/基线跟踪)    │
                    └───────────────┬─────────────────────────┘
                                    │ UART 0x7F 协议 @192000
                    ┌───────────────▼─────────────────────────┐
  蓝牙(小程序) ◄────►  CH32V208 (vd960DBN)                     │
  网口 ETH    ◄────►│  · TCP JSON :5960 / IoT MQTT 双主题       │
  4G(RFU)     ◄────►│  · BLE 配置 + OTA、Loop MCU ISP 透传      │
                    │  · 参数/日志外部存储                       │
                    └─────────────────────────────────────────┘
芯片 型号 主频 Flash SRAM 职责
检测 MCU AT32F421 (Cortex-M4) 120MHz 64KB 16KB 四路线圈信号采集与车辆检测算法
通信 MCU CH32V208 (RISC-V) 144MHz(实际 120MHz 128KB 64KB 蓝牙、网口、双路 TTL 串口(内部互联 + 4G 扩展)、外部存储
  • 四路线圈、四个双路继电器,每路线圈两级调频电容(33nF/10nF)。
  • 支持 OTACH32V208 经蓝牙小程序 OTAAT32F421 经 CH32V208 串口透传 ISP 升级。
  • 地感配置存储于 AT32F421,可经 小程序↔BLE↔CH32V208↔UART↔AT32F421 链路读写。

详见 docs/DLD960硬件资源.md

子项目

子项目 目录 MCU 固件版本 功能
vd960Loop vd960Loop/ AT32F421 1.0 线圈驱动、频率采样、车辆检测算法、0x7F 串口上报
vd960DBN vd960DBN/ CH32V208 1.02.04 蓝牙管理、TCP/IPWCHNET)、MQTT、串口桥接、4G 扩展(RFU)

⚠ 发布约束:自协议 V1.05 起(variation 2B无符号 → 3B有符号),Loop 固件与 DBN 固件必须同版本配套发布,禁止混刷。

产品文档(docs/

文档 版本 说明
DLD960_产品手册.md V1.02 面向安装调试与使用:接口、指示灯、线圈施工、配置、故障排查
DLD960_技术规格书.md V1.02 完整技术参数:检测规格、灵敏度、算法机制、接口、协议矩阵

协议文档(docs/

文档 版本 适用层 说明
DLD960Loop_串口通信协议.md V1.05 Loop MCU ↔ DBN MCU 0x7F 帧、0xC0 传感主动上报、variation 3B 有符号
DLD960_串口通信协议.md V1.01 整机 TTL 串口 设备管理、参数配置、数据上报
DLD960_TCP_JSON协议.md V1.03 以太网 TCP :5960 鉴权 + 命令 + event_report 客户端必答 + 脱机日志(事件/快照流)
DLD960_IoT_MQTT协议.md V1.09 云平台 MQTT 双主题 {sn}/srv+{sn}/dev、initialize、event_report 平台必答、设备时钟同步、脱机日志(事件/快照流)、Loop 远程 OTA(ota_* 命令,先存后刷)
DLD960_BLE协议.md V1.02 蓝牙 BLE 帧格式 + 分包 + 脱机日志(OFFLOG_STAT/QUERY/CLEAR+ 传感快照(SNAP_STAT/QUERY/CLEAR0x28/0x29/0x2A),与 MQTT/TCP 同语义
DLD960硬件资源.md 硬件 双 MCU IO 分配、继电器、指示灯、拨码

开发文档

文档 说明
vd960Loop/docs/devlog.md 检测算法开发日志(IIR、斜率限幅、基线冻结、时间量单位演进)
vd960DBN/docs/devlog.md 通信固件开发日志(WCHNET、MQTT 稳定性、event_report 可靠上报)
vd960Loop/docs/acceptance-standard.md 检测算法验收标准
vd960Loop/docs/variation-analysis.md variation 上报量分析报告(基线 vs 当前值三时钟关系)
vd960DBN/docs/incidents/ 现场事故分析归档

配套工具

工具 目录 说明
DBNetClient DBNetClient/ TCP JSON 协议桌面测试工具(Python + tkinter,零第三方依赖)
DBNMQTTool DBNMQTTool/ IoT MQTT 协议测试工具(Python + PySide6 + paho-mqtt,双主题 UI

开发环境

  • vd960LoopKeil MDK / AT32 IDEARM Cortex-M4ARMCC V5)、FreeRTOS V10.4.3
  • vd960DBNMounRiver StudioRISC-V)、WCH BLE 协议栈 + WCHNET
  • 调试口:Loop MCU TTL Tx3.3V 9600 8N1);DBN 侧 PRINT 串口

版本发布流程

  1. 确认 vd960Loopvd960DBN 固件按同一协议版本联调通过;
  2. 更新两侧 cmcng.hFIRMWARE_VER
  3. 更新 CHANGELOG.md 与各 devlog 修订记录;
  4. 打 tagvX.Y.Z)推送 Gitea,并在 Gitea Releases 挂发布说明与固件产物(hex/bin)。