diff --git a/docs/README.md b/docs/README.md index 6226a204..1d57fe7b 100644 --- a/docs/README.md +++ b/docs/README.md @@ -236,7 +236,7 @@ docs/ | [`UI_自动化测试流程.md`](UI设计/UI_自动化测试流程.md) | UI 模拟器像素回归(ui-verify 五步) | | [`LVGL模拟器部署与使用说明.md`](UI设计/LVGL模拟器部署与使用说明.md) | PC 端 LVGL 模拟器部署与使用 | | [`RemoDispBus协议与接收设计说明.md`](UI设计/RemoDispBus协议与接收设计说明.md) | 远端显示总线协议与接收设计 | -| [`页面补齐规划.md`](UI设计/页面补齐规划.md) | 27 个空叶子页面的归并、前置能力(数据快照层/数值编辑)与分批顺序(2026-10-23) | +| [`页面补齐规划.md`](UI设计/页面补齐规划.md) | 内容页现状:43 节点 / 30 叶 / 已绑 27,逐页形态与数据来源,未绑三叶的原因 | | [`UI_数据供给设计说明.md`](UI设计/UI_数据供给设计说明.md) | 页面实时数据的高内聚低耦合方案:快照推送(rt/par 双通道)、写路径、记录 reader 注入(2026-10-23) | | [`页面扩充详细方案.md`](UI设计/页面扩充详细方案.md) | 27 个空叶子 + 3 页回炉的逐页方案:行表、数据源、组件、分批与预算(2026-10-23) | | `mockups/` | 各页面参考图与说明 | diff --git a/docs/UI设计/UI_数据供给设计说明.md b/docs/UI设计/UI_数据供给设计说明.md index 99f48696..04b837d0 100644 --- a/docs/UI设计/UI_数据供给设计说明.md +++ b/docs/UI设计/UI_数据供给设计说明.md @@ -1,7 +1,7 @@ # UI 数据供给设计说明(高内聚低耦合) > **定位**:解决"内容页拿不到实时数据"的架构问题——给出数据从 App 层到 UI 层的**唯一通道**、数据契约、并发模型、写路径与测试策略。 -> **问题来源**:`docs/UI设计/页面补齐规划.md` §1 与 §3.1(现状:交流量第 2/3 页、直流量全部为硬编码占位值)。 +> **问题来源**:`docs/UI设计/页面补齐规划.md` §1/§2.1(本层落地前,交流量/直流量全部为硬编码占位值)。 > **门禁口径**:`scripts/check_layer_deps.py` 的文件头已写明三种合法做法(注入 / 上层取好传进来 / 叶子工具进 ALLOW)。本文选择并细化前两种。 > **前置阅读**:`docs/UI设计/内容页架构.md`(页面描述符与 4 个钩子)、`docs/架构设计/项目架构总览.md`(六层单向依赖)。 @@ -585,7 +585,7 @@ typedef struct { ### 9.3 与"虚拟注入"的关系 -`docs/UI设计/页面补齐规划.md` §7 提的厂家调试"虚拟注入",**天然落在 `ui_data_feed` 上**:注入值只要在 feed 组装时覆盖对应字段即可,**页面完全不知情**。 +`docs/UI设计/页面补齐规划.md` §5 记的厂家调试"虚拟注入"(未做),**天然落在 `ui_data_feed` 上**:注入值只要在 feed 组装时覆盖对应字段即可,**页面完全不知情**。 约束(必须写进代码注释):虚拟注入**只能在 feed 层覆盖快照字段**,绝不能改 `prot_set` / `phasor` 的输入——否则会污染保护判据路径。 @@ -739,5 +739,5 @@ typedef struct { - **门禁**:`scripts/check_layer_deps.py` 的三种合法做法本文全部用上(快照推送=②,写路径与记录 reader=①),**不新增任何 `ALLOW` 或 `BASELINE` 条目**;计划的 3 条削减**已于 2026-10-25 兑现**(task/UI-rec-reader 落地 §7.2 契约,基线 6 → 3,详见 `docs/门禁说明/layer-deps.md` §1)。 - **页面框架**:`docs/UI设计/内容页架构.md` 的 `refresh` / `count_cb` 钩子**签名不变**,页面只是改为从 `ui_data` 取数。 -- **页面清单**:`docs/UI设计/页面补齐规划.md` 的"批 1"第一项即本文 步骤1~步骤3。 +- **页面清单**:`docs/UI设计/页面补齐规划.md` §2.1 的交流量/直流量两页即本文的消费端。 - **数据真实性**:`docs/问题记录/采集与数据处理短板评测.md` 的标定(§4.1)与遥测链(§4.2)落地后,只需改 `ui_data_feed` 的取数来源与 `eng` 取值,页面零改动。 diff --git a/docs/UI设计/页面扩充详细方案.md b/docs/UI设计/页面扩充详细方案.md index 5c7b05d7..7397ec61 100644 --- a/docs/UI设计/页面扩充详细方案.md +++ b/docs/UI设计/页面扩充详细方案.md @@ -1,6 +1,6 @@ # 页面扩充详细方案(27 个空叶子 + 3 页回炉) -> **定位**:`docs/UI设计/页面补齐规划.md` 回答"怎么归并、分几批";本文回答**每一页显示什么、数据从哪来、要改哪些代码**——可直接照着开工的粒度。 +> **定位**:`docs/UI设计/页面补齐规划.md` 回答"现在有哪些页、每页是什么形态";本文回答**每一页显示什么、数据从哪来、要改哪些代码**——可直接照着开工的粒度。 > **数据通道**:`docs/UI设计/UI_数据供给设计说明.md`(快照推送 + 写路径 + 记录 reader 注入)。 > **数据真实性**:`docs/问题记录/采集与数据处理短板评测.md`(标定、遥测链、运行参数段的缺口)。 > **统计口径**:本文所有节点/叶子数字均由 `ui_menu_tree.txt` 脚本统计 + `Drivers/BSP/UI/ui_page_registry.c` 交叉核对,不引用旧文档结论。 @@ -52,7 +52,7 @@ ### 1.4 与既有规划的关系 -`docs/UI设计/页面补齐规划.md` 已把 27 个空叶子归并为 **7 个页面模块 + 1 个共享组件 + 2 项框架能力 + 1 个数据层**。本文沿用该归并,但**新增三项**(核对后才发现必需): +落地的 27 页按 **7 个页面模块 + 1 个共享组件 + 2 项框架能力 + 1 个数据层** 归并。本文沿用该归并,但**新增三项**(核对后才发现必需): | 新增项 | 为什么规划里没有 | |---|---| @@ -648,7 +648,7 @@ SNTP 客户端 ──────→ 批4 SNTP设置 | 文档 | 回答什么 | |---|---| -| `docs/UI设计/页面补齐规划.md` | 27 页怎么归并、分几批、内存预算 | +| `docs/UI设计/页面补齐规划.md` | 现状规模、逐页形态与数据来源、未绑三叶的原因 | | **本文** | 每一页显示哪些行、数据从哪来、要改哪些代码 | | `docs/UI设计/UI_数据供给设计说明.md` | 数据怎么从 App 到 UI(通道/契约/并发/写路径) | | `docs/UI设计/内容页架构.md` | 页面框架本身(描述符/钩子/权限) | diff --git a/docs/UI设计/页面补齐规划.md b/docs/UI设计/页面补齐规划.md index 3edfbd0b..648c3669 100644 --- a/docs/UI设计/页面补齐规划.md +++ b/docs/UI设计/页面补齐规划.md @@ -1,231 +1,119 @@ -# UI 页面补齐规划(2026-10-23) +# UI 页面补齐现状 -> **定位**:盘清当时 42 节点菜单里**还没有内容页的 27 个叶子**(节点数现值 43 = 9 菜单 + 34 叶, -> 2026-10-29 录波道加「录波回放」叶后升级;本文其余数字是 2026-10-23 立项快照,按 §1 的「完成即冻结」不回改),按"数据是否就绪 + 页面形态"归并成可施工的包,给出分批顺序与每页规格。 -> **前置阅读**:`docs/UI设计/内容页架构.md`(框架机制与新增页面六步)、`docs/UI设计/菜单页面设计.md`(菜单树与几何)、`docs/UI设计/UI_自动化测试流程.md`(像素回归门禁)。 -> **不重复登记**:页面级规格写进本文与 `docs/UI设计/内容页架构.md`;顺序归 `docs/任务规划/README.md` §2。 -> **逐页细化**:每页显示哪些行、数据从哪来、要改哪些代码,见 `docs/UI设计/页面扩充详细方案.md`(本文的落地细化版)。 +> **定位**:菜单树 43 节点 / 30 叶里,**27 叶已绑内容页、3 叶未绑**。本文按分组逐页说明当前形态与数据来源, +> 并把剩下三叶为什么没做、什么条件下才做写清楚。历史上的分批排队与估算已全部落地,不再保留。 +> **前置阅读**:`docs/UI设计/内容页架构.md`(框架机制与新增页面六步)、`docs/UI设计/菜单页面设计.md`(菜单树与几何)、 +> `docs/UI设计/UI_数据供给设计.md`(注入通道契约)、`docs/UI设计/UI_自动化测试流程.md`(像素回归门禁)。 +> 逐页行表与代码级明细见 `docs/UI设计/页面扩充详细方案.md`。 --- -## 1. 一页结论 +## 1. 现状规模 -**"27 个空页面"不是 27 份工作,是 7 个页面模块 + 1 个共享组件 + 2 项框架能力 + 1 个数据供应层。** - -真正卡住进度的不是"画页面",是两件事: - -| 卡点 | 实质 | 后果 | +| 项 | 现值 | 出处 | |---|---|---| -| **UI 拿不到实时数据** | 分层门禁禁止 `Drivers/BSP/**` include `App/**` 头(`scripts/check_layer_deps.py`),而相量/定值/遥信全在 `App/` | 已建的 3 个数据页(装置信息/交流量/直流量)**整页都是 Flash 字面量**(`"3.01"` 这类),新建页也只能照抄假数据 | -| **没有数值编辑器** | 现有编辑能力只有"逐字节改 IP"(`ui_page_net_cfg.c`),定值要改浮点/整数并校验范围 | 4 个"整定"页无法开工 | +| 菜单节点 | **43**:7 个一级菜单(装置信息/实时数据/参数定值/三遥设置/装置维护/通讯参数/记录查询)+ 27 个二级条目 + 8 个三级条目,其中叶子 **30** | `ui_menu_tree.txt` | +| 叶子 | **30** | 同上 | +| 已绑内容页叶子 | **27**;注册表 `UI_PAGE_MAP_COUNT` = 31,差额 4 为「查看/整定」两组叶子的两态复用带来的映射条目 | `Drivers/BSP/UI/ui_page_registry.h` | +| 未绑叶子 | **3**(遥信类型 / 遥信防抖 / 双点遥信) | `ui_menu_tree.txt` | +| `ui_page_*.c` 源文件 | **30**(含 registry 与密码页两个非节点页) | `Drivers/BSP/UI/` | +| 像素黄金参考 | **74 张**(`simulator/tests/ref/shot_*.bin`) | 同目录实数 | -**建议先做数据供应层与数值编辑这两项前置能力,再按"数据就绪度"分四批铺页**——顺序按数据走,不按菜单走。 +> 口径:叶子判定 = 无更深缩进后继者;已绑判定 = 该行带 `#page=`。复核方法与 `docs/UI设计/菜单页面设计.md` §3.9 一致。 --- -## 2. 现状 +## 2. 逐页现状 -### 2.1 规模 +### 2.1 装置信息与实时数据 -> ⚠ **本表是 2026-10-23 立项当天快照**(节点 42 / 有内容页叶子 6 / 空叶子 27 / 黄金参考 11 份均为当日实数,按"完成即冻结"不回改)。 -> 页面扩充落地后现值已变——黄金参考现为 66 份(`simulator/tests/ref/` 入库的 `shot_*.bin` 实数,2026-10-28 记录 5 页与运行报告页落地 +7 张;2026-10-29 录波 UI 道 +6 张),现状口径见 -> `docs/UI设计/页面扩充详细方案.md` 与 `docs/UI设计/UI_数据供给设计说明.md`。 - -| 项 | 数 | -|---|---| -| 菜单节点总数 | **42**(9 菜单 + 33 叶子) | -| 有内容页的叶子 | **6**(装置信息 / 交流量 / 直流量 / 网口设置 / 自检记录 / 运行记录) | -| 无内容页的叶子 | **27** | -| 独立内容页(非节点绑定) | 1(用户密钥/密码页) | -| 已入库像素黄金参考 | 11 份(`simulator/tests/ref/shot_*.bin`) | - -### 2.2 已有 7 页的真实完成度 - -| 页 | 节点 | 数据来源 | 真实度 | +| 页 | 叶子 | 数据来源 | 备注 | |---|---|---|---| -| 装置信息 | 1 | Flash 静态表 | ⚠ **6 行全是字面量**(含参考项目遗留的校验码 `4454`、日期 `2024.08.27`),不随构建变化 | -| 交流量 | 3 | Flash 静态表 | ❌ **24 行全是 Flash 字面量,不会变**(第 1 页数值取自参考图实测,看着像真值);且 24 行是参考机全套(含 P/Q/S/PF 与两段母线),**本机 V0.1 只有 8 路电气量 + 温度**,行表需按实际通道裁剪 | -| 直流量 | 4 | Flash 静态表 | ❌ **3 行全是占位**(`3.01/3.15/3.288`);**且 V0.1 硬件没有直流采样通道**(`ADC_SEM` 只有 8 路电气量 + 温度)→ 这页当前**无数据源** | -| 网口设置 | 30 | `net_cfg` RAM 副本 | ✅ 真(可编辑 + 保存交接) | -| 自检记录 | 39 | `sys_log`(`/log/selftest.log`) | ✅ 真(经 `ui_w_records`) | -| 运行记录 | 40 | `sys_log`(`/log/run.log`) | ✅ 真(同上) | -| 用户密钥 | — | 编译期密码 | ✅ 真 | +| 装置信息 | 装置信息 | 全部运行时取真值(型号 / 软硬件版本 / 校验码 / 程序日期 / MAC / IP / 运行时长,共 8 行) | 不再有 Flash 字面量 | +| 交流量 | 交流量 | `ui_data_rt()` 快照(`ui_data_rt_seq()` 变化才整帧拷贝) | **7 行**(UA/UB/UC/UN/IA/IB/IC),非参考机 24 行全套 | +| 直流量 | 直流量 | `ui_data_rt()` 快照 | **2 行**,V0.1 无直流采样通道,行集按实际可用量收窄 | +| 遥信量 | 遥信量 | `ui_data_rt()` 快照,33 位 + 有效位 | 无效位置灰语义 | -**结论**:7 页里有 **3 页是静态字面量**(装置信息、交流量、直流量),其余 4 页为真。这 3 页**必须回炉**,它们是"有页但不可信",比空叶子更容易误判为已完成。 +### 2.2 参数定值(查看 + 整定两态) -> 逐页的行表、数据源与代码改动量见 `docs/UI设计/页面扩充详细方案.md`。 +八个叶子共用**一份描述符**(`ui_page_view_param/set/word/plate.c` → `ui_w_setview` 四张视图表), +同一份行表/取数/反显,不存在"查看一套边界、整定另一套边界"。差异只在进入时是否带编辑叠层: -### 2.3 27 个空叶子逐项清单 - -> 形态:**信息页**(静态行)/ **列表页**(静态或动态行)/ **表单页**(自绘 + 自有键)/ **操作页**(确认 → 执行 → 回报)。 -> 就绪度:✅ 数据现成 / 🔶 需新数据层 / ❌ 数据源不存在。 - -| 节点 | 叶子 | 建议形态 | 数据源 | 就绪度 | -|---|---|---|---|---| -| 5 | 遥信量 | 动态列表(33 行 / 5 页) | `iec104_pts` 遥信位图 + 有效位图 | ✅(需快照层) | -| 8 | 参数(整定) | 可编辑列表(8 项) | `prot_set` 参数类 | ✅(需编辑器) | -| 9 | 定值(整定) | 可编辑列表(18 项 / 3 页) | `prot_set` 数值类 | ✅(需编辑器) | -| 10 | 控制字(整定) | 可编辑列表(4 项) | `prot_set` 跳闸投退类 | ✅(需编辑器) | -| 11 | 软压板(整定) | 可编辑列表(10 项) | `prot_set` 投退类 + 全局 | ✅(需编辑器) | -| 13 | 参数(查看) | 列表(8 项 1 页) | 同 8 | ✅(需快照层) | -| 14 | 定值(查看) | 列表(18 项 / 3 页) | 同 9 | ✅(需快照层) | -| 15 | 控制字(查看) | 列表(4 项) | 同 10 | ✅(需快照层) | -| 16 | 软压板(查看) | 列表(10 项 / 2 页) | 同 11 | ✅(需快照层) | -| 18 | 遥测死区 | 可编辑列表(4 项) | `[run_par]` 9 键死区 | ✅ 已落地(ui_page_deadband.c,2026-10-27) | -| 19 | 遥测系数 | 可编辑列表(9 项) | `[adc_cal]` 的 k / b | ✅ 已落地(ui_page_calib.c,2026-10-27) | -| 20 | 遥信类型 | 可编辑列表 | 开入量 | ❌ 开入未实现 | -| 21 | 遥信防抖 | 可编辑列表(1 项) | 运行参数 0x8030 | ❌ 同上 | -| 22 | 双点遥信 | 可编辑列表 | 开入量 | ❌ 同上 | -| 24 | 时钟设置 | 表单(6 字段) | `sys_clock_get_time/set` | ✅ | -| 25 | 强制复归 | 操作页(确认) | `prot_elm_request_reset()` | ✅ | -| 26 | 手动录波 | 操作页(确认) | `wave_ring_request` 手动触发经 `ui_data_wave_ops_t` 注入 | ✅ 已落地(`ui_page_wave_manual.c`,2026-10-29 录波 UI 道;配套新增「录波回放」叶 node 43 = `ui_page_wave_play.c`,不在本表 27 叶之列) | -| 27 | 清除记录 | 操作页(选类型 + 确认) | `sys_log`(**缺删除 API**) | 🔶 需补 API | -| 29 | 通讯设置 | 可编辑列表(4~6 项) | 104 公共地址/端口/主站(当前固定) | 🔶 需 `comm_cfg` | -| 31 | SNTP设置 | 可编辑列表(3 项) | SNTP 客户端 | ✅ 已落地(`ui_page_sntp.c`,2026-11-04 板端 SNTP 接入立项;形态较原规划多 1 行 = 启用/主服务器/备服务器/周期(分) + 保存行,编辑语义复刻网口设置页) | -| 33 | SOE记录 | 动态列表(每记录 2 行) | `/log/soe.log` 二进制 64B | ✅ 已落地(`ui_page_soe.c`) | -| 34 | 事故记录 | 动态列表 | /log/accid.log(SYSLOG_ACCIDENT,写入点 protect_task.c) | ✅ 已落地(ui_page_accident.c,2026-10-28) | -| 35 | 操作记录 | 动态列表 | /log/oper.log(SYSLOG_OPER,写入点 4 处:定值保存 / 复归 / 对时 / 清除记录) | ✅ 已落地(ui_page_oper.c,2026-10-28) | -| 36 | 保护告警 | 动态列表 | /log/alarm.log(SYSLOG_ALARM,asserted 且跳闸投退=0) | ✅ 已落地(ui_page_alarm.c,2026-10-28) | -| 37 | 保护启动 | 动态列表 | /log/start.log(SYSLOG_START,picked 上升沿) | ✅ 已落地(ui_page_start.c,2026-10-28) | -| 38 | 遥控记录 | 动态列表 | /log/yk.log(SYSLOG_YK,写入点 iec104_pts.c 遥控段) | ✅ 已落地(ui_page_yk.c,2026-10-28) | -| 41 | 运行报告 | 列表页(12 行 / 2 页,四数逐个挂范围标签) | boot_stats(上电次数 + 复位原因)+ 四个 104 观测计数 + uptime_s,经 ui_data info 帧下发 | ✅ 已落地(ui_page_runreport.c,2026-10-28;跨开机累计按裁定不做) | - -**统计(2026-10-25 复核)**:本表 27 叶中 **6 叶已落地**(遥信量 / 查看 4 页 / SOE),剩 21 叶 = 数据现成 **8** 项(整定 4 + 时钟 + 复归 + 死区 + 系数)· 需新数据层 **2** 项(清除记录 / 通讯设置)· 数据源不存在 **11** 项(遥信 3 + 手动录波 + SNTP + 记录 5 + 运行报告)。**逐页形态与数据源只看本表,排期不进本文**——当时的执行清单文件已于 2026-11-09 随 UI 补齐整体销项删除,页面口径现归 `docs/UI设计/内容页架构.md` §7.1。 - -**2026-10-28 复核**:本表 27 叶中 **22 叶已落地**(本批 +6:记录 5 页与运行报告);未落地的 5 叶 = 遥信类型 / 遥信防抖 / 双点遥信(无开入硬件)+ 手动录波(无录波模块)+ SNTP设置(产品口径未定),重开条件见 `docs/架构设计/硬件规格与能力边界.md` H3 与各模块文档。口径闭合:本表 22 叶 + 立项前就已绑定、不在本表内的 6 叶(装置信息 / 交流量 / 直流量 / 网口设置 / 自检记录 / 运行记录)= 现值已绑 28 叶(= UI_PAGE_MAP_COUNT);本表未落地 5 叶 = 菜单树未绑 5 叶(33 − 28)。复核方法:按缩进判叶子(有更深缩进后继者即非叶子),再按行内 #page= 数已绑(完整命令见 `docs/UI设计/菜单页面设计.md` §3.9)。**2026-10-29 补充**:「手动录波」已随故障录波独立立项(docs/子系统设计/故障录波设计说明.md;原卡片登记簿 2026-10-30 销项并入该文 §10),上面那行数字仍是 2026-10-28 当日复核值,未随立项改动。 -**2026-10-29 二补(录波 UI 道落地)**:本表「手动录波」转已落地(23 叶);菜单树另新增「录波回放」叶(node 43,不在本表立项快照内)——现值 43 节点 / 34 叶 / 已绑 30 / 未绑 4(= 遥信 3 + SNTP 1,UI_PAGE_MAP_COUNT = 30),口径复核方法与上一段相同 -**2026-11-04 复核(板端 SNTP 接入立项,#57 调研结论)**:本表「SNTP设置」转已落地(24 叶)——`ui_page_sntp.c` 绑 `#page=sntp`,[sntp] 段经 `net_cfg_load` 注册、SNTP 客户端在 timeSyncTask 轮询(`App/sync/time_sntp.c`);现值 43 节点 / 34 叶 / 已绑 31 / 未绑 3(= 遥信 3,UI_PAGE_MAP_COUNT = 31),口径复核方法与上一段相同 - ---- - -## 3. 三个前置能力(不先做,页面只能显示假数据) - -### 3.1 UI 数据快照层(最关键) - -**问题**:分层门禁规定 `Drivers/BSP/**` 不得 include `App/**` 头(`scripts/check_layer_deps.py`),现有 6 条基线只减不增。相量、定值、遥信全在 `App/`,所以页面**无法合法地直接取数**——这正是交流量/直流量只能写死占位值的根因。 - -**方案**:沿用门禁注释里已经写明的意图——"记录读取应由上层递进来"。即 **App 推、BSP 存、页面只读**: - -``` -App/app/ui_data_feed.c(App 层,可同时 include 两侧) - 每 N ms 组装一帧 → ui_data_publish_rt(&frame) / ui_data_publish_par(&frame) - │ - ▼ -Drivers/BSP/UI/ui_data.c(BSP 层,持有最新一帧) - │ ui_data_rt(&snap) / ui_data_par(&snap) —— 页面钩子只读 - ▼ -ui_page_ac / ui_page_yx / ui_page_setlist ... -``` - -> 契约、并发模型、写路径、记录 reader 注入与测试策略见 `docs/UI设计/UI_数据供给设计说明.md`,本节只保留规划粒度。 - -- 快照内容:9 路遥测值 + 品质、33 位遥信 + 有效位、40 项定值(Q10)+ 封存态、频率、时钟。 -- 发布节奏:遥测/遥信 **200 ms**(与遥测链同源);定值**仅变化时**发布(`prot_set_checksum()` 变化触发,避免每拍 160 B 拷贝)。 -- 方向正确:App → BSP 是"上层依赖下层",门禁允许;BSP 侧不认识 `App/` 任何符号。 -- **并发:单写者同上下文,不需要锁**——`ui_data_feed_tick()` 与页面钩子都跑在 uiTask;序号只用于页面侧缓存失效判断(`ui_data_rt_seq()`),不是同步原语。 -- 规模:**M**(`ui_data` + `ui_data_feed` 约 150 行 + 单测 + `ui_task.c` 接线)。 - -> ⚠ 没有这一层,后面 11 个"数据现成"的页面全部是假的。**它是本规划的第一优先项**,优先于任何单页。 - -### 3.2 数值编辑能力 - -**问题**:现有编辑只有 `ui_page_net_cfg.c` 的"逐字节改 IP"(↑↓ 调字节、←→ 移光标)。定值要改的是**浮点工程量**(10.0 A、120.0 V、500 ms),需要:位数移动、步进(含 0.01/0.1/1/10 分级)、范围校验、越界提示、保存失败提示。 - -**方案**:把编辑逻辑从 `ui_page_net_cfg.c` 抽成共享组件 `ui_w_editor`(或扩展 `ui_w_*` 家族),提供: - -| 能力 | 说明 | -|---|---| -| 进入/退出编辑 | ENTER 进入(需 `edit_capable` 且 `UI_PERM_MODIFY`)、ESC 取消并回滚 | -| 数值步进 | ↑↓ 按当前光标位加减;光标位决定步长(个位/十分位/百分位) | -| 范围校验 | 取 `prot_set_meta_t` 的 `min/max`,越界拒绝并提示 | -| 提交 | 行内 ENTER 暂存 → 末行"保存"统一提交(一次封存、一次校验和) | - -**关键设计**:定值保存必须**整表提交**而不是逐项写盘——`prot_set_set()` 批量写后必须 `prot_set_seal()`(见 `docs/算法/采集与算法层设计说明.md` §8)。逐项写会把校验和打成中间态,被自检判为损坏。 - -- 规模:**M**(组件 + 与 `prot_set` 的写回交接)。 - -### 3.3 记录类型表(记录页共用) - -已有 `ui_w_records` 组件把"读日志 → 行渲染"收成一份代码,`ui_page_selftest` / `ui_page_runlog` 只是薄跳板。**新增文本类记录页 = 一行实例 + 一个 `syslog_id_t`**。 - -但 `sys_log` 目前只有 2 个 ID(运行、自检),且 **`/log/soe.log` 是二进制 64 B 结构**,不是文本 64 B——不能直接复用 `ui_w_records`。两条路: - -| 记录 | 方案 | 成本 | -|---|---|---| -| 文本类(事故/操作/告警/启动/遥控) | 扩 `syslog_id_t` + 各记录写入方 | 页面 S,**写入方 M~L** | -| SOE(二进制) | 新 `ui_w_soe`:按 `soe_rec_parse()` 解码成"时间 + 类型 + 元件 + 值"两行 | **M** | - -数据怎么进页面已定:**注入 reader**(`ui_rec_reader_t`),页面不再 include `sys_log.h`——顺带退掉 3 条分层基线(6 → 3)。契约见 `docs/UI设计/UI_数据供给设计说明.md` §7。 - ---- - -## 4. 页面归并:27 页 → 7 模块 - -| 包 | 模块 | 覆盖叶子 | 复用 | +| 视图 | 行数 | 内容 | 整定态额外行为 | |---|---|---|---| -| **A 实时数据** | `ui_page_yx` | 5 | 动态列表 + 快照层 | -| **B 定值查看** | `ui_w_setlist` + `ui_page_set_ro` ×4 描述符 | 13/14/15/16 | 一份组件,4 张视图表 | -| **C 定值整定** | 同 B + `ui_w_editor` | 8/9/10/11 | 同上 + 编辑 | -| **D 三遥设置** | `ui_page_three_remote`(5 描述符) | 18/19/20/21/22 | 同 B 组件 | -| **E 装置维护** | `ui_page_clock`(表单)+ `ui_page_action`(操作页) | 24/25/26/27 | 操作页可复用(复归/录波/清除三处) | -| **F 通讯参数** | `ui_page_comm`(2 描述符) | 29/31 | 同 B 组件 | -| **G 记录查询** | `ui_page_soe` + `ui_w_records` 扩 ID | 33/34/35/36/37/38 | 记录组件 | -| (H 厂家设置) | 见 §7 | 0(菜单树需扩) | — | +| 参数 | 8 | PT/CT 一次二次额定 + 4 个返回系数 | 可编辑 + 保存行 + 未标定徽标 | +| 定值 | 18 | 三段过流、过负荷、过压/低压、零序过压、过频/低频的定值与延时 | 同上 | +| 控制字 | 4 | OC1~OC3、OL 的跳闸/告警选择 | 同上 | +| 软压板 | 10 | 全局软压板 + 9 个元件投退 | 同上 | -**定值 40 项的视图划分**(`prot_set` 现有 40 项,按语义分四组,不改校验和覆盖序): +- **数值编辑**由 `ui_w_editor` 承担:进入/退出、逐位步进(个位/十分位/百分位)、`min/max` 范围校验、行内暂存 + 末行统一提交。 +- **保存必须整表提交**:`prot_set_set()` 批量写后必须 `prot_set_seal()`,逐项写会把校验和打成中间态、被自检判为损坏。 +- 行表用 2~4 字缩写("Ⅰ段电流"而非"过流Ⅰ段定值"),受字体子集约束。 -| 视图 | 项数 | 内容 | +### 2.3 三遥设置 + +| 叶子 | 数据来源 | 状态 | |---|---|---| -| 参数 | 8 | PT/CT 一次二次额定、四个返回系数 | -| 定值 | 18 | 三段过流、过负荷、过压/欠压、零序过压、过频/低频的定值与延时 | -| 控制字 | 4 | OC1~OC3、OL 的"跳闸/告警"选择(`*_TRIP`) | -| 软压板 | 10 | 全局软压板 + 9 个元件投退(`*_EN`) | +| 遥测死区 | `[run_par]` 段(`ui_page_deadband.c`) | ✅ 已落地 | +| 遥测系数 | `[adc_cal]` 段 k / b(`ui_page_calib.c`) | ✅ 已落地 | +| 遥信类型 | 开入量 | ❌ **未绑**,见 §3 | +| 遥信防抖 | 运行参数 `0x8030` | ❌ **未绑**,见 §3 | +| 双点遥信 | 开入量 | ❌ **未绑**,见 §3 | -> 现状 `prot_set_meta_t` **没有名称字段、没有分类字段**。需要补:① 40 条中文名(受字体子集约束,见 §6);② 一个 `cat` 字段(ROM 表,不参与校验和,加字段安全)。 +### 2.4 装置维护 + +| 叶子 | 形态 | 数据来源 / 执行侧 | +|---|---|---| +| 时钟设置 | 表单 | `sys_clock_get_time/set` + `[sntp]` 段,SNTP 为唯一网络对时来源 | +| 强制复归 | 操作页(确认) | `prot_elm_request_reset()` | +| 手动录波 | 操作页(确认) | `wave_ring_request`,经 `ui_data_wave_ops_t` 注入 | +| 清除记录 | 七行清单 + 逐行两段式确认 | 条数走 `ui_w_records_count_of()`;删除只发请求(`syslog_request_clear`),真反馈 = 状态机 + 下一帧条数归零 | + +### 2.5 通讯参数 + +| 叶子 | 行数 | 数据来源 | +|---|---|---| +| 通讯设置 | 2(公共地址 / 监听端口)+ 保存行 | `[comm]` 段 RAM 副本,经 `ui_data.h` 通道六注入 | +| 网口设置 | 6 | `[network]` 段 RAM 副本(可编辑 + 保存交接) | +| SNTP 设置 | 4 + 保存行(启用 / 主服务器 / 备服务器 / 周期(分)) | `[sntp]` 段 RAM 副本 | + +### 2.6 记录查询 + +七类记录统一走 `ui_w_records` 组件(一行 `syslog_id_t` 即一个页面),SOE 走专用的 `ui_w_soe`(二进制 64 B 解码)。 + +| 叶子 | 记录类 | 数据文件 | +|---|---|---| +| SOE 记录 | 二进制 64 B 结构 | `/log/soe.log` | +| 自检记录 | `SYSLOG_SELFTEST` | `/log/selftest.log` | +| 运行记录 | `SYSLOG_RUN` | `/log/run.log` | +| 事故记录 | `SYSLOG_ACCIDENT` | `/log/accid.log` | +| 操作记录 | `SYSLOG_OPER` | `/log/oper.log` | +| 保护告警 | `SYSLOG_ALARM` | `/log/alarm.log` | +| 保护启动 | `SYSLOG_START` | `/log/start.log` | +| 遥控记录 | `SYSLOG_YK` | `/log/yk.log` | +| 运行报告 | boot_stats + 104 计数 + uptime(13 行 / 2 页) | `ui_data` info 帧 | +| 录波回放 | 单通道波形自绘(8 路切换、阶梯线、削徽标) | 故障录波模块 | --- -## 5. 分批实施 +## 3. 未绑的三叶:遥信类型 / 遥信防抖 / 双点遥信 -> 排序原则:**前置能力 > 数据现成 > 需补数据层 > 数据源不存在**。不按菜单顺序铺页。 +三叶在菜单树里保留(显示为空白终点框,不伪造数据),未绑的**唯一原因是没有数据源**,不是待排期: -### 批 1:打通数据 + 清掉"假页面"(9 个叶子 + 2 个回炉) +| 叶子 | 需要什么 | 现状 | +|---|---|---| +| 遥信类型(常开/常闭) | 可配置的开入量点表 | 开入未实现(`docs/架构设计/硬件规格与能力边界.md` H3 能力边界) | +| 遥信防抖 | 开入量的防抖时间参数 | 同上;运行参数 `0x8030` 只在开入存在时才有意义 | +| 双点遥信 | 成对开入量的双点编码 | 同上 | -1. **`ui_data` 快照层**(§3.1)——所有后续页面的地基。 -2. **交流量 / 直流量回炉**:接快照层,删掉占位值;直流量改成真实 3 路(直流通道 2 路 + 温度 1 路,或按 V0.1 实际可用量重定行)。 -3. **遥信量**(node 5):33 行,无效位显示 `--` 并置灰语义(单色屏用前缀 `*` 或后缀 `?` 表示无效)。 -4. **定值查看 4 页**(13/14/15/16):一份组件 + 4 张视图表 + 名称表。 -5. **时钟设置**(24):6 字段表单,写 `sys_clock_set` 后回读校验。 -6. **强制复归**(25):确认 → `prot_elm_request_reset()` → 回报(操作页首个实例)。 -7. **清除记录**(27):需先给 `sys_log` 补删除 API(按 ID 删文件 + 重建 + 计数归零)。 -8. **SOE 记录**(33):`ui_w_soe` 二进制解码列表。 - -**退出判据**:主站改一条定值 → 就地页面 200 ms 内显示新值;SOE 记录页能翻到最近 20 条。 - -### 第二轮:整定与通讯(6 个叶子) - -9. **`ui_w_editor`**(§3.2)→ **定值整定 4 页**(8/9/10/11)。 -10. **通讯设置**(29):需先建 `comm_cfg`(`[comm]` 段:104 公共地址/端口/主站地址),照 `net_cfg` 的"RAM 副本 + 保存请求交接"范式。 -11. **SNTP设置**(31)——已落地(2026-11-04):页面读写 `[sntp]` 段 RAM 副本(`ui_page_sntp.c`,PR 链 #73/#77);原「当前对时走 8888 端口私有协议」口径作废——8888 已退役(#78),SNTP 即对时唯一网络来源。 - -**退出判据**:就地改一条定值 → 保存 → 掉电重启 → 值保持且校验和自检通过;主站 C_RD 读到同一值。 - -### 批 3:等数据层(12 个叶子) - -12. **三遥设置 5 页**(18~22)——等运行参数段与开入量。 -13. **事故/操作/告警/启动/遥控 5 页**(34~38)——等记录写入方(每类记录 = 一个写入点 + 一个 `syslog_id_t`)。 -14. **手动录波**(26):操作页(`ui_page_action` 确认链,受理后回「已请求录波」)——已落地(2026-10-29);同批新增「录波回放」单页(上下键切通道、左右键切段、阶梯线 3px/点、0 线虚线、峰值 mV 经 `wave_store_code_to_milli` 唯一口径、削徽标、空态/坏段显式文案,规格见 docs/子系统设计/故障录波设计说明.md §8.1)。 -15. **运行报告**(41)——等计数器(上电次数/运行时长/复位原因/104 统计)。 - -### 批 4(可选):厂家设置 - -见 §7。 +**重开条件**:RS-485 采集接线与开入通道落地后,这三叶按 `ui_w_setlist` 的既有形态(可编辑列表)即可开工, +无需新框架——它们是描述符级别的增量,不是架构级工作。 --- -## 6. 每页成本与门禁 +## 4. 每页成本与门禁 -**标准动作**(已由生成器收敛,实测 3 处人工 + 1 条命令): +**标准动作**(已由生成器收敛): | # | 动作 | 落点 | |---|---|---| @@ -236,45 +124,34 @@ ui_page_ac / ui_page_yx / ui_page_setlist ... **三条硬约束**: -1. **汉字子集**:任何新文案的汉字必须先过 `tools/font_gen/extract_cn.py` → `make_font.py`,否则显示空白方块(`font-charset` 门禁会拦)。40 条定值名 + 33 条遥信名会显著扩字库——**建议定值名沿用 2~4 字缩写**(如"过流Ⅰ段定值"→"Ⅰ段定值"),控制新增字数。 +1. **汉字子集**:任何新文案的汉字必须先过 `tools/font_gen/extract_cn.py` → `make_font.py`,否则显示空白方块(`font-charset` 门禁会拦)。当前子集 **218 字 / 324 字形**。 2. **像素黄金**:新页入 `ui-golden`,此后任何几何/字体改动都会触发全量比对;参考图一旦入库就只能"改代码对齐",禁止刷参考掩盖。 -3. **RAM**:描述符 + 行表是 Flash const,**不占 LVGL 池**;开页峰值 +776 B(池 16 KB,实测峰值占 40%)→ 页数增加不影响池水位,但 `ui-golden` 的池基线常量要按新页复核。 +3. **RAM**:描述符 + 行表是 Flash const,不占 LVGL 池;开页峰值 +776 B(池 16 KB)。页数增加不影响池水位,但 `ui-golden` 的池基线常量要按新页复核。 --- -## 7. 厂家设置:菜单树缺的一整支 +## 5. 厂家设置支:现状是"不做" -参考项目的菜单有 **厂家设置**(`CN_COP_PWD` 厂家密码)一支,本项目菜单树**完全没有**: +参考项目的"厂家设置"菜单一支,本项目**菜单树里没有**。逐项结论: -| 参考项 | 本项目 | 价值判断 | +| 参考项 | 本项目 | 结论 | |---|---|---| -| 版本信息(板件版本) | 无 | **建议合并进"装置信息"**——单板设备,装置信息已有型号/软硬件版本/校验和/日期,再开一页是重复 | -| 恢复默认(全部/参数/定值/软压板) | 无 | **建议做**:生产返修与现场救急必备;依赖定值/参数模型(第二轮 之后) | -| 元件配置 | 无 | 不做:本项目元件表是编译期数据驱动,运行期改元件等于改点表,超出 V0.1 范围 | -| 交流显示(一次/二次值切换) | 无 | 建议做(1 项配置):依赖标定,随批 3 | -| 装置调试:虚拟遥信/交流虚遥测/动作虚事件/动作出口 | 无 | **建议做"虚拟注入"**:无标准源也能验证 UI/104/记录全链,正好补 第三方送检验收 的前置条件(详见下) | +| 版本信息(板件版本) | 已并入"装置信息"页 | 不另开页——单板设备,装置信息已有型号/软硬件版本/校验和/日期 | +| 恢复默认(全部/参数/定值/软压板) | 无 | 未做 | +| 元件配置 | 无 | 不做:元件表是编译期数据驱动,运行期改元件等于改点表,超出 V0.1 范围 | +| 交流显示(一次/二次值切换) | 交流量页内固定为二次值 | 未做 | +| 装置调试(虚拟注入) | 无 | 未做;若做必须旁路真实采样,**绝不能进保护链** | -> **虚拟注入的价值**:当前送检等标准源(第三方送检验收),而虚拟注入能让"改一个假值 → 看 UI 是否变 → 看 104 是否上送 → 看 SOE 是否记录"这条链在没有硬件激励的情况下闭环。它是**测试基础设施**,不是产品功能,建议放在厂家菜单并加明显标识(标题后缀"调试")。 -> -> **代价**:菜单树从当时 42 节点扩到约 48~50 节点(节点数现值 43,2026-10-29 录波道加「录波回放」叶),`ui_menu_tree.txt` 改动会触发菜单 8 状态像素回归与 `task-table` 式索引文档同步。**这是需要拍板的项**——见 §8。 +**虚拟注入的价值**(如将来要做):没有标准源也能把"改一个假值 → UI 是否变 → 104 是否上送 → SOE 是否记录" +这条链闭环,属测试基础设施而非产品功能,天然落在 `ui_data_feed` 上。 --- -## 8. 需要拍板的 5 个问题 +## 6. 与其他文档的关系 -| # | 问题 | 影响 | -|---|---|---| -| 1 | 菜单是否扩到 48~50 节点(加厂家设置支)? | 节点数以 `产品需求设计文档.md` §8.2 为准(2026-10-29 现值 43,此前 42);扩了要改该节与菜单像素回归 | -| 2 | **直流量页怎么办?**(V0.1 没有直流采样通道)三选一:改成"温度 + 备用"页 / 从菜单删掉 / 保留空页显示 `--` | 决定行表与菜单节点数 | -| 3 | 定值名用全称还是缩写?(字体子集大小 vs 可读性) | 40 条名 × 平均字数,直接影响字库与 `font-charset` | -| 4 | 事故/操作/告警/启动/遥控 5 类记录,是否本轮就要? | 每类 = 一个写入方 + 一个 `syslog_id_t` + 一个页面,是本规划里最大的一块后端工作 | -| 5 | 虚拟注入是否要做?做在哪一层(旁路真实采样 vs 覆盖快照)? | 决定它是否会影响保护判据路径(**必须旁路,绝不能进保护链**) | -| 6 | 交流量行表裁到几行?(24 行参考全套 vs 本机 9 路实有) | 决定页数与黄金参考数量 | - ---- - -## 9. 与既有规划的关系 - -- 本文替代"剩余页面尚未规划"的状态(原 `docs/任务规划/README.md` §2.0 中「UI 扩展」的剩余 21 叶页面落地项按"暂缓、未规划"记载)。 -- 页面工作**不应独立于数据层推进**:批 1 的第 1 项(快照层)与采集/遥测链共享同一批数据,建议与"测量子系统"同波次排期。 -- 与 `docs/问题记录/采集与数据处理短板评测.md` 的对应:该文的标定(`docs/问题记录/采集与数据处理短板评测.md` §4.1)与遥测链(同文 §4.2)落地后,交流量/直流量/遥测系数三页才有真实数据可显示。 +- **框架与新增页面六步** → `docs/UI设计/内容页架构.md` +- **注入通道契约、并发模型、记录 reader 注入** → `docs/UI设计/UI_数据供给设计.md` +- **逐页行表与代码改动明细** → `docs/UI设计/页面扩充详细方案.md` +- **菜单树与几何** → `docs/UI设计/菜单页面设计.md` +- **能力边界(开入为何没有)** → `docs/架构设计/硬件规格与能力边界.md` H3 +- **推进顺序** → `docs/任务规划/README.md`