Files
STM32F4-Base/Drivers/BSP/UI/ui_page_yk.c
T
wandering1 84c5a5d92a fix(docs): 修 16 处指向已删文件的历史指针,别让读者照着找空门
上一笔改名把 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。
2026-11-18 14:32:40 +08:00

84 lines
4.2 KiB
C
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
/*
* 模块名称: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,
};