refactor(UI): 记录页改注入式 reader，layer-deps 基线 6->3(道B task-6)
B-6 分层收紧（UI_数据供给设计说明.md §7.2 契约原样落地）：
- ui_w_records：删 #include "sys_log.h"，改 ui_rec_reader_t 只读函数表 +
ui_w_records_bind() 模块级注入（sys_log 读 API 本为全局，函数表共享、
实例读盘缓存仍各自独享——切页陈旧行防御不变）；log_id 换不透明编号
UI_W_REC_LOG_RUN/SELFTEST；缓冲容量宏本地化 UI_W_REC_TS/DESC_LEN
（20/29，与 sys_log 契约下限同宽；读失败退化空行防御保留）
- ui_page_runlog / ui_page_selftest：去 sys_log include，实例改不透明编号
- 两端薄包装适配层（编号→syslog_id_t 显式映射，错误码 0/-1/-2 直通不改写）：
App/task/ui_task.c 与 simulator/main.c（无头+窗口两个 init 点），均在
ui_menu_init 之前 ui_w_records_bind；未绑定窗口组件按空态防御不读野
- scripts/check_layer_deps.py：BASELINE 6→3（--prune 实测恰 3 条 UI 记录
边消失后写回；剩 NETCFG×2 + lftpd_io 与 UI 无关）——道B 独占收紧口径
- 文档同步：门禁说明 layer-deps.md §1/§6/§9 与 README 计数 6→3；
UI_数据供给设计说明.md §7.2 加落地注记、§14"计划削减"改"已兑现"
- 首提被 id-check 拦下：注释/文档里自造"批卡编号"（B-6/道B-3）命中
"未登记前缀"增量拦截——已全数改回 task-6/道B 普通指称（编号不回收、
禁自造，教训入本提交）；id-check 复跑 RC=0（S10 告警为存量非本改动）
验证：
- 模拟器 0 警告；菜单 8 状态 + 内容页 11 页黄金参考逐字节 PASS
（记录页数据流经 reader 后像素与基线一致，无基线更新提交）
- cppcheck/coding-standard/bsp-err/font-charset/no-mojibake 单跑全绿；
layer-deps 复跑：6 处反向 include = 豁免 3 / 基线内 3 / 新增 0，
--prune 显示"基线无需收紧（3 条存量全部仍成立）"
- doc-links --all 的 35 处告警全为本仓检出路径含空格误扫 SDL2 自带 md
（环境问题、非本改动引入；提交门禁按暂存文件名过滤不受影响）
- @build 0 Error 0 Warning（终树复跑 BUILD_OK）；uvprojx 无 UV4 抖动、
无新文件不涉注册；其余 38 钩全绿（ui-golden/font-charset/coding-standard/
bsp-err/id-check/cppcheck…单跑复验 RC=0）
增量（A/B 同树 .map，基线 = 合入 c1b425d 后 HEAD）：
- Flash：Code +104 B、RO +8 B（两端薄包装代码 + reader 函数表 const）
- RAM：RW +4 B（s_reader 指针）/ ZI +4 B（两页实例 struct 枚举改 uint8
本应 -8 B，链接段对齐后净 +4 B）；RW+ZI 合计 +8 B
gate: only mem-budget/mem-numbers pending lead ledger backfill
- pre-commit run --all-files 实测仅这两条失败（台账/RAM 文档 vs .map 漂移，
根因即上列 Code +104/RO +8/RW +4/ZI +4），其余 38 钩全绿；按 Lead 裁决
（task-4 口径"以后照此办理"，含 Flash/RAM 漂移同例外）--no-verify 提交，
合并后请主树回填台账（scripts/ram_baseline.py --write 由 Lead 侧执行）
- 手工自查通过：5 个 BOM 文件 BOM=EF BB BF 齐全、docs/py/main.c 保持无 BOM，
全部 10 文件 CR=0、U+FFFD=0
- 台账增量供回填：Flash Code +104 B、RO +8 B；RAM RW +4 B、ZI +4 B
This commit is contained in:
@@ -1,8 +1,9 @@
|
||||
/*
|
||||
* 模块名称：UI Page RunLog (运行记录内容页)
|
||||
* 模块功能：运行记录叶子节点（node 40）的内容页数据——动态列表，每条记录 2 行
|
||||
* （偶数行 = 时间戳、奇数行 = 描述），可移选分页；数据源 = sys_log API
|
||||
* （/log/run.log，上电/重启事件）；空日志显示单条伪行"无记录"；
|
||||
* （偶数行 = 时间戳、奇数行 = 描述），可移选分页；数据经 ui_w_records
|
||||
* 注入 reader 取自 sys_log（/log/run.log，上电/重启事件；本文件不再直接
|
||||
* include sys_log.h——task-6 分层收紧）；空日志显示单条伪行"无记录"；
|
||||
* 向框架 ui_content_page 提供页面描述符（零 LVGL 对象）
|
||||
* 适用平台：STM32F407ZGTx / PC 模拟器（两端共用）
|
||||
* 作者：王建锋
|
||||
@@ -10,6 +11,9 @@
|
||||
* 修改记录：
|
||||
* v1.0 2026-09-14 王建锋 创建初始版本（设计见 docs/子系统设计/运行与自检记录设计说明.md §5.3）
|
||||
* v1.1 2026-10-20 王建锋 改用 ui_w_records 共享组件（W6 U2：合并两页重复实现）
|
||||
* v1.2 2026-10-25 王建锋 记录 reader 注入（道B task-6）：不再 include sys_log.h，
|
||||
* 数据经组件内注入的 ui_rec_reader_t 取；日志 ID 换
|
||||
* 不透明编号 UI_W_REC_LOG_RUN（映射在两端绑定处）
|
||||
*/
|
||||
|
||||
/* 头文件包含区 */
|
||||
@@ -20,8 +24,6 @@
|
||||
|
||||
#include "ui_tokens.h"
|
||||
|
||||
#include "sys_log.h"
|
||||
|
||||
/* 静态变量定义区 */
|
||||
|
||||
/* 最近读取的记录缓存（偶数行读盘后，奇数行复用；避免同记录重复 I/O） */
|
||||
@@ -39,7 +41,7 @@
|
||||
* 实例 s_rec 携带日志 ID 与**本实例自己的**读盘缓存——两页共用组件代码，
|
||||
* 但缓存不得共享，否则切页会命中上一记录号而显示另一页的陈旧行。
|
||||
*/
|
||||
static ui_w_records_t s_rec = { SYSLOG_RUN };
|
||||
static ui_w_records_t s_rec = { UI_W_REC_LOG_RUN };
|
||||
|
||||
static uint16_t pg_count(void) {
|
||||
return ui_w_records_count(&s_rec);
|
||||
|
||||
@@ -1,8 +1,9 @@
|
||||
/*
|
||||
* 模块名称：UI Page SelfTest (自检记录内容页)
|
||||
* 模块功能：自检记录叶子节点（node 39）的内容页数据——动态列表，每条记录 2 行
|
||||
* （偶数行 = 时间戳、奇数行 = 故障描述），可移选分页；数据源 = sys_log API
|
||||
* （/log/selftest.log，开机自检故障，仅故障才写）；空日志显示单条伪行"无记录"；
|
||||
* （偶数行 = 时间戳、奇数行 = 故障描述），可移选分页；数据经 ui_w_records
|
||||
* 注入 reader 取自 sys_log（/log/selftest.log，仅故障才写；本文件不再直接
|
||||
* include sys_log.h——task-6 分层收紧）；空日志显示单条伪行"无记录"；
|
||||
* 向框架 ui_content_page 提供页面描述符（零 LVGL 对象）
|
||||
* 适用平台：STM32F407ZGTx / PC 模拟器（两端共用）
|
||||
* 作者：王建锋
|
||||
@@ -10,6 +11,9 @@
|
||||
* 修改记录：
|
||||
* v1.0 2026-09-14 王建锋 创建初始版本（设计见 docs/子系统设计/运行与自检记录设计说明.md §5.4）
|
||||
* v1.1 2026-10-20 王建锋 改用 ui_w_records 共享组件（W6 U2：合并两页重复实现）
|
||||
* v1.2 2026-10-25 王建锋 记录 reader 注入（道B task-6）：不再 include sys_log.h，
|
||||
* 数据经组件内注入的 ui_rec_reader_t 取；日志 ID 换
|
||||
* 不透明编号 UI_W_REC_LOG_SELFTEST（映射在两端绑定处）
|
||||
*/
|
||||
|
||||
/* 头文件包含区 */
|
||||
@@ -20,8 +24,6 @@
|
||||
|
||||
#include "ui_tokens.h"
|
||||
|
||||
#include "sys_log.h"
|
||||
|
||||
/* 静态变量定义区 */
|
||||
|
||||
/* 最近读取的记录缓存（偶数行读盘后，奇数行复用；避免同记录重复 I/O） */
|
||||
@@ -39,7 +41,7 @@
|
||||
* 实例 s_rec 携带日志 ID 与**本实例自己的**读盘缓存——两页共用组件代码，
|
||||
* 但缓存不得共享，否则切页会命中上一记录号而显示另一页的陈旧行。
|
||||
*/
|
||||
static ui_w_records_t s_rec = { SYSLOG_SELFTEST };
|
||||
static ui_w_records_t s_rec = { UI_W_REC_LOG_SELFTEST };
|
||||
|
||||
static uint16_t pg_count(void) {
|
||||
return ui_w_records_count(&s_rec);
|
||||
|
||||
@@ -1,12 +1,14 @@
|
||||
/*
|
||||
* 模块名称：UI 记录页共享组件实现
|
||||
* 模块功能：见 ui_w_records.h（逻辑照搬合并前的 ui_page_runlog.c / ui_page_selftest.c，
|
||||
* 两文件差异仅为日志 ID 与符号名，其余逐字相同）
|
||||
* 两文件差异仅为记录源编号与符号名，其余逐字相同；数据经注入 reader 取）
|
||||
* 适用范围：Drivers/BSP/UI
|
||||
* 作者：王建锋
|
||||
* 创建日期：2026-10-20
|
||||
* 修改记录：
|
||||
* v1.0 2026-10-20 王建锋 创建（W6 U2）
|
||||
* v2.0 2026-10-25 王建锋 reader 注入（道B task-6）：syslog_count/syslog_get_record
|
||||
* 直调改为 s_reader 函数表调用；未注入按空态渲染
|
||||
*/
|
||||
|
||||
#include <string.h>
|
||||
@@ -15,15 +17,29 @@
|
||||
|
||||
#include "ui_tokens.h"
|
||||
|
||||
/* 静态变量定义区 */
|
||||
|
||||
/* 注入的记录 reader（模块级单例，理由见头注；NULL = 未注入 → 空态） */
|
||||
static const ui_rec_reader_t *s_reader;
|
||||
|
||||
/* 函数定义区 */
|
||||
|
||||
/*
|
||||
* 函数功能：注入记录 reader
|
||||
*/
|
||||
void ui_w_records_bind(const ui_rec_reader_t *a_reader) {
|
||||
s_reader = a_reader;
|
||||
}
|
||||
|
||||
/*
|
||||
* 函数功能：总行数（动态；每条记录 2 行，空日志 = 单条伪行"无记录"）
|
||||
* 入口参数：a_inst - 记录页实例 ui_w_records_t *
|
||||
* 返回值：总行数 uint16_t
|
||||
* 函数说明：未注入 reader 视同 0 条（空态伪行），两端启动期绑定前的开页窗口
|
||||
* 也被覆盖（防御不崩）
|
||||
*/
|
||||
uint16_t ui_w_records_count(ui_w_records_t *a_inst) {
|
||||
uint32_t n = syslog_count(a_inst->id);
|
||||
uint32_t n = (s_reader != NULL) ? s_reader->count(a_inst->log_id) : 0u;
|
||||
|
||||
if (n == 0u) {
|
||||
return 1u; /* 空态伪行（页脚"共 1 页"，避免"共 0 页"） */
|
||||
@@ -40,7 +56,7 @@ uint16_t ui_w_records_count(ui_w_records_t *a_inst) {
|
||||
* 限定条件：页面打开中（框架绘制/按键上下文，uiTask）
|
||||
*/
|
||||
void ui_w_records_refresh(ui_w_records_t *a_inst, uint16_t a_row, char *a_name, char *a_value) {
|
||||
uint32_t n = syslog_count(a_inst->id);
|
||||
uint32_t n = (s_reader != NULL) ? s_reader->count(a_inst->log_id) : 0u;
|
||||
|
||||
a_value[0] = '\0';
|
||||
if (n == 0u) {
|
||||
@@ -52,8 +68,9 @@ void ui_w_records_refresh(ui_w_records_t *a_inst, uint16_t a_row, char *a_name,
|
||||
uint32_t rec = a_row / 2u;
|
||||
|
||||
if (!a_inst->cache_valid || rec != a_inst->last_rec) {
|
||||
if (syslog_get_record(a_inst->id, rec, a_inst->ts, sizeof(a_inst->ts),
|
||||
a_inst->desc, sizeof(a_inst->desc)) != 0) {
|
||||
if ((s_reader->get)(a_inst->log_id, rec, a_inst->ts, sizeof(a_inst->ts),
|
||||
a_inst->desc, sizeof(a_inst->desc)) != 0) {
|
||||
a_inst->cache_valid = 0u;
|
||||
a_name[0] = '\0'; /* 读失败（越界/存储异常）：空行防御 */
|
||||
return;
|
||||
}
|
||||
|
||||
@@ -1,14 +1,21 @@
|
||||
/*
|
||||
* 模块名称：UI 记录页共享组件（运行记录 / 自检记录两页的公共实现）
|
||||
* 模块功能：把"定长记录 -> 每记录 2 行（偶数行时间戳、奇数行描述）+ 同记录读盘缓存
|
||||
* + 空态单条伪行"这套逻辑收成一份，供多个日志页按实例复用
|
||||
* 适用范围：Drivers/BSP/UI（仅 UI 层，数据源固定为 sys_log API）
|
||||
* + 空态单条伪行"这套逻辑收成一份，供多个日志页按实例复用；
|
||||
* 数据经注入式 reader 回调取（UI_数据供给设计说明.md §7.2 契约），
|
||||
* 本头**不含任何 App 头**——记录属主 sys_log 留在 App 侧，启动时由
|
||||
* App/task/ui_task.c（MCU）与 simulator/main.c（PC）各注入一份薄包装
|
||||
* 适用范围：Drivers/BSP/UI（仅 UI 层；分层方向由 check_layer_deps 门禁守护）
|
||||
* 说明：缓存必须按实例存放而非文件级静态——两页共用代码但各有独立实例，
|
||||
* 若共享缓存，从 A 页切到 B 页会命中上一记录号而显示另一页的陈旧行（静默错数据）。
|
||||
* 作者：王建锋
|
||||
* 创建日期：2026-10-20
|
||||
* 修改记录：
|
||||
* v1.0 2026-10-20 王建锋 创建（W6 U2：合并 ui_page_runlog / ui_page_selftest 的重复实现）
|
||||
* v2.0 2026-10-25 王建锋 记录 reader 注入（道B task-6）：删 #include "sys_log.h"，
|
||||
* 改 ui_rec_reader_t 函数表 + ui_w_records_bind()；
|
||||
* log_id 换不透明编号（UI_W_REC_LOG_*）；缓冲容量宏本地化
|
||||
* （与 sys_log 契约下限同宽，逐字节一致）
|
||||
*/
|
||||
|
||||
#ifndef UI_W_RECORDS_H
|
||||
@@ -20,34 +27,83 @@ extern "C" {
|
||||
|
||||
#include <stdint.h>
|
||||
|
||||
#include "sys_log.h"
|
||||
/* 记录源不透明编号：UI 侧只认"0 号 / 1 号日志"，App 侧适配层映射到 syslog_id_t
|
||||
* （映射表见 App/task/ui_task.c 与 simulator/main.c 的绑定处；新增记录页 =
|
||||
* 这里加编号 + 两端适配层各加一条映射） */
|
||||
#define UI_W_REC_LOG_RUN 0u /* 0 号：运行记录（MCU /log/run.log） */
|
||||
#define UI_W_REC_LOG_SELFTEST 1u /* 1 号：自检记录（MCU /log/selftest.log） */
|
||||
|
||||
/* 读取缓冲容量（UI 侧定义；必须 >= sys_log 契约下限：时间戳 19+NUL、描述 28+NUL。
|
||||
* sys_log 侧 SYSLOG_TS_LEN/SYSLOG_DESC_MAX 变化时这里同步加宽——容量不足时
|
||||
* reader 按契约返回负码、页面退化空行，不会读越界） */
|
||||
#define UI_W_REC_TS_LEN 20u /* "YYYY-MM-DD HH:MM:SS" 19 + NUL */
|
||||
#define UI_W_REC_DESC_LEN 29u /* 描述 28 + NUL */
|
||||
|
||||
/*
|
||||
* 记录页实例：日志源 + 该实例自己的读盘缓存
|
||||
* 用法：页面文件里 static ui_w_records_t s_rec = { SYSLOG_XXX };
|
||||
* 注入式记录 reader（只读函数表；契约 = UI_数据供给设计说明.md §7.2）
|
||||
* 实现体在 App / 模拟器侧，uiTask 上下文同步调用——记录页绘制路径上的读盘
|
||||
* 时序与合并前直调 syslog_* 完全一致，无新增并发面
|
||||
*/
|
||||
typedef struct {
|
||||
/*
|
||||
* 函数功能：取该日志当前记录条数
|
||||
* 入口参数：log_id - 不透明记录源编号（UI_W_REC_LOG_*） uint8_t
|
||||
* 返回值：记录条数（0 = 空态，页面显示伪行"无记录"） uint16_t
|
||||
*/
|
||||
uint16_t (*count)(uint8_t a_log_id);
|
||||
/*
|
||||
* 函数功能：读第 idx 条记录（时间戳 + 描述两字段）
|
||||
* 入口参数：log_id - 记录源编号 uint8_t
|
||||
* idx - 记录序号（0 起） uint32_t
|
||||
* ts - 时间戳缓冲 char *
|
||||
* ts_len - ts 容量（>= UI_W_REC_TS_LEN） uint32_t
|
||||
* desc - 描述缓冲 char *
|
||||
* desc_len - desc 容量（>= UI_W_REC_DESC_LEN）uint32_t
|
||||
* 返回值：0 = 成功；-1 = 序号/编号越界；-2 = 读失败
|
||||
* （与 sys_log 契约同值，适配层直通不改码） int
|
||||
*/
|
||||
int (*get)(uint8_t a_log_id, uint32_t a_idx,
|
||||
char *a_ts, uint32_t a_ts_len, char *a_desc, uint32_t a_desc_len);
|
||||
} ui_rec_reader_t;
|
||||
|
||||
/*
|
||||
* 记录页实例：记录源编号 + 该实例自己的读盘缓存
|
||||
* 用法：页面文件里 static ui_w_records_t s_rec = { UI_W_REC_LOG_xxx };
|
||||
* 其余字段自动清零，即"缓存初始无效"，与合并前两页的行为一致。
|
||||
*/
|
||||
typedef struct {
|
||||
syslog_id_t id; /* 日志源 ID（决定读哪个记录文件） */
|
||||
uint8_t cache_valid; /* 缓存有效标志（0 = 无缓存） */
|
||||
uint32_t last_rec; /* 已缓存的记录序号 */
|
||||
char ts[SYSLOG_TS_LEN + 1u]; /* 时间戳缓存（含 NUL） */
|
||||
char desc[SYSLOG_DESC_MAX + 1u];/* 描述缓存（含 NUL） */
|
||||
uint8_t log_id; /* 记录源编号（UI_W_REC_LOG_*，透传给 reader） */
|
||||
uint8_t cache_valid; /* 缓存有效标志（0 = 无缓存） */
|
||||
uint32_t last_rec; /* 已缓存的记录序号 */
|
||||
char ts[UI_W_REC_TS_LEN]; /* 时间戳缓存（含 NUL） */
|
||||
char desc[UI_W_REC_DESC_LEN];/* 描述缓存（含 NUL） */
|
||||
} ui_w_records_t;
|
||||
|
||||
/*
|
||||
* 函数功能：注入记录 reader（启动时一次；NULL = 撤销注入，页面回到空态）
|
||||
* 入口参数：reader - 只读函数表（生命周期由注入方保证，组件只存指针）
|
||||
* const ui_rec_reader_t *
|
||||
* 返回值：无
|
||||
* 限定条件：uiTask 启动期注入（ui_menu_init 之前，UI_数据供给设计说明.md §7.2）；
|
||||
* 未注入时组件按"空态"渲染（伪行"无记录"），不崩不读野
|
||||
* 函数说明：模块级单例——sys_log 读 API 本就是全局的，两端各只有一份实现；
|
||||
* 两页共享函数表、独享各自的读盘缓存（缓存才是必须按实例存的那半）
|
||||
*/
|
||||
void ui_w_records_bind(const ui_rec_reader_t *a_reader);
|
||||
|
||||
/*
|
||||
* 函数功能：总行数（动态；每条记录 2 行，空日志 = 单条伪行"无记录"）
|
||||
* 入口参数：inst - 记录页实例 ui_w_records_t *
|
||||
* 入口参数：a_inst - 记录页实例 ui_w_records_t *
|
||||
* 返回值：总行数 uint16_t
|
||||
*/
|
||||
uint16_t ui_w_records_count(ui_w_records_t *a_inst);
|
||||
|
||||
/*
|
||||
* 函数功能：逐行取数（偶数行 = 时间戳、奇数行 = 描述；值列恒空）
|
||||
* 入口参数：inst - 记录页实例 ui_w_records_t *
|
||||
* row - 全局行下标 uint16_t
|
||||
* name - 名输出缓冲（框架栈缓冲 UI_BUF_STRLEN=32，含 NUL） char *
|
||||
* value - 值输出缓冲（同上；本组件恒写空串） char *
|
||||
* 入口参数：a_inst - 记录页实例 ui_w_records_t *
|
||||
* a_row - 全局行下标 uint16_t
|
||||
* a_name - 名输出缓冲（框架栈缓冲 UI_BUF_STRLEN=32，含 NUL） char *
|
||||
* a_value- 值输出缓冲（同上；本组件恒写空串） char *
|
||||
* 限定条件：页面打开中（框架绘制/按键上下文，uiTask）
|
||||
*/
|
||||
void ui_w_records_refresh(ui_w_records_t *a_inst, uint16_t a_row, char *a_name, char *a_value);
|
||||
|
||||
Reference in New Issue
Block a user