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，交台架道补。
This commit is contained in:
@@ -92,6 +92,15 @@ static const adc_cal_bcfg_t s_bcfg_rom = { { 0L, 0L, 0L, 0L, 0L, 0L, 0L, 0L } };
|
||||
* adc_cal_init 清零 = 新一轮观测窗） */
|
||||
static uint8_t s_err_latched;
|
||||
|
||||
/*
|
||||
* 观测计数（三态语义唯一落点在 adc_cal.h，这里只写"怎么自增"）：与上面那个留痕位
|
||||
* 不同，这三个数一个 [ERR] 都不打、也不参与任何判定，因此 **adc_cal_init() 刻意不清**
|
||||
* ——清了水位与计数就失配，会凭空造出一段"假未落盘"差额。
|
||||
*/
|
||||
static volatile uint32_t s_st_set_ok; /* 成功改写 RAM 副本的次数 */
|
||||
static volatile uint32_t s_st_set_reject; /* 被拒次数（非法通道 / 越出合法带） */
|
||||
static volatile uint32_t s_st_persist_water; /* 落盘水位：盖写，绝不自增 */
|
||||
|
||||
/* 键表：offset 用 offsetof 取真值（k[0]@0 / k[1]@4 … valid@32） */
|
||||
static const cfg_key_def_t s_k_keys_tbl[9] = {
|
||||
{ "k_ua", CFG_VAL_INT, offsetof(adc_cal_kcfg_t, k[0]), 4u },
|
||||
@@ -355,19 +364,49 @@ float adc_cal_b_codes(adc_semantic_t sem) {
|
||||
*/
|
||||
int adc_cal_set(adc_semantic_t sem, int32_t k_q16, int32_t b_codes) {
|
||||
if ((unsigned)sem >= (unsigned)ADC_SEM_TEMP) {
|
||||
s_st_set_reject++; /* 观测：连通道号都非法，RAM 未动 */
|
||||
return -1;
|
||||
}
|
||||
if (s_kband_ok((unsigned)sem, k_q16, b_codes) == 0) {
|
||||
DBG_ERROR("set ch=%u rejected: k_q16=%ld b=%ld out of ROM band [0.5x,2x]/|b|<=%ld",
|
||||
(unsigned)sem, (long)k_q16, (long)b_codes, (long)ADC_CAL_B_MAX);
|
||||
s_st_set_reject++; /* 观测：越出合法带，RAM 未动（[ERR] 由上一行打） */
|
||||
return -1;
|
||||
}
|
||||
s_kcfg.k[sem] = k_q16;
|
||||
s_bcfg.b[sem] = b_codes;
|
||||
s_kcfg.valid |= (uint8_t)(1u << (unsigned)sem);
|
||||
s_st_set_ok++; /* 观测：RAM 副本确实被改写了（与落盘无关） */
|
||||
return 0;
|
||||
}
|
||||
|
||||
/*
|
||||
* 函数功能：读标定层观测计数（不取锁、不取时刻、任意上下文可读）
|
||||
* 返 回 值：无 void
|
||||
* 限定条件：无；adc_cal_init() 之前可读（全 0 = 本层还没被改写过）
|
||||
* 函数说明：见 adc_cal.h 同名声明（三态语义与那张成对读表都在那里，本处只取数）
|
||||
*/
|
||||
void adc_cal_get_stats(adc_cal_stats_t *p_out) {
|
||||
if (p_out == NULL) {
|
||||
return; /* 观测件不得反过来制造故障 */
|
||||
}
|
||||
p_out->set_ok = s_st_set_ok;
|
||||
p_out->set_reject = s_st_set_reject;
|
||||
p_out->persisted_set_ok = s_st_persist_water;
|
||||
}
|
||||
|
||||
/*
|
||||
* 函数功能：落盘成功回执——把水位盖写为当前的 set_ok（不是自增）
|
||||
* 返 回 值：无 void
|
||||
* 限定条件：仅"整档保存已成功"那一条路径（当前唯一调用点 run_par_store_save()）
|
||||
* 函数说明：盖写而非自增的理由与回归用例见 adc_cal.h 同名声明。水位直接取 set_ok 的
|
||||
* 当前值，因此它**在结构上不可能越过** set_ok——差额是 uint32 相减，一旦越过
|
||||
* 就绕回成一个巨大的假未落盘数，这里不留那种可能
|
||||
*/
|
||||
void adc_cal_note_persisted(void) {
|
||||
s_st_persist_water = s_st_set_ok; /* 水位只会追平，不会越过 */
|
||||
}
|
||||
|
||||
/*
|
||||
* 函数功能：两点标定公式（卡 12 的算术核，纯函数无状态）
|
||||
* 入口参数：c_lo/c_hi、v_lo_uv/v_hi_uv、p_k_q16/p_b 见 adc_cal.h 同名声明
|
||||
|
||||
+66
-2
@@ -158,8 +158,11 @@ float adc_cal_b_codes(adc_semantic_t sem);
|
||||
* 限定条件：**整定路径上下文**（defaultTask 标定流程/整定链；卡 10 起 iec104Task
|
||||
* 经 App/algo/run_par.c 的 0x8040~/0x8048~ 直通写亦为授权写者——写的仍是
|
||||
* 引擎对齐 int32 单字，µs 级混窗契约同「数据可信」§4.4）。勿在 adcTask 调用
|
||||
* 函数说明：只写 RAM 副本；落盘由属主经 cfg_file_save 完成（卡 10 前整定链
|
||||
* 未接，台架两点标定（卡 12）是首个消费者）
|
||||
* 函数说明：**只写 RAM 副本，不置脏、不落盘、不返回"稍后会存"的承诺**——落盘由属主经
|
||||
* cfg_file_save 完成，而"要不要落盘"这件事只有一个真源：run_par 的脏标志。
|
||||
* 因此授权写者是 run_par 的语义 setter（写值 + 置脏成对发生，lead 裁②）；
|
||||
* 绕过它直调本函数 = 值只活在 RAM 里，重启即丢且**没有错误返回**，
|
||||
* 该形态现可被本层观测计数抓到（差分口径见下方 adc_cal_stats_t 那张表）
|
||||
*/
|
||||
int adc_cal_set(adc_semantic_t sem, int32_t k_q16, int32_t b_codes);
|
||||
|
||||
@@ -189,6 +192,67 @@ int adc_cal_two_point(int32_t c_lo, int32_t c_hi, int32_t v_lo_uv, int32_t v_hi_
|
||||
*/
|
||||
int adc_cal_rail_ths(adc_semantic_t sem, int32_t *p_lo_th, int32_t *p_hi_th);
|
||||
|
||||
/*
|
||||
* 观测计数：把「改了没落盘」从意图式陈述变成可诊断事实（道G task-43 第②项；
|
||||
* 先例 App/fs/vol_lock.h 的同族设计——只计数、不取锁、不在调用点打日志、不打 [ERR]）
|
||||
*
|
||||
* 三态语义（**定义只在本头文件这一处**，消费者只描述取数与断言，不重定义）：
|
||||
* set_ok RAM 副本被本层 API 成功改写的累计次数
|
||||
* set_reject 被本层拒掉的整定请求累计次数（参数非法 / 越出合法带）
|
||||
* persisted_set_ok **水位**而不是计数：最近一次随整档保存落盘成功时的
|
||||
* set_ok 快照（由 adc_cal_note_persisted() 盖写，永不越过 set_ok）
|
||||
*
|
||||
* 未落盘差额 = set_ok − persisted_set_ok，即"自上次成功落盘之后被改写的次数"。
|
||||
* 单看差额不够定性，必须与 run_par_dirty_peek() 成对读（两列一起才只有一种解释）：
|
||||
*
|
||||
* 差额 run_par_dirty_peek() 说的是什么事
|
||||
* ------ ---------------------- ----------------------------------------------
|
||||
* 0 0 盘与 RAM 齐（或压根没改过）——健康
|
||||
* >0 1 改了、还没到落盘时机——正常在途
|
||||
* >0 0 **改了且永远不会落盘**：写者绕过 run_par 的语义
|
||||
* setter 直调 adc_cal_set()（本卡起的事）
|
||||
*
|
||||
* 消费者告诫（与 vol_lock_get_stats() 同一套，别重犯）：
|
||||
* ① 本组接口不取锁、不取时刻，任意上下文可读；三个数各自是 uint32 单字读写，
|
||||
* Cortex-M4 上原子，但三个数之间**没有共同时刻**——别把它们拼成"一个瞬间的快照"
|
||||
* 下结论，定性只按上面那张两列表成对读。
|
||||
* ② 需要"被观测到的时刻"请在消费者侧自盖并冠 obs_ 前缀命名（先例：喂狗点单写者 latch），
|
||||
* 本层不存时刻——存了就得连带管溢出与单位。
|
||||
* ③ 这些计数**不参与任何判定**：能不能信只看 adc_cal_flags() /
|
||||
* adc_cal_prot_blocked()，要不要落盘只看 run_par 的脏标志。别拿差额去改控制流，
|
||||
* 那等于把观测升级成第二真源（本卡第①项已由 run_par 语义 setter 收口，不再加口）。
|
||||
* ④ 写清盲区：本层刻意**不挂** cfg_file 回调，因此"盘 → RAM 的覆盖"（cfg_file_load
|
||||
* 与外部变更重载）不产生任何计数；未落盘的改值被一次重载无声吞掉，正是这三个
|
||||
* 数照不到的那一条。要照它得先给本层挂回调 = 行为改动，另卡处置。
|
||||
*/
|
||||
typedef struct {
|
||||
uint32_t set_ok; /* 成功改写 RAM 副本次数（见上方唯一落点） */
|
||||
uint32_t set_reject; /* 被拒次数（见上方唯一落点） */
|
||||
uint32_t persisted_set_ok; /* 落盘水位，不是计数（见上方唯一落点） */
|
||||
} adc_cal_stats_t;
|
||||
|
||||
/*
|
||||
* 函数功能：读标定层观测计数（只读，不改任何状态）
|
||||
* 入口参数：p_out - 输出：三个观测计数 adc_cal_stats_t *
|
||||
* 返 回 值：无 void
|
||||
* 限定条件：任意上下文可读（含 ISR 与内核启动前）；adc_cal_init() 之前可读，得全 0
|
||||
* 函数说明：p_out 为 NULL 时静默返回——观测件不得反过来制造故障
|
||||
*/
|
||||
void adc_cal_get_stats(adc_cal_stats_t *p_out);
|
||||
|
||||
/*
|
||||
* 函数功能：落盘成功回执——把水位 persisted_set_ok 盖写为当前的 set_ok（**不是自增**）
|
||||
* 入口参数：无 void
|
||||
* 返 回 值：无 void
|
||||
* 限定条件：只允许配置引擎属主侧"整档保存已成功"那一条路径调用；当前唯一调用点 =
|
||||
* App/algo/run_par.c 的 run_par_store_save() 中 cfg_file_save() 返 0 之后
|
||||
* 函数说明：为什么盖写不自增——一次 save 覆盖整档，可能对应多次整定改写（逐通道
|
||||
* 标定 3 路 = 3 次 adc_cal_set + 1 次 save）；自增会留下 2 次"假未落盘"。
|
||||
* 水位语义让差额只反映"上次落盘之后的改写"，回归锁见
|
||||
* test/host/adc_cal/adc_cal_test.c 的 TC-ADCCAL-021
|
||||
*/
|
||||
void adc_cal_note_persisted(void);
|
||||
|
||||
#ifdef __cplusplus
|
||||
}
|
||||
#endif
|
||||
|
||||
@@ -354,6 +354,9 @@ uint8_t run_par_dirty_peek(void) {
|
||||
* 限定条件：defaultTask（配置引擎属主）上下文，SYS_EVT_RUN_PAR_SAVE 驱动
|
||||
* 函数说明：一次 save 同时覆盖 [run_par] 9 键与刚被 adc_cal_set 改写的
|
||||
* [adc_cal]/[adc_cal_ofs] 副本（lead 裁②：一条事件位一次 save）。
|
||||
* 成功路径上给标定层盖一次落盘水位（adc_cal_note_persisted()）——它是
|
||||
* **观测回执**，不参与本函数任何判定；失败路径不盖，于是"save 一直失败"
|
||||
* 在标定层侧表现为差额长期不归零（道G task-43 第②项）。
|
||||
*/
|
||||
int run_par_store_save(void) {
|
||||
if (s_dirty == 0u) {
|
||||
@@ -364,5 +367,6 @@ int run_par_store_save(void) {
|
||||
return -1;
|
||||
}
|
||||
s_dirty = 0u;
|
||||
adc_cal_note_persisted(); /* 观测回执：水位追平，差额归零（不是判定输入） */
|
||||
return 0;
|
||||
}
|
||||
|
||||
+21
-2
@@ -22,6 +22,18 @@
|
||||
* 保存（含 [run_par] 与刚被 adc_cal_set 改写的 [adc_cal]/[adc_cal_ofs]
|
||||
* 副本）→ 成功清脏；失败留脏 = 下轮天然重试。本模块自身零文件 IO
|
||||
* （属主纪律）。
|
||||
* ⚠ 三份职责别混（道G task-43 第③项，此前只有意图式陈述）：
|
||||
* - **谁写 RAM**：系数/零点的唯一真源是 adc_cal 的引擎副本，而本模块那两支
|
||||
* 语义 setter（run_par_cal_k_set / run_par_cal_b_set，task-7 落地）是**唯一
|
||||
* "写值 + 置脏"成对发生**的入口；任何消费者绕过它们直调 adc_cal_set()，
|
||||
* 值只进 RAM、脏标志不动 ⇒ 屏上"当前生效"是新的、盘上仍是旧的、重启即丢，
|
||||
* 且该路径**没有错误返回**。这条形态现在可观测：adc_cal 侧
|
||||
* set_ok 与落盘水位的差额 > 0，而 run_par_dirty_peek() 恒为 0。
|
||||
* - **谁落盘 / 什么时机**：只有 defaultTask 的 run_par_store_save()（由
|
||||
* iec104Task peek 后置的 SYS_EVT_RUN_PAR_SAVE 驱动）；本模块零文件 IO。
|
||||
* - **cfg_file_poll() 不是保存路径**：它的方向是**盘 → RAM 的重载**（外部
|
||||
* 改档 → 沉降去抖 → 重载），拿它"兜住"未落盘的改值会把 FTP 侧的旧档倒灌
|
||||
* 回 RAM，比不兜更坏。设计依据见 docs/算法/采集与算法层设计说明.md §10.1。
|
||||
* 并发契约：引擎副本 int32 对齐字读写在 Cortex-M4 上原子；poll 重载 µs 级窗口
|
||||
* 为「数据可信」§4.4 明载设计（adc_cal 同款）。写路径 = 104 执行段
|
||||
* （iec104Task）与引擎读路径互不加锁，勿改成"读侧缓存"（缓存 = 新真源）。
|
||||
@@ -41,6 +53,10 @@
|
||||
* RUN_PAR_K_MAX_UV；毫→工程换算收进模块内单点
|
||||
* s_milli_to_eng()（顺带把 task-43 第①项所需的
|
||||
* "写值必置脏"这一半满足掉）
|
||||
* v1.2 2026-10-27 DTU 项目组 道G task-43 第②③项：run_par_store_save() 成功路径
|
||||
* 给标定层盖一次落盘水位（纯观测回执，不参与判定）；
|
||||
* 本头把"谁写 RAM / 谁落盘 / 什么时机 / poll 不是保存
|
||||
* 路径"从意图式陈述改成逐条契约
|
||||
*/
|
||||
|
||||
#ifndef RUN_PAR_H
|
||||
@@ -88,8 +104,11 @@ float run_par_deadband(uint8_t idx);
|
||||
* 函数功能：写第 idx 路死区（工程量，含范围守卫 + 脏置位）
|
||||
* 入口参数：idx - 同上 uint8_t；db - 死区工程量（V/A/Hz，≥0） float
|
||||
* 返 回 值：0 成功；-1 越界/越程/NaN（副本不动） int
|
||||
* 限定条件：**iec104Task 上下文**（104 执行段 / 卡 11 后的整定路径；UI 若整定
|
||||
* 需另行走配置引擎属主路径，勿跨任务直写）
|
||||
* 限定条件：写者两门——**iec104Task**（104 C_SE 执行段）与 **uiTask**（遥测死区页
|
||||
* 经 ui_data 通道五注入转达，道F task-7 起；ui_data.h 通道五表注：合法域
|
||||
* 与"写值+置脏"必须原子发生在执行侧）。两门都只写 RAM 副本 + 置脏，
|
||||
* 落盘统一收敛在 defaultTask（勿在 adcTask 调用；此句为 2026-10-27 措辞
|
||||
* 收口——原写"UI 若整定需另行走属主路径"是 task-2 期遗留，task-7 已接线）
|
||||
* 函数说明：合法域按点型分档——电压 0~50 V、电流 0~1 A、频率 0~5 Hz（上限 =
|
||||
* 额定 × 二档裕量，守卫目的是挡误写不是限工况；见 .c 常量段）。
|
||||
* 成功即置脏（落盘请求，见文件头持久化契约）。
|
||||
|
||||
Reference in New Issue
Block a user