wandering1/STM32F4-Base
1
0
Fork 0
Code Issues 30 Pull Requests Actions Packages Projects 2 Releases Wiki Activity
655 Commits 3 Branches 0 Tags
e7136cbea3afffb871eae5f1f9f0a7f76bbeb39b
Commit Graph

24 Commits

Author SHA1 Message Date
wandering1 77779d49d6 feat(ui+记录): 整定写路径与四类页落地，五类记录写入方补齐 
UI 面：ui_data 增加深度 4 参数写队列（请求 168 B、队列 .bss 672 B）与状态机
OK/ERR_RANGE/ERR_LOCKED/ERR_BUSY，ui_data_feed 出队后按注入 ops 走「闭锁 → 整批
预检 → 逐项 prot_set_set_sealed」，只提交改动位图；par 帧尾追加 cal_block
（口径 = UA/UN/IA 三路 ADC_CAL_F_VALID，与 protect_task 判据同构，不用 rt.eng
反推，V0.1 下 eng 恒 0）、UI_DATA_VER 升到 2。参数/定值/控制字/软压板四叶绑定
内容页（UI_PAGE_MAP_COUNT 12→16，复用四个查看模块，零新增 .c），编辑态按
is_editable 分派，LOCK（写不进去）与「未标定」（仍可改值）两源两通道两词。

记录面：syslog_request_clear/state/apply 三段式删除 API（UI 只发请求，落地在
defaultTask 的 drain 尾部且必须后置，卷锁一律 try，幂等只认 FR_NO_FILE）；
事故/告警/启动/操作/遥控五类各有一个真实写入点，记录类型 = 日志 ID 本身
（一类一个 /log 严格 8.3 文件；64B 定长体没有类型字段位，塞字段会砸掉既有读者）。
为守 protectTask 872 B 静态最坏链另拆 syslog_post_quiet()（无 DBG 的投递核，
丢弃留痕挪到 drain 侧差值补发），syslog_post 对外语义逐字不变。

为什么两道合成一笔而不是各一笔（实测，不是省事）：simulator/main.c 同时消费
两道新增 API（整定 pump 与 logtest 清除用例），按道切文件会让中间提交编不过；
RAM 受管快照与体积同码凭证描述的是合并后的 .map，拆开必落在「台账与 .map 不同
码」这条红线上。pre-commit 跑钩子前会 stash 未 staged 部分，这类耦合没法绕。

实测：@build 0 错误 0 警告；Code 228,260 / RO 24,960 / RW 1,440 / ZI 135,976 B；
RW_IRAM1 79,992 B = 61.0%、RW_CCM 87.9%（阈值 92%）；九个任务静态最坏链全 PASS，
protectTask 872 B / 57% 改前后逐字节不变（记录投递没垫栈）。主机单测 ui_data 82→
164、sys_log_mcu 106→137、prot_elm 47→60、iec104 141→154、iec104_serv 28→34，
既有断言零删改；48 个钩子 --all-files 全绿；编号门禁可判定 86.34%（基线 86.0%）、
不可判定 1,153 处低于上限 1,166；doc-links 无法判定 0；UI 黄金 18 页扩到 27 页
连跑两次逐字节一致；字库 diff 空。

顺手修掉三处既有缺陷（都是本轮第一个消费者才暴露）：sim_syslog.c 的 s_paths 行宽
16 而 "sim_selftest.log" 正好 16 字符没有 NUL 位（stat/remove 读越过数组尾，此前
靠后面 .rodata 碰巧为 0）；ui_w_setlist 二态行 ENTER 不回绕（控制字与软压板出厂值
全在最后一项，按了像没反应而叠层里已是越界值）；生成物 ui_menu_tab.h 与 gen_menu.py
模板漂移（上一笔改了模板没重跑生成器），现随生成器输出对齐。

未收口（不算完成）：保存后重启值保持与主站 C_RD 读回两条只能上板，台架窗口执行；
LOCK 屏显与越界反显的页面侧在模拟器造不出来（模拟器不跑定值自检、无 NAND），
已由生成侧单测与代码注释点名差距；同类页数与钩子数陈述残留另立待办。
 2026-10-26 15:51:12 +08:00
wandering1 0f7b5a87fb chore(编号): 存量编号全量转语义短语，门禁识别面与语料同批重打 
登记簿、文档与代码注释里的存量字母加数字编号（N-x / S-x / T-x / E-x / A-x / 卡号）
一律改写为语义短语，净删 2,028 处引用；删除基线与待确认、并行分道方案、排期详述、
采集保护收尾 4 篇（内容已并入 docs/任务规划/README 与登记簿）。

门禁机器与三张账同批重打：check_ids.py 新增变更记录行豁免与第二根护栏
undecidable_total_ceiling；check_test_traceability.py 只加 stdout/stderr UTF-8
reconfigure（TC_RE 未动）；check_cubemx_survival.py 的 --write 固定 newline=LF；
id_registry / id_aliases（+19 条 retired-to-phrase）/ id_known_backlog 重打。

test/ 56 个文件同步 TC 标签语义化，其中 18 个 TU 改了 CHECK / printf 里的标签文字，
是本批唯一改变构建产物的文件集合。

为什么合成一笔、不拆四笔（实测撞闸，非偏好）：pre-commit 跑钩子前会 stash 未 staged
部分，拆开后中间提交必然是「新规则 + 旧语料」——实跑可判定 85.15% < 基线 86.00%、
不可判定 1,453 > 上限 1,166，编号门禁直接拦下。编号识别面与它描述的语料只能同码移动。

实跑基线（工作区全量）：754 文件 / 8,230 处编号字面量 / 可判定 7,079 = 86.01%
（基线 86.0%，容差 0.1pp）/ 不可判定绝对数 1,151（上限 1,166）/ 校验 1-6 错误级 0 /
告警 = 悬空 2（App/algo/freq.c 的 S2，属 §4.4 同号不同义）+ 孤儿 50。

基线从 84.0 抬到 86.0 的理由见 docs/门禁说明/id-check.md §7.6：本批真删了 2,028 处
引用，可判定面随真实内容上升，不是把分母做小。同批新增排除 docs/硬件平台/ 语料，使
识别面少 264 处——芯片手册位号与网表料号不属编号空间（registry 有 excluded_paths_note）。

⚠ 余量只剩 0.11pp（约 10 处）与绝对数 15 处：把「可判定的引用」改成散文会立刻撞第二
根护栏。另遗留一项：id_aliases 里 retired 的 N / S / T / A 别名没有 scope（U1~U5 有），
今后有人新写一个 A-4，校验 3 不会响，只能靠人，建议下批补 scope。

固件不变证据：115 个 .c/.h 剥注释并归一字符串后与 HEAD 逐字节全等，残留代码差异 0；
App / Src / Drivers 的字符串字面量零改动。@build 0 错误 0 警告；40/40 主机套件、2,889
断言全通过；覆盖率 line 89.2% / func 92.6%；pre-commit 48 钩子 --all-files 全绿；
check_doc_links --all 通过（176 文档，章节引用无法判定 0）；逐字节卫生核过：14 个带
BOM 文件与 HEAD 一致、0 个 CR、0 个 U+FFFD，字符串字面量纯 ASCII。

.cubemx_survival_baseline.json 的 watchdog-module 哈希 56bf27 变 2bb051 属合法：
Src/freertos.c 的 USER CODE 区内只有注释文字随编号改写，代码未变。

同批带上体积同码凭证与 RAM 台账行（@build 之后盖戳）：RW_IRAM1 79,008 B / 60.3%，
RW_CCM 57,376 B / 87.9%，阈值 92%。
 2026-10-26 12:28:14 +08:00
wandering1 8c72698666 feat(运行参数): 卡10 run_par真源收编+104段0x8020~0x8058读写映射（道D M6-①） 
新增 App/algo/run_par.c/h（「数据可信」卡 10，lead 四裁落地）：
- [run_par] cfg 段：遥测死区 9 键 int32 毫单位（db_ua…db_freq），工厂默认 =
  卡 6 额定 0.5% 档（500mV×4 / 5mA×4 / 500mHz）；注册走 adc_cal 同款内核前
  契约（app_main_init），不挂回调 = 引擎副本即生效值；键数 9≤16 不拆段
- 真源收编（裁③）：pts 层 s_yc_db 运行时副本删除，COV 每拍实时读 run_par
  （协议→算法向下依赖，同 meas 先例；无投递无缓存 = 顺序/幂等平凡成立）；
  iec104_pts_yc_set_deadband()/deadband() 保留为转发壳，壳内保留"成功清
  半截确认计数"语义并由 TC-IEC104-027 追加断言钉住（裁⑤）
- 104 地址映射（裁①）：0x8030~0x8038 死区 9 点 / 0x8040~0x8047 k 覆盖 /
  0x8048~0x804F b 覆盖（逐项地址本仓自定——复现规划 §5.4 权威表不在仓，
  送检点表到位后替换 run_par.c 顶部常量段一处；已在 IEC104 §3.4 表头挂账）；
  路由顺序 = run_par 表先、未命中落 prot_set——0x8027~0x802A 属 prot_set
  告警段永不覆盖，TC-IEC104-029 双向往返钉死；空隙地址自然 COT14/PN
- 通道系数覆盖 = adc_cal_set 代理（裁②a）：合法带/越带 [ERR] 留痕全复用，
  run_par 不存第二份系数（防双真源）；单侧写 RMW 用另一侧当前生效值；
  回显 = 生效值视图（文件坏值被哨兵回退 ROM 时主站看到的就是下游吃到的）；
  adc_cal 配套：+adc_cal_b_codes() 读取口（回显/RMW 用）+ set() 授权写者
  注记扩至 iec104Task 直通路径（单字原子契约同「数据可信」§4.4）
