wangfq
d4d57f6487
需求(2026-09-10): 打通 vd960DBN 与 vd960Air(Air780) 两侧串口对接逻辑 ——
DBN 侧 UART1(PB6/PB7) 通道 + UART2↔UART1 双向透传。
协议依据 DLD960_IoT_MQTT协议 §6.1(V1.12 方案C):
上行 Loop 0x7F(UART2) --原样转发--> UART1 --> Air780 解析转 JSON --> MQTT
下行 平台 JSON --> Air780 --转 0x7F 帧--> DBN --0x7F(UART2)--> Loop
DBN 只做字节流透传, 零业务转换; 魔数分流: 0x7F -> UART2, 0x8F -> DBN 本地
实现:
- usart_biz.c +242 行: UART1 通道整段
* uart1_dma_init(): USART1 重映射 PB6(TX)/PB7(RX), 115200 8N1,
RX 走 DMA1_Ch5 循环 512B (UART2 占 Ch6/Ch7, 不冲突)
* uart1_feed_byte()/uart1_frame_ready()/uart1_resync(): 独立帧装配器
* uart1_dispatch_frame(): 按魔数分流
* uart1_dma_poll(): 主循环消费 DMA 缓冲
* uart_srv() 内插入上行转发(484-490): 紧接 lup_process_frame 之后、
InitPkgUart 消费之前, 且只转发 lup_verify_checksum()==0 的完整帧
(位置必须在 BLE 分支改写 pkg[0]=0x8F 之前, 否则会给 Air780 发错魔数帧)
- cmcng.h: 声明 uart1_dma_init/poll + 5 个通道计数
- peripheral_main.c: 主循环加 uart1_dma_poll() (置于 MK_UART_SRV fault marker
之外, 不改变既有 marker 语义)
三个关键决定:
1. 接收走 DMA 而非 RXNE 中断 —— 理由同 UART2 方案A(2026-08-17): PRINT 临界区
关中断 ~7.4ms / BLE 栈回调 / SPI 擦除 45ms 等长阻塞窗口会屏蔽 RXNE 丢字节。
"不丢帧"是 Air780 沿检测(loop_state 变化沿)判车的硬前提。
2. 帧装配器独立于 g_lup_parser —— 后者硬编码专供 UART2/Loop 通道, 两条流混进
同一状态机必然互相残杀; 只复用纯函数 lup_verify_checksum()。
3. 坏帧回找魔数 resync —— 防"单帧损坏 → 后续帧全部失步、链路长时间瞎掉"。
与 printf 共用 USART1 (按用户 2026-09-10 指示: printf 串口不动, 4G 时禁用 debug):
- 开关 UART1_AIR780_EN, 默认 (DEBUG == 0)
- 4G 版本 -DDEBUG=0 编译即自动启用: #if(DEBUG) 为假 -> PRINT 空宏, 且
USART_Printf_Init() 里 USART1 配置分支整段不编译(已核对 USART_Init/USART_Cmd
均在 #if(DEBUG == DEBUG_UART1) 内)
- 调试版本通道为空实现; debug.h/debug.c 一行未改, printf 行为完全不变
验证:
- host 单测: 从 usart_biz.c 原样抽取装配器 + 逐字复刻 loop_uart_proto.c 的
XOR/SUM 校验, gcc -Wall -Wextra -Werror 零警告, 13 组用例全部通过 ——
含"坏帧后紧跟好帧仍送达"、"截断帧后只交付 1 帧完整好帧"、70B 最大帧、
LEN 非法/超长、0x9F(Loop OTA 魔数)忽略、上行闸门只放行校验通过帧
- 待板级验证: 本机无 RISC-V 工具链, 固件编译与实机联调尚未进行
现场核对: 新增 g_uart1_fwd_to_air / _to_loop / _local_cnt / _badchk / _drop
计数, 判据为"g_uart1_fwd_to_air 与 Air780 侧实收帧数相等"
文档: devlog 新增 2026-09-10 条目(含接线说明 PB6/PB7 交叉 + 待办清单)
vd_960 — DLD960 四通道车辆检测器（双 MCU 架构）
当前发布：vd960DBN V1.02.05（2026-08-21，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.05 | 蓝牙管理、TCP/IP（WCHNET）、MQTT、串口桥接、4G 扩展（RFU） |
⚠ 发布约束：自协议 V1.05 起（variation 2B无符号 → 3B有符号），Loop 固件与 DBN 固件必须同版本配套发布，禁止混刷。
产品文档（docs/）
| 文档 | 版本 | 说明 |
|---|---|---|
| DLD960_产品手册.md | V1.03 | 面向安装调试与使用：接口、指示灯、线圈施工、配置、故障排查 |
| DLD960_技术规格书.md | V1.03 | 完整技术参数：检测规格、灵敏度、算法机制、接口、协议矩阵 |
协议文档（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.13 | 云平台 MQTT | 双主题 {sn}/srv+{sn}/dev、initialize（extra_info 含 imei/iccid）、event_report 平台必答、设备时钟同步、脱机日志（事件/快照流）、Loop 远程 OTA（ota_* 命令，先存后刷）、4G 通道适配（方案 C：Air780 协议转换，标准 JSON 命令面 + link，V1.12） |
| DLD960_BLE协议.md | V1.03 | 蓝牙 BLE | 帧格式 + 分包 + 配置命令全表（0x09~0x24/0x31/0x8A/0x92/0xC5，未实现如实标注）+ 脱机日志（OFFLOG_STAT/QUERY/CLEAR）+ 传感快照（SNAP_STAT/QUERY/CLEAR）+ 透传（0x7F/0x9F） |
| 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）。