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