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。
84 lines
4.2 KiB
C
84 lines
4.2 KiB
C
/*
|
||
* 模块名称:UI Page 遥控记录(遥控记录内容页)
|
||
* 模块功能:遥控记录叶子节点(node 38,父节点「记录查询」)的内容页数据——动态列表,
|
||
* 每条记录 2 行(偶数行 = 时间戳、奇数行 = 描述),可移选分页;数据经 ui_w_records
|
||
* 注入 reader 取自 sys_log(/log/yk.log,容量上限 256 条,满时删除重建);
|
||
* 空日志显示单条伪行"无记录";向框架 ui_content_page 提供页面描述符(零 LVGL 对象)
|
||
* 记录口径(本文件只读显示、不实现写入方;权威表 App/log/README.md §五类记录):
|
||
* 触发判据 = 104 遥控的选择 / 执行 / 拒绝(含未知类型与参数越界);
|
||
* 写入点 = 旧 App/protocol/iec104/iec104_pts.c 的遥控段(该文件 2026-11-18
|
||
* 已删除);骨架阶段**当前无生产者**——模拟动作绝不驱动物理出口,
|
||
* 见 docs/子系统设计/IEC104上行设计说明.md §0.5;
|
||
* "记录类型 = 日志 ID 本身"(一类记录一个文件,记录体内没有类型字段位,
|
||
* Lead 裁定 2026-10-26)——本页只读 yk.log 一个文件,不做跨文件混排。
|
||
* 台架复核已完成(2026-11-06,Issue #53 台架轮、实机 boot 188–193,证据贴 Issue #53 评论):
|
||
* 真 NAND 真实记录的翻页读取、复位(RAM 全清)后从 NAND 原样重读、清除记录后
|
||
* 本页归零(34 条 → 无记录、YK.LOG 从盘上消失)三件事均已上板复核;真·拔
|
||
* 市电本机不可控,保持性以 RAM 全清 + 全链重启代理(POR 计数差额人工一眼可补)。
|
||
* 模拟器侧该文件仍无写入方,像素黄金维持空态"无记录"口径。
|
||
* 适用平台:STM32F407ZGTx / PC 模拟器(两端共用)
|
||
* 作者:DTU 项目组
|
||
* 创建日期:2026-10-28
|
||
* 修改记录:
|
||
* v1.0 2026-10-28 DTU 项目组 创建(UI 补齐「记录 5 页」:照 ui_page_runlog.c 同构,
|
||
* 分页 / 空态 / 按实例读盘缓存全部复用 ui_w_records,
|
||
* 本文件不重复实现,也不改共享组件)
|
||
*/
|
||
|
||
/* 头文件包含区 */
|
||
#include "ui_page_yk.h"
|
||
#include "ui_w_records.h"
|
||
|
||
#include "ui_tokens.h"
|
||
|
||
/* 静态变量定义区 */
|
||
|
||
/*
|
||
* 记录页薄跳板:内容全部走 ui_w_records 共享组件(W6 合并先例)。
|
||
* 实例 s_rec 携带记录源编号与**本实例自己的**读盘缓存——多页共用组件代码,
|
||
* 但缓存不得共享,否则切页会命中上一记录号而显示另一页的陈旧行(静默错数据)。
|
||
*/
|
||
static ui_w_records_t s_rec = { UI_W_REC_LOG_YK };
|
||
|
||
/*
|
||
* 函数功能:总行数(动态;每条记录 2 行,空日志 = 单条伪行"无记录")
|
||
* 入口参数:无
|
||
* 返 回 值:总行数 uint16_t
|
||
* 限定条件:uiTask 绘制上下文(经框架回调)
|
||
*/
|
||
static uint16_t pg_count(void) {
|
||
return ui_w_records_count(&s_rec);
|
||
}
|
||
|
||
/*
|
||
* 函数功能:逐行取数(转调共享组件;偶数行 = 时间戳、奇数行 = 描述)
|
||
* 入口参数:row - 全局行下标 uint16_t
|
||
* name - 名输出缓冲 char *
|
||
* value - 值输出缓冲(本组件恒写空串) char *
|
||
* 返 回 值:无 void
|
||
* 限定条件:uiTask 绘制上下文(经框架回调)
|
||
*/
|
||
static void pg_refresh(uint16_t row, char *name, char *value) {
|
||
ui_w_records_refresh(&s_rec, row, name, value);
|
||
}
|
||
|
||
/*
|
||
* 页面描述符(外部链接:生成物 ui_page_registry.c 按菜单树 #page=yk 绑定引用):
|
||
* 动态列表页——每记录 2 行、UI_LIST_ROWS 行/页;band_h=UI_ROW_BAND_H(同 AC/DC 约定:
|
||
* selectable 页选中行黑字必须配白带,band_h=0 会致选中行不可见)
|
||
*/
|
||
const content_page_def_t ui_page_yk_desc = {
|
||
.id = "yk",
|
||
.title = "遥控记录",
|
||
.selectable = 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,
|
||
.count_cb = pg_count,
|
||
.refresh = pg_refresh,
|
||
};
|