wangfq
181467b9e6
协议 V1.10 (3be9e50) 三处新增落地:
1. dev_info_query 响应 data 补 loop_ver/loop_hw_ver (0x4A 缓存值, 未完成/失败为空串)
2. initialize 上报同样携带 (尽力, 可为空)
3. 新增 §4.25 loop_version_query: 0x4A 异步实时查询, 响应在 iot_verq_poll() 回包
固件:
- loop_uart_proto.h/c: 新增 LoopVerCache + g_lup_ver_cache (0x4A 缓存);
lup_cache_from_info() 写缓存, lup_refresh_version_cache() 后台刷新 (通道空闲才发)
- iot_mqtt_srv.c: dev_info_query/initialize 加字段; loop_version_query 分支
(暂存 msg_id/deadline 300ms, busy 拒绝重复查询); iot_verq_poll() 异步回包
(RESPONSE_READY -> code=0 + 三字段 + 同步刷缓存; TIMEOUT -> code=5 保缓存值);
后台刷新: 上电 iot_mqtt_init + OTA done (iot_ota_report_result ok=1) 置 dirty
关键设计: 版本来源=0x4A 实时查询 (非 OTA 元数据 version=目标版本);
缓存值语义 dev_info_query/initialize 同步回包不等异步; 与 TCP 共用 g_lup_cmd
单命令通道 (后发覆盖, 先发者超时 — 低频命令, 待板上验证时序)
单测: tests/test_iot_loop_ver.c — gcc 隔离 (extract+embed 6 函数 + mock)
44 断言全过: 版本帧解析(正常+4 错误路径) / 缓存写入+格式化(空串/NULL 防护) /
verq_poll 成功回包(code=0+三字段+topic+缓存刷新+通道释放) / 超时回包(code=5+缓存值) /
后台刷新(发起/忙不消费/响应消费/残留超时清理)
验证: check_c_balance.py 3 文件 OK; 待板上验证 UART2 0x4A 与 loop_data 共用总线时序
vd_960 — DLD960 四通道车辆检测器（双 MCU 架构）
当前发布：vd960DBN V1.02.04（2026-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）。
- 支持 OTA：CH32V208 经蓝牙小程序 OTA；AT32F421 经 CH32V208 串口透传 ISP 升级。
- 地感配置存储于 AT32F421，可经 小程序↔BLE↔CH32V208↔UART↔AT32F421 链路读写。
子项目
| 子项目 | 目录 | MCU | 固件版本 | 功能 |
|---|---|---|---|---|
| vd960Loop | vd960Loop/ |
AT32F421 | 1.0 | 线圈驱动、频率采样、车辆检测算法、0x7F 串口上报 |
| vd960DBN | vd960DBN/ |
CH32V208 | 1.02.04 | 蓝牙管理、TCP/IP（WCHNET）、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.10 | 云平台 MQTT | 双主题 {sn}/srv+{sn}/dev、initialize、event_report 平台必答、设备时钟同步、脱机日志（事件/快照流）、Loop 远程 OTA（ota_* 命令，先存后刷） |
| DLD960_BLE协议.md | V1.02 | 蓝牙 BLE | 帧格式 + 分包 + 脱机日志（OFFLOG_STAT/QUERY/CLEAR）+ 传感快照（SNAP_STAT/QUERY/CLEAR，0x28/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） |
开发环境
- vd960Loop：Keil MDK / AT32 IDE（ARM Cortex-M4，ARMCC V5）、FreeRTOS V10.4.3
- vd960DBN：MounRiver Studio（RISC-V）、WCH BLE 协议栈 + WCHNET
- 调试口：Loop MCU TTL Tx（3.3V 9600 8N1）；DBN 侧 PRINT 串口
版本发布流程
- 确认
vd960Loop与vd960DBN固件按同一协议版本联调通过； - 更新两侧
cmcng.h的FIRMWARE_VER； - 更新
CHANGELOG.md与各 devlog 修订记录； - 打 tag（
vX.Y.Z）推送 Gitea，并在 Gitea Releases 挂发布说明与固件产物（hex/bin）。