wandering1
48a8ef0564
这两页是「UI补齐」里唯一带**持久化语义**的一档，所以整笔的设计重心不在画面上，而在**页面如何诚实表达 「已受理」与「已落盘」**——这一点由 setpage-scout 在开工前的只读查实钉下来：cfg_file_save() 全仓唯一调用 者是 run_par_store_save()，而 default_task.c:246 **每轮无条件**调它、函数首行 s_dirty==0 就直接返回 ⇒ 落盘动力本来就在 defaultTask，不在 104 会话、也不在事件位。因此本笔走 A2（UI 不当授权写者），不需要 新事件位、不需要新同步口。 页面三态判据 = run_par_dirty_peek()：ENTER / WAIT（脏位仍在 = 已受理未落盘）/ OK（脏位归零 = 整档已外科 保存成功）/ 写被拒 = ERR。两条限制写在页面注释里没藏：脏位是**整档全局**的（一趟落 [run_par] 9 键 + [adc_cal] 两段，归零只证明「这一档落盘了」，不证明「我这一项单独落盘」）；他人随后再改会重新置脏 ⇒ 沿用 clear/clock 页的结果锁存，把「我这次动作的结果」与「档位此刻的状态」分开。 **为什么黄金必须出两张**（这条是本轮最有价值的防假证据规则）：模拟器假件**保留脏位**、全仓唯一的 s_yt_dirty=0 写点是 sim_yt_pump()（setter 只置不清），于是 WAIT 与 OK 各出一帧——两组同键序、唯一差别是 EXTRA 里的 --yt-nopump。若假件同步清脏位，真机的 WAIT 态永远不会被像素回归覆盖，黄金就成了「只钉住最 好看那一帧」。TC-UIDATA-028o 另钉住 ui_data 层零缓存。 形状：新增 ui_data 第四张注入表（八字段整表校验、拒残表），实现落在装配层 App/app/ui_data_feed.c， 页面零 App include（分层方向 + 模拟器不链 run_par 两条老理由都成立）；共用视图模型 ui_w_ytview 承载两页。 合法域一律由执行侧出口给（run_par_db_range / RUN_PAR_K_MAX_UV），页面不抄第二真源——系数页 v1 只用粗守 并在注释写明两层守卫互不掩盖，µV/码 ×[0.5,2.0] 那条真带的出口器归 task-43，**没有**在页面里抄常量。 取舍与遗留（如实）：系数行 d=0 整 µV（1e9 装不下两位小数，注释写了「要小数改哪、不收紧假上限」）；b 覆盖 无口未做；徽标只画系数页；行名因「率」缺字改为 Hz死区（font-charset 机器先抓到的，不是我目测判的）。 实测：@build 0 错误 0 警告（Code=233,900 / RW-data=1,536）；ui_data 单测 277/277、run_par 67/67 零回归； 内容页黄金 47 页全过、**存量 40 张逐字节零漂移**（git 里只有 7 张新增）；menu_rows / 池水位 / font-charset / bom / mojibake / nested-comment / cppcheck / coding-standard / layer-deps / bsp-err 全 0 新增；编号五项式 refs 8,778 / dec 7,622 / und **1,156**（上限 1,166）/ 比值 86.83%（基线 86.0% 之上）/ 错误差值 0，注释零裸形 字母+数字。generated-fresh 与 registration-check 本地 PASS；新增 6 只源文件按规矩**双端注册同笔**（叶子 + registry 19→21 + uvprojx + CMakeLists），uvprojx 这次属「真的增删源文件」才入库。 移交三条不混进本笔：① 全量 --selftest 现 exit 1 是 task-41 硬闸在模拟器上也拒 reset/clear（既有红，快检档 不受影响），归台架道定夺；② 内容页 40→47 的全仓文档计数改写由 Lead 派；③ run_par_deadband_set 的限定 条件语措辞（「iec104Task 上下文」已被装配层裁定覆盖）归算法层下一笔。
118 lines
4.7 KiB
C
118 lines
4.7 KiB
C
/*
|
|
* 模块名称：UI Page deadband (遥测死区内容页)
|
|
* 模块功能：三遥设置 → 遥测死区 叶子（#P 受密码保护）的内容页——9 行数值表，
|
|
* 每页 8 行自动分页；本文件零 App include：行表现状（值/粗守域/量纲/
|
|
* 小数位）逐行来自 ui_data.h 通道五注入表，写与落盘确认全经
|
|
* ui_w_ytview 视图模型（状态机/反显/徽标在那一侧，两页共用一份）——
|
|
* 本文件只是标准骨架几何令牌接进框架的薄跳板，改一次口径两页一致
|
|
* 两态一页：123 修改权限 → 可编辑（编辑器 + 保存行 = 落盘确认）；000 查看权限
|
|
* → 只读（attach 内不绑 commit → 无保存行、key_cb 整页交回框架，
|
|
* 行为与"没有 key_cb"逐字等价，整定四页同一条分派纪律）
|
|
* 徽标说明：本页**不画**"未标定"——死区数值来自 [run_par] 档、与两点标定无关，
|
|
* 挂不相干的告警等于稀释真告警（ui_w_ytview.h 同注）
|
|
* 适用平台：STM32F407ZGTx / PC 模拟器（共用源码）
|
|
* 作者：DTU 项目组
|
|
* 创建日期：2026-10-27
|
|
* 修改记录：
|
|
* v1.0 2026-10-27 DTU 项目组 创建（道F task-7；判据 docs/任务规划/UI补齐.md
|
|
* §2 第 4 行「改死区能改变 104 上送门限 / 改 k 后
|
|
* 页面值按比例变化 / 只走既有落盘链不加第二真源」）
|
|
*/
|
|
/* 头文件包含区 */
|
|
#include "ui_page_deadband.h"
|
|
|
|
#include "ui_tokens.h"
|
|
#include "ui_w_setlist.h"
|
|
#include "ui_w_ytview.h"
|
|
|
|
/* 静态变量定义区 */
|
|
|
|
/* 本页定值表实例（组件状态独占一份，勿跨页共用——ui_w_setlist 实例化约定） */
|
|
static ui_w_setlist_t s_sl;
|
|
|
|
/* 函数定义区 */
|
|
|
|
/*
|
|
* 函数功能：开页绑视图（行表现状逐行现取 + 两态分派都在视图模型内；接 init_cb）
|
|
* 入口参数：无
|
|
* 返回值：无
|
|
* 限定条件：框架开页链内（本次进入权限已装载，时序依据见 ui_page_view_param.c
|
|
* 同位置注释：框架先装权限再调 init_cb）
|
|
*/
|
|
static void pg_init(void) {
|
|
ui_w_ytview_attach_db(&s_sl);
|
|
}
|
|
|
|
/*
|
|
* 函数功能：总行数（数据行现给 + 可编辑态才有保存行；接 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_setlist_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);
|
|
|
|
}
|
|
|
|
/*
|
|
* 函数功能：按键转发（接 key_cb）
|
|
* 入口参数：a_key - LVGL 键值 lv_key_t
|
|
* 返回值：true - 本页已消费；false - 交回框架（↑↓ 移选、← 关页）
|
|
* 限定条件：描述符 edit_capable=1 + key_intercept=1（编辑中 ←→ 是移数字光标，
|
|
* 必须先给页面，否则框架把 ← 当关页——整定四页同款实证）
|
|
* 函数说明：第一条门 = 只读进入（未绑 commit）整页交回框架，与"本页没有
|
|
* key_cb"逐字等价（黄金参考只读态为证）；其余分发规则全在组件
|
|
*/
|
|
static bool pg_key(lv_key_t a_key) {
|
|
if (s_sl.commit == NULL) {
|
|
return false;
|
|
}
|
|
return (ui_w_setlist_key(&s_sl, a_key) != 0u);
|
|
}
|
|
|
|
/*
|
|
* 页面描述符（外部链接：生成物 ui_page_registry.c 按菜单树 #page=deadband 绑定引用）
|
|
* 列表页骨架 + 可编辑 + ← 拦截；band_h 必须 >0（选中行黑字白底反显，同四整定页）；
|
|
* row_count 给静态上限（9 数据行 + 保存行），行数运行时以注入表现报为准
|
|
*/
|
|
const content_page_def_t ui_page_deadband_desc = {
|
|
.id = "deadband",
|
|
.title = "遥测死区",
|
|
.selectable = 1u,
|
|
.edit_capable = 1u,
|
|
.key_intercept = 1u,
|
|
.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,
|
|
.row_count = 10u,
|
|
.init_cb = pg_init,
|
|
.count_cb = pg_count,
|
|
.refresh = pg_refresh,
|
|
.draw_cb = pg_draw,
|
|
.key_cb = pg_key,
|
|
};
|