wandering1
45393be3d5
四个空叶子（参数定值 → 查看 → 参数/定值/控制字/软压板）接上 par 通道。页面薄、模型厚：
新建 Drivers/BSP/UI/ui_w_setview.{c,h} 收四张视图表 + Q10 换算 + 越界反显，四个页面各是
一份实例 + 四个跳板钩子；渲染与分页复用批 1 的 ui_w_setlist（查看态 commit=NULL：无保存行、
无编辑通路，§3.2.6 查看列口径）。
行表三项口径全部有真源，一项都不在这份文件里拟定
- id = App/algo/prot_set.h 的枚举序。BSP 不 include App 头（分层门禁），所以行表里是裸数字
+ 行尾注枚举名——这份对不上就没人能在 BSP 侧编译期发现，于是从外面钉：见下面的新脚本
- min/max = App/algo/prot_set.c 的 g_prot_set_meta Q10 上下限按该行小数位换算的结果。整定页
下一批复用同一批表，界内界外一处一份，不会出现「查看看着合法、整定说越界」两套边界
- 显示名/小数位/单位 = docs/UI设计/页面扩充详细方案.md §3.2.2~§3.2.5 四张表
一处偏离文档（不是静默偏离，写进三处：代码注释 / 文档落地注 / 本正文）
- 四个返回系数按 2 位小数显示，文档写 3 位。理由是量值真实性不是排版：Q10 存不下 0.95
（0.95×1024 截成 972 → 真存 0.94921875），按 3 位显示就多打一位根本不存在的数字；整定单
上写 0.95 的人看到屏上 0.949 会怀疑装置、甚至反复重输（重输还是 0.949）。2 位才是这份存储
在自身可分辨精度上的正确读数——文档的 3 位来自「把 Q10 当成十进制存储」这个误会
- 单位挂在值串尾（10.00A / 500ms）而不是塞进显示名：值列只有数字会让 60000 既是 ms 又是 A。
为此给 ui_w_setlist_row_t 加了 unit 字段（该结构此前无任何消费者，扩展零成本）；只挂在
非编辑态——编辑中是逐位输入串，挂单位会让位光标算错列宽。A/V/ms/Hz 全 ASCII 不占字库
新增可重跑核验：tools/setview_check/check_setview_limits.py
- 从外面把三件事钉住：四张表的 id 恰好覆盖 0..39 各一次；数值行 min/max 等于 meta 上下限的
换算；kind 与 meta.is_ctl 一致、dec 查表与行表小数位一致、单位只允许 ASCII。改 meta 不改
行表就红。当前输出：行表 40 行 / dec 40 项 / meta 40 项 -> OK
- 写这个脚本时自己踩的两个坑也留在脚本注释里：① 正则用 \w+ 吃不下带引号的单位，会让整行
**静默跳过**（少检一行比检查错更难发现）→ 改 \S+ 并加「行数必须等于 40」硬闸；② 脚本要
打印中文，Windows 控制台按 CP936 写 stdout 会崩在半路（崩在半路 = 一条都没检查）→ 开头
把 stdout/stderr 锁到 UTF-8
两个只有画面才会暴露的错（都不是静态检查抓到的，都记进了注释）
- ui_data_par() 的通道是 0=成功 / -1=尚无首帧，我按 bool 反义用了：真机与模拟器上都会「永远
读不到」，整页值列恒 --，而页面看起来完全正常、编译与钩子全绿。看像素图才发现满屏横杠
- 肉眼把 CT 一次额定读成 1000A，字形匹配器证明值列只有 4 个字符位（命中 x=101/107/113/119）：
实际是 100A。断言因此按匹配器能证明的写。顺带一个自洽佐证：PT 10000/100 V 配 CT 100/5 A
正是 10 kV 馈线终端的变比；控制字页默认值天然两两一组（Ⅰ/Ⅱ 段跳闸、Ⅲ 与过负荷段告警），
行表若整体错位就不可能复现这个组合——这条已进像素断言，成为 id 对齐的机械证据
无数据时的显示口径
- 参数帧未就位：名字照打、值列打 --（不把 0 当定值显示，也不给整页空白让人以为菜单坏了）
- 越界反显只在 bad_valid=1 时参与：把「没数据」画成「这行有毛病」是假告警，比不画更糟
- Q10 换算不用浮点也不用 64 位除：整数段 + 小数段拆分四舍五入，满位进位（MicroLIB 软浮点与
__aeabi_ldiv 一进镜像几百字节，模拟器（宿主 CRT）永远照不出这笔代价）
批 1 那个 KEEP_EXTRA 决策在这里第一次兑现
- 本批行表用到的「延时 / 电流 / 压力 / 总 / 配 / 重 / 间 / 未」等字，正是当时成组并入 KEEP_EXTRA
的 35 个「未知冗余」字里的一批；若当时按 extract 输出重写字符集，这些字形已被洗掉，本批
上屏就是白框，而 font-charset 只会报「字在清单里没有」——它报不出「字曾被删掉过」
- 本批 font-charset 直接 Passed，未扩字库、未重生成字体
验证
- @build 0 错误 0 警告；模拟器 0 警告；内容页 19 项 PASS（16 页像素 + 四页共 39 条文本断言），
其余 12 页逐字节不变；菜单 8 状态 PASS；ui-data 83/83、soe 32/32
- 四页出图逐张肉眼确认：值列右缘不越屏（10000V 最宽）、名值不重叠、第 1 页行槽与页脚不撞；
分页页码正确（定值 18 行 = 3 页、软压板 10 行 = 2 页）
- check_setview_limits.py OK；ui_menu_tab.h 等生成物全部由 gen_menu.py 重生成（手改生成物 = 一定
会被覆盖，见批 2 那条），uvprojx/CMakeLists 注册由生成器写入，另手工登记 ui_w_setview.c 两处
- 全量钩子 --all-files：见下一行 gate；红项只有同族三条（台账与同码凭证回填归单写者）
体积（相对 b746a1f 台账 217204 / 21504 / 1256 / 132680）
- 实测 Code 221856 / RO 23508 / RW 1300 / ZI 134660
→ Code +4652、RO +2004、RW +44、ZI +1980
- Flash 合计 +6700 B、RAM +2024 B（三批累计）。本批 RO +2120 主要是 40 行行表与名称/单位串，
ZI +388 是 par 帧缓存（184 B）+ 四个组件实例 + 注册表增量；这是把 40 项真定值上屏的代价，
不是可省开销
待台架实测：装载真定值后的四页读数（含真机 bad_mask 非 0 时的反显行）、翻页节拍、
PT/CT 变比与 104 上位的定值读回（C_RD）一致性。
gate: only mem-budget/mem-numbers/size-gate pending lead ledger backfill
（同族三条，root cause 一条：台账与同码凭证回填归单写者）
像素基线单独提交（下一笔新增 4 个 shot_v*.bin）：本笔单独 checkout 时 ui-golden 会报缺参考，
属预期拆分；上面的钩子结论取自「本笔 + 下一笔」的合并树。
自查：12 个新增/改动 UI 源文件 BOM 与 HEAD 对齐（本批 edit 又剥掉 4 次，逐次补回）；CR = 0；
U+FFFD = 0；C 字面量纯 ASCII（中文只在带 BOM 文件里）。
95 lines
3.5 KiB
C
95 lines
3.5 KiB
C
/*
|
||
* 模块名称：UI Page view_set (定值查看内容页)
|
||
* 模块功能：参数定值 → 查看 → 定值 的内容页——18 行数值表（三段过流/过负荷/过压/低压/零序/过频/低频 定值与延时），每页 8 行、3 页；
|
||
* 数据 = 参数快照（Q10）按行表小数位换算，越界项由 bad 回调反显；
|
||
* 本文件零 App include、零写路径（查看页没有"保存"这件事）
|
||
* 为什么这么薄：行表与取数在 ui_w_setview（四个查看页共用一份视图模型），
|
||
* 渲染与反显在 ui_w_setlist（与整定页同一组件）——本文件只把视图编号
|
||
* 和标准骨架几何令牌接进框架的跳板，改一次口径四处一致
|
||
* 适用平台：STM32F407ZGTx / PC 模拟器（共用源码）
|
||
* 作者：王建锋
|
||
* 创建日期：2026-10-25
|
||
* 修改记录：
|
||
* v1.0 2026-10-25 王建锋 创建（道E task-15 批 3）
|
||
*/
|
||
/* 头文件包含区 */
|
||
#include "ui_page_view_set.h"
|
||
|
||
#include "ui_tokens.h"
|
||
#include "ui_w_setlist.h"
|
||
#include "ui_w_setview.h"
|
||
|
||
/* 静态变量定义区 */
|
||
|
||
/* 本页实例（组件状态：编辑态等；查看页只用行游标与反显，实例仍须独占一份，
|
||
* 与别的页面共用会互相踩状态——同 ui_w_records 的实例化约定） */
|
||
static ui_w_setlist_t s_sl;
|
||
|
||
/* 函数定义区 */
|
||
|
||
/*
|
||
* 函数功能：开页绑定视图（行表 + 取数/反显回调一次配齐；接框架 init_cb）
|
||
* 入口参数：无
|
||
* 返回值：无
|
||
* 限定条件：框架开页链内调用（uiTask）
|
||
* 函数说明：每次开页都重新 attach——组件实例内残留的编辑态/游标会跨页带过来，
|
||
* 开页复位比"信任上一次已经清干净"可靠
|
||
*/
|
||
static void pg_init(void) {
|
||
ui_w_setview_attach(&s_sl, UI_W_SETVIEW_SET);
|
||
}
|
||
|
||
/*
|
||
* 函数功能：数据行数（框架 count_cb；查看视图没有保存行）
|
||
* 入口参数：无
|
||
* 返回值：行数 uint16_t
|
||
* 限定条件：框架绘制/翻页链内
|
||
*/
|
||
static uint16_t pg_count(void) {
|
||
return ui_w_setlist_count(&s_sl);
|
||
}
|
||
|
||
/*
|
||
* 函数功能：逐行取数（框架 refresh；内部先按发布序号同步参数帧）
|
||
* 入口参数：a_row / a_name / a_value - 契约见 ui_content_page.h
|
||
* 返回值：无
|
||
* 限定条件：框架绘制链内
|
||
*/
|
||
static void pg_refresh(uint16_t a_row, char *a_name, char *a_value) {
|
||
ui_w_setview_refresh(&s_sl, a_row, a_name, a_value);
|
||
}
|
||
|
||
/*
|
||
* 函数功能：自绘层（越界行反显；框架内置区块画完后调用）
|
||
* 入口参数：a_layer / a_clip - 契约见 ui_content_page.h
|
||
* 返回值：无
|
||
* 限定条件：框架绘制链内
|
||
*/
|
||
static void pg_draw(lv_layer_t *a_layer, const lv_area_t *a_clip) {
|
||
ui_w_setlist_draw(&s_sl, a_layer, a_clip);
|
||
}
|
||
|
||
/*
|
||
* 页面描述符（外部链接：生成物 ui_page_registry.c 按菜单树 #page=view_set 绑定引用）
|
||
* edit_capable=0 + 无 key_cb + key_intercept=0：查看页不接受任何写交互，
|
||
* ↑↓ 移选与 ← 关页全走框架内置（§3.2.7 表里"权限不足 ENTER 一律忽略"在
|
||
* 查看页等价于"根本没有 ENTER 这条路"）
|
||
*/
|
||
const content_page_def_t ui_page_view_set_desc = {
|
||
.id = "view_set",
|
||
.title = "定值",
|
||
.selectable = 1u,
|
||
.edit_capable = 0u,
|
||
.top_y = UI_LIST_TOP,
|
||
.pitch = UI_ROW_PITCH,
|
||
.band_h = UI_ROW_BAND_H,
|
||
.text_dy = 0,
|
||
.left_x = UI_LIST_LEFT_X,
|
||
.right_x = UI_LIST_RIGHT_X,
|
||
.rows_per_page = UI_LIST_ROWS,
|
||
.init_cb = pg_init,
|
||
.count_cb = pg_count,
|
||
.refresh = pg_refresh,
|
||
.draw_cb = pg_draw,
|
||
};
|