DLD110SV4B/docs/devlog.md

DLD110SV4 开发日志

MCU: CH591R (RISC-V, BLE) @60MHz | 通道: 1 路线圈 | 调试口: UART0 (DEBUG 编译, 230400)

2026-08-26 — 0x24 偏移 7 语义对齐 DLD154Pro（direction_mode 完整字节）

改动

王工调整 dbn_ble_srv.c 一行：0x24 响应偏移 7 从 g_function_mode（= direction_mode>>4）改为 g_loop_cng_unit.direction_mode 完整字节，与 DLD154Pro 语义对齐。顺手修掉双分号 direction_mode;;。

影响

• 协议语义变化：小程序读偏移 7 从"功能模式高 4 位"变为"完整方向/触发模式字节"——解析逻辑必须按新语义（低 4 位 = 方向/触发模式，高 4 位 = g_function_mode）
• 协议文档同步：§5.4 表格 + 坑清单第 9 条（原"与 DLD154Pro 不同"已改为"语义对齐"）
• 0x23 写路径不受影响（unpack_pkg_set_cjq_param 仍存完整 direction_mode 字节）

---

2026-08-26 — V4.31：断开次数双变量拆分（LED 3次上限 vs BLE 持续累计）

背景

V4.30 代码合并整理时，peripheral_main.c 出现了两处回退（删 g_loop_cut_last = 0 + 加回 3 次上限）。核对 1815caf 后确认：删掉 g_loop_cut_last = 0 会让第二次断开不再计数（FLAG_CUT 0→1 时 last 仍为 1，边沿检测失败）。且 3 次上限原意是给 LED 快闪，但小程序要读"上电后持续累计的断开次数"——一个变量无法同时满足两个需求，拆成两个。

改动（王工确认方案）

文件	改动
peripheral_main.c	① 恢复重连分支 g_loop_cut_last = 0（边沿记忆同步，1815caf 修复回归防御）；② 新增 uint32_t g_loop_cut_total（上电持续累计，不截断）；③ 断开计数处 g_loop_cut_amount++（3 次截断，LED 用）+ g_loop_cut_total++（不截断）
cmcng.h	extern g_loop_cut_total
dbn_ble_srv.c	0xC0 偏移 4-6（3B）与 0x24 偏移 5-6（2B）上报改用 g_loop_cut_total
docs/ble-protocol.md	固件版本 V4.20→V4.31；断开次数字段标注"上电持续累计，不截断"
docs/product-manual.md	版本历史补 V4.30/V4.31
docs/technical-spec.md	cut_amount 语义更新 + V4.31 变更说明 + 修订记录 V1.1

要点

• 双变量语义：g_loop_cut_amount（≤3）= LED 黄灯快闪指示；g_loop_cut_total（uint32 无上限）= 小程序读的真实断开次数
• 上电未连线圈时两个变量上报值仍为 1（g_loop_power_up_state == 0 ? 1 : ...）
• INIT_VD() 不复位两个计数变量（BLE 上报语义），仅边沿记忆 g_loop_cut_last 在重连分支复位
• 版本号 cmcng.h FIRMWARE_VER = "4.31"（V4.30 合并整理由王工在 MRS 完成，本仓库同步 bump）

---

2026-08-26 — 0x24 追加归一化基数 LOOP_MEASURE_BASE（协议 V1.1）

背景

小程序评估 DLD110S 上报数据时发现归一化基数 bug：用 DLD154V4B 的 MEASUREMENT_BASE=131072 归一化 variation，DLD110S 实为 524288（2^19 @60MHz）→ 所有百分比放大 4 倍（ΔL/L 报 8.85% 实为 2.21%）。根治方案（王工确认方案 A）：固件显式上报基数，第三方不猜。

改动

文件	改动
APP/include/cmcng.h	新增 #define LOOP_MEASURE_BASE 524288L（注释标明必须与 peripheral_main.c MEASUREMENT_BASE 同步）
APP/dbn_ble_srv.c	0x24 读参响应尾部追加 3B LE：LOOP_MEASURE_BASE（响应 8B→11B，仍单包 ≤14B，无分包）
docs/ble-protocol.md	§5.4 响应表加偏移 8-10 + 换算公式 + 背景说明（协议 V1.1）

要点

• 换算公式：Δf/f ≈ variation / LOOP_MEASURE_BASE，ΔL/L ≈ -2 × variation / LOOP_MEASURE_BASE
• 向后兼容：老小程序只读前 8B 不受影响；新小程序读 11B 拿基数
• 零分包风险：0x24 响应 11B data < MAX_BLE_DAT_RESPONSE_LEN=14，单包不变；0xC0 未动（加实时 Origin 需 13→16B 会触发分包，本轮不做）
• 未 bump 固件版本号（V4.20 → 用户确认 V4.30 有部分代码更新，晚点统一同步）
• 上报缺陷（0xC0 无 Origin）已确认：第三方用频率基线或本基数均可，固件暂不扩 0xC0

