wandering1
48a8ef0564
这两页是「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 上下文」已被装配层裁定覆盖）归算法层下一笔。
57 lines
2.3 KiB
C
57 lines
2.3 KiB
C
/*
|
||
* 模块名称：UI 页面注册表头文件（自动生成）
|
||
* 模块功能：叶子节点 → 内容页描述符的映射表与查询 API；密码页非节点绑定，单独出口
|
||
* 适用平台：STM32F407ZGTx / PC 模拟器（共用源码）
|
||
* 作者：王建锋
|
||
* 创建日期：2026-10-15
|
||
* 自动生成：本文件由 tools/menu_gen/gen_menu.py 从 ui_menu_tree.txt 的 #page= 注记生成，请勿手改。
|
||
* 新增一页：菜单树给叶子加 " #page=<模块名>" + 写 ui_page_<模块名>.c，重跑生成器
|
||
* （双端注册 uvprojx/CMakeLists 亦由生成器自动写入）
|
||
*/
|
||
#ifndef UI_PAGE_REGISTRY_H
|
||
#define UI_PAGE_REGISTRY_H
|
||
|
||
#include <stdint.h>
|
||
|
||
#include "ui_content_page.h"
|
||
|
||
#ifdef __cplusplus
|
||
extern "C" {
|
||
#endif
|
||
|
||
/* 注册表条目：一个绑定了内容页的菜单叶子（表序 = 节点下标升序） */
|
||
typedef struct {
|
||
uint8_t node; /* 菜单叶子节点下标（g_menu_tab 下标） */
|
||
const content_page_def_t *desc; /* 页面描述符（Flash const） */
|
||
} ui_page_entry_t;
|
||
|
||
#define UI_PAGE_MAP_COUNT 21u /* 绑定了内容页的叶子数 */
|
||
|
||
extern const ui_page_entry_t g_ui_page_map[UI_PAGE_MAP_COUNT];
|
||
|
||
/*
|
||
* 函数功能：查叶子节点绑定的内容页描述符
|
||
* 入口参数：node - 菜单叶子节点下标 uint8_t
|
||
* 返回值：页面描述符；该叶子未绑定内容页返回 NULL const content_page_def_t *
|
||
* 限定条件：node < UI_MENU_TAB_COUNT
|
||
* 函数说明：取代旧 ui_menu.c 手写 case 分发——映射的唯一真源是 ui_menu_tree.txt，
|
||
* 表序变化不会造成"下标硬编码错位"（线性扫描：绑定页是个位数量级）
|
||
*/
|
||
const content_page_def_t *ui_page_registry_for(uint8_t node);
|
||
|
||
/*
|
||
* 函数功能：取密码页描述符（需密码叶子统一进这一页）
|
||
* 入口参数：无
|
||
* 返回值：密码页描述符；菜单树未声明 @password 指令时返回 NULL const content_page_def_t *
|
||
* 限定条件：无
|
||
* 函数说明：密码页**不是**节点绑定的（任何 #P 叶子都进同一页），故不进 node→desc 映射，
|
||
* 由本接口单独出口；取值来自 ui_menu_tree.txt 的 `# @password=<模块名>` 指令
|
||
*/
|
||
const content_page_def_t *ui_page_registry_password(void);
|
||
|
||
#ifdef __cplusplus
|
||
}
|
||
#endif
|
||
|
||
#endif /* UI_PAGE_REGISTRY_H */
|