Files

T

wandering1 a7f526569a perf(mem): R-9 落地——LVGL 池 40→16 KB，SRAM1 74.9%→56.1%

取值依据是实测水位，不是预估：菜单根框 5,368 B、开页-关页往返
5,448 B、最重页面峰值 6,568 B（占 16 KB 的 40%）、真机开机
used=3,192 B。注意 16,384 B 建池后 lv_mem_monitor 报的 total 是
15,020 B（TLSF 控制块与对齐元数据 ≈1,364 B），核算余量用后者。

两端 lv_conf.h 同步改值（lv-conf-sync 生效值比对 163 项 PASS），
Lib/lv_conf.h 的 UTF-8 BOM 已按原样补回（Edit 会静默剥掉）。

验证：
- @build 0 错 0 警；ZI 154,456 → 129,880，精确 −24,576 B
- SRAM1 98,144/74.9% → 73,568/56.1%（余 57,504 B）；CCM 不变 87.9%
- 模拟器菜单回归 PASS（8 状态像素 + 池基线 5,368 B 未变）；11 页
  黄金参考逐字节 10/11 一致，往返池水位 5,448 B 分毫未变
- 唯一差异 netcfg_save 保存态：用 40 KB 旧池做 A/B 复测同样失败，
  确认与本改动无关（属 506eccc 的 cfg_file 行为变化），未刷黄金
  参考掩盖，留给该改动属主处置
- @test PASS：fw build Oct 15 2026 07:31:34，无 [ERR]/Fault，
  开机 622 ms 到 net init: OK，menu build done: used=3192
- 本地 CI 全绿（L0 + L0.5，15 runner / 955 断言）
- 台账受管区与内存快照区已 --write 回填，mem-budget / mem-numbers
  由红转绿

连带结论：R-2 后半待迁体量 54,146 → 29,570 B，瓶颈由 SRAM1 换到
CCM（只剩 7,904 B）；解锁链第 ① 步完成，下一步只差缩堆 56→32 KB
（B5 是反向扩容，缩回前须重跑 stack_report.py + 上板 min_ever）。

文档同步 20 处：本报告按修复即销项删除 R-9 行，并改写 §0.2/§0.3/
§0.4/§5.1/§5.2/§5.3/§6.4 与变更记录、去处表；RAM使用分析 §2.6.2
新增实测水位表、阶段 1.1 标已执行；台账 §3 解锁链、登记簿 N-27、
任务规划 README W3 行与链路图；UI 四篇、产品需求、内存内容分配
策略、运行与自检记录、项目部署环境要求、测试开发标准流程、
simulator/README、ui-verify skill 常量。顺带订正三处与脚本不符的
旧值：池水位常量 4784/4864 → 5368/5448、FreeRTOS 堆 48 → 56 KB。

2026-10-15 09:56:15 +08:00

6.0 KiB

Raw Blame History

界面 01：主界面（根页）— 规格说明

本文件为设计规格（source of truth）：布局参数、字符集核对、待确认问题、映射、LVGL 翻译要点。P1 照参数表翻译代码，P2 出图对照参数表 + 原图。规则：160×160 设备像素 | 1bpp 纯黑白 | SimSun 12px（汉字 12px/字，ASCII 6px/字，行高 13）布局依据：原图 01_主界面原始图片.png（628×631 @ 3.925x 缩放）实测 + 模拟器出图目视比对。

一、布局参数（单位：设备像素）

项	值	说明
顶部装饰	开口浅 V，两腿 3px / 水平线 2px	左尖 (7,7)、底左 (16,17)、底右 (145,17)、右尖 (158,7)；底边 y=17，两腿外上翘至 y=7。实现拆 3 段 `lv_line`：两腿加粗（`MENU_DECO_LEG_W`=3）补偿 1bpp 斜线边缘阈值损耗，水平线保持 2px（`MENU_DECO_HORIZ_W`）
状态行	左对齐 x=17，顶 y=20	行高 13，文案"当前模式：无模式"（全角冒号，两侧半角空格）
列表框	x=0，顶 y=44，宽 99，高 107	左对齐（非通栏），1px 白边框，内 7 行 × 15px（7×15+2 边框=107）
行高	15	7 行
行内文字	左对齐，左留白 8	4 字 = 48px（x 8~56）
箭头 ▶	x=58（紧跟文字）	非右对齐；仅第 2~7 行有
选中行	第 1 行整行反色	白底黑字，无箭头，白色高亮铺满框宽

二、行内容与状态

行	文本	箭头	状态
1	装置信息	无	选中（整行反色：白底黑字）
2	实时数据	▶（紧跟文字）	普通（黑底白字）
3	参数定值	▶（紧跟文字）	普通
4	三遥设置	▶（紧跟文字）	普通
5	装置维护	▶（紧跟文字）	普通
6	通讯参数	▶（紧跟文字）	普通
7	记录查询	▶（紧跟文字）	普通