---

2026-08-26 — 环路线圈健康评估设计依据归档 + 小程序评估报告核验

背景

王工上传《环路线圈健康评估_第三方应用设计依据_V1.1.md》（FHWA/NEMA 口径），要求归档到 DLD110S 项目；随后上传小程序《车检器环境诊断报告》（DLD110S E04E7AA1E88C，30s 评估），要求按设计依据核验上报数据评估有无问题。

归档文件

文件	内容
docs/coil-eval-design-basis.md	原设计依据 V1.1（原样归档）
docs/coil-eval-design-basis-review.md	技术评审 + DLD110S 字段映射（8 项参数→实际上报字段）
docs/coil-eval-report-20260826.md	小程序评估报告核验结论

关键发现

1. 🚨 小程序归一化基数 bug（放大 4 倍）：DLD110S 固件 MEASUREMENT_BASE=524288（2^19, CH591R @60MHz），小程序却用 DLD154V4B 的 131072（2^17）做 variation 归一化 → 车辆 ΔL/L 报 8.85% 实为 2.21%，无车波动报 0.11% 实为 0.0277%。验证：2×5801/131072=8.85% 逐位吻合。本次结论侥幸不变（2.21% 仍 ≥1% 正常），但临界车（真实 0.5%）会被报成 2% 误判正常。教训：跨产品照搬常数（同类 DLD154V4B→DLD110S 的 MEASUREMENT_BASE 差异），与协议文档防错同一模式。
2. 判据空洞：小程序自创无车波动阈值 <0.1%/0.3~1%/>1%，0.1~0.3% 无定义且 0.11% 不在正常区间却判正常；设计依据 §3.2.3 是 ±10%/±20% 频率判据，两套体系需对齐
3. DLD110S 低频档(FLEVEL=3) 电容=76nF 实锤：45980Hz ↔ 157.648μH ↔ 76nF 三者自洽（正算差 0Hz），印证设计依据四档电容 33/43/66/76nF
4. DLD110S 上报缺陷确认：0xC0 只有 frequency+variation，无 Origin/CAPVD → 第三方算 ΔL/L 只能走频率基线路径（Δf/f≈variation/Origin≈-(1/2)ΔL/L），建议固件后续版本补报 Origin
5. 待确认：报告软件版本 4.30（ble-protocol 记录 4.20）、"灵敏度模式 AI"（DLD110S 拨码 3 档无 AI 模式）

涉及文件

文件	内容
docs/coil-eval-design-basis.md	新增（原文档 V1.1 归档）
docs/coil-eval-design-basis-review.md	新增（评审映射 + 小程序检查清单）
docs/coil-eval-report-20260826.md	新增（本次评估核验报告）

---

2026-08-25 — 蓝牙小程序接口协议文档

背景

根据 dbn_ble_srv.c（+ peripheral.c/gattprofile.c/peripheral_main.c/storage.h/cmcng.h）整理蓝牙小程序与芯片交互的完整接口协议。

文档要点

章节	内容
开头差异表	与 DLD154Pro 的三处关键差异
§1 BLE 服务	0xFFE0 服务；Char1(0xFFE1 RW 命令下发)、Char4(0xFFE4 Notify)；设备名 DLD110S
§2-3 帧格式/分包	Magic(8F/7F)+Header+Len+CMD+Data+XOR+SUM；14B 写死分包
§4-5 命令	0x10/0x1F/0x23/0x24/0x8A/0x92/0xC5 逐字段（无 0x31）
§6 主动上报	0xC0 线圈动态（type=5）
§7 坑清单	10 条源码事实

关键发现（源码事实）

1. ⚠ 灵敏度由硬件拨码 KEY_SA1/SA2 决定（poll_sens_key peripheral_main.c:263）：检测阈值 = g_loop_sens_list.sens[g_freq_sens]，0x23 设置的 sensitvity 仅存档不生效，0x24 回读 = 拨码档位+1（1~3）
2. 3 档灵敏度（MAX_LOOP_SENS_AMOUNT=3）：默认 {108,54,28} / {81,32,16}（DLD154Pro 为 4 档）
3. 无 0x31（DLD110SV4 无 RS485）
4. 0x24 偏移 7 是 g_function_mode（DLD154Pro 为 direction_mode）
5. g_hold_time = exist_mode × 600 tick（DLD154Pro ×100）——产品差异
6. 0xC5 超时疑似 bug：timeout_min × 60 × 100（应 ×1000？待现场验证）