- 持久化（裁②b）：新事件位 SYS_EVT_RUN_PAR_SAVE(1<<8)；iec104Task 主循环
  peek 投递 → defaultTask run_par_store_save() 一条事件一趟 cfg_file_save
  整档外科（覆盖 [run_par] 9 键 + 联动 [adc_cal] 两段）；失败脏保留 = 天然
  重试（B7 prot_set 同款）。C_SE 现行无"暂停/测试态"门控——文档现行如此
  不造新语义，送检若要求接线点已写进 §3.4 注（裁④）

测试：新建 test/host/run_par（TC-RUNPAR-001~008，67 断言，真实 cfg 引擎 +
真实 adc_cal + 内存虚拟盘同 adc_cal 套件先例；[run_par] 注册契约/落盘往返/
外改文件即副本生效/两段式不提交不置脏/合法带拒+RMW+生效值回显/init 幂等
重注册留痕）；iec104 套扩真链 TU（cfg_file+adc_cal+run_par 非桩，141 断言：
+TC-IEC104-029 路由 + 壳清确认计数 3 断言）；meas 套静态更名 s_snap*→
s_ms_snap*（与 cfg_file.c s_snap 同 TU 相撞，D1 同款改名法，226 断言不变）；
iec104_serv 套补 run_par_dirty_peek 假件。id_registry 建族 TC-HOST-RUNPAR
（游标 008）+ TC-HOST-IEC104 游标 028→029；新钩子 run-par-unit-test +
iec104 钩子触发面随真链扩；uvprojx +run_par.c（合法入库）+ SIM_EXEMPT 登记
（模拟器不编 104 协议，已核实 CMake 面）。

文档：IEC104 §3.4 运行参数段表（含送检替换账/门控未来条件/代理声明）、§7、
§8 第 4 条、变更记录；网络配置说明新增 §3.5 [run_par] 键表；复现规划 §5.4
补运行参数段落实进度。**遗留（交 lead）**：数据可信 §4.4 "引擎 RAM 副本"
一节当时的措辞对象含 pts 侧副本，s_yc_db 删除后该句过时（裁③b 点名，§4.4
在写域外未动）。

gate：@build 0/0（Code=219620 RO=22036 RW=1280 ZI=132864）；vs 0cbae7d：
Flash +1912B、RAM(RW+ZI) +8B（37B 新静态被链接器并洞吸收）；iec104Task 栈
1456B/margin 43%、defaultTask 3032B 不变；id-check/doc-links/cppcheck/
coding-standard 实跑过；--all-files 全量 45 钩子实跑（43 绿 + 仅 mem-budget /
mem-numbers 两红 = 台账受管区 vs .map 漂移，回填属 lead 单写者区，批 1/道D-1
/D2 同口径）：gate: only mem-budget/mem-numbers pending lead ledger backfill
BOM/CR/U+FFFD/字面量 ASCII 逐文件自查通过。
 2026-10-25 13:15:41 +08:00
wandering1 48bc50e794 feat(遥测快照): 卡8 meas 双区快照模块 + adc_task 200ms 唯一发布点（道D M5） 
卡 8（App/algo/meas.*，新增；布局权威 docs/任务规划/数据可信.md §4.5）：
- meas_snap_t = §4.5 布局（sizeof 72 B；字段偏移由 TC-MEAS-002 钉死——卡 9/
  UI 按整体拷贝消费，破布局=破协议；谐波 k-bin 扩展（docs/算法/继电保护功能
  复现规划.md L2-8）只许尾部追加，留口注释已写进 meas.h）
- 并发 = phasor 双区 + 单字节索引翻转（L2-7 同型，无锁）；seq 只增供判"换帧"；
  meas_get 失败路径清零填充（-2 未就绪时调用方可安全读）
- 值口径 = A-lite 裁决（lead 2026-10-25 快裁，推翻票面全链）：基波有效值瞬时
  透传，复用 phasor_calc 纯核 → 与 phasor 使用区同拍同值（TC-MEAS-005 逐位
  相等钉死）；不做 4 点平均/方和根（§4.5"200 ms 是上送节拍不是平均窗"）
- 品质注入：CLIPPED 位图唯一源 = adc_cal_flags()（「数据可信」§4.2 三态表，
  编排方注入、本层不链 adc_cal）；取窗不足路 = IV|NT 且整帧 valid=0 但照常
  发布（品质节拍性刷新）；TEMP = 最新一点透传 + NT（「数据可信」决策 5）；
  MEAS_QDS_* 低字节 = 104 QDS 线上值（本层不 include 协议层头——分层方向，
  卡 9 直接截低字节映射）；OV 留位不填（判据待运行参数化，卡 10 域）
- adc_task.c 编排：新帧拍 freq_run() 后按 **tick 经过**分频（非拍计数，idle/
  skip 拍会拉长名义节拍）调 meas_tick()——全仓调用点数 = 1（「数据可信」§8
  风险表"快照双写"行评审判据）；meas_init 挂 adc_task_init（不动 app_main.c）；
  心跳新增 meas: 行（seq/v/ua·un·ia_mv/f/fv）作 M5 台架观测面
- 死区 2 点确认状态机本卡不建（卡 9 迁移 104 语义时随建，lead 裁③）；104 层
  现有 deadband 常量未动；频率点绑定归卡 11
- 实测采样类判据（读数 vs 注入源）= 待台架实测，本卡零台架动作

测试与注册：新套件 test/host/meas（226/226，链真源 meas+phasor+sample_ring
免桩；覆盖 seq/双区无撕裂/布局/品质汇总/回绕/守卫）；id_registry 建族
TC-HOST-MEAS（游标 011）；meas-unit-test 钩子 + SIM_EXEMPT 一条 + uvprojx
仅增 meas.c 单条挂载（diff 已核零 UV4 抖动）；App/algo/README.md §1/§2/
§3.9/§4 同步（设计说明大节与 AGENTS 口径留 lead 收口，同批 1 先例）

gate：@build 0 错 0 警（Code=216352 RO=21476 RW=1232 ZI=132128）；RAM 增量
RW+ZI = +152 B（快照双区恰 +144 B = 卡面 DoD；余 s_meas_ms 等编排状态），
IRAM1 57.8%→约 57.9%；Flash（Code+RO+RW）+696 B；adcTask 静态最坏链 1408 B
/ margin 1152 B（45%）PASS（stack_report 实测，无抬栈）；BOM/CR/U+FFFD/
字面量 ASCII 逐文件自查通过（未触碰带 BOM
文件）。pre-commit run --all-files 实跑：其余钩子全绿（含 doc-links/id-check/
覆盖率总闸/双端注册/ui-golden/全部主机单测套），仅 mem-budget + mem-numbers
两条红 = 台账受管区 vs .map 漂移（Flash/RAM 台账回填属 lead 单写者区，批 1
同口径）：
gate: only mem-budget/mem-numbers pending lead ledger backfill
 2026-10-25 10:02:10 +08:00
wandering1 ffd462ef3c feat(保护标定): 卡5 未标定闭锁 + 卡6 下游三常数重定 + 卡7 量纲回归单测 
卡 5（protect_task.c 第⑤闭锁源，「数据可信」§4.3 决策 1=闭锁）：
- UA/UN/IA 的 adc_cal VALID 未全置位 → prot_elm_init + 本拍不 eval；每拍现查
  flags、无自有状态（卡 12 标定写入后自动解锁）；判据链优先级 = 采样可信在前、
  标定可用在后（数据都是旧的谈不上标定）
- 边沿日志用 DBG_INFO 而非 [ERR]：未标定是出厂常态、非故障，且 @test 禁用
  [ERR]（「默认构建保护不动作 = 期望」的台架判据同步项已在 MR 报 lead）；
  SOE 分型 SOE_T_CAL_BLOCK/RESUME（soe_rec.h 枚举尾追加，值 6/7——reader 侧
  显示标签映射归道B reader，MR 已报）
- 台架旁路 = 编译期宏 DTU_BENCH（§4.3：不进 cfg 不进 104；本仓所有提交目标
  都不定义它 = 产品恒强制闭锁）

卡 6（下游三常数按工程量重定，依据同源 docs/任务规划/数据可信.md §2.3）：
- FREQ_AMP_MIN（freq.h）：语义从拟定码值域重定为二次值 V——50 V = 0.5×Un
  （标称 100 V），断保险/PT 空载/浮空必低于之；数值沿用 50.0f 属巧合并在
  注释明写；eng=0 过渡期本门恒失效 → OF/UF 按必不启动填充，与卡 5 同向安全
- k_yc[].deadband（iec104_pts.c）：9 点按「额定 0.5 %」规则重定：电压类
  0.5 %×100 V=0.5、电流类 0.5 %×1 A=0.005、频率维持 0.5 Hz 绝对值（非额定
  比，卡 10 运行参数化）；标称基准与 prot_set 头部同源，防两处真相
- g_prot_set_meta[]（prot_set.c）：数值/范围复核结论=不动（0~4×标称自洽），
  文件头补量纲口径块：A/V = 二次值、标称 100 V/1 A、OV120=1.2Un/UV20=.2Un/
  3U0 15=.15Un、OC1/2/3=10/5/2×Ir、OL=1.0×Ir；PS_ID_COUNT/blob VER 未动
- iec104 套件 TC-008 死区用例同步重定标（100.4 带内 / 101.25 越带），97/97

卡 7（test/host/prot_dim 新套件，真实链 adc_cal→ring→phasor→prot_elm）：
- 用例从 ADC 码值出发、显式写出 code↔二次值互逆换算（dim_code vs apply），
  折算点被旁路或量纲再错位断言立刻翻转（M4 判据⑥「不该动作时不动作」）
