feat(UI): W6 第一波——设计令牌层、页面注册表生成器与 UI 门禁补强
启动 docs/任务规划/README.md 的 W6 UI 扩展簇(用户裁定,覆盖 2026-10-11
的"本轮不排期")。四个工作包,全部验证通过。
## U1 设计令牌层(零行为变化)
新建 Drivers/BSP/UI/ui_tokens.h(20 个宏),框架 + 7 个页面 + App/task/
ui_task.c 全部接入。屏幕几何**复用 ui_port.h 既有 UI_SCREEN_W/H**,不重复
定义;令牌头自身只 include ui_port.h,不把 LVGL 拖进全部消费者。
补收了报告没列但代码里真重复的量:UI_TEXT_BAND_H 15(7 次)、列表左右边界
与每页行数(各 4 个页面逐字复制)、推流协议几何与显示几何同源(此前硬编码
3200 且注释写着"须与 UI_FB_SIZE 一致"——典型漂移隐患)、UI_TASK_TICK_MS
(ui_port_step 与 osDelay 必须同值,原先靠注释维系)。
故意不收页面私有几何与"同形不同义"的值(device_info 的 pitch=15 与列表
UI_ROW_PITCH=14 合并即改像素)。
## U3 页面注册表与生成器(删手工分发)
ui_page_registry.{c,h} 由生成器产出,**手工 menu_content_page_for() 已删
除**(仓库内仅存 2 处历史说明注释)。密码页按代码实况**单独出口**
(ui_page_registry_password())——它非节点绑定,任何 #P 叶子进同一页。
顺带落地此前判定"U1 阶段做不了"的共享 flat 样式 ui_style.{c,h}。
生成器除产注册表外**自动把新 .c 写进 uvprojx 与 CMakeLists.txt**,且
**双向对账**:加页打印 registered、删页打印 pruned,不留死条目;并双向
校验(#page 找不到实例报错、实例未被任何 #page 引用也报错)。
## U4 门禁补强(35 个钩子)
新增 font-charset 钩子(scripts/check_font_charset.py):复用
tools/font_gen 的同一套提取与 cmap 解析规则(importlib 直载,零第二套
规则),A 段查源码在用 vs 字符集、B 段查字符集 vs 字体 cmap。
registration-check 补第 ④ 类:实测原规则对"进了两端构建但没接描述符表"
的页面**全绿**——desc 被链接器剥离、编译链接全过、菜单永远打不开的死代码。
仍照不出的两项已如实写进文档(枚举漏加归 @build、菜单树漏挂归 golden)。
## 字体子集瘦身(D 案,4 留 3 删)
ui_cn_chars.txt 122→119 字(恰删 上/电/重,零新增)。异/常/片/芯 进
KEEP_EXTRA 带理由白名单:它们曾在 9eb1bd63 被写进中文自检描述落盘
/log/selftest.log(定长 64B 记录跨固件持久),删字形会使历史故障记录
渲染空白且不可逆。保留字按**必需**处理,反向有牙——谁只跑 extract_cn
把它们静默洗掉,钩子直接 FAIL 并逐字打印理由。
--strict 口径为"未知冗余 = 0"而非"冗余 = 0"。
## 验证
@build 0 错 0 警;ER_IROM1 232,052 B(较 HEAD −228 B)、RW_IRAM1
75,232 B **零增量**、RW_CCM 87.9% 未变。golden:菜单 8 状态全像素一致 +
内容页 11 页逐字节一致,**参考图 sha256 差异 0 条**(未用 --update 刷
基线);池水位菜单基线 5368 B、开页-关页往返 5448 B 与 U1 时相同。
38 个在途修改文件逐个核对 BOM/CRLF/U+FFFD 全部与 HEAD 一致。
L0 33 钩子 + L0.5 16 runner / 1104 断言全绿;check_doc_links --all
142 篇、无法判定 0;mem-budget / mem-numbers 已回填。
## 单位成本实测(U5 排期依据)
临时页 zzprobe 绑到"遥信量"叶子 → 只跑生成器 → 带页 @build 0/0 →
注册表出现 {5u, &ui_page_zzprobe_desc} → 回滚后 6 个产出文件 zzprobe
残留计数均 0、重编回基线。
**结论:新增一页 = 3 处人工(新 .c + 新 .h + 菜单树那一行加
#page=<名>)+ 1 条生成器命令,手工编辑注册文件 0 处。**
据此修正报告原口径"8 处降到 1 处"——那个 1 只在"1 处对既有文件的修改"
意义下成立,页面自身 2 个文件本就要写,真实处数是 3。
## 文档同步与两处自我修正
§0.1 UI 行 B → B+;§6.1「内容页」「设计令牌」两行按实况回填;§6.5 U1/U3
状态更新;§6 顶部加"建议栏不可照抄"总警示(本轮四次证伪:ui_port.h 已有
同名宏、LV_COLOR_BLACK/WHITE 不存在且极性反了、27 页实为目标页数现存 7
个、生成器草图漏密码页非节点绑定)。
两处改口:① §6.5 U4 从我上一版**误写的 3/3 改回 2/3**——"golden 脚本早已
存在"不等于"已进自动门禁",两个 golden 脚本至今未挂 pre-commit,该缺口
单列为待办;② 原计划"分三笔提交"**作废**,U1 与 U3 改同一批文件、文件内
交叠,硬切会产生不可编译的中间态,故整波一笔。
This commit is contained in:
+20
-33
@@ -17,6 +17,8 @@
|
||||
|
||||
#include "lvgl.h"
|
||||
#include "ui_menu_view.h"
|
||||
#include "ui_style.h"
|
||||
#include "ui_tokens.h"
|
||||
|
||||
#define DBG_TAG "[UI_STANDBY]"
|
||||
#include "dbg_log.h"
|
||||
@@ -25,11 +27,9 @@
|
||||
|
||||
/*
|
||||
* 布局常量(设备像素;参考 mockups/待机显示页面.jpg):
|
||||
* 6 路电流值行自 y=28 起、行距 18(末行 y=118..130);分隔线 y=132;底部时钟 y=140 居中
|
||||
* 屏幕宽高取令牌 UI_SCREEN_W/H;6 路电流值行自 y=28 起、行距 18
|
||||
* (末行 y=118..130);分隔线 y=132;底部时钟 y=140 居中
|
||||
*/
|
||||
#define SB_SCREEN_W 160 /* 屏幕宽(px,与 ui_port.h / 模拟器一致) */
|
||||
#define SB_SCREEN_H 160 /* 屏幕高(px) */
|
||||
|
||||
#define SB_CH_COUNT 6u /* 电流通道数 */
|
||||
#define SB_ROW_Y0 28 /* 首数据行顶 y */
|
||||
#define SB_PITCH 18 /* 行距(相邻行槽顶间距) */
|
||||
@@ -55,21 +55,8 @@ static lv_obj_t *s_prev_scr; /* 进入待机前的活动屏(ENTER 还原
|
||||
static lv_obj_t *s_prev_focus; /* 进入待机前组内焦点对象 */
|
||||
static ui_standby_time_cb s_time_cb;
|
||||
|
||||
/* flat:透明、无边框/圆角/内边距——剥离 mono 主题给普通 lv_obj 附加的 card 样式(同 ui_content_page.c) */
|
||||
static const lv_style_const_prop_t sb_flat_props[] = {
|
||||
{ .prop = LV_STYLE_BG_OPA, .value = { .num = LV_OPA_TRANSP } },
|
||||
{ .prop = LV_STYLE_BORDER_WIDTH, .value = { .num = 0 } },
|
||||
{ .prop = LV_STYLE_RADIUS, .value = { .num = 0 } },
|
||||
{ .prop = LV_STYLE_PAD_LEFT, .value = { .num = 0 } },
|
||||
{ .prop = LV_STYLE_PAD_RIGHT, .value = { .num = 0 } },
|
||||
{ .prop = LV_STYLE_PAD_TOP, .value = { .num = 0 } },
|
||||
{ .prop = LV_STYLE_PAD_BOTTOM, .value = { .num = 0 } },
|
||||
{ .prop = LV_STYLE_PAD_ROW, .value = { .num = 0 } },
|
||||
{ .prop = LV_STYLE_PAD_COLUMN, .value = { .num = 0 } },
|
||||
LV_STYLE_CONST_PROPS_END
|
||||
};
|
||||
|
||||
LV_STYLE_CONST_INIT(sb_style_flat, sb_flat_props);
|
||||
/* flat 样式(透明、无边框/圆角/内边距,剥离 mono 主题 card)取自共享样式表
|
||||
* ui_style.c:与 ui_content_page / ui_menu_view 共用同一 const 对象,不再本地重复定义 */
|
||||
|
||||
/* 函数定义区 */
|
||||
|
||||
@@ -99,15 +86,15 @@ static void sb_draw_centered_text(lv_layer_t *layer, const char *text, int32_t y
|
||||
lv_draw_label_dsc_t ld;
|
||||
|
||||
area.x1 = 0;
|
||||
area.x2 = SB_SCREEN_W - 1;
|
||||
area.x2 = UI_SCREEN_W - 1;
|
||||
area.y1 = y;
|
||||
area.y2 = y + 15; /* 覆盖字体行高(13)+ 余量 */
|
||||
area.y2 = y + UI_TEXT_BAND_H; /* 覆盖字体行高(13)+ 余量 */
|
||||
|
||||
lv_draw_label_dsc_init(&ld);
|
||||
ld.base.layer = layer;
|
||||
ld.text = text;
|
||||
ld.color = lv_color_white();
|
||||
ld.ofs_x = (SB_SCREEN_W - lv_text_get_width(text, (uint32_t)strlen(text), LV_FONT_DEFAULT, 0)) / 2;
|
||||
ld.color = UI_COL_FG;
|
||||
ld.ofs_x = (UI_SCREEN_W - lv_text_get_width(text, (uint32_t)strlen(text), LV_FONT_DEFAULT, 0)) / 2;
|
||||
ld.ofs_y = 0;
|
||||
lv_draw_label(layer, &ld, &area);
|
||||
}
|
||||
@@ -128,7 +115,7 @@ static void sb_draw_cb(lv_event_t *e) {
|
||||
lv_draw_label_dsc_t ld;
|
||||
|
||||
strip.x1 = 0;
|
||||
strip.x2 = SB_SCREEN_W - 1;
|
||||
strip.x2 = UI_SCREEN_W - 1;
|
||||
strip.y1 = row_y;
|
||||
strip.y2 = (int32_t)(row_y + SB_PITCH - 1u);
|
||||
if (!sb_areas_intersect(&strip, &layer->_clip_area)) {
|
||||
@@ -139,7 +126,7 @@ static void sb_draw_cb(lv_event_t *e) {
|
||||
ld.base.layer = layer;
|
||||
ld.text = s_ch_name[i];
|
||||
ld.text_static = 1;
|
||||
ld.color = lv_color_white();
|
||||
ld.color = UI_COL_FG;
|
||||
ld.ofs_x = SB_LABEL_X;
|
||||
ld.ofs_y = 0;
|
||||
lv_draw_label(layer, &ld, &strip);
|
||||
@@ -148,7 +135,7 @@ static void sb_draw_cb(lv_event_t *e) {
|
||||
ld.base.layer = layer;
|
||||
ld.text = "=";
|
||||
ld.text_static = 1;
|
||||
ld.color = lv_color_white();
|
||||
ld.color = UI_COL_FG;
|
||||
ld.ofs_x = SB_EQ_X;
|
||||
ld.ofs_y = 0;
|
||||
lv_draw_label(layer, &ld, &strip);
|
||||
@@ -157,7 +144,7 @@ static void sb_draw_cb(lv_event_t *e) {
|
||||
ld.base.layer = layer;
|
||||
ld.text = s_ch_value[i];
|
||||
ld.text_static = 1;
|
||||
ld.color = lv_color_white();
|
||||
ld.color = UI_COL_FG;
|
||||
ld.ofs_x = SB_VALUE_X;
|
||||
ld.ofs_y = 0;
|
||||
lv_draw_label(layer, &ld, &strip);
|
||||
@@ -169,13 +156,13 @@ static void sb_draw_cb(lv_event_t *e) {
|
||||
lv_draw_rect_dsc_t fd;
|
||||
|
||||
line.x1 = 8;
|
||||
line.x2 = SB_SCREEN_W - 9;
|
||||
line.x2 = UI_SCREEN_W - 9;
|
||||
line.y1 = SB_LINE_Y;
|
||||
line.y2 = SB_LINE_Y;
|
||||
if (sb_areas_intersect(&line, &layer->_clip_area)) {
|
||||
lv_draw_rect_dsc_init(&fd);
|
||||
fd.base.layer = layer;
|
||||
fd.bg_color = lv_color_white();
|
||||
fd.bg_color = UI_COL_FG;
|
||||
fd.bg_opa = LV_OPA_COVER;
|
||||
lv_draw_rect(layer, &fd, &line);
|
||||
}
|
||||
@@ -186,9 +173,9 @@ static void sb_draw_cb(lv_event_t *e) {
|
||||
lv_area_t t;
|
||||
|
||||
t.x1 = 0;
|
||||
t.x2 = SB_SCREEN_W - 1;
|
||||
t.x2 = UI_SCREEN_W - 1;
|
||||
t.y1 = SB_TIME_Y;
|
||||
t.y2 = (int32_t)(SB_TIME_Y + 15);
|
||||
t.y2 = (int32_t)(SB_TIME_Y + UI_TEXT_BAND_H);
|
||||
if (sb_areas_intersect(&t, &layer->_clip_area)) {
|
||||
char ts[24];
|
||||
|
||||
@@ -307,8 +294,8 @@ int ui_standby_init(uint32_t idle_timeout_ms, ui_standby_time_cb time_cb) {
|
||||
return -1;
|
||||
}
|
||||
lv_obj_add_flag(s_cont, LV_OBJ_FLAG_IGNORE_LAYOUT);
|
||||
lv_obj_set_size(s_cont, SB_SCREEN_W, SB_SCREEN_H);
|
||||
lv_obj_add_style(s_cont, &sb_style_flat, 0);
|
||||
lv_obj_set_size(s_cont, UI_SCREEN_W, UI_SCREEN_H);
|
||||
lv_obj_add_style(s_cont, &ui_style_flat, 0);
|
||||
lv_obj_add_flag(s_cont, LV_OBJ_FLAG_CLICK_FOCUSABLE);
|
||||
lv_obj_add_event_cb(s_cont, sb_key_cb, LV_EVENT_KEY, NULL);
|
||||
lv_obj_add_event_cb(s_cont, sb_draw_cb, LV_EVENT_DRAW_MAIN, NULL);
|
||||
|
||||
Reference in New Issue
Block a user