wandering1
ae09c5737a
任务规划目录从 5 个文件收敛到 3 个：只留导航（README）、待办（登记簿）、 暂缓专项（暂缓-RS485）。 删除的两个文件都不再有现行读者： - UI补齐.md 执行清单 2026-10-28 清空、上板判据 2026-11-06 台架轮已复核； 叶数口径迁 docs/UI设计/菜单页面设计.md §3.9，三条内容页硬规矩迁 docs/UI设计/内容页架构.md §7.1，两条未闭环待办迁登记簿 §7/§8。 - 数据可信.md 不是完成记录，而是被约 130 处代码头注释引用的设计约束， 因此按内容分三处落位后删除，不整篇丢弃。 数据可信内容的新归属（旧节号 → 新家）： - §2/§4 设计口径 → docs/算法/采集与算法层设计说明.md 新增 §13（13 小节）， §7 前置决策表 → §13.12 已定案的前置决策。 - §3 台阶与波次退出判据 → docs/硬件平台/ADC通道映射说明.md 新增 §9。 - §5 任务卡 → docs/任务规划/登记簿.md §7（拆成变比确认 / 两点标定两行）。 引用改写 34 文件 77 处路径引用 + 14 文件 24 处昵称引用 + 双重节号 35 处， 覆盖代码头注释、测试、生成器与文档；归档区历史路径改纯文本提及。 四个 SVG 生成器文案同步并重跑，产物随脚本同批提交。 同批处理两件事： - 9 个 UTF-16 LE 证据文件转 UTF-8。end-of-file-fixer 按字节判末尾换行， UTF-16 的换行是 0A 00、末字节 00，钩子会追加裸 0x0a 使文件变奇数长度， 8 个已实际损坏。转码后逐文件比对 HEAD 原文验证正文零丢失。 - 修回 App/cfg/cfg_file.c 被剥掉的 UTF-8 BOM（补 3 字节，未整文件重写）。 验证：/keil-build 0 错误 0 警告（Code=255160）；check_doc_links --all --sections-strict 221 篇全通过、无法判定 0；pre-commit 全量全 Passed。
154 lines
7.1 KiB
C
154 lines
7.1 KiB
C
/*
|
||
* 模块名称：UI Page reset (强制复归内容页)
|
||
* 模块功能：装置维护 → 强制复归 叶子（node 25，#P 受密码保护）的内容页——
|
||
* 复用 ui_page_action 共享确认链（一次确认 → 二次确认 → 执行回报），
|
||
* 并在同一屏画一行"保护动作 N"（N = 当前处于动作态的保护元件个数）：
|
||
* 复归前 N > 0、复归请求被 protectTask 消费后 N 归 0，这个变化就是
|
||
* "动作位真的复归了"的屏上证据，不用翻页、不用外接表；
|
||
* 执行只做两件事：投复归请求 + 补一条本地操作记录留痕；
|
||
* 只读进入（查看密码）整页拒执行并显式说"没权限"（LOCK）——
|
||
* 破坏性动作不给"看着像能按"的第二次机会；
|
||
* 本文件零 App include、零存储触点（分层方向由注入表守住）
|
||
* 为什么这么薄：确认链的形态（含二次确认与回报）是共享件，四个维护/操作类叶子
|
||
* 共用一份实现；本文件只把"这一页问什么、执行什么、观测什么"三项
|
||
* 配置接进框架的描述符骨架（同 ui_page_runlog 之于 ui_w_records）
|
||
* 适用平台：STM32F407ZGTx / PC 模拟器（两端共用）
|
||
* 作者：DTU 项目组
|
||
* 创建日期：2026-10-26
|
||
* 修改记录：
|
||
* v1.0 2026-10-26 DTU 项目组 创建（道F task-3；判据 docs/UI设计/内容页架构.md
|
||
* §7.1 第 2 条「强制复归确认后动作位复归且有 SOE」）
|
||
*/
|
||
|
||
/* 头文件包含区 */
|
||
#include "ui_page_reset.h"
|
||
|
||
#include "ui_content_page.h"
|
||
#include "ui_data.h"
|
||
#include "ui_page_action.h"
|
||
|
||
/* 私有宏定义区 */
|
||
|
||
/*
|
||
* 本地这条操作记录的描述串：ASCII 20 字节 < SYSLOG_DESC_MAX(28)。
|
||
* 与远端那条（App/protocol/iec104/iec104_pts.c 的 "force reset"）**刻意不同串**——
|
||
* 操作记录是审计面，两条一样就再也分不出"是主站下发的还是现场有人按面板"，
|
||
* 而那正是查遥控事故时第一个要问的问题。
|
||
* 为什么由页面投而不是由 prot_elm_request_reset() 投：那条函数在 algo 层，
|
||
* 在那里投会把 sys_log.h 拽进算法层（并把记录通道的依赖摊到 test/host/prot_dim
|
||
* 的 include 路径上）；而"这是本地发起的"这个事实只有页面知道（口径真源
|
||
* App/log/README.md 五类记录表 + task-10 结论）。
|
||
*/
|
||
#define RS_OPER_NOTE "force reset by panel"
|
||
|
||
/* 私有函数声明区（静态初始化器要引用下面两个函数的地址，故先声明） */
|
||
|
||
static bool rs_ok(void);
|
||
static uint32_t rs_watch(void);
|
||
|
||
/* 静态变量定义区 */
|
||
|
||
/*
|
||
* 本页操作页实例（配置全为 Flash 字面量与函数地址；运行态两字节由组件写）。
|
||
* 字段顺序 = ui_page_action_t 声明序（ARMCC v5 = C99 要求指定顺序一致）。
|
||
*/
|
||
static ui_page_action_t s_act = {
|
||
"确认复归保护?", /* prompt：问句用字已在字库（确/认/复/归/保/护 + '?'） */
|
||
"已请求复归", /* done_text：回报"请求已受理"，不谎称"已复归完成" */
|
||
rs_ok, /* ok_cb */
|
||
1u, /* need_modify：只读进入一律拒执行 */
|
||
"保护动作", /* watch_label（用字全在既有子集内；曾拟"动作元件"，
|
||
其中"元"不在子集 —— 见本行下方注释与终报） */
|
||
rs_watch, /* watch_cb */
|
||
0u, /* stage（运行态初值） */
|
||
0u /* err （运行态初值） */
|
||
};
|
||
|
||
/* 函数定义区 */
|
||
|
||
/*
|
||
* 函数功能：执行投递——请求复归，受理成功后补投本地操作记录
|
||
* 入口参数：无
|
||
* 返回值：true = 已受理（组件转成功回报）；false = 拒收（组件显示 ERR） bool
|
||
* 限定条件：由 ui_page_action_key 在第二次 ENTER 时调用（uiTask 上下文）
|
||
* 函数说明：两条腿的次序即判据——**先请求后留痕**：请求被拒时一条记录都不投，
|
||
* 给一次没发生过的操作写审计记录，比少一条记录坏得多（同
|
||
* App/task/iec104_serv.c 对时留痕"只在真改成功之后才投"那条纪律）。
|
||
* 维护通道未注入（装配缺一半）也走拒收这条腿：屏上显 ERR，
|
||
* 比"按了像成功其实什么都没发生"诚实
|
||
*/
|
||
static bool rs_ok(void) {
|
||
if (ui_data_maint_reset_req() != 0) {
|
||
return false;
|
||
}
|
||
(void)ui_data_maint_oper_note(RS_OPER_NOTE);
|
||
return true;
|
||
}
|
||
|
||
/*
|
||
* 函数功能：取当前处于动作态的保护元件数（观测行 "保护动作 N" 的 N）
|
||
* 入口参数：无
|
||
* 返回值：元件数（未注入时 0） uint32_t
|
||
* 限定条件：绘制路径可直调（一次转发，零 I/O、零锁）
|
||
* 函数说明：⚠ 台架判据的前提要写清：产品构建现处"未标定闭锁"
|
||
* （App/task/protect_task.c 停走判据），闭锁态下元件本就是复位态，
|
||
* "N 从 >0 变 0"这一眼要等两点标定解卡后才成立；解卡前该判据
|
||
* 退化为"页面受理 + 操作记录落一条"，不得把闭锁态报成复归无效
|
||
*/
|
||
static uint32_t rs_watch(void) {
|
||
return ui_data_maint_active_count();
|
||
}
|
||
|
||
/*
|
||
* 函数功能：开页复位确认链（框架 init_cb）
|
||
* 入口参数：无
|
||
* 返回值：无
|
||
* 限定条件：框架开页链内调用
|
||
* 函数说明：复位由组件做（stage/err 是它的运行态），本页不重复清一遍
|
||
*/
|
||
static void pg_init(void) {
|
||
ui_page_action_init(&s_act);
|
||
}
|
||
|
||
/*
|
||
* 函数功能：自绘（框架 draw_cb；四行居中全由组件画）
|
||
* 入口参数：a_layer / a_clip - 契约见 ui_content_page.h
|
||
* 返回值：无
|
||
* 限定条件：框架绘制链末尾调用
|
||
*/
|
||
static void pg_draw(lv_layer_t *a_layer, const lv_area_t *a_clip) {
|
||
ui_page_action_draw(&s_act, a_layer, a_clip);
|
||
}
|
||
|
||
/*
|
||
* 函数功能：按键转发（框架 key_cb）
|
||
* 入口参数：a_key - LVGL 键值 lv_key_t
|
||
* 返回值：true = 本页已消费；false = 交回框架 bool
|
||
* 限定条件：框架按键链内
|
||
* 函数说明：确认链的判定全在组件里（含只读拒执行），本页只如实透传返回值，
|
||
* 不在这层"顺手"加判据——两处各判一次早晚分家
|
||
*/
|
||
static bool pg_key(lv_key_t a_key) {
|
||
return (ui_page_action_key(&s_act, a_key) != 0u);
|
||
}
|
||
|
||
/*
|
||
* 页面描述符（外部链接：生成物 ui_page_registry.c 按菜单树 #page=reset 绑定引用）
|
||
* 表单/操作页形态：无浅 V、无页脚、无行列表（用户密钥页与网口设置页先例）；
|
||
* edit_capable=1 是**能不能改**的那半，另半（本次进入授予的权限）由
|
||
* ui_content_page_is_editable() 给——两半都在，组件才能判出"只读"；
|
||
* key_intercept=0：LEFT 不拦截，关页 = 取消（本链没有"编辑到一半"的状态要保）
|
||
*/
|
||
const content_page_def_t ui_page_reset_desc = {
|
||
.id = "reset",
|
||
.title = "强制复归",
|
||
.hide_deco = 1u,
|
||
.hide_footer = 1u,
|
||
.selectable = 0u,
|
||
.key_intercept = 0u,
|
||
.edit_capable = 1u,
|
||
.init_cb = pg_init,
|
||
.draw_cb = pg_draw,
|
||
.key_cb = pg_key,
|
||
};
|