说明：选中行（第 1 行）无 ▶ 箭头；其余行 ▶ 紧跟在 4 字文本后（非右对齐）。行内文字左对齐、左留白 8px。

三、字符集核对（对照现有 ui_font_cn_12：78 汉字 + ASCII 0x20~0x7E）

菜单 7 项共 22 个唯一汉字：命中 21（装置信息实时数据参定值遥设维护通讯记录查询），新增 1（三）。
状态行"当前模式：无模式"：新增 5（当前模式无） + 全角冒号：（U+FF1A，新增）；空格为 ASCII（已在字库）。
箭头：▶（U+25B6，新增符号）。

→ 确定新增 8 个字形：三当前模式无： ▶。

写 LVGL 代码前必须重新生成字体，否则新增字在真机显示为空白。流程：代码落库 → python tools/font_gen/extract_cn.py（自动从 UI 源码字符串提取）→ & '.venv\Scripts\python.exe' tools/font_gen/make_font.py（需 fontTools，见 UI_中文字体生成与配置.md §2.1）→ 两端（MCU/模拟器）同时生效。

四、待确认问题

设计形态（框宽/选中态/装饰形状/冒号）已按原图定形（见第一、二节），不再待确认。以下为内容/数据问题，需用户答复。

#	问题	说明
Q1	7 个条目 ↔ 子树映射（见第五节表）是否成立？	其中 3 项疑似重命名（参数定值/三遥设置/通讯参数），需逐项确认
Q2	"三遥设置"对应现有哪个节点？	现有 g_menu_tab 有"遥测量"（测量值/遥调系数/遥测系数/双字节/装置遥调）；"三遥"是否 = 遥测+遥信+遥控的新节点？
Q3	"厂家设置 / 版本信息"入口在哪？	旧菜单中"厂家设置"为独立顶级项（含元件设置/恢复默认/版本显示/版本信息），新 7 项列表未包含——从哪进入？
Q4	"当前模式"指什么、数据从哪来？	状态行动态值来源（运行/保护/通信模式？）；"无模式"为默认？需 App 层供给字符串

五、条目 → 子树建议映射（Q1，均待确认；对照现有 g_menu_tab）

#	条目	现有节点	建议映射
1	装置信息	装置信息（L1）	直接沿用（无变化）
2	实时数据	实时数据（L1）→ 交流量/直流量/开入量	直接沿用（无变化）
3	参数定值	定值参数（L1）→ 定值/查看	重命名定值参数 → 参数定值？（待确认）
4	三遥设置	遥测量（L1）→ 测量值/遥调系数/…	对应"遥测量"？或新增"三遥"（遥测/遥信/遥控）节点？（Q2）
5	装置维护	装置维护（L1）→ 时间设置/强制复归/手动录波/自动录波	直接沿用（无变化）
6	通讯参数	通讯设置（L1）→ 通讯参数/网络配置/SNTP设置	重命名通讯设置 → 通讯参数？或提升 L2"通讯参数"？（待确认）
7	记录查询	记录查询（L1）→ SOE/事故/操作/告警/…	直接沿用（无变化）

注：旧菜单中的"厂家设置"（L0，含元件设置/恢复默认/版本显示/版本信息/装置遥调/装置记录）未出现在新 7 项列表中，入口待 Q3 确认。

六、LVGL 翻译要点（P1 用）

列表 = 持久容器 lv_obj（x=0, y=44, 99×107，1px 边框）+ 7 个行子 lv_obj（高 15，绝对定位 lv_obj_set_pos，固定布局更可控）
行 = lv_obj + lv_label（静态文本，左对齐 x=8）+ lv_label（"▶"，x=58，紧跟文字）；选中行 = LV_STATE_CHECKED 整行反色（白底黑字，高亮铺满框宽）
状态行 = lv_label（x=17, y=20，文本由 App 层供给，Q4）
顶部装饰 = 开口浅 V（4 段折线：(7,7)→(16,17)→(145,17)→(158,7)）：LVGL 可用 3 条 lv_obj 线段拼合（斜线用 lv_line），或预渲染 1bpp 位图 lv_image（更省对象、更精确）
1bpp 禁区（本设计均未使用）：圆角 / 阴影 / 透明度 / 渐变 / 多色
内存：根页 = 1 列表容器 + 7 行 ×（行 obj + 2 label）+ 状态 label + 装饰 ≈ 20+ 个对象，为最高频页面，P1 需核算 16KB LVGL 池占用

6.0 KiB Raw Blame History Unescape Escape