wandering1
4332142680
批 4 主体（票 task-15；规格 docs/UI设计/页面扩充详细方案.md §3.1.3 方案 A）。V0.1 只有 6 点有 硬件来源，其余 27 点在屏上就是 "--"——这是真实状态，不是页面没做完。 页面与数据 - 33 行固定名表（Flash const）+ 动态分页（8 行/页 = 5 页）。两处命名不照抄文档简写：idx0~3 屏上写「位置1~4」而非「YK1~4 位置」（遥信页出现 YK 前缀会被读成遥控对象，对应关系留在注释）； idx30 写「保护闭锁」（写侧位号注释的语义即此，用编号反而丢信息）。idx4~13、idx31~32 点表未 定义功能名，如实写点号占位（YX5…、YX32），不编造功能名。 - 值映射次序：先判无效 → 再判单/双点 → 最后看位值。无效位上的位值不代表任何事实，次序颠倒就会 把垃圾位画成「复归」。 - 快照新增 yx_dp 双点位图（+8 B）。不教页面"前 4 点是双点"：单双点是 104 点表事实（YX_DP_N / iec104_pts_yx_is_dp），抄进表现层就是第二真相——点表把双点段挪位或改起始下标，屏上不报错， 只会用错词形容同一个点。写侧逐点问 is_dp() 拼位图。 - UI_DATA_YX_N(33) 与 iec104_pts_yx_count() 编译期比不了（那个 #define 在协议层 .c 内），故写侧 留一条一次性 DBG_ERROR（约 90 B Flash，只在真漂移时打一次）。名表行数 = UI_DATA_YX_N 由数组 宽度法编译期守卫钉住（ARMCC C99 无 _Static_assert，本仓惯用写法）。 - 补 include 一条实测坑：DBG_ERROR 是宏，漏 include "dbg_log.h" 时 ARMCC 把它当隐式声明函数放过 编译期，错落在链接期（L6218E Undefined symbol DBG_ERROR）——报错点离根因隔了一整个链接步骤， 已在 include 处写明「DBG_TAG 必须在 include 之前」。 一个只有像素文本断言能抓到的截断 bug - 照抄批 1 的 *_PUT(dst, 源) 宏（长度取 sizeof(源)），但本表源是 const char *const 数组的 **元素（指针）**，sizeof 得 4 → 「故障总」被截成「故」，而 "YX9" 恰好 4 字节看起来完全正常。 编译器 / cppcheck / 编码钩子全不响。定位来自断言：第 2 页「过流Ⅰ段」匹配不到，同一行值列 「复归」却在原位 = 名字被截、值没错位。修法：长度取目标缓冲容量 UI_BUF_STRLEN。同名宏、不同 参数类别（数组 vs 指针），批 1 那处本身是对的，照抄才中招——教训写在宏定义上方。 模拟器与覆盖诚实性 - 固定帧发布 yx_dp = 0x0F，但刻意不把这几位置进 yx_valid：V0.1 无开入硬件，屏上就是 "--"。不用 「让它显示合位/分位」的假数据填满画面，那等于让黄金参考声称本机有开关位置遥信。 - 代价如实登记：合位/分位这条词映射当前**没有任何自动化证据**（像素恒 IV；页面依赖 LVGL 进不了 主机单测）。已写进方案 §3.1.3 落地注与契约落地进度·四，作为开入落地后的台架判据，不假装测过。 测试 - 主机单测 +2 条（TC-UIDATA-009c 双点位图原样透传、不被 valid 掩；009d 点数 33 的独立见证，注明 绊红时要同步改哪四处）→ 85/85。 - 文本断言 +33 条（yx / yxp2 两态，含页码钉住 33/8 = 5 页的分页数学）；两页像素基线单独一笔。 - font-charset 本批零新增字：名表用字全部命中既有 183 字子集——「置/故/障/总/外/部」正属批 1 成组并入 KEEP_EXTRA 的那批字，第二次兑现（当时若按 extract 输出重写字符集，这些字早被洗掉， 上屏是空白，而门禁只会说「字不在清单里」）。 体积（同一棵树、构建前后的实测增量） - Code 224272→224688（+416）；RO 24040→24640（+600）；RW 1324→1328（+4）； ZI 134844→135088（+244）→ Flash 约 +1020 B、RAM +248 B。 - RO 增量主要是 33 行名表与名称串，是"把 33 个真点名上屏"的代价，不是可省开销。 跳过的门禁（三条同族，同一根因）：mem-numbers / mem-budget / size-gate（L0c）——台账与体积凭证 回填是 Lead 单写者，本分支不做静默处理，数值见上。
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 12u /* 绑定了内容页的叶子数 */
|
||
|
||
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 */
|