docs(V4B): 注释同步 — 全部 疾闪 → 一长两短 (用户指出残留)

TaskLoop.c/h 现役注释 5 处 + tests 4 处 (180/983/997/1004/84 + 6/103/104/127)
代码本体 V4.36.38 已是一长两短 6 相, 注释滞后同步
devlog V2.77 / spec V2.59 (历史版本行保留当时变更记录)
语法0 error, 4测试全绿
This commit is contained in:
wangfq
2026-09-09 11:35:35 +08:00
parent 41a4577fa7
commit 1de4b4c8f3
5 changed files with 12 additions and 10 deletions
@@ -81,7 +81,7 @@
#define ENV_WARN_WAIT 200 // 环境预判 (V4.31): dev>+4dlt 高位连续 ~2s → 黄灯预判锁存(回摆保持)
#define ENV_RECOVER_WAIT 200 // 恢复确认 (V4.31): 新基线替换后 环境空闲连续 ~2s 才解除预判, 黄灯灭
#define COIL_F_OK_MIN_KHZ 18 // 线圈频率合理窗 (V4.36.18): 默认低频档口径, <18kHz → L偏大 (≈双 250µH+ 大线圈放行)
#define COIL_L_MIN_UH 24 // V4.36.23/25: 出窗偏小指示阈值 µH (对应 COIL_L_MIN_F_KHZ=156): L<此值 → 黄灯疾闪 100ms(独立节奏), 判定恒照常
#define COIL_L_MIN_UH 24 // V4.36.23/25/38: 出窗偏小指示阈值 µH (对应 COIL_L_MIN_F_KHZ=156): L<此值 → 黄灯一长两短(可用级), 判定恒照常
#define COIL_L_SHORT_UH 20 // V4.36.37: 真短路级阈值 µH (方案A 分级): L<20µH(f>171k) → 断开级快闪(200ms, 与真断开同款), COIL_UNDER_MIN_AS_OPEN 作用于此级
#define COIL_L_SHORT_F_KHZ 171 // V4.36.37: f@20µH=171.6k 取 171: f>此值 → L<20µH 短路级
#define COIL_UNDER_MIN_AS_OPEN 1 // V4.36.24/37/39: L<20µH(f>171k, 短路级) 是否视为线圈断开完全状态(方案A 作用域从 156k 移到 171k):
@@ -177,7 +177,7 @@ uint32_t g_stab_base = 0; // V4.36.15: 步进比较基准 CAPVD
uint8_t g_release_need = 3; // V4.36.8: 释放确认样本数 (按Q档, 高3/中4/低5)
uint8_t g_fault_phase = 0;
uint16_t g_fault_tick = 0;
uint8_t g_coil_fault = 0; // V4.26/25/37: 电感量异常 0=正常 1=出合理窗→一长一短(f<18k L偏大 / 125k<f≤156k L偏小) 2=156<f≤171k L20~24µH→疾闪100ms(恒判车) 3=f>171k L<20µH短路级→断开级快闪(宏=1 等同断开)
uint8_t g_coil_fault = 0; // V4.26/25/37/38: 电感量异常 0=正常 1=出合理窗→一长一短(f<18k L偏大 / 125k<f≤156k L偏小) 2=156<f≤171k L20~24µH→一长两短(可用级, 恒判车) 3=f>171k L<20µH短路级→断开级快闪(宏=1 等同断开)
uint16_t g_coil_bad_cnt = 0; // V4.26: 电感异常防抖计数 (V4.36.21: 500tick=5s 置位/清除, 宏 COIL_FAULT_HOLD_TICKS)
/*===========================================================================
@@ -980,7 +980,7 @@ static uint32_t coil_l_uH(uint32_t f_khz)
* 拍板规格: 默认低频档口径, 空场频率合理窗 20~120kHz, 出界即判定电感量不合理
* (黄灯"一长一短"告警, 见 poll_yellow_led 模式5)
* 调用点保证: 仅稳定 + 无车空闲 + 未断开时执行 (车压/自检/断开不判)
* g_coil_fault: 0=正常 1=出窗一长一短 2=156~171k疾闪(可用级) 3=f>171k短路级(断开级快闪)
* g_coil_fault: 0=正常 1=出窗一长一短 2=156~171k一长两短(可用级) 3=f>171k短路级(断开级快闪)
* 防抖: 越界/恢复均连续 COIL_FAULT_HOLD_TICKS(500tick=5s, V4.36.21) 才置位/清除 — 下限判定重要, 加长防误检
*===========================================================================*/
static void coil_monitor(void)
@@ -994,14 +994,14 @@ static void coil_monitor(void)
/* V4.36.25/37 四分语义 (43nF, 方案A 分级):
* f<18k → want=1 L偏大 → 一长一短
* 125k<f≤156k → want=1 L偏小(出窗) → 一长一短
* 156k<f≤171k → want=2 L 20~24µH 低于下限可用级 → 疾闪100ms(与断开区分), 判定恒照常
* 156k<f≤171k → want=2 L 20~24µH 低于下限可用级 → 一长两短(V4.36.38, 与断开区分), 判定恒照常
* f>171k → want=3 L<20µH 短路级 → 断开级快闪(200ms), COIL_UNDER_MIN_AS_OPEN 决定功能 */
if (f_khz < COIL_F_OK_MIN_KHZ)
want = 1; /* L 偏大 */
else if (f_khz > COIL_L_SHORT_F_KHZ)
want = 3; /* L<20µH 短路级 → 断开级快闪 */
else if (f_khz > COIL_L_MIN_F_KHZ)
want = 2; /* 156~171k L20~24µH → 疾闪(可用级) */
want = 2; /* 156~171k L20~24µH → 一长两短(可用级) */
else if (f_khz > COIL_F_OK_MAX_KHZ)
want = 1; /* L 偏小(出合理窗, 不低于下限) → 一长一短 */