Files
STM32F4-Base/Drivers/BSP/UI/ui_page_yk.c
T
wandering1 2053f6d913 docs(iec60870): 把 104 板端落地文档归入 docs/iec60870/板端落地
四篇讲「本项目怎么接 104」的文档原来散在子系统设计与网络两个目录,
和随库迁入的 36 篇协议库设计混在一起。现集中到 docs/iec60870/板端落地/:

- IEC104上行设计说明.md(原 docs/子系统设计/)
- IEC104_Net适配契约.md(原 docs/网络/)
- IEC104_MCU落地规划.md(原 docs/子系统设计/)
- IEC104_MCU最小可行性验证.md(原 docs/子系统设计/)

改动:
- 四篇 git mv 保留历史,全库引用经 rename_ref.py 逐篇改写(27 个文件
  54 处引用行),旧路径残留扫描为 0。
- docs/README.md:§5.3 改为「IEC 60870-5-104 文档(40 篇)」,拆成
  「板端落地 4 篇」与「协议库设计与接口 36 篇」两张表,说明两条轴的分工;
  从 §5.1 功能子系统表里移除这三篇的重复条目。
- docs/iec60870/README.md:新增两条轴入口与板端落地表,原阅读顺序
  改标注为「协议库部分」。

验证:
- check_doc_links.py --all --sections-strict:310 篇 0 问题。
- 三份索引 markdown 链接可达性逐个 exists() 校验,断链 0;索引表覆盖
  36 篇协议库文档,与实际磁盘文件双向差集为空。
- 板端落地目录 4 篇 BOM / CR / U+FFFD 均为 0。
- 工作树 Keil 权威构建 0 errors 0 warnings(Code=365896 RO=48336
  RW=2736 ZI=173104),此后预提交 21 Passed / 0 Failed。
2026-11-18 23:31:37 +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/iec60870/板端落地/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,
};