- 合成 ROM 覆写（#undef K_Q16 宏）模拟卡 12 标定后板级口径，走 adc_cal_set
  正规路径置 VALID；b=-30 码全链对消进 rms 断言
- 38/38：基线静默（含 OL 低定值陷阱）、反错配对照（raw 码值灌环复现历史事故
  必假动作 vs 经折算必静默）、OC1/2/3+OL+OV+UV+3U0 七类逐一：越限定值→
  受控启动拍→dly-2 不动作/+5 动作→返回系数带内保持→跌破释放、双件聚合位图
  独立性（撤 IA 只回 OC1）

测试与注册：prot-dim-unit-test 钩子 + TC-HOST-PROTDIM 族（游标 010，B 层口径
同 ADCHEALTH/ADCCAL 先例）；无新 MCU 源文件（uvprojx/SIM_EXEMPT 零改动）

gate：@build 0 错 0 警（Code=215640 RO=21388 RW=1220 ZI=131980 vs 基线
215440/19780/1220/131980 → Flash +1808 B、RAM 零增量）；protectTask 静态最坏
链 872 B/margin 1176 B（57%）PASS，adcTask 不变；staged 门禁除 mem-numbers/
mem-budget（台账漂移，回填归 lead）外全绿：
gate: only mem-budget/mem-numbers pending lead ledger backfill
BOM/CR/U+FFFD/字面量 ASCII 已逐文件自查（本轮未触碰带 BOM 文件）
 2026-10-25 05:22:17 +08:00
wandering1 3528644e9d feat(采集标定): 卡2 adc_cal 折算模块 + 卡4 系数落盘 + L5-2 码值贴轨检出 
卡 2（App/algo/adc_cal.*，新增；adc_task.c:335 折算点收口）：
- 模型：工程量 =(code+b)×k（「数据可信」§4.1）；k 以 int32 Q16(µV/码×65536)
  落盘、b 以 int32 码值落盘；ROM 默认 = 卡 1 定死的引脚侧 LSB，Q16 下整除无
  舍入（TPAFE 10,000,000=152.587890625 µV/码；STM32 52,800,000=805.6640625）
- adc_task 每拍 frame[s] 改 adc_cal_apply()（现单位 = ADC 引脚电压 V，eng=0，
  二次值语义等 VALID）；TEMP 透传码值（决策 5）；不缓存 k_f 副本——逐点由
  RAM 现值派生（无回调设计下杜绝陈旧系数；18k flops/s 可忽略）
- 三态 flags（§4.2）：VALID = 文件位图 ∧ k 在合法带；CLIPPED 按来源运行期
  派生（V0.2/N-18 后自动恒 0）；消费者判可用性只查 adc_cal_flags()
- 合法带哨兵：k∉ROM×[0.5,2.0] 或 |b|>8192 → 折算回退 ROM + 每通道每开机
  一条 [ERR] + VALID 压制（位图说谎也兜住）——同时挡坏文件与坏标定
- 两点标定公式 adc_cal_two_point() 算术核齐备（int64、±舍入界、斜率/零点
  守卫 -1/-2 分档）；台架两点标定（卡 12）按用户指示未跑，留台架注入口径：
  心跳新增 cal: 行（ua/un/ia_mv 定点 + vl/cl/rail 位图，未标定 vl 应恒 0x00、
  cl 应恒 0xE6，注入饱和电平 rail 位应起）

卡 4（[adc_cal] k_ua..k_in+valid / [adc_cal_ofs] b_ua..b_in，§4.4 布局）：
- 两段注册进 cfg 引擎（data_size 33/32，不挂回调——RAM 副本即生效值）；
  adc_cal_init() 落 app_main_init 内核前（注册必须先于 defaultTask 的
  cfg_file_load；跨任务读走 4 字节对齐字，µs 级混窗为「数据可信」§4.4 明载
  设计）；文件缺失/损坏 = 引擎回退工厂默认 = ROM 表本体（默认即理论系数）
- adc_cal_set()：整定写入口（属主上下文），越带拒绝 RAM 不动
- 单测走真实 cfg_file 引擎集成：文件值生效 / 越界 k 哨兵兜住且不报 VALID /
  超长损坏文件回退默认且 flags 无 VALID（卡 4 DoD 原句）/ 段缺失默认

L5-2（adc_health v1.2，越界门限按 FS 百分比、码值域与标定正交）：
- adc_health_rail_watch()：连续 20 拍（=一周波）贴同侧轨带（TPAFE±98%半量程、
  STM32 顶 98%/底 2%，门限由 adc_cal_rail_ths 供）且此前见过中带释放沿才
  锁存——空载恒 0 / 开机恒 0 合法工况不误报（短板评测 §6.2 判据①）；
  adc_task 编排：边沿 DBG_ERROR + SYSLOG 每开机一次 + 心跳 rail/edge 位图
- 健康用例 60/60（+13）：释放沿/清零/交替/双侧/init 复位/越界通道守卫

测试与注册：新套件 test/host/adc_cal（89/89，8 通道×≥3 码点期望值由 LSB
常数独立推导、Q16 无舍入、set 边界含端点、两点还原合成 k/b 往返）；
编号形态返工一轮：TC-ADCCAL-00A~00D 改 014~017、注释 FS-1 字样改写、
id_registry 族 pattern 转义修正、族游标登至 017；coding-standard 返工：
公开实现函数补齐函数头注释块（CODE-RULE-09）
uvprojx 仅增 adc_cal.c 一条挂载（diff 已核零抖动）；SIM_EXEMPT/id_registry
(TC-HOST-ADCCAL 族)/adc-cal-unit-test 钩子行按 new-source-file 与 B 层口径
补齐；覆盖率 34/34 套件 89.6%，adc_cal.c 99.2%（baseline --update 属共享
台账文件，留 lead done 后统一回填）

