3 Commits

Author	SHA1	Message	Date
wandering1	728d60675f	feat(UI/采集/104): 通讯设置页 + 开机账本 + adc_cal 可诊断化——三车道同树一次构建入库 ... 三条道在同一棵树上交付，故合并成**一次权威构建**（@build 0 错 0 警，Code=235236 RO=26308 RW=1572 ZI=136924）后同笔入库；台账已按该构建回填（`ram_baseline.py --update` + `--write`、`chec k_mem_numbers.py --write`），凭证与实际 .map 同源。归属如下： · **通讯设置页**（道G task-9）：新增 `Drivers/BSP/UI/ui_page_comm.{c,h}`（通道六注入，与死 区页同骨架同纪 律），`#page=comm` 绑定使 bound **21 → 22**、内容页黄金 **47 → 53**（旧 47 页字节零变化， 新增六态含 WAIT/OK 两张）；`iec104_comm` 脏位 + store_save（**无事件位**）挂 defaultTask 同点位 轮询；`port_104` 由 宏改走 getter、`IEC104_SERV_PORT` 删除；字体 +听/监（185 字全覆）。**实机链已闭环**：FTP 外改 [comm] 的 ca/port → 复位 → 串口出现 `section 'comm' (2 keys)` 与 `i104: listening o n 9004` → 还原 2404，全程无 FAIL ⇒「重启即生效 + 端口真值」不是推断是实测。上限核对 6/8 段、2/16 键，超限现象由 TC-CONFIG-056/057 钉死（注册 -1 + `comm init: FAIL` 锚 + getter 回 ROM），**不抬宏**。 · **开机账本**（道F task-12）：新增 `App/util/boot_stats.{c,h}`——上电次数落 SD2506 用户 SRAM（magic + 小端计数 + 版本 + 异或校验），一次上电 = 1 读 + ≤1 写，**零 NAND、零卷锁、零配置段**；四态互斥 UNKNOWN / FRESH / CONTINUED / RESTARTED（BLF=1 才算电池域掉过电），**读失败绝不回写**； 文案口径「自 RTC 电池周期起」，**禁写终身次数**。复位原因优先级链从 `app_main.c` 的 if-else 收进一份真源（串口与屏幕同 源）；104 四个只增不清计数 + `iec104_serv_get_stats()` 留在 serv、未塞进 link（会被 open /close 洗掉）。 运行时长按用户裁定 = **只报本次开机以来**，零新增代码。新套件 `test/host/boot_stats` 21/21，五处注入 **全部有牙**（含「漂一字节被校验和挡下而不是报 256 倍错账」）。 · **adc_cal 可诊断化**（道E task-43）：三个 volatile 计数 + `adc_cal_get_stats()` / `adc_cal_note_persisted()` （水位**盖写非自增**，因为一次 save 覆盖整档，数 save 会留假未落盘）；「差额 × 脏位」三态语义唯一落在 `adc_cal.h`，其中「差额 > 0 且脏位恒 0」= 绕过语义 setter 的静默丢失；TC-ADCCAL-019~023。 三条**必须留档的自纠**（都是执行道自己报的，我不替他们润色）： ① stdint 那条断链是**宿主套件抓到、通讯道先修**，采集道承认自己是重复添加者并删掉自己那份； ② 「exit 2 不是证据，断言变红才是」——采集道第一版反证注入了未声明标识符导致编译错，差点当成功； ③ 套件汇总行原写 `s_total/s_total`，失败时会打印「21/21 PASSED (failed=1)」这种自相矛盾的行，已改。 另修：`check_registration.py` 的 `SIM_EXEMPT` 加一行豁免 `App/util/boot_stats.c `（依赖 I2C 与 RCC 位掩码， MCU 专属；核过 `sys_clock.c`/`sha256.c` 同形态先例），注册反向校验 exit 1 → 0。发号 TC-IEC1 04-034、 TC-UIDATA-029 已实抬游标（`TC-IEC104-033→034`、`TC-UIDATA-026→029`）。 门禁：id-check --strict 与 plain 均 rc=0、doc-links --all rc=0、注册校验 0、cppche ck / coding-standard / bom-drift 0；iec104 179/179、ui_data 295/295、boot_stats 21/21、adc_cal 11 7/117、run_par 67/67；菜单 8 状态 池 5368 不变、内容页 53/53。**已知遗留**：内容页数 47 → 53 的全仓文本同步尚未做（另卡跟踪），本笔只保 证代码与黄金一致；面板注键真机那一腿缺 CLI，交台架道补。	2026-10-27 11:29:23 +08:00
wandering1	b623a406ad	fix(栈·存储·UI 收尾): 断掉临界区↔断言幻影环回到 1,464，标定门控单点化，卷锁五态可观测 ... 这四笔在主树里已经互相纠缠（同一次 @build 编译、同一份 .htm 度量），拆成四笔就不 存在任何一个被真编过的中间态，所以合一笔入库；下面按模块分段陈述，作者与出证归属 逐段写明。 —— 一、崩溃证据路径的整行独占收尾（log-maint-writer，task-26）—— 上午那笔 1d4b6a17 之后，stack_report 报 iec104Task 静态最坏链 1,544 / margin 1,016， 低于 1,024 的 ISR 底线。真因不是新增局部缓冲，而是本模块与内核临界区之间新长出 一条环：taskEXIT_CRITICAL ⇒ vPortExitCritical ⇒ configASSERT ⇒ vApplicationAssertFailed ⇒ dbg_console_write_raw ⇒ 回到本模块。armlink 把这一整坨计入**每一个含临界区的 任务链**（vApplicationAssertFailed 的 Max Depth 由约 40 B 涨到 128 B + In Cycle）， 所以九条链同涨约 80 B——同涨本身就排除了任何单个调用方。 改法两处：① 本模块三处窗口（取凭证 / 还凭证 / 整行入环）改用 CON_CRIT_ENTER/EXIT （PRIMASK 保存恢复到局部变量；注释写全为什么不能直接 __enable_irq()——嵌套时会 替别人打开任务级临界区——以及屏蔽面变宽是有意为之）；② 异常/终点钩子里那对 自证空转的 begin/end 摘掉（异常态 begin 放行但不持有、end 是幂等空操作，调它只有 成本没有收益），任务态 STALL 行保留 begin/end，这个区分写进两处注释与文档 §4.4.1。 实测四棵树逐个 .htm 解析（身份钉 tree + Linker run 时刻 + 产物来源）：A=77779d49 链 1,456；B=1d4b6a17 链 1,464 / margin 1,096 PASS；C=含未提交钩子接线的工作树 1,544 / 1,016 FAIL；D=本轮修复后（Linker run 22:52）回到 **1,464 / 1,096 PASS**， 九条链齐降 80 B。断环图证：vPortExitCritical 由 136 B + In Cycle 变 8 B 且不再 In Cycle，con_tx_release 子树 152→8；Error_Handler 回到 280 + In Cycle = A 树同值 （既有发送环无人拆动）。顺带删掉 Src/freertos.c 崩溃路径里最后一个 HAL_Delay(200) （该文件真实调用现为 0）。 测试：console_log 152→**153** 条（只增不减）；换钉不删防——015 现在钉「PRIMASK 窗口 2 次、深度 1、内核临界区 0 次」，新钉 015c 绝不等待，160 注入点搬到 con_pm_hook，176 强化到未调度路径连 PRIMASK 窗口都不开；红线水位 con_pm_at_tx_max 与 con_uart_crit_at_tx_max 双 0；判据⑦（延后的行与当场直发逐 字节相同）170b/171/178 仍全绿。作者自报并纠正一处：换钉时曾把 TC-CONLOG-015b 改 编号，而 015b 在生产注释与文档里都被引用——已恢复「编号不退役、语义搬过去」。 覆盖率 App/log/console_log.c 199/200 → 256/257 行、21/21 函数（只增）。 —— 二、未标定闭锁判据收成单点访问器（ui-param-writer，task-16）—— 「UA/UN/IA 三相 VALID 全置位才允许跑判据」这条门控原先在两处各自镜像实现 （protect_task.c 的 s_cal_locked 与 ui_data_feed.c 的 feed_cal_block），改一处另一处 静默失效且无门禁可照。现新增 adc_cal_prot_blocked() 落在 App/algo/adc_cal，DTU_BENCH 特例收进一处；两个消费者同批改调、本地副本删除。作者还查实并纠正了我先前一句 错判：全仓 App/app→App/task 的 include 实为 0 条，故访问器不能落在 protect_task。 新增 TC-ADCCAL-018 八条（含冷启动即闭锁），adc_cal 套件 99/99。 —— 三、共享卷锁五态可观测性（ui-param-writer，task-17）—— 原状比登记簿写的更糟：五个可区分态（未调用 / try 超时 / 分片超时 / fail-open / 未持锁却 release）生产侧零留痕，且 vol_lock.c 的返回值注释与代码相反—— fail-open（锁没建成、互斥已失效却在读写盘）被返 1 **谎报成取到锁**，而那正是 vol_lock.h 记录的台架实证故障（并发写坏 FTL → 喂狗点饥饿 → IWDG 误复位）的前置。 锁层加四个 volatile 计数（16 B 静态，零新局部、零新 callee、零日志、零 FatFs）与 不取锁的 vol_lock_get_stats()；13 处 try 调用点一字未动。**刻意不在锁层记时刻**： 记时刻要读 tick，等于给 defaultTask 取锁链添帧——诊断不值那几个字节；消费方若 自盖时间戳，那只能是被观测到的时刻而非发生时刻，.h 里已写明不得写成首次/末次。 四套本地假件各加 s_last_wait_to（字段名逐字一致），把「喂狗点取锁一律 timeout=0」 与「ftpTask 分片一律 100 ms」从注释纪律升级成会 FAIL 的断言；红-绿反证：临时把 sys_log_mcu.c 的 0u 改 50u → TC-SYSLOG-010/012 双红，把 lftpd_io.c 的 100u 改 0u → TC-LFTPIO-034 红，两处按原串改回并用 SHA-256 证明逐字节还原。TC-VOLLOCK-015~019 共 45/45（无新桩）。 —— 四、UI 死接口清理（ui-maint-writer，task-6 收尾）—— 删掉 ui_data_maint_ready()：全仓零消费者、只有它自己的用例在读。**更值得记的是 它为什么能活过一整轮评审**：头注释写的是「页面用它决定这页能不能操作」，而页面 从来没用过它——注释陈述的是意图，评审读的是意图，门禁读的是可达路径，两者都不 反驳「意图未实现」。作者对「连用例一起删」做了显式抗命：TC-UIDATA-025 的 13 条里 只有 4 条读那个死口，另 9 条钉的是真防线（六口未注入安全返回 / 残表整表拒绝 / 被拒不覆盖已生效的好表），故删冗余的 025a、把 025i/025k/025m 换成用 reset_req() 的可观察返回值判定，性质不丢。ui_data 套件 244 → 243（净减 1），黄金 40 页与 池 5448 B 未变（该刀零像素影响，参考图无 diff）。 —— 门禁与未跑项（本笔如实留账）—— cubemx-survival 基线已 --write（漂移 6 项全部是上述意图内区域：断言/栈溢出钩子 实现、看门狗模块行等），基线文件同笔入库，随后 --check 通过。 本笔未跑的钩子只有两条：mem-numbers 与 mem-budget——磁盘 .map 出自 22:52 那次 构建、含尚未入库的 UI 与工具改动，与 HEAD 台账必然不同码；按仓库既有约定允许 --no-verify + 正文留证，回填在紧随的台账一笔统一做（含 ram_baseline --update 与 覆盖率基线两条 [NOTE]：ui_data.c 65→316、iec104_comm.c 36/36）。 两条已挂着的账：① id-check 不可判定引用 1,162 / 上限 1,166，**余量只剩 4**， 主要吃进者是我今天推进的 UI 那笔（68 条文本断言的注释引用），账在 Lead； ② 崩溃注入腿（故意复位）台架复验未跑，需先由代码道提交触发器，且判据只判原子性 不判 [ERR]=0——IPSR 路径的主张归主机侧套件，硬件照不出来。 产物身份（按 D 表要求钉死，避免数字与树脱钩）：本笔包含的固件树就是那张 D 表对应的 那一棵——MDK-ARM/.../STM32F407-Demo.htm 的 mtime = 2026-10-26 22:52:12（.htm/.map 按 约定不入库，故把时刻写进正文）。提交前在本树复跑 stack_report.py：exit 0， iec104Task 1,464 / margin 1,096（42%）PASS、defaultTask 3,040 / 2,080（40%）PASS， 与 D 表逐项一致；本次运行不含任何未提交固件源码之外的新改动。	2026-10-26 23:31:05 +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