feat(UI): 遥测死区与系数 2 页——注入表第四张、三态用脏位、WAIT 与 OK 各出一张黄金
这两页是「UI补齐」里唯一带**持久化语义**的一档，所以整笔的设计重心不在画面上，而在**页面如何诚实表达 「已受理」与「已落盘」**——这一点由 setpage-scout 在开工前的只读查实钉下来：cfg_file_save() 全仓唯一调用 者是 run_par_store_save()，而 default_task.c:246 **每轮无条件**调它、函数首行 s_dirty==0 就直接返回 ⇒ 落盘动力本来就在 defaultTask，不在 104 会话、也不在事件位。因此本笔走 A2（UI 不当授权写者），不需要 新事件位、不需要新同步口。 页面三态判据 = run_par_dirty_peek()：ENTER / WAIT（脏位仍在 = 已受理未落盘）/ OK（脏位归零 = 整档已外科 保存成功）/ 写被拒 = ERR。两条限制写在页面注释里没藏：脏位是**整档全局**的（一趟落 [run_par] 9 键 + [adc_cal] 两段，归零只证明「这一档落盘了」，不证明「我这一项单独落盘」）；他人随后再改会重新置脏 ⇒ 沿用 clear/clock 页的结果锁存，把「我这次动作的结果」与「档位此刻的状态」分开。 **为什么黄金必须出两张**（这条是本轮最有价值的防假证据规则）：模拟器假件**保留脏位**、全仓唯一的 s_yt_dirty=0 写点是 sim_yt_pump()（setter 只置不清），于是 WAIT 与 OK 各出一帧——两组同键序、唯一差别是 EXTRA 里的 --yt-nopump。若假件同步清脏位，真机的 WAIT 态永远不会被像素回归覆盖，黄金就成了「只钉住最 好看那一帧」。TC-UIDATA-028o 另钉住 ui_data 层零缓存。 形状：新增 ui_data 第四张注入表（八字段整表校验、拒残表），实现落在装配层 App/app/ui_data_feed.c， 页面零 App include（分层方向 + 模拟器不链 run_par 两条老理由都成立）；共用视图模型 ui_w_ytview 承载两页。 合法域一律由执行侧出口给（run_par_db_range / RUN_PAR_K_MAX_UV），页面不抄第二真源——系数页 v1 只用粗守 并在注释写明两层守卫互不掩盖，µV/码 ×[0.5,2.0] 那条真带的出口器归 task-43，**没有**在页面里抄常量。 取舍与遗留（如实）：系数行 d=0 整 µV（1e9 装不下两位小数，注释写了「要小数改哪、不收紧假上限」）；b 覆盖 无口未做；徽标只画系数页；行名因「率」缺字改为 Hz死区（font-charset 机器先抓到的，不是我目测判的）。 实测：@build 0 错误 0 警告（Code=233,900 / RW-data=1,536）；ui_data 单测 277/277、run_par 67/67 零回归； 内容页黄金 47 页全过、**存量 40 张逐字节零漂移**（git 里只有 7 张新增）；menu_rows / 池水位 / font-charset / bom / mojibake / nested-comment / cppcheck / coding-standard / layer-deps / bsp-err 全 0 新增；编号五项式 refs 8,778 / dec 7,622 / und **1,156**（上限 1,166）/ 比值 86.83%（基线 86.0% 之上）/ 错误差值 0，注释零裸形 字母+数字。generated-fresh 与 registration-check 本地 PASS；新增 6 只源文件按规矩**双端注册同笔**（叶子 + registry 19→21 + uvprojx + CMakeLists），uvprojx 这次属「真的增删源文件」才入库。 移交三条不混进本笔：① 全量 --selftest 现 exit 1 是 task-41 硬闸在模拟器上也拒 reset/clear（既有红，快检档 不受影响），归台架道定夺；② 内容页 40→47 的全仓文档计数改写由 Lead 派；③ run_par_deadband_set 的限定 条件语措辞（「iec104Task 上下文」已被装配层裁定覆盖）归算法层下一笔。
This commit is contained in:
@@ -679,6 +679,161 @@ int ui_data_clock_parse(const char *a_ts, ui_data_clock_t *p_out);
|
||||
*/
|
||||
int ui_data_clock_format(const ui_data_clock_t *p_in, char *a_buf, uint32_t a_len);
|
||||
|
||||
/* ── 通道五：遥测整定注入（死区 / 系数，道F task-7）────────────────────────
|
||||
*
|
||||
* 为什么又是一张注入表而不是页面直调 run_par / adc_cal：与通道四完全同一组理由
|
||||
* ——① 分层方向（Drivers/BSP 不得反向 include App 头，layer-deps 拦提交）；
|
||||
* ② 模拟器既不链 App/algo/run_par.c 也不链 App/algo/adc_cal.c，页面里用一次
|
||||
* 真源函数就是"MCU 编得过、模拟器链接期爆"（通道四表注已记过一次的同族坑）；
|
||||
* ③ 合法域与"写值 + 置脏"必须原子发生在执行侧（run_par_cal_k_set 的文件头契约：
|
||||
* 拆开等于"屏上已改、盘上永不落、且没有任何错误返回"），本表只转达。
|
||||
* ⚠ 本表刻意不含任何范围数值的拷贝：lo/hi 由执行侧逐行现给（合法域唯一出口
|
||||
* run_par_db_range，系数粗守上限唯一出口 RUN_PAR_K_MAX_UV），页面抄一份数字
|
||||
* 就是第二真源——µV 真带（执行段裁）没有公开访问器，也**不许**页面自己补一份。
|
||||
*/
|
||||
|
||||
/* 死区点数：下标 0..7 = 电气语义通道序（UA..IN），8 = 频率（与 104 地址映射表
|
||||
* 0x8030~0x8038 同序）；系数覆盖点数：电气 8 路（语义枚举前缀段）。
|
||||
* 与 App/algo/run_par.h 的 RUN_PAR_DB_N / RUN_PAR_CH_N 等值——BSP 看不到 App 头，
|
||||
* 等值由装配层编译期守卫（App/app/ui_data_feed.c）与 TC-UIDATA-027 同时钉住 */
|
||||
#define UI_DATA_YT_DB_N 9u
|
||||
#define UI_DATA_YT_CH_N 8u
|
||||
|
||||
/* 量纲代码：unit 是"这行数值本身的物理量纲"（诚实性字段，同 rt 帧 eng 的思路），
|
||||
* 归数据源管；把它显示成什么字符串（"V"/"Hz"/"uV"）才是表现层的事 */
|
||||
#define UI_DATA_YT_UNIT_V 0u /* 电压死区，V */
|
||||
#define UI_DATA_YT_UNIT_A 1u /* 电流死区，A */
|
||||
#define UI_DATA_YT_UNIT_HZ 2u /* 频率死区，Hz */
|
||||
#define UI_DATA_YT_UNIT_UV 3u /* 系数 k，µV/码（屏上串用 ASCII "uV"） */
|
||||
|
||||
/* 一行遥测整定项的完整现状（执行侧现给，页面只读） */
|
||||
typedef struct {
|
||||
float val; /* 当前工程量：死区 V/A/Hz；系数 = adc_cal 当前生效值（µV/码，
|
||||
与 104 回显同视图：文件坏值被合法带哨兵回退 ROM 时显 ROM） */
|
||||
float lo; /* 粗守下限（含）——合法域唯一出口给，页面不得自造 */
|
||||
float hi; /* 粗守上限（含）——同上；真带在执行段另裁，两层互不掩盖 */
|
||||
uint8_t unit; /* UI_DATA_YT_UNIT_* */
|
||||
uint8_t decimals; /* 显示小数位（**显示域选择**，不是数据源精度，归装配层定） */
|
||||
} ui_data_yt_row_t;
|
||||
|
||||
/*
|
||||
* 执行侧函数表（常驻注入；形状与 ui_data_maint_ops_t 同款：整表校验、拒残表）
|
||||
*
|
||||
* 与定值整定（通道 param 的位图批量 + 工作叠层）**故意不同形**：死区/系数写的是
|
||||
* 运行参数档（[run_par]/[adc_cal]），语义 setter 本身就是"写 RAM 副本 + 置脏"
|
||||
* 的原子出口、单行即提交；落盘确认是独立一问（pending），所以本表没有 commit
|
||||
* 一口——保存行按键读的就是 pending()。
|
||||
*/
|
||||
typedef struct {
|
||||
/*
|
||||
* 函数功能：死区点数（执行侧真值；未注入时本层返回 0）
|
||||
* 返回值：点数 uint8_t
|
||||
*/
|
||||
uint8_t (*db_n)(void);
|
||||
/*
|
||||
* 函数功能：读第 idx 行死区现状（工程量 + 粗守域 + 量纲 + 显示小数位）
|
||||
* 返回值：0 - 已写出；-1 - idx 越界 / 指针空 / 执行侧无此行 int
|
||||
*/
|
||||
int (*db_row)(uint8_t a_idx, ui_data_yt_row_t *a_out);
|
||||
/*
|
||||
* 函数功能：写第 idx 行死区（工程量）——真机 = run_par_deadband_set()
|
||||
* 返回值：0 - 副本已写且已置脏；-1 - 粗守或执行侧拒（副本未动、不置脏） int
|
||||
*/
|
||||
int (*db_set)(uint8_t a_idx, float a_eng);
|
||||
/* 函数功能：系数覆盖点数（执行侧真值） 返回值：点数 uint8_t */
|
||||
uint8_t (*cal_n)(void);
|
||||
/* 函数功能：读第 idx 路系数现状（同 db_row，工程量域为 µV/码） int */
|
||||
int (*cal_row)(uint8_t a_idx, ui_data_yt_row_t *a_out);
|
||||
/*
|
||||
* 函数功能：写第 idx 路系数 k（µV/码）——真机 = run_par_cal_k_set()
|
||||
* 返回值：0 - 已写并置脏；-1 - 粗守或执行段真带拒（副本未动、不置脏） int
|
||||
*/
|
||||
int (*cal_k_set)(uint8_t a_idx, float a_uv);
|
||||
/*
|
||||
* 函数功能：未标定闭锁徽标源——真机 = adc_cal_prot_blocked()（task-16 单点
|
||||
* 访问器，与判据停走同一个判定；这里**不**用 rt 帧 eng 反推）
|
||||
* 返回值：1 - 未标定闭锁中；0 - 正常 uint8_t
|
||||
*/
|
||||
uint8_t (*cal_blocked)(void);
|
||||
/*
|
||||
* 函数功能：整档落盘脏位探查——真机 = run_par_dirty_peek()
|
||||
* 返回值：1 - 有已整定未落盘改动；0 - 干净 uint8_t
|
||||
* ⚠ 两条口径必须与页面注释同步（道F task-7 Lead 裁定）：
|
||||
* ① 脏位是**整档全局**的（一趟落 [run_par] 九键 + [adc_cal] 两段），归零
|
||||
* 证明"这一档落盘了"，不证明"我这一项单独落盘"；
|
||||
* ② 他人（104 C_SE）随后再改会重新置脏 ⇒ 页面必须结果锁存，把"我这次动作
|
||||
* 的结果"与"档位此刻的状态"分开（clear/clock 页同一条先例）。
|
||||
*/
|
||||
uint8_t (*pending)(void);
|
||||
} ui_data_yt_ops_t;
|
||||
|
||||
/*
|
||||
* 函数功能：注入遥测整定执行侧函数表（启动期一次；形状/语义逐字对齐 ui_data_maint_bind）
|
||||
* 入口参数：ops - 函数表（八个成员指针都不得为 NULL）；NULL = 撤销注入（只在宿主测试存在）
|
||||
* 返回值：0 - 已注入（或已撤销）；-1 - ops 非空但成员残缺（存量不动，页面按
|
||||
* "整定能力不可用"渲染，不崩不猜） int
|
||||
* 限定条件：uiTask 启动期、先于 ui_menu_init()（真机在装配层 ui_data_feed_tick()
|
||||
* 首轮懒绑一次——该调用点在 ui_menu_init 之前，时序与通道四绑定等价）
|
||||
*/
|
||||
int ui_data_yt_bind(const ui_data_yt_ops_t *a_ops);
|
||||
|
||||
/*
|
||||
* 函数功能：死区点数
|
||||
* 入口参数：无
|
||||
* 返回值：点数；未注入返回 0 uint8_t
|
||||
*/
|
||||
uint8_t ui_data_yt_db_n(void);
|
||||
|
||||
/*
|
||||
* 函数功能：读第 idx 行死区现状
|
||||
* 入口参数：idx - 行下标 uint8_t；a_out - 行现状（返 0 才被整份写出） ui_data_yt_row_t *
|
||||
* 返回值：0 - 已写出；-1 - 未注入 / 参数空 / 执行侧无此行 int
|
||||
*/
|
||||
int ui_data_yt_db_row(uint8_t a_idx, ui_data_yt_row_t *a_out);
|
||||
|
||||
/*
|
||||
* 函数功能：写第 idx 行死区（工程量）
|
||||
* 入口参数：idx - 行下标 uint8_t；a_eng - 工程量（V/A/Hz） float
|
||||
* 返回值：0 - 已写并置脏；-1 - 未注入或执行侧拒（未注入与拒绝同码：页面都按
|
||||
* ERR 显示，装配故障与工况故障的区分归日志不归屏幕） int
|
||||
*/
|
||||
int ui_data_yt_db_set(uint8_t a_idx, float a_eng);
|
||||
|
||||
/*
|
||||
* 函数功能：系数覆盖点数
|
||||
* 入口参数：无
|
||||
* 返回值：点数；未注入返回 0 uint8_t
|
||||
*/
|
||||
uint8_t ui_data_yt_cal_n(void);
|
||||
|
||||
/*
|
||||
* 函数功能：读第 idx 路系数现状（µV/码域）
|
||||
* 入口参数：idx - 电气语义通道序 uint8_t；a_out - 行现状 ui_data_yt_row_t *
|
||||
* 返回值：0 - 已写出；-1 - 未注入 / 参数空 / 执行侧无此行 int
|
||||
*/
|
||||
int ui_data_yt_cal_row(uint8_t a_idx, ui_data_yt_row_t *a_out);
|
||||
|
||||
/*
|
||||
* 函数功能：写第 idx 路系数 k（µV/码）
|
||||
* 入口参数：idx - 电气语义通道序 uint8_t；a_uv - 新系数（µV/码） float
|
||||
* 返回值：0 - 已写并置脏；-1 - 未注入或拒（粗守/真带，副本未动） int
|
||||
*/
|
||||
int ui_data_yt_cal_k_set(uint8_t a_idx, float a_uv);
|
||||
|
||||
/*
|
||||
* 函数功能：未标定闭锁徽标源
|
||||
* 入口参数：无
|
||||
* 返回值：1 - 闭锁中；0 - 正常或未注入（宁可不画，不假报） uint8_t
|
||||
*/
|
||||
uint8_t ui_data_yt_cal_blocked(void);
|
||||
|
||||
/*
|
||||
* 函数功能：整档落盘脏位探查（保存行三态判据）
|
||||
* 入口参数：无
|
||||
* 返回值：1 - 有已整定未落盘改动；0 - 干净或未注入 uint8_t
|
||||
*/
|
||||
uint8_t ui_data_yt_pending(void);
|
||||
|
||||
#ifdef __cplusplus
|
||||
}
|
||||
#endif
|
||||
|
||||
Reference in New Issue
Block a user