feat(vd960Air): 方案 C MVP — 0x7F 帧解析 + 标准 JSON 上报(2026-08-31)

协议依据:《DLD960_IoT_MQTT协议》V1.13(4G 通道适配方案 C)

新增模块:
- frame_parser.lua: 0x7F 帧解析状态机(Lua 版 lup_feed_byte, XOR+SUM 校验)
- proto_conv.lua: 0xC0 传感帧 → loop_data + car_state/loop_state 沿检测(4 类线圈事件)
- evt_queue.lua: event_report 队列 + ACK 状态机(16深/5s×3/跨重连同 msg_id,对齐 DBN)
- clock.lua: report_config 时钟校准(协议 §2.3)
- app_iot.lua: initialize(extra_info imei/iccid + link)/ heartbeat / poll 驱动
- tools/sim_frame_test.py: 帧协议参考验证(56B 帧/4 路解析/沿检测/JSON 格式,全过)

改造:
- uart_app.lua: 0x7D 帧 → 0x7F 帧驱动;loop_data/event_report 组包 + link 注入
- mqtt_receiver.lua: 下行分发(ACK 路由 + 时钟校准)
- mqtt_main.lua: 连接成功 → initialize + 未决事件重发
- config.lua/main.lua: 方案 C 配置与入口

MVP 范围: 上行(initialize/loop_data/event_report/heartbeat)+ report_config;
下行命令转换与 0x7D 配置同步列入 P1。

luatos/air780epm/module/Air780EPM/demo/vd960Air/config.lua

@@ -1,45 +1,52 @@
 --[[
 @module  config
-@summary vd960Air 配置: MQTT 服务器 / 设备序列号 / UART 参数
+@summary vd960Air 配置: MQTT 服务器 / 设备标识 / 主题 / UART / 上报参数
 @date    2026.08.31
 @usage
 vd960Air 是 Air8781P 整板(Air780EPM 核心模组)上的 LuatOS 应用,
-作为 vd960DBN 车检器在有线网络失效时的 4G 兜底通道(UART <-> MQTT 桥)。
+作为 vd960DBN 车检器在有线网络失效时的 4G 兜底通道(方案 C: Air780 协议转换)。
 
-协议依据:《DLD960_IoT_MQTT协议》V1.10(命令面/JSON 结构与有线通道完全一致)
+协议依据:《DLD960_IoT_MQTT协议》V1.13(4G 通道适配方案 C,标准 JSON 命令面)
 ]]
 
 -- ==================== MQTT 服务器 ====================
--- 商用服务器地址和端口(替换为实际值;官方 demo 地址仅测试用)
+-- 商用服务器地址和端口(替换为实际值)
+-- 注: 后续 vd960DBN 更新版本后,经 BLE 设置的服务器参数会同步下发覆盖此处(配置同步, P1)
 CFG_MQTT_HOST = "lbsmqtt.airm2m.com"
 CFG_MQTT_PORT = 1884
 
 -- ==================== 设备标识 ====================
--- 设备序列码: 6 字节十六进制字符串(与 vd960DBN dev_serial 一致)
--- 说明: 有线通道的 Topic 用 dev_serial 生成;4G 通道必须同一主题族,平台才能统一管理。
---       【待确认】是否由 vd960DBN 经 UART 握手动态下发,而非本地写死(见 readme 待办)
+-- 设备序列码: 6 字节十六进制字符串(与 vd960DBN dev_serial 一致,有线/4G 同一设备)
 CFG_DEV_SERIAL = "A1B2C3D4E5F6"
 
+-- 产品信息(initialize 上报,协议 §5.1)
+CFG_MODEL       = "DLD960"
+CFG_HW_VER      = "1.0"
+CFG_SW_VER      = "1.0"
+CFG_LOOP_VER    = ""   -- 地感 Loop 固件版本(0x4A 查询 P1 后填充)
+CFG_LOOP_HW_VER = ""   -- 地感 Loop 硬件版本
+
 -- MQTT Topic(与《DLD960_IoT_MQTT协议》§1.2 一致)
-CFG_TOPIC_UP   = "dld960/" .. CFG_DEV_SERIAL .. "/dev"  -- 设备上报(4G publish)
-CFG_TOPIC_DOWN = "dld960/" .. CFG_DEV_SERIAL .. "/srv"  -- 服务器下发(4G subscribe)
+CFG_TOPIC_UP   = "dld960/" .. CFG_DEV_SERIAL .. "/dev"  -- 设备上报
+CFG_TOPIC_DOWN = "dld960/" .. CFG_DEV_SERIAL .. "/srv"  -- 服务器下发
 
 -- MQTT ClientID: 用 IMEI 保证唯一(与序列码解耦;鉴权待确认)
 CFG_MQTT_CLIENT_ID = "vd960Air-" .. mobile.imei()
 
 -- ==================== UART(对接 vd960DBN) ====================
 -- vd960DBN 侧: CH32V208 串口1(PB6=TX, PB7=RX)
--- 波特率: 官方 demo 默认 115200;vd960DBN UART1 预留口速率【待确认】
+-- 波特率: 115200(用户决策 2026-08-31,后续如需再调)
 CFG_UART_ID   = 1
 CFG_UART_BAUD = 115200
 
--- 帧协议参数(4G <-> vd960DBN UART 链路帧,设计稿 v0.2 — 用户决策 2026-08-31 校验统一 XOR+SUM)
--- 帧 = [0x7D] [LEN_H] [LEN_L] [PAYLOAD...] [XOR] [SUM]
--- 校验范围: 从 LEN_H 起到 PAYLOAD 末字节(不含 HEAD,与 DBN↔Loop 0x7F 同风格)
-CFG_FRAME_HEAD   = 0x7D
-CFG_FRAME_MAXLEN = 2048  -- PAYLOAD 最大字节数(防御: 超长判非法帧)
+-- 链路帧: 0x7F 帧字节流(方案 C,数据面透传 Loop 地感协议)
+-- 0x7D 帧仅用于 DBN↔Air780 配置同步/握手(P1)
+
+-- ==================== 上报节奏 ====================
+CFG_HEARTBEAT_INTERVAL = 60    -- 心跳周期(秒,协议 §5.4 默认 60)
+CFG_REPORT_ALWAYS      = true  -- MVP: 每收到 0xC0 帧都上报 loop_data;P1 按协议三档节流
 
 -- ==================== 4G 特有字段注入 ====================
--- 用户决策 2026-08-31: 4G 上报附加 IMEI/流量卡ICCID/IMSI/MSISDN/CSQ 字段
+-- 用户决策 2026-08-31: 上行附加 link 对象 + initialize extra_info 含 imei/iccid
 -- true = 上行 JSON 顶层注入 link 对象(见 link_info.lua)
 CFG_LINK_ENABLE = true