gate：@build 0 错 0 警（Code=215440 RO=19780 RW=1220 ZI=131980）；
RAM 增量 +144 B（RW+16/ZI+128：贴轨 9×6B + 两段 RAM 副本，IRAM1 57.7%→
约 57.8%）；Flash +1336B/+920B RO。adcTask 栈 worst=1344B margin 1216B
(47%) PASS（stack_report 实测）。staged 门禁除 mem-numbers/mem-budget 外
全绿（该两条 = 台账漂移，回填 --write 落 docs/内存管理/** 单写者区，按
Lead 既定例外归 lead done 后处理）：
gate: only mem-budget/mem-numbers pending lead ledger backfill
BOM/CR/U+FFFD/字面量 ASCII 已逐文件自查（本次未触碰任何带 BOM 文件）
 2026-10-25 04:21:12 +08:00
wandering1 d4867ddbe2 fix(algo): Q10 定值宏改单精度；收口 Flash 优化簇并更正审查报告三处误判 
影响面：一个头文件宏（App/algo/prot_set.h）+ 七份文档口径；固件行为逐位
等价，无功能变化。门禁全绿后提交，未推送。

验证链
- @build：0 错 0 警；Code 213,520 → 213,188（−332 B），RO/RW/ZI 不变。
- 真机 @test PASS：戳 fw build: Oct 22 2026 10:36:15 suite=NONE；无
  [ERR]/ERROR/FAIL/Fault；708 ms 到 net init: OK；protect task start、
  i104: listening on 2404、[STACK] 三面水位齐。
- 主机单测：prot_set 90/90、prot_elm 47/47、iec104 97/97。
- 等价性穷举：宏内 42 个字面量；int32 全域 ÷1024 往返 4,494,305 例零
  差异；×1024 方向 20 万随机 float 零差异（×/÷1024 是 2^10 指数平移，
  不产生尾数舍入）→ 定值默认值/上下限、校验和、104 上送值全部不变。

F-6 双精度软浮点（已落地）
- 两个 Q10 宏去掉显式 (double)、1024.0 → 1024.0f：保护判据每 20 ms 每
  元件 3 次定值读取改走 F407 单精度 FPU，不再软件模拟。
- .map 里 dflti/d2f/f2d/dfixi/fepilogue 共 300 B 消失；自研侧对双精度
  helper 的引用归零。
- 更正报告归因：全库 0 处 %f（扫 App/Src/Inc/Drivers 共 173 个 .c/.h），
  剩下 dadd/dmul/ddiv/depilogue/dfixul = 1,018 B 由 MicroLIB printfa.o 的
  _printf_core → _fp_digits 无条件引用，只要还用 snprintf 就删不掉；
  报告"把 %f 改整数刻度"没有可执行对象。

F-4 LVGL 死代码（判定不做）
- 报告列的五项字节数逐字节仍准（合计 10,060 B），但没有一项有开关：
  根因是 lv_draw_sw.c 的 execute_drawing() 无条件 switch 引用全部 task
  类型，链接器 --remove 无从下手。
- 唯一总开关 LV_DRAW_SW_COMPLEX 被 ui_deco.c 的"浅 V"3 px 粗斜腿依赖
  （斜段与其所需 mask 核心都在该开关内）；2026-09-03 已实测失败并把两端
  =1 固化 → UI_设计架构.md §1.4 第 7 条。
- 报告原"mask/grad 是文字与矩形绘制必经路径"证伪：字形走 blend 层
  mask_buf，不经 lv_draw_sw_mask_*。
- 剩余路线需给 Lib/lvgl 打本地补丁（上限 ≈16 KB），而 Flash 仅占 22.1%、
  无 OTA/双镜像预算 → 收益不抵代价；图片链同理不打补丁。

F-5 uvprojx 空 TU（降级为观察项）
- 实测 326 个 .c / LVGL 201 个 / .map 零产出 127 个；但增量构建 4~5 s、
  空 TU 只在全量重建或改 lv_conf.h 时才重编，且远程 CI 刻意不跑 @build。
- 报告原"编译时长 −40%"无基线记录，不复述；真要做用 Keil 原生
  <IncludeInBuild>0</IncludeInBuild>，且排在任何 lv_conf.h 改动之后。

文档与台账
- 审查报告 §0.1/§0.4/§1/注册表/§5.1/§5.4/§6.4/W4 行按实测更正，补
  2026-10-22 变更记录行与 F-4/F-6 记录去处行；登记簿 N-28 改写为"三项
  已判定、仅剩 F-5 观察项"。
- 更正 FTL 写回缓存旧口径（sys_log_mcu.c 注释、运行与自检记录设计说明
  §4.4、实机测试实施指南 §9.1）：f_close 经 sync_fs → CTRL_SYNC →
  ftl_flush_cache 已落盘，"写另一个文件逼出脏页"不是必要条件；2026-10-02
  那次"复位后写入整段丢失"根因是 dhara resume 锚错 checkpoint。
- 部署环境要求 §3.3 资源预算由 2026-09-11 快照刷新为 2026-10-22 实测，
  并补 CCM 红线行（旧"SRAM 95.4%/极度紧张"的说法早已失效）。
- ram_baseline.py --update/--write、check_mem_numbers.py --write 已回填：
  mem-budget（SRAM1 57.4% / CCM 87.9%，阈值 92%）与 mem-numbers 转绿。
 2026-10-22 11:03:05 +08:00
wandering1 790e153cd6 fix(adc_input): 丢帧计数改按帧点数累计，与 TPAFE 侧 tgap 同单位 
读码确认的口径缺陷：两片转换器的丢帧计数单位不一致——TPAFE 侧
adc_health_tpafe_gaps() 按 (d-1) 加权记「帧点数」，STM32 侧
adc_input_stm32_gaps() 每次事件只 +1 记「次数」。两者都被当作心跳字段
并排打印（adc1_gap / tgap），一次跨多帧时数值就分叉：同样丢 3 帧，
一边记 2、一边记 1。跨字段对比或做除法会得出错误结论。

选 A（改代码，真对称）而不是只改字段名：
- 单拍超一帧（d=2）时两者数值相同，历史上绝大多数样本本来就等价，
  换单位对既有判读习惯冲击很小；
- 只在一次跨 ≥2 帧时分叉，而那正是心跳日志突发期最常见的形态，
  留在文档里当"注意点"迟早还会读错一次。

改动：
- adc_input.c：s_stm32_gaps += (d - 1u)（d = seq - s_dma_seq_seen，
  顺带把已算过的差值提成局部变量 d，不再重复算一遍）
- adc_input.h / adc_input.c 函数头：单位写明「Σ 每次前进的超出部分」，
  并点名 2026-10-21 之前固件该字段是次数口径，跨版本日志不可直接对比
- 用例：原两档只跨 1 帧（前进 2 记 1），钉不出单位；补第二档——连投
  3 帧不消费（一次跨 2 帧）必须记 2 点、累计 1+2=3。补充断言沿用所属
  用例覆盖点，不另立新编号，也不在文档外复制用例号（编号门禁按文件内
  实例数比对台账豁免，多写一处即被判新债）
- 文档同步：ADC采样节拍设计说明 §8/§9 字段口径与稳态基线、采集与算法
  层设计说明 §3/§4、采样有效性校验设计说明 §6.2/§10/§11（并把"两车道
  单位不同"从观测盲区降级为"历史日志口径差异"）、ADC输入层单元测试
  说明用例表该行；两张配图生成器文案同步

实测：
- @build 0 错 0 警；Program Size 与上一提交**逐字节相同**（Code=213520
  RW=1184 ZI=131504）——编译器早已为半区推导算过同一差值并复用，
  故本次净增 0 B，不产生新的台账漂移
- 主机单测：ADC 输入层 103/103、ADC 有效性 45/45
- stack_report：adcTask 1320 B / protectTask 872 B 均不变
- 字节卫生：BOM 无 / CR 0 / U+FFFD 0 / 文件尾换行齐
- id-check：Passed（曾因新增用例号实例触发"台账之外 +2"，已按不复制
  用例号的方式消除，未动 id_known_backlog.json 台账）

gate: only mem-budget/mem-numbers pending lead ledger backfill
pre-commit run --all-files 失败仅这两条，漂移量来自上一条提交 6f90600
（+96 B Code / +24 B ZI）；本条自身 0 B。按并行分支约定本分支不跑
--write，台账由 Lead 合并后统一回填。
 2026-10-22 00:43:32 +08:00
wandering1 9f826dbb4d fix(protect): 采样陈旧时独立闭锁保护（判定层失明的兜底门） 
问题：L5-4 闭锁读的 adc_health_flags() 只有 adcTask 每拍跑
adc_health_check() 才可能置位。TIM3 一停，adcTask 就永久阻塞在
osThreadFlagsWait（刻意的 fail-safe），check() 不再执行 → stall 位
永远是 0，而 protectTask 仍每 20 ms 拿冻在最后一帧的相量继续判据。
窗口最坏约 800 ms（停喂阈值）+ 2498 ms（IWDG 标称）≈ 3.3 s。

方案：保护侧建一条与消费者存活完全解耦的兜底新鲜度门。
- adc_health.c/h 新增 adc_health_age_stale()：无模块状态的纯判据，
  参照系 adc_health_age_t 由调用方自存。故意不让 protectTask 去调
  adc_health_check()——那是「每拍一次、单写者」的契约，两个上下文
  同写会互相刷新差值基线，把现有判定层一起弄坏。
- 新增 ADC_HF_STALE = bit8（与判定层 bit0..bit7 位段错开）。本位
  不由判定层写、不进 sticky、不进编排层 logged 位图。
- protect_task.c 用自己的时基直接读两个**中断侧递增**的计数器
  （tpafe5160_frame_seq / adc_input_stm32_seq），并入掩码。两条车道
  各自一份 primed：共用会让先观测的那条把标志置 1，另一条首拍拿
  adv_ms = 0 算年龄 → 开机即误锁保护。
- 门限 PROT_STALE_AGE_MS = 100 + 20 = 120 ms，买的是时序阶梯：
  判定层活着时它先报 0x1/0x2（带日志与自检留痕），死了只出现
  0x100。闭锁最迟 140 ms，仍远小于最小动作延时（默认 1000 ms）。

实测：
- @build 0 错 0 警：Code 213424 → 213520（+96 B）；ZI 131480 →
  131504（+24 B = 两份 age 结构）；RW-data 1184 不变
- stack_report：protectTask 静态最坏链 872 B 不变（余 1176 B / 57%）、
  adcTask 1320 B 不变——新判据无日志，不进最坏链
- 主机单测 45/45（新增 TC-ADCHEALTH-012..017 共 14 条断言：首拍只建
  基线 / 超拍不判老 / 门限含等号 / 跨 tick 回绕 / 倒退按分工不判老 /
  双观察者互不污染 / 空参数不判老）
- 台架注入（一次性停 TIM3 300 ms 探针，验完已撤；探针固件与最终
  固件 Program Size 逐字节相同）：
  [+5462ms] [ERR][PROT] sampling FAULT -> protection blocked (hf=0x00000100)
  [+5757ms] [PROT] sampling recovered -> protection resumed
  同次开机 [ADC_TASK] health: 出现 0 次；MISS 快照缺的正是 bit6
  （0x1F7 - 0x1B7 = 0x40，实证 adcTask 当时确实阻塞，不是"在跑但没报"）；
  reset cause: 仅 1 次（300 ms 被 800 ms 容忍吸收，闭锁不靠复位）
  证据 docs/测试说明/boot_log_data/20261021_probe_stale_gate_boot_log.txt
- 字节卫生：BOM 无 / CR 0 / U+FFFD 0；新增行无非法字面量

gate: only mem-budget/mem-numbers pending lead ledger backfill
pre-commit run --all-files 失败仅这两条（台账受管快照与本树 .map 的
Flash/RAM 水位漂移，即本次 +96 B Code、+24 B ZI）。按并行分支约定
本分支不跑 --write，台账由 Lead 合并后统一回填。

文档同步：设计说明新增 §15（原相关文档改 §16），§7 位表加 bit8 行、
§8 责任矩阵与「已知窗口」段改写为已闭合、§10 盲区第 3 条、§11 用例
表、§12 判读手册、§14 改前清单全部跟上；位图配图补 bit8 列，并修掉
生成器把列数硬编码成 8 列导致新列被备注框盖住的问题。
 2026-10-22 00:43:32 +08:00
wandering1 5a9988b557 chore(注释): 清掉源码里不可检索的过程编码 
清掉的（读者无从解析、且所指文档已不存在）
- 已删任务文档的编号：Task #32、其内部 §5 / §4.3、P1-5、P0-2、P1-4a、
  "方案 a"、"Lead 批准 2026-10-12"
- 正文里当代词用的文件版本号："（v2.7 起为 AboveNormal）""已随 v2.0 事件
  驱动改造删除""（v2.0：DMA 消费）""见文件头 v1.3 说明"等 → 改写成陈述现状
- 测试与脚本同类：adc_input 桩头"v2.0：DMA 模型"、stub/adc.h 的 v2.0、
  check_cubemx_survival.py 段头的"2026-10-10 v2.8"、run_all_suites.py 的"方案 A"

刻意保留
- 可检索登记簿锚点：P-AUDIT 真条目（P0-1/P1-8/P2-1/P2-9/P3-11）、S6/S11、
  E-31/E-44、N-18/N-23/N-32、B1/B5/B7/B8、L1-x~L5-x 功能号
- 文件头修改记录块内的 vN.M（规范 V1.0 §2.1/§2.2 要求保留该块；块内编号
  在本文件内自洽可读）

顺带纠正注释与代码已经不一致的过时事实
- 仍把 TIM6 写成现行节拍源：Src/main.c 的 include 注释与回调注释、
  Src/freertos.c 的 adcTask 块 → 改 TIM3；adc_input.h 修订条目里"ADC1 只认
  TIM2/TIM3/TIM8 的 TRGO"不准确 → 换成指向判据（ADC采样节拍设计说明 §3.2）
- App/algo/phasor.c 双区注释称"唯一消费者是 adcTask、为后续保护任务预留"，
  实际 protectTask 已跨上下文读（prot_elm_run -> phasor_get）→ 改为"读者跨
  adcTask 心跳与 protectTask 判据两个上下文，勿改加锁、勿取消双区"，并同步
  修正 docs/算法/采集与算法层设计说明.md 同一句
- adc_tick_irq_notify() 的"拒绝 ISR 内计算"理由仍写"内含 2 ms 忙等"（DMA 化
  后已无忙等）→ 换成三条真实理由：任务级共享数据 / 计算量 / 生成区回调
- 裸 §5（指代不明）与"规划 §1.6 / 规划 §4"昵称式 → 写成完整路径紧邻式

字节卫生（Edit 会静默剥 BOM）
- App/task/ui_task.c 与 Drivers/BSP/UI/ui_net_sink.c 被剥掉 BOM 两次，均按
  3 字节 EF BB BF 前缀补回并复验；全部 20 个文件 CR=0、U+FFFD=0、无行尾空白

门禁
- @build 0 错误 0 警告，且 Program Size 与清理前逐项相同
  （Code=213356 RO=18580 RW=1184 ZI=131480）→ 纯注释改动、中文未被误重编码
- ui-golden 首跑红：新工作树缺被 gitignore 的黄金参考 simulator/tests/ref/
  （不入库、只在主工作树生成过）；从主工作树复制该基线后复跑通过 → 注释改动
  零像素影响
- 全套 pre-commit 在这 20 个文件上 Passed（coding-standard / cppcheck /
  6 个主机单测 / doc-links / task-table / mem-numbers / cubemx-survival /
  registration-check / mem-budget / font-charset / ui-golden / id-check）
- id-check 可判定比例 82.71% -> 82.88%（删掉的是"形似 P-AUDIT 但查无定义"的
  假锚点），悬空引用 863 -> 854
 2026-10-21 11:39:53 +08:00
wandering1 64d8b052b1 docs(algo): App/algo/README 缩成目录索引，详细设计迁入 docs/算法 
拆分层级
- 新建 docs/算法/采集与算法层设计说明.md（413 行、13 节）承接机制、契约、
  判据与设计理由：定位与边界 / 数据流与初始化落点 / adc_input / adc_health /
  sample_ring / phasor / freq（7.1 为什么自适应窗、7.2 判据 J1~J6）/
  prot_set / prot_elm / 关键约定与禁令 / 资源足迹 / 验证与判读 / 相关文档
- App/algo/README.md 360 -> 128 行：只留文件清单、依赖、逐文件"改代码必须
  知道"的红线、构建与测试入口、新增模块动作；深挖改成逐条指针
- README 保留 §3.1-§3.7 原编号，既有"§3.7"引用不失效

索引与引用同步
- 索引：docs/README.md §5.2 新增行；项目架构总览主题表拆成"设计与判据 /
  目录索引"两行；AGENTS.md 与 App/README.md 指向（后者原文还写着 L1/L2）
- 按内容重指（编号仍在但内容已搬走，只核编号会静默指错）：App/algo/freq.h、
  test/host/freq/freq_test.c、run_unit_test.py、继电保护规划 L2-4 行、
  pre-commit使用说明 J4 行 -> 指向设计说明
- ADC采样节拍设计说明的两处指向同步改到新文档

修 README 内过时事实
- 挂载写"八个 .c"，实际 uvprojx 内 7 个
- SIM_EXEMPT 写"prot_set / freq 才登记豁免"，实际七个全在表内
- freq-unit-test 标"待登记"，实际已在 .pre-commit-config.yaml
- 定值项数一处 31->40、一处 32->40；blob 144->176 B 证明是 32->40
- 用例与判据数字不再三处复制：属主是 test/host/<模块>/ 与 docs/测试说明/

门禁
- doc-links --all 无新增问题；--sections-strict 覆盖 10 篇文档通过
- id-check 可判定 82.65%（基线 82.6，容差 0.1）；TC 双向追溯差异 124 处不变
- registration-check PASS（1 条已知 WARN）；freq 单测 46/46；@build 0 错 0 警
- 全部改动文件无 BOM、无 CR、U+FFFD = 0
 2026-10-21 11:39:53 +08:00
wandering1 0f0d002afc docs(ADC): 采样节拍设计说明只留现状，历史决策与台架记录移出 
删除（已确定的决策与过程记录，无现状信息量）
- §2 方案选型（方案 A 推荐 / 方案 B 备选与结论）
- §9 变更记录整表（9 行"已实现 / 已验收 / 已落地 / 复核修正"叙事）
- §7.1、§10.3、§11.5 三张台架实测对照表 + 反向验证记录 + boot_log 证据行
- 用户决策与过程编号（Task #32 P1-5 方案 a、B1、P0-1/P0-2、v2.0/v2.2/v2.7/v2.8、
  "规划未预见""原规划写错了"更正叙事）
- §4 代码改造清单（改造已完成）与 §8 / §10.5 的后续规划口吻

保留并补齐现状
- 链路总览（新增 TIM3 同源 Mermaid）· 实现落点表 · TIM3 配置与"为什么是 TIM3"
  （F4 触发清单是硬约束）· ADC1 + DMA 四条硬约束与半区无竞态推导 · 上电自校准
  · TPAFE 侧契约与原子快照 · 就绪门与节拍缺失 fail-safe · 单周期时序
  · 心跳计数逐个判读（含相位伪影为何阈值取 2）· 性能与资源特征
  · 设计边界与已知代价（N-18 无同刻性、滞后一拍、TPAFE 未 DMA 化的前提未定、
  调频能力现状）· 设计铁律
- 468 -> 344 行

顺带修掉文档自相矛盾
- 原 §3 / §4 仍在教人配 TIM6（§11 已改 TIM3）-> 全文统一 TIM3
- 上位需求引用写成 继电保护功能复现规划.md §3.2，实际 L1-1 在 §3.1

连带引用同步（7 文件 8 处）
- App/algo/adc_input.c -> §8；App/task/adc_task.c -> §6；Src/main.c -> §3.3；
  Src/freertos.c -> §9 与 §10（顺带纠正已失效的"ADC 2 ms 忙等"表述，DMA 化后
  单拍取数已零忙等）
- 看门狗设计说明 §6 与 §9 / §4.4；ADC通道映射说明 §4 与 §6；
  继电保护功能复现规划 §3.2
- 其中 2 处活断链 doc-links --all 抓不到（整行含"已消""已实现"状态词被豁免），
  另写脚本按「文档名 + 章节号」全库扫出后修复

门禁
- doc-links --all（非 SDL2 问题 0，可判定 57% -> 58%）与 --sections-strict 通过
- no-mojibake / trailing-whitespace / end-of-file-fixer / id-check 通过；
  task-table / mem-numbers 一致；@build 0 错误 0 警告
- 改动文件均无 BOM、无 CR、U+FFFD = 0；CubeMX 文件的注释改动都落在 USER CODE 区
 2026-10-21 11:39:52 +08:00
wandering1 bda7ab2b50 refactor(编号): 16 个测试模块码单词化 + 门禁识别面连带放宽 
批 2（用户授权改名 + 「新名要一眼看懂」裁定）
- 16 个有歧义模块码单词化，共 1,146 处随 scripts/rename_ids.py 改写：
  AI→ADCIN、AH→ADCHEALTH、PS→PROTSET、PE→PROTELEM、PH→PHASOR、
  TS→TIMESYNC、VL→VOLLOCK、NP→NANDPORT、CFG→CONFIG、CLK→SYSCLK、
  WD→WATCHDOG、STO→STORAGE、SH→SHA256、FA→FTPAUTH、FR→FREQ、104→IEC104
- 不动 NET/GD5F/RTC/SOE/UI/ADC/LOG/RS485/TOOL（已是单词、芯片名或业界通用词，
  改了纯属 churn）
- 别名按全局登记：这批字面量已完全限定（TC-<码>-<nnn>），不存在裸形多义
- 映射表存档 scripts/rename_maps/batch2.json 作审计轨迹；§6 模块码表同步

连带修门禁（关键教训）
- 模块码涨到 9 位（ADCHEALTH/WATCHDOG）后，候选正则与族正则的 {0,4} 上界
  会让改名后的号**整批从门禁眼里消失**：实测编号字面量从 8271 掉到 7315、
  悬空假降 490 处。已放宽到 {0,9} 并写进 §6 注记
- 结论：改名批次必须连带复核识别面，只改数据不改判据 = 静默放行；
  这次是靠「可判定比例跌破基线即失败」那条线拦下来的

现状与遗留
- 校验 1 未登记前缀 0 处；可判定比例 82.71%（基线 82.6%，只涨不跌成立）
- 遗留：7 个模块的「单元测试说明.md」仍缺（PROTSET 116、NANDPORT 109、
  PROTELEM 65、FREQ 48、FTPAUTH 45、SHA256 25、SOE 14 处悬空）——改名不解决
  缺文档，处置方式待议
- 遗留：T-2/T-3/T-4/T-6 历史任务号悬空（别名表未收全，属本工具批次漏项）
- 未改任何 C/H 可编译语义（仅注释与宏名内的编号），故不需 @build
 2026-10-21 09:53:28 +08:00
wandering1 0264b49489 feat(algo): B8 频率测量层 + 过频/低频保护（L3-5） 
新增 App/algo/freq.c/h：由 L2 基波相量导出系统频率。相邻两拍共轭
乘积 P=Z(m)·conj(Z(m-1)) 取角 = 每拍相位增量（免显式解缠绕），再按
自适应窗长 K_eff=round(8·Fs/(2·f_hat))（45~55 Hz 段 73~89 拍）做滑动
平均。定长窗受 20 点矩形窗负序泄漏纹波限制（实测扫频最坏 0.317 Hz；
60 拍 Kay 复数和 0.197 Hz，交叉项和角不按 1/K^2 衰减），自适应窗使
窗长恰为纹波周期 fs/(2f) 整数倍 -> 最坏 0.0101 Hz。推导与两轮弯路
写在 freq.c 文件头。

假值钳制带取 35~65 Hz，刻意宽于系统合理带 40.5~60.5：单拍相位差本身
带 ±5 Hz 泄漏纹波，贴边钳制会非对称丢弃纹波半周 -> 均值偏置（实测
45 Hz 点 +0.16 Hz）。系统合理带由 OF/UF 定值范围在消费侧把关。
幅值门 FREQ_AMP_MIN=50 码（拟定，待 L1-5 标定复核）：低于门判无有效
波形，停更新、valid 清零、读数保持 -> 浮空/PT 断线不发散。源优先级
UA(C02)->IA(C01)，按名前缀解析、每拍动态回退，切换即废相位基准。

prot_set：尾追加 8 项（PS_ID_COUNT 32->40，编号不回收）
OF_EN/OF_HZ/OF_DLY/UF_EN/UF_HZ/UF_DLY/RET_OF/RET_UF。OF/UF 逐项通讯
地址不在本仓库 -> 全部 comm_addr=0 本地项（104 C_SE 不可寻址，待对照
参考表补）。频率返回系数独立（0.99/1.01），勿与电气量 0.95/1.05 共用。
bad_mask 随项数扩为 uint64_t。PROT_SET_BLOB_VER 1->2。

prot_set_store：换代与损坏分流。load 返回 2 = 版本/项数换代（本文件
打 INFO "prot set blob version change, defaults in use"），-1 = 真损坏
（defaultTask 按 CORRUPT 报 ERROR + 自检留痕）。B7 旧档（ver=1/32 项）
升级首启属预期路径，不得报成损坏。语义分流收在属主文件内，
default_task.c 不动。

prot_elm：实例表加 src 字段（0=phasor rms，1=freq），PE_OF/PE_UF 尾
追加（PE_COUNT 7->9）。freq 无有效读数按方向填"必不启动"值（过量 0 /
欠量 1e30 -> 滞回比较恒假 -> 元件复位），不整拍跳过——频率源缺失不得
饿死电流/电压类元件（B5 行为不回归）。OF/UF 暂未映射独立 104 遥信点，
动作只经 YX15 保护总聚合可见（送检点表 = B10）。

板端接线：adcTask 在 phasor_run() 之后同拍调 freq_run()；心跳/首拍日志
追加 freq(<tag>): f=%ld valid=%u (x0.01)（MicroLIB 无 %f）。app_main
内核前 freq_init()。

主机单测：freq 46 用例（J1 扫频 45~55 Hz <=0.02 Hz 实测最坏 0.0101；
J2 噪声 1% <=0.10 实测 0.0160；J3 启动收敛 <=40 ms 实测 20；J4 阶跃
50->51 <=120 ms 实测 98；J5 浮空 valid=0 不发散；J6 跳变 60 ms 内回
±0.05；另直流 8000 码 / 3-5 次谐波 20%/10% / UA->IA 回退）。
prot_set 90（+TC-PS-011 OF/UF 行 + 64 位 bad_mask bit39 + 旧档拒绝）、
prot_elm 47（+OF/UF 滞回与方向隔离 + run() 测频接线）。回归：phasor
57、iec104 94 全绿。

J4=120 ms 是"精度优先于响应"的显式取舍（Lead 批准）：4 周波窗换
0.317->0.0101 Hz，测频响应 98 ms << OF/UF 定时限默认 1000 ms（占
总动作时间 <10%），暂态另有 J6 <=60 ms 兜底。

注册：freq.c 入 uvprojx algo 组 + check_registration.py SIM_EXEMPT
（纯算法、模拟器无消费路径，照 prot_set.c 先例）。

@build 0 错误 0 警告（Code=207468 RO=18304 RW=1068 ZI=153084）。
RAM：RW_IRAM1 96096->96728 B（+632 B，73.3%->73.8%）、RW_CCM 不变
57376 B（87.9%）、Flash 224596->226840 B（+2244 B，21.4%->21.6%）；
台账随合并由 Lead 回填。stack_report：adcTask 静态最坏链 1320 B /
余量 1240 B（48%）改前后完全不变（freq_run 帧未进最坏链，无需抬栈）；
protectTask 链 872 B / 余 1176 B（57%）同样不变。

gate: only mem-budget/mem-numbers pending lead ledger backfill
--------------------------------------------------------------
门禁实跑（pre-commit run --all-files，Lead 批准 --no-verify 提交）：
28 Passed / 2 Failed，失败仅 mem-numbers 与 mem-budget 两条——均为
docs/内存管理 受管快照与本 .map 不一致（台账由 Lead 每次合并后
--write 回填，避免多分支同改受管表冲突）。其余含 doc-links /
coding-standard / no-mojibake / cppcheck / registration-check /
13 条主机单测钩子全 Passed（gitlint 属 commit-msg 阶段，不在该次
--all-files 内）。ci_local L0.5 全绿（freq 46/46 等）。
字节卫生自查（--no-verify 跳过卫生钩子，故手工核）：17 个暂存文件
全部 BOM=无 / CR=0（纯 LF）/ U+FFFD=0；自研 .c/.h 去注释后字符串
字面量 100% ASCII（唯一非 ASCII 字面量在 test/host/iec104/iec104_test.c
的既有用例名，非本次改动行；test/ 不在 coding-standard 钩子范围）。
 2026-10-12 19:16:37 +08:00
wandering1 1fe163ba7b feat(protect): B7 定值持久化 + 全局软压板 + L5-1 竞态收口（W1 代码腿完成） 
- prot_set：新增 PS_GLOBAL_EN（枚举尾追加）；值区双缓冲 + 单字交换，
  prot_set_set_sealed 原子写+封存；selfcheck 改 seqlock 式复核
  （提交撞见 = 本轮跳过）→ 收口 B5 登记的 µs 级误锁窗口
- 持久化：新增 App/cfg/prot_set_store.c/h，/prot_set.bin blob
  （magic+版本+计数+值区+sum32 正/反码对，144 B）走 cfg_store_write_atomic；
  uvprojx 注册 + 模拟器豁免点名（check_registration 同步）
- 写路径：C_SE/YK12 执行段置脏 → iec104Task 投递 SYS_EVT_PROT_SET_SAVE
  （事件位 bit7）→ defaultTask（配置引擎属主）落盘，写失败脏回置 = 天然
  重试；装载 = STORAGE_READY 屏障前整表原子 parse（损坏保出厂默认 +
  自检留痕 prot set corrupt；文件缺失 = 首启静默）
- YK12 转真：两段式（选择段校验 DPC / 执行段 set_sealed），protectTask
  下一拍读退出态 → 复位元件 + 停判据（global plate OUT/IN 边沿日志）；
  本地定值项 comm_addr=0 显式不可寻址（防 IOA=0 误命中首个本地项）
- 单测：prot_set 63 断言（+33：软压板/原子写/脏握手/blob 往返/损坏拒绝/
  伪造自洽越界对抗样本）、iec104 94 断言（+7：YK12 两段转真/置脏/本地项
  C_RD EVI）
- 文档：IEC104 设计说明 §3.3/§3.4/§7、保护规划 §3.5 L5-1/§7 P4/变更记录、
  App/algo 与 App/cfg README、W1 任务卡 B7→🟦（台架腿 🔴 待窗口，随 B6 同窗）
- 验证：@build 0 错 0 警（Code=205500，ZI +280 = 双缓冲+blob 缓冲）；
  ci_local 全绿（L0 27 钩子 + L0.5 13 套件 826 断言）；ram_baseline 台账
  受管区与内存快照已同步；19 个改动文件无 BOM / LF / 零乱码
 2026-10-12 15:01:49 +08:00
wandering1 90db528032 W1 功能主线完成：内存台账三件套(W1-0) + IEC104 上行(B4) + protectTask 板端接线(B5) 
W1-0 台账三件套：scripts/ram_baseline.py（四模式）+ ram_baseline.tsv 趋势 +
docs/内存管理/RAM预算台账.md + pre-commit mem-budget 钩子（RW_IRAM1/RW_CCM >92%
即 FAIL + Top-10 附表）；审查报告 §5.5 三条闭环。

B4 IEC 60870-5-104 上行（被控站，TCP 2404）：App/protocol/iec104/ 三模块
（asdu 编解码 / pts 点表+数据源 vtable / link APCI+FSM，纯逻辑零 I/O）+
App/task/iec104_serv.c（iec104Task，NET_READY 屏障 100ms 分片喂位）。
82 断言 L0.5 全绿 + iec104-unit-test 钩子（第 31 钩子）；
设计说明 docs/子系统设计/IEC104上行设计说明.md 全量回填。

B5 protectTask（L3 板端接线）：App/task/protect_task.c——20ms 判据节拍
prot_elm_run + L5-4 采样故障闭锁（adc_health 电平位→元件复位）+ L5-1 定值
校验和巡检；新增 prot_elm_request_reset() 收口跨上下文复归（104 YK11 落请求、
eval 头部消费）；定值/元件初始化移入 app_main_init（内核前）。TC-PE-010
（prot_elm 28 用例）。

门禁与内存：TASK_WD_PROTECT=8 入 required_mask（产品 0x77→0x1F7、HW 层
0x1F5，看门狗单测 39 断言同步）；FreeRTOS 堆 48→56KB（.ioc L1 参数 +
FreeRTOSConfig.h 同步，RAM预算台账 §6 登记配额 48→56KB）。
ZI 144,008→152,204（+8,196 B = 堆 +8KB，B5 扩容）；Code=204,348。
stack_report：protectTask 512 words 静态链 872 B/余 57%、iec104Task
640 words 1456 B/余 43% 均 PASS；RW_IRAM1 73.1% / RW_CCM 87.9%（<92%）。

验证：@build 0 错 0 警；ci_local 全绿（31 钩子 + 13 主机侧单测）；
doc-links 135 文档 PASS。登记簿 B4/B5 销项、W1 波次完成；保护规划/看门狗
说明/AGENTS（9 任务）/RAM 三文档全部同步。

遗留（验收窗口，非代码空洞）：台架第三方 104 主站往返（送检窗口）、
标准源注入动作判据、@test PROT 锚点 + protect 栈水位 + 新堆 min_ever 复测。
 2026-10-12 12:36:23 +08:00
wandering1 c936441c83 门禁扩容：新增 lv-conf-sync、simulator/ 纳入全部钩子；含 L3 定值/元件框架落地 
本轮把"自研代码落在门禁之外"的口子收掉，同时落地 LVGL 特性裁剪与
L3 保护定值/元件框架。

门禁（.pre-commit-config.yaml，26 个钩子）
- 新增 scripts/check_lv_conf_sync.py + 钩子 lv-conf-sync：比对两份
  lv_conf.h 的**生效值**（未定义则取 lv_conf_internal.h 兜底默认），
  抓 MISMATCH / LVGL 不认的宏名 / 同文件重复定义
- 顶层 exclude 删掉 simulator/：其下 21 个 tracked 文件全是本项目自研
  代码，生成物（build/、SDL2/、tests/ref/、shot*）已在 .gitignore；
  doc-links 的 exclude 同步删除
- lv-conf-sync 的 files: 覆盖两端配置 → 只改 simulator/lv_conf.h 也触发
  （pre-commit 4.x 已移除 always: true，实测只告警并跳过，无兜底开关）
- 新增 prot-set-unit-test / prot-elm-unit-test 两个主机侧单测钩子
- S11(2.3.5) 判定细化：禁的是"用路径找文件"，尖括号系统头带子目录
  （如 <sys/stat.h>）不再误报；全仓库复核仅 2 处项目代码判定变化

模拟器代码整改（纳入钩子后暴露，全部修代码而非豁免）
- cppcheck 4 处：sim_syslog.c 判空分支内解引用 p_epoch（真实 bug）、
  2 处 struct tm 未初始化、1 处指针可加 const
- coding-standard 61 处：44 处函数左大括号并到右括号同行、8 处补函数
  注释、3 处补文件头注释块、2 处 __ 前缀保护宏改 XXX_H、2 处 sprintf
  改 snprintf（写入字节数与原来完全一致）

LVGL 特性裁剪（F-1/F-2/F-3）
- 两端 lv_conf.h 对齐同一特性子集：删 26 个 LVGL 9.3 不存在的选项名、
  3 处重复定义，10 项靠默认值隐式生效的改为显式固化
- 实测对镜像体积中性；价值在防漂移，且模拟器 golden 回归跑的正是固件
  实际编译的配置

L3 软件侧
- App/algo/prot_set.* Q10 定值模型（范围校验 / 整表 all-or-nothing /
  校验和封存-自检-闭锁）+ prot_elm.* 通用"滞回+定时限"元件框架 7 实例
- test/host/prot_set、test/host/prot_elm 主机侧单测；uvprojx 挂载两处

文档同步
- pre-commit使用说明：§2.8 S11 口径、§2.15 lv-conf-sync 详解、新增 §5.5
  复盘（教训：exclude 只写真正不该进钩子的路径）
- AGENTS.md、UI_设计架构 §1.4 第 10 条、RAM 分析、审查报告刷新与销项

验证
- @build BUILD_OK 0/0（Code=194276 RO=15872 RW=876 ZI=139892）
- 模拟器重建：菜单 8 状态像素逐字节一致（池 5368 B）、11 内容页黄金参考
  全过（往返 5448 B）、remo sink 0/25600 位差异、--logtest/--cfgtest PASS
- 全仓库 cppcheck / coding-standard / no-mojibake --all-files 全过
- check_doc_links --all 129/0；check_mem_numbers --check 内存数字一致
- 端到端：往 simulator/lv_conf.h 注入一行漂移 → 钩子 FAIL（exit 1）
 2026-10-11 08:48:49 +08:00
wandering1 13a4e61c27 L1-6 采样有效性校验：adc_health 判定层 + 告警编排 + 31 用例单测 + 台架闭环 
新增 App/algo/adc_health.c/h（纯逻辑判定层，零平台依赖免桩单测）：
- 静默：两侧帧序号连续 >=100ms 无前进（电平位可自愈，flags() 为 L5-4 闭锁预留）
- 丢帧：TPAFE 序号一次前进 >1 计 tgap（与 STM32 侧 adc1_gap 对称，边沿事件）
- 单调性：序号倒退锁存位；tick/计数差值法 (int32_t)(a-b) 回绕安全
- 错误增量：FRSTDATA / HAL 错误 / STM32 停摆计数增量，事件位与锁存位编号对齐，
  消费者按位图做"每类每次开机留痕一次"编排

adc_task.c v2.9 告警编排（判定与编排分离）：严重事件/电平上升沿 DBG_ERROR +
SYSLOG_SELFTEST（每类每次开机一次防刷屏），下降沿 DBG_INFO 恢复；gap 不告警
（消费者超拍是已知现象，告警会淹没真故障）；心跳行增 tgap 观测字段。

主机单测 test/host/adc_health/ 31 用例全绿（100ms 门限两侧 / 边沿语义 /
倒退锁存 / tick 回绕 / NULL 守卫 / init 幂等），登记 adc-health-unit-test 钩子。

台架 @test PASS：零 [ERR]（健康不误报）、tgap=1->2 与 adc1_gap 同步可见、
frames 1000.0 Hz；证据 boot_log_data/20261011_prod_adc_health_boot_log.txt。

抬栈：adc_health_report->syslog_post 控制台回显尾使 adcTask 静态最坏链
832->1080 B（512 words 余 968 B < 1024 B ISR 底线）-> 512->640 words，
复测余 1480 B / 57%，堆 min_ever 7152->6640 B（-512 B 符合预算）。
AGENTS/README 任务表、RAM 方案 §2.3、规划文档 §3.1 L1-6 已同步置完成。
 2026-10-11 01:28:20 +08:00
wandering1 9bbe117f97 adc: 节拍源 TIM6->TIM3 + ADC1 走 DMA 乒乓双缓冲，消除 2 ms 忙等（P1-5 单拍硬上界办结） 
用户选定最彻底方案（B2）：DMA + 定时器 TRGO 硬件触发 + 消费上一拍
已完成的半区。对应 P1-5 拆出的"单拍硬上界"，现已办结。

硬件事实更正（查 CubeMX 器件库 + 本仓 HAL 头证实）：F4 上 ADC1 的
外部触发清单里没有 TIM6/TIM7 TRGO（只接 DAC）。故 1 kHz 节拍源由
TIM6 改为 TIM3（PSC 83 / ARR 999，TRGO=UPDATE），同一个更新事件
同时 ① ISR 脉冲 TPAFE CONVST ② 经 TRGO 触发 ADC1 一轮 9 通道
③ 置位 ADC_WAKE_FLAG 唤醒 adcTask。TIM6 从 .ioc 整体移除。

代码：
- Src/tim.c/h：新增 MX_TIM3_Init（含 MasterSlaveMode），删 htim6
- Src/adc.c：ExternalTrigConv=T3_TRGO + EDGE_RISING +
  DMAContinuousRequests=ENABLE；MspInit 挂 hdma_adc1（DMA2_Stream4
  循环模式）。DDS 位关掉 = 一轮只发一次请求，静默丢 8 路
- Src/dma.c：DMA2_Stream4 NVIC 优先级 6（CubeMX 换流会把它重置为 0，
  优先级 0 会抢占 FreeRTOS 临界区，违反"外设中断 ≥5"）
- Src/main.c：周期回调加 TIM3 分支；stm32f4xx_it.c 向量同步
- App/algo/adc_input.c：stm32_scan() → stm32_take()，逐通道
  PollForConversion 全删；乒乓半区由完成计数奇偶推出（只读一个
  32 位量 → 与 ISR 无竞态）；STM32 侧数据固定滞后 1 拍
- App/task/adc_task.c：心跳日志拆出四类计数

观测性：adc1_seq（完成计数）/ adc1_gap（seq 前进 >1 = 丢帧）/
adc1_err（连续 ≥2 拍无新帧 = 停摆）/ adc1_hw（HAL 错误回调）。
单拍无新帧是消费者相位伪影（DMA 完成落在唤醒后 ≈67 µs），不计故障。

验证：
- 主机单测 79 → 101 全绿；反向验证四连均咬（半区奇偶取反 11 条、
  停摆拍置 valid 4 条、STALL_RUN_MAX 改 1 为 6 条、gap 阈值 1 条）
- @build 0 错 0 警，Code 256872 → 257660
- @test PASS：adcp 122 µs → 8 µs、adc1_err=0、adc1_hw=0、
  adc1_gap=27/20002 拍、adc1_seq 与 seq 恒定偏移 2
- stack_report 7/7 PASS，adcTask 832 B / 余 59%（不变）
- cubemx-survival 新增 5 项审计（TIM3 分支 / T3_TRGO / DDS /
  DMA 挂载 / 流优先级），28 通过 0 失败

文档：ADC 采样节拍设计说明新增 §11；看门狗停摆分析 §4.4 与 §8 收口；
算法规划 L1-1/L1-3、通道映射、测试说明、各 README 同步。
 2026-10-11 00:31:33 +08:00
wandering1 dd8210867a adc_input: 失败拍清 s_stm32_valid，杜绝超时沿用上一拍旧值（单测 70->79） 
缺陷（真机实测发现）：本层只有一份 s_stm32_raw[]，有效标志此前只在成功时
置 1、失败时从不清零 -> 超时拍消费侧照样取数、照样压入采样环（且超时前
几个 Rank 已写本拍新值、后面几个是上一拍旧值 = 半新半旧混合帧），直接污
染 20 点 DFT 相量窗；adc_input_poll() 返回值只由 TPAFE 决定，s_frames_skip
也抓不到它。

修复：stm32_scan() 两条失败支路（HAL_ADC_Start 失败 / 轮询超时）都清
s_stm32_valid -> 本拍 adc_input_raw() 对 STM32 语义通道返 -2 -> adc_task
走既有 skip 整帧跳过路径；下一拍扫描成功自动置回 1（自愈）。

测试：新增 TC-AI-070..078（70 -> 79 用例）。旧用例 TC-AI-034/039b 都是
init 后立刻失败（valid 本就是 0），照不出成功过之后再失败这条路径，故新
用例先成功一拍进入有效态再注入失败。**反向验证已做**：把支路改回旧行为 ->
TC-AI-039b/073/074 立即 FAIL（76/79），证明用例有效。

验证：主机单测 79/79 PASS；@build 0 错 0 警（Code 256868 -> 256872）；
@test PASS（本轮无超时：adc1_err=0、skip=0、idle=0、frames=20001）；
18 钩子全绿。文档同步 4 处（停摆分析 4.4 / ADC采样节拍 10.4 / ADC输入层
单测说明 / test-host README）。

遗留：2 ms 忙等本身未消（硬化 2 = DMA，方案 B2 待 CubeMX 配置）。
 2026-10-10 23:08:01 +08:00
wandering1 9231a3c22c adcTask 事件驱动消费（P1-5 方案 a）+ 补 F4 ADC 上电自校准 + 修正 2 ms 忙等过期表述 
P1-5 方案 a（事件驱动消费，Task #32）：
- TIM6 1 kHz ISR 除触发 CONVST 外再调 adc_tick_irq_notify()，置位
  ADC_WAKE_FLAG；adcTask 循环尾改 osThreadFlagsWait(osWaitForever)，
  删除 ADC_TASK_BEAT_MS 定时轮询
- adcTask 优先级 Normal(24) -> AboveNormal(32)（Src/freertos.c USER CODE 区）
- 补消费者就绪门（规划未预见）：TIM6 在 app_main_init 就启动，比调度器
  早约 100 ms，未就绪时 ISR 不得 osThreadFlagsSet
- 实测 6 次上板：idle 由 1~649 降到 0/20000 拍，frames 1000.0 Hz，
  seq-frames=7 正是就绪窗口；UI 侧 uip/uiw/uis 无退化

补 STM32F4 ADC 上电自校准（此前项目从未做过）：
- 核查证实裁剪版 HAL 无 HAL_ADCEx_Calibration_Start、裁剪版 CMSIS 头无
  ADC_CR2_CAL -> 按 RM0090 13.3.6 在 Src/adc.c 的 USER CODE 区手写
  adc1_calibrate()，MX_ADC1_Init() 末尾调用
- 新增 cubemx-survival 审计项 adc1-calibration-call / -impl（清单 21->23）
- 实测校准前后同一拍 STM32 侧 6 路同向偏移 +10~+63 LSB，TPAFE 侧不变

修正两处过期表述（实测反证）：
- 原文 9 通道全超时最坏 = 18 ms 连占 有误：stm32_scan() 在首个超时处即
  Stop+return，单拍上界 = 一次超时约 2~3 ms
- adcm 约 2.1 ms 的峰值归因由 ADC 采集改判为每 10 s 一次的心跳日志；
  6 次对照 adcp = 122 us（无超时）/ 2209 us（超时 1 次）
- 同步修正 adc_task.c 两处过期注释；新发现超时拍 STM32 侧静默沿用
  上一拍值的正确性代价，硬化排序记入 4.4 / 10.4（未实施）

验证：@build 0 错 0 警（Code 256728 -> 256868）；@test 6/6 PASS；
stack_report 7 任务全 PASS（adcTask 832 B / 余 59%）；18 钩子全绿
 2026-10-10 22:41:19 +08:00
wandering1 317e97fca6 docs(algo): App/algo/README.md 补齐为详版（分层/数据流/接口/测试/扩展） 
- 该文件此前仅 27 行（仅"现有模块"表 + 约定 + 相关文档），本次补齐为 168 行
  详版：文件清单、1 ms 数据流图、逐文件 API 表与要点、关键约定、静态足迹、
  构建与测试（含两个主机单测钩子）、新增算法模块的固定动作。
- 内容已逐项对照当前源码核验：相量实例 5 行 / 环容量 2×20 点 / 9 个语义通道 /
  Rank 映射（CH0..CH7 + CH14）/ 所引文档、脚本与 skill 均存在。
- 与 L1/L2 现状一致：adc_input（L1）、sample_ring + phasor（L2）三模块。
 2026-10-10 18:04:51 +08:00
wandering1 3762c03bb4 L2 相量层：采样环缓冲 + 全周傅氏 + 主机单测（台架间歇复位待查） 
新增（均已通过主机侧单测与构建，**台架存在未定位的间歇性回归，见下**）：
- App/algo/sample_ring.c/h：按语义通道的采样环缓冲（2 周波 = 40 点），
  整帧压入 + 帧计数，供 L2 按窗取数。
- App/algo/phasor.c/h：全周傅氏相量层，覆盖规划 §3.2 的 L2-1/2/3/6/7——
  系数表按 docs/算法/傅氏算法详解.md §2.3 预乘 √2/N（fAmSQ 直接即有效值）；
  5 个数据驱动实例（IA/UA/UN 基波 + IA 二/五次谐波）；暴力滑动窗；
  计算区/使用区双区原子切换。
- test/host/phasor/：主机侧单测（52/52 PASSED，无需桩）——系数表逐项复核、
  幅值/有效值/相位、直流与谐波抑制、任意次谐波提取、频率敏感性（±2Hz≤3%）、
  环缓冲时序与回绕、实例层与双区交换。
- 集成：adc_task 每拍压帧 + 重算（v2.4）；app_main 调 phasor_init()；
  Keil 工程挂 phasor.c/sample_ring.c（App/algo 已在 IncludePath）。

验证：
- 主机单测 52/52 PASSED。
- @build 0 错误 0 警告；内存快照已刷新（RW_IRAM1 89,320→90,936 B）。
- 台架：L2 链路数据正常（ring=10001、skip=0、回读一致、相量日志可见），
  但 10 次运行中 3 次出现 UI 任务看门狗停喂（mask=0x67 缺 TASK_WD_UI）
  → IWDG 复位；改动前基线 6 次运行 0 次。属**未定位的间歇性回归**。

未完成：定位并修复该间歇性复位；L2 文档状态与登记簿条目尚未按结论更新。
 2026-10-10 17:39:37 +08:00
wandering1 d59c2198eb feat(adc): L1 采集层落地——STM32 ADC1 扫描 + 语义通道映射 
新增 App/algo/adc_input.c/h（L1 采集与预处理层，落实 L1-3/L1-4）：
- L1-4 语义通道映射表 k_adc_map[]：UA/UN/IA → TPAFE buf[6]/[5]/[2]；
  UB/UC/IB/IC/IN/TEMP → STM32 ADC1 CH14/3/6/1/2/5。消费侧一律经
  adc_input_raw() 按语义取数，不写死下标（V0.2 改版只改表内容）。
- L1-3 STM32 ADC1 9 通道软件触发顺序扫描：HAL_ADC_Start + 逐通道
  PollForConversion/GetValue（EOC_SINGLE_CONV + 无 DMA，可逐通道轮询）。
- adc_input_poll() 统一"TPAFE 原子快照 + STM32 扫描"；
  adc_input_init() 做映射自检（STM32 映射通道必落在扫描序列内，否则
  返回 -1），挡住"映射到不扫描的通道 → 恒读陈旧值"的静默错。

集成：
- adc_task.c 取数改走 L1 层（首帧日志补全 8 路 + 温度；心跳增
  adc1_rc/adc1_err 观测 STM32 侧健康度）。
- app_main.c 在 tpafe5160_init() 之后调 adc_input_init()，失败记
  SYSLOG_SELFTEST("ADC map fault")。
- Keil 工程挂 adc_input.c 并加 ../App/algo 包含路径。
- 文档同步：继电保护规划 §1.2/§3.1（L1-3/L1-4 改 ✅）、ADC通道映射说明
  §7/§8/§9、产品需求 §5.9/§9、架构总览 §7、AGENTS.md、App/README.md、
  App/task/README.md、新增 App/algo/README.md、boot_log_data 清单。

验证：
- @build 0 错 0 警；镜像无源文件新于 hex。
- 台架 @test PASS：ADC input layer init OK、adc1_rc=0/adc1_err=0
  （30 s ≈27 万次转换零超时）、seq 仍 1000.0 Hz、adc 栈峰值
  528→584 B（余 71%）、回读一致、零 [ERR]/HardFault。
  证据 docs/测试说明/boot_log_data/20261010_prod_adc_l1_boot_log.txt
- 内存快照已刷新（Flash 269,404→270,712 B）。
 2026-10-10 16:06:31 +08:00