feat(vd960DBN): UART1 ↔ Air780 4G 通道 (协议 §6.1 纯字节流透传)

需求(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 交叉 + 待办清单)

vd960DBN/docs/devlog.md

@@ -4,6 +4,80 @@
 >
 > 项目定位: DLD960 通信板 — BLE 配网、TCP JSON 协议服务、Loop MCU 串口桥接
 
+## 2026-09-10 — vd960DBN UART1 ↔ Air780 4G 通道实现（协议 §6.1 纯透传）
+
+> 用户需求 2026-09-10：把 vd960DBN 与 vd960Air(Air780) 两侧的串口对接逻辑做出来 —— DBN 侧 UART1(PB6/PB7) 通道 + UART2↔UART1 双向透传。
+> **关闭**：V1.12 条目"vd960DBN 侧开发计划"第 1 条；V1.11 条目第 1、2 条（UART1 通道 / 双向透传）。
+
+### 实现
+
+| 文件 | 改动 |
+|------|------|
+| `APP/usart_biz.c` | +242 行：UART1 通道整段（118-347）；上行转发插入 `uart_srv()`(484-490) |
+| `APP/include/cmcng.h` | 声明 `uart1_dma_init/poll` + 5 个通道计数 |
+| `APP/peripheral_main.c` | 主循环加 `uart1_dma_poll()`（置于 `MK_UART_SRV` fault marker **之外**，不改变既有 marker 语义） |
+
+**上行**（Loop → Air780）：`uart_srv()` 内 `lup_process_frame()` 之后、**`InitPkgUart` 消费之前**插入转发，
+且**只转发 `lup_verify_checksum()==0` 的完整帧**。插入点必须在 BLE 分支改写 `pkg[0]=0x8F` 之前 ——
+否则会把已改魔数的帧发给 Air780。
+
+**下行**（Air780 → DBN）：UART1 收帧 → **魔数分流**：`0x7F` → `UART2_SendString()` 给 Loop；`0x8F` → DBN 本地处理（预留，当前仅计数）。
+
+### 三个关键设计决定（含理由）
+
+1. **接收走 DMA（DMA1_Ch5 循环 + 512B），不用 RXNE 中断。** 理由与 UART2 方案A(2026-08-17) 完全相同：
+   `PRINT` 临界区关中断 ~7.4ms / BLE 栈回调 / SPI 擦除 45ms 等长阻塞窗口会屏蔽 RXNE → 丢字节 → 校验失败。
+   本通道"不丢帧"是 Air780 沿检测的硬前提。UART2 占 DMA1_Ch6/Ch7，**Ch5 空闲，无冲突**。
+2. **帧装配器独立于 `g_lup_parser`。** `lup_feed_byte()` 硬编码操作全局 `g_lup_parser`（专供 UART2/Loop 通道），
+   两条字节流混进同一状态机必然互相残杀。故 UART1 用独立装配器，只复用纯函数 `lup_verify_checksum()`。
+3. **坏帧回找魔数（resync）。** 校验失败时在已收缓冲里从 idx=1 起回找下一个 `0x7F/0x8F`，残余搬到头部继续装配，
+   防"单帧损坏 → 后续帧全部失步、链路长时间瞎掉"。
+
+### 与 printf 共用 USART1 的处理（按用户指示）
+
+用户 2026-09-10 指示：**printf 对应串口不动；不会同时使用 Debug 打印和 4G 通信，4G 通信时禁用 debug 即可。**
+
+- 现状：`debug.c` 的 `USART_Printf_Init()` 把 USART1 重映射到 PB6 做 printf，且 `PRINT` 走 `__disable_irq()`。
+- 落地：本通道用编译开关 `UART1_AIR780_EN`（默认 `(DEBUG == 0)`）—— **4G 版本以 `-DDEBUG=0` 编译即自动启用**。
+  此时 `#if(DEBUG)` 为假：`PRINT` 是空宏，且 `USART_Printf_Init()` 里 USART1 的配置分支整段不参与编译
+  （已核对 `USART_Init/USART_Cmd` 均在 `#if(DEBUG == DEBUG_UART1)` 内）→ USART1 干净地交给本文件。
+- 调试版（DEBUG!=0）本通道编译为空实现，**`debug.h`/`debug.c` 一行未改**，printf 行为完全不变。
+- ⚠ 遗留：`net_srv.c:125` 有一处裸 `printf()`（错误路径），`DEBUG=0` 时仍会调用，建议改为 `PRINT`（列入待办）。
+
+### 验证
+
+- **host 单测**（本机无 RISC-V 工具链，无法编译固件）：从 `usart_biz.c` **原样抽取**装配器代码 + 逐字复刻
+  `loop_uart_proto.c` 的 XOR/SUM 校验，gcc 编译（`-Wall -Wextra -Werror` **零警告**）跑 13 组用例 **全部通过**：
+  单帧 `0x7F`/`0x8F` 分流、带数据帧逐字节一致、70B 最大帧、校验和破坏不转发、
+  **坏帧后紧跟好帧仍送达**、**截断帧后只交付 1 帧完整好帧**、乱码前缀、`LEN=0` 非法、`LEN` 超长、三帧连发、
+  `0x9F`(Loop OTA 魔数) 忽略、上行闸门只放行 verify 通过的帧。
+- **待板级验证**：需 MounRiver 工具链编译 + 实机（本机无 riscv 工具链，固件编译尚未跑过）。
+
+### 现场核对手段（比翻日志可靠）
+
+新增 5 个全局计数（`cmcng.h` 已声明，可调试器 Watch）：
+`g_uart1_fwd_to_air`（上行转发帧数）/ `g_uart1_fwd_to_loop`（下行 0x7F）/ `g_uart1_local_cnt`（下行 0x8F）/
+`g_uart1_badchk`（校验失败）/ `g_uart1_drop`（DMA 溢出）。
+
+**判据：跑一段时间后 `g_uart1_fwd_to_air` 与 Air780 侧实收帧数必须相等。**
+
+### 接线（供硬件核对）
+
+- DBN `USART1` 重映射：**PB6 = TX / PB7 = RX**，115200 8N1
+- 与 Air780 必须**交叉**：`DBN_PB6(TX) → Air780_RX`，`DBN_PB7(RX) ← Air780_TX`
+- 波特率两侧一致：115200（Air780 侧日志 `Uart_ChangeBR uart1, 115200`）
+
+### 仍待办
+
+- [ ] `0x8F` 下行的本地处理行为（当前仅计数；协议未细化具体动作）
+- [ ] `0x7D` 握手/配置同步帧（V1.11 曾提，未进正式协议，暂预留）
+- [ ] BLE 设置服务器/topic 时同步下发 Air780 配置（V1.12 第 2 条）
+- [ ] 通道切换策略（V1.12 第 3 条，待讨论；暂定默认 4G）
+- [ ] `net_srv.c:125` 裸 `printf` → `PRINT`
+- [ ] 板级联调：编译烧录 + 帧计数对齐 + 断线重连
+
+---
+
 ## 2026-08-31 — MQTT 协议 V1.13：initialize extra_info 增加 imei/iccid 可选字段
 
 > 用户需求 2026-08-31：initialize 指令的 `extra_info` 增加可选字段 `imei` / `iccid`（4G 模块 IMEI / 流量卡 ICCID）。