84c5a5d92a
上一笔改名把 App/protocol/iec104 搬到 App/iec60870/104_port 时,机械
文本替换把「讲一个已经删掉的文件当初做什么」的叙述也一起改了:
iec104_pts.c / iec104_asdu.c / iec104_link.c
这三个文件在 90cc9a7d 里就删了(旧自研协议层整体退役),
App/iec60870/104_port/ 下从来没有它们。于是文档与注释里出现了一批
「新路径 + 旧行为」的混合描述,读者按图索骥只会撞空。
按两类分别处理,共 11 个文件(只有注释与 Markdown,零代码行):
一、讲历史事实的 -> 写回当时真实的旧名,就近标「已删除」
App/task/ui_task.c SYSLOG_OPER 那条原写入点
App/algo/run_par.h 104 消费侧每拍读取
Drivers/BSP/UI/ui_data.h YX_DP_N / 遥控记录两条
Drivers/BSP/UI/ui_page_oper.c 操作页写入点
Drivers/BSP/UI/ui_page_reset.c 复归串与远端那条刻意不同
Drivers/BSP/UI/ui_page_yk.c 遥控页写入点
Drivers/BSP/UI/ui_data.c CP56 正反两套实现同族
test/host/ui_data/ui_data_test.c 两处历史注释
simulator/main.c 双点位图固定帧的来历
App/log/README.md oper.log / yk.log 生产者
docs/UI设计/UI_数据供给设计.md
docs/UI设计/页面扩充详细方案.md
docs/产品需求/产品需求设计文档.md 链路层与点表实现指针
二、讲现在仍活着的接缝的 -> 指向真实存在的文件,并 test -f 过
App/algo/run_par.h:23 死区分流现由 iec104_dtu_table.c +
iec104_source.c 承担
App/algo/meas.h 数值口径改指 common/IEC60870_InformationObjects.h
的 IEC60870_ASDU_QUALITY_*;顺带修掉同句里两个
既有错:引用了不存在的 test/host/iec104/,
且 104 当前消费点是 iec104_serv.c 的 s_measure()
test/host/bench/iec104/iec104_master.py 常量与帧头说明改指
common/IEC60870_Asdu.c 与 104/IEC104_Types.h
App/task/iec104_serv.c 单独说明:文件还在但 s_clock_sync() 已随新契约
消失(grep RC=1),所以写「同日重写后不再投递」,不写「已删除」。
验证:grep 新假路径零命中;旧真名 14 处全部带删除标注;check_bom_drift
RC=0(6 个带 BOM 文件按原始字节补回,未过文本编解码);check_mojibake
RC=0;check_coding_standard 逐文件 RC=0;doc-links 308 篇 / 30 处问题
全部仍在 IEC60870-Slave 供应商快照内,非 vendor 计数仍为 0。
155 lines
7.2 KiB
C
155 lines
7.2 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",该文件
|
||
* 2026-11-18 已删除,骨架阶段 104 侧无此记录)**刻意不同串**——
|
||
* 操作记录是审计面,两条一样就再也分不出"是主站下发的还是现场有人按面板",
|
||
* 而那正是查遥控事故时第一个要问的问题。
|
||
* 为什么由页面投而不是由 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,
|
||
};
|