涉及文件

文件	内容
docs/ble-protocol.md	新增（固件 V4.20 / 硬件 V4.01 / 型号 DLD110S）

---

2026-07-20 — variation 3 字节上报 + 编码 GBK→UTF-8 + 线圈重连对齐 DLD154V4B spec

variation 上报升级

• int16_t → int32_t：去掉 ±32767 截断，保留完整诊断信号（线圈漂移/老化等异常场景下 variation 可远超 32767）
• BLE 上报 2 → 3 字节（小端序 int24），与 frequent/cut_amount 统一宽度
• storage.h 结构体大小不变（原 int16_t 后 uint32_t 有 2B padding，改为 int32_t 后 padding 消失）

全项目编码 GBK → UTF-8

62 个 .c/.h 源文件全部从 GBK 转换为 UTF-8（保留 CRLF 行尾），消除 patch 工具乱码问题。

补充 g_sys_freq 全局变量定义

dbn_ble_srv.h:93 声明了 extern uint32_t g_sys_freq;，但 .c 中漏了定义导致 undefined reference。在 peripheral_main.c 全局变量区补上 uint32_t g_sys_freq = 0;。

RLY1 脉冲输出 (进入脉冲 / 离开脉冲)

原代码中 case 1（进入脉冲）和 case 2（离开脉冲）的 switch 逻辑正确， 问题为 output_mode 配置未正确写入 flash 导致始终走 case 0（存在输出）。 修复后现场验证通过。

线圈重连逻辑对齐 DLD154V4B spec (第 8 章)

问题：旧逻辑断开时清零 loop1_VD_FLAG，重连时调 INIT_VD() 全复位重建基线， 无法恢复断开前有车状态。

修复 (对齐 DLD154V4B technical-spec.md §8)：

改动	旧行为	新行为
断开时 VD_FLAG	清零	保留（车在线圈上时不丢状态）
重连后	INIT_VD 全复位	CAPVD=0 直锁首个样本快速收敛
断开跟踪	无	新增 g_disconnect_active 状态位
断开次数上限	255	3（对齐 spec）
LED 断开指示	loop1_FLAG_CUT 150ms 闪	g_disconnect_active 200ms 快闪

行为变化：线圈断开时继电器释放，但保留 loop1_VD_FLAG。重连后 CAPVD=0 触发首个样本直锁 + 丢弃断开期间的 ORG_SUM/CNT 过期数据：

• 车仍在 → VD_FLAG=1，继续走有车分支，恢复继电器输出 ✓
• 车已离开 → 走离开检测（cnt_release 递增），正常释放 ✓

注意：此改动推翻了移植日志（2026-07-18）中的"断线重连不再恢复车辆状态"说明。

---

2026-07-18 — 检测算法移植 DLD154V4B (V2.0)

背景

DLD110SV4 原固件 (V4.x) 使用旧一代算法: 一阶滤波 + 二阶变化量 + FltHistoryManager 多时间窗基准 + 二次判断 (FUNCTION_A/B) + 快速变化检测等多套机制叠加, 分支复杂、 参数纠缠, 现场调优困难。DLD154V4B 已在 AT32F421 上完成算法精简重构 (对齐 M1H 参考 实现 + M4 优化), 本次将其整体移植到 CH591R, 旧线圈算法代码全部删除。

移植内容

模块	旧实现	新实现 (移植后)
测量窗	LPCNT=(32768/Xn)<<6, Value=ΣXn>>5 (~65536, 窗长 ~35ms)	LPCNT=2^19/Xn, Value=ΣXn (~524288, 窗长 ~8.74ms)
滤波	IIR 79/256, 无限幅	IIR 79/256 + 斜率限幅 5% (EMI 尖峰拒绝)
开机收敛	INIT_SAMPLE_COUNT=10 累加平均	稳定期 128 窗, 小窗口 100, 绕过 IIR
基线跟踪	窗口 50, 有车冻结	窗口 500, 冻结保护 (超时 ~8.7s + 稳定性 ±2% 双条件)
进入判定	单次阈值 (FUNCTION_B 时 3 次)	连续 3 次确认 (ENTRY_CONFIRM)
离开判定	滞回 + check_flat_leave + 二次判断嵌套	平坦性三条件 (CN200910309382), 滞回阈值 sens_out
有限存在超时	FLAG_HOLD_TIMEOUT → INIT_VD + 快速补偿窗	同思路保留: 全复位重建基线
断线重连	flt_mgr.flag_loop_reconnect 多阶段恢复 (保留断开前 Origin 重判)	简化为全复位重建基线 (断开时继电器已释放, 行为对齐 M1H)
安全复位	代码存在但 LC_HOLD 激活被注释 (实际不生效)	恢复启用: loopSafe_Timeout 非 0 时进车启动计时
灵敏度切换	仅开机读取 (主循环 poll 被注释)	每个测量窗轮询滑动开关, 运行时即时生效

删除的旧算法模块

SecondOrderState / get_second_order / FltHistoryManager (flt_mgr) / StageRangeConfig (stage_config) / update_flt_history / check_flt_by_stage / check_flat_leave / update_lower_upper / reload_lower_upper / rapid_change 快速变化检测 / relay_on(off)_confirm 多重确认 / FUNCTION_A/B 分支。 FUNCTION_* 宏与 g_function_mode 保留 (BLE 协议 direction_mode 高 4 位仍读写), 但算法不再消费。

参数适配 (CH591R @60MHz)

参数	DLD154V4B (@120MHz, 10ms)	DLD110SV4 (@60MHz)	说明
MEASUREMENT_BASE	131072 (2^17)	524288 (2^19)	窗长 2^19/60M ≈ 8.74ms, 接近 10ms 任务节拍
ALFA_CAP1	79 (τ≈32ms)	79 (τ≈24ms)
WINDOW_ORIGIN	500 (5s)	500 (~4.4s)
FREEZE_TIMEOUT	1000 (10s)	1000 (~8.7s)
SLOPE_FLAT_THRESH	100	350	幅值基准放大 4×、窗周期 0.87×, 净缩放 ~3.5×
MIN_DELTA2 / MIN_DELTA3	5 / 2	18 / 7	同上缩放, 待现场验证
VARIATION_EVENT_TH	—	40	BLE variation 事件阈值, 对应旧代码的 5 (幅值 8×)

BLE 接口适配 (dbn_ble_srv.c)

• loop_capvd 上报: 旧值为 ΣXn>>5, BLE 端 <<5 还原; 新值直接 ΣXn, 删除 <<5。频率公式 freq = g_sys_freq / (loop_capvd / LPCNT) + 360 结构不变 (+360 为硬件校准偏移, 待现场复核)。
• condition (线圈环境评估 0~15): 旧源 flt_mgr.cnt_not_idle; 新源 g_env_activity (CAPVD 相邻差 > ENV_ACT_TH=30 累加 / 否则衰减, 阈值待现场验证)。
• variation = Origin − CAPVD, 有符号, 饱和到 ±32767; 幅值基准变为 2^19, 小程序端若有固定阈值需同步放大 8×。

顺手修复

• update_moving_average 的 window 参数 uint8_t → uint16_t (500 会被截断为 244, DLD154V4B 已知 pitfall)。
• DLD154V4B 的 _stable_cnt 为函数内 static, 二次进入稳定期时不清零 → 1 个样本即判稳。 移植版改为全局 loop1_stable_cnt, 稳定期结束与 INIT_VD/安全复位时清零。 (DLD154V4B 侧同样的隐患待回改)
• TMR0 ISR 增加 Xn==0 保护 (除零) 与 LPCNT>65535 保护 (Xn 毛刺)。
• 进入判定成立时平坦性差分基准 g_prev_capvd 以当前 CAPVD 播种, 避免离开检测 第一帧出现虚假大斜率。

行为变化说明 (现场注意)

1. 断线重连不再尝试恢复断开前的车辆状态, 一律重建基线 (~1.1s 稳定期 + 绿灯快闪)。 重连时若线圈上有车, 基线落在占用值, 不输出存在信号 — 与断开即释放的行为一致。
2. 安全复位 (loopSafe_Timeout) 从"配置存在但不生效"变为真正生效, 升级存量设备时 注意该参数配置值。
3. 灵敏度滑动开关运行时切换即时生效, 不再需要重新上电。

待现场验证

• 各频率档下 LPCNT / 实测窗长 / CAPVD 幅值 (示波器 + DEBUG 串口)
• 平坦性离开阈值 SLOPE_FLAT_THRESH=350, MIN_DELTA2=18, MIN_DELTA3=7
• ENV_ACT_TH=30 (condition 上报的灵敏程度)
• BLE 频率读数 +360 偏移是否仍准确 (测量方案已变)
• 小程序 variation 显示幅值 (基准放大 8×)

---

修订记录

版本	时间	说明
V1.1	2026-07-20	variation 3B上报 + GBK→UTF-8 + RLY1脉冲 + 线圈重连对齐DLD154V4B spec
V1.0	2026-07-18	建仓; 算法移植 DLD154V4B V2.0, 删除旧线圈算法; FIRMWARE_VER 4.00→4.20