diff --git a/App/task/ui_task.c b/App/task/ui_task.c index c3350528..d67cb6c0 100644 --- a/App/task/ui_task.c +++ b/App/task/ui_task.c @@ -30,6 +30,8 @@ #include "ui_menu.h" #include "ui_net_sink.h" #include "ui_standby.h" +#include "ui_w_records.h" /* task-6 记录 reader 注入点(UI 页面不再 include sys_log.h) */ +#include "sys_log.h" #include "ui_tokens.h" /* UI 设计令牌:循环周期 UI_TASK_TICK_MS / 待机阈值 UI_STANDBY_IDLE_MS */ #include "sys_clock.h" #include "test_config.h" /* TEST_LATENCY_PROBE(链路时延探针编译开关) */ @@ -49,6 +51,41 @@ static void ui_task_time_cb(char *buf, size_t len) { } } +/* + * 函数功能:记录 reader 适配(task-6 注入)——UI 不透明编号 0/1 → syslog_id_t 映射 + * 入口参数:log_id - UI 记录源编号(UI_W_REC_LOG_*) uint8_t + * 返回值:记录条数;未知编号返回 0(页面退化为空态) uint16_t + * 限定条件:uiTask 上下文同步调用(记录页绘制路径,与合并前直调同形) + */ +static uint16_t ui_task_rec_count(uint8_t log_id) { + if (log_id == UI_W_REC_LOG_RUN) { + return (uint16_t)syslog_count(SYSLOG_RUN); + } + if (log_id == UI_W_REC_LOG_SELFTEST) { + return (uint16_t)syslog_count(SYSLOG_SELFTEST); + } + return 0u; +} + +/* + * 函数功能:记录 reader 适配(task-6 注入)——读记录字段直通 sys_log(错误码不改写) + * 入口参数:log_id/idx/ts/ts_len/desc/desc_len - 契约见 ui_w_records.h ui_rec_reader_t + * 返回值:0 成功;-1 编号/序号越界(未知编号同 -1);-2 读失败 int + * 限定条件:同上 + */ +static int ui_task_rec_get(uint8_t log_id, uint32_t idx, char *ts, uint32_t ts_len, + char *desc, uint32_t desc_len) { + if (log_id == UI_W_REC_LOG_RUN) { + return syslog_get_record(SYSLOG_RUN, idx, ts, (size_t)ts_len, desc, (size_t)desc_len); + } + if (log_id == UI_W_REC_LOG_SELFTEST) { + return syslog_get_record(SYSLOG_SELFTEST, idx, ts, (size_t)ts_len, desc, (size_t)desc_len); + } + return -1; +} + +static const ui_rec_reader_t s_rec_reader = { ui_task_rec_count, ui_task_rec_get }; + #define DBG_TAG "[UI_TASK]" #include "dbg_log.h" @@ -103,6 +140,9 @@ void ui_task_func(void *argument) { for (;;) { osDelay(1000); } } DBG_INFO("UI port init: OK"); + /* 记录 reader 注入:必须在 ui_menu_init 之前(记录页在此前不可能被打开, + * 但契约把"启动期先绑定"写死;未绑定窗口组件按空态防御——见 ui_w_records.h) */ + ui_w_records_bind(&s_rec_reader); DBG_INFO("UI task: ui_menu_init enter"); if (ui_menu_init() != 0) { DBG_ERROR("UI menu init: FAIL"); diff --git a/Drivers/BSP/UI/ui_page_runlog.c b/Drivers/BSP/UI/ui_page_runlog.c index ff225724..3264ca98 100644 --- a/Drivers/BSP/UI/ui_page_runlog.c +++ b/Drivers/BSP/UI/ui_page_runlog.c @@ -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); diff --git a/Drivers/BSP/UI/ui_page_selftest.c b/Drivers/BSP/UI/ui_page_selftest.c index d18b89c2..a61bf8c8 100644 --- a/Drivers/BSP/UI/ui_page_selftest.c +++ b/Drivers/BSP/UI/ui_page_selftest.c @@ -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); diff --git a/Drivers/BSP/UI/ui_w_records.c b/Drivers/BSP/UI/ui_w_records.c index d31fcbf8..6b5566ac 100644 --- a/Drivers/BSP/UI/ui_w_records.c +++ b/Drivers/BSP/UI/ui_w_records.c @@ -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 @@ -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; } diff --git a/Drivers/BSP/UI/ui_w_records.h b/Drivers/BSP/UI/ui_w_records.h index 80eabc84..fd9c16ae 100644 --- a/Drivers/BSP/UI/ui_w_records.h +++ b/Drivers/BSP/UI/ui_w_records.h @@ -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 -#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); diff --git a/docs/UI设计/UI_数据供给设计说明.md b/docs/UI设计/UI_数据供给设计说明.md index 0d5662e2..d2cc9012 100644 --- a/docs/UI设计/UI_数据供给设计说明.md +++ b/docs/UI设计/UI_数据供给设计说明.md @@ -333,6 +333,10 @@ void ui_w_records_bind(const ui_rec_reader_t *reader); /* App 启动时注入 - `log_id` 用 `uint8_t`(**不透明编号**),BSP 不知道 `SYSLOG_RUN` 是什么,只知道"0 号日志"。 - 注入点在 `App/task/ui_task.c`(`ui_menu_init` 之前),实现体是 `sys_log` 的两个薄包装。 +- 【2026-10-25 落地注】模拟器同形镜像:`simulator/main.c` 的 `sim_rec_count/sim_rec_get`, + 无头与窗口两个初始化点都在 `ui_menu_init` 前调 `ui_w_records_bind`;UI 侧编号常量 + `UI_W_REC_LOG_RUN/SELFTEST`(映射只在两端适配层,UI 不感知 `syslog_id_t`)。 + `ui_rec_reader_t` 按本文契约**原样**实现(`int` 错误码 0/-1/-2 未改型)。 ### 7.3 收益:可削减 3 条既有基线 @@ -489,7 +493,7 @@ typedef struct { ## 14. 与既有文档和门禁的关系 -- **门禁**:`scripts/check_layer_deps.py` 的三种合法做法本文全部用上(快照推送=②,写路径与记录 reader=①),**不新增任何 `ALLOW` 或 `BASELINE` 条目**,并计划削减 3 条。 +- **门禁**:`scripts/check_layer_deps.py` 的三种合法做法本文全部用上(快照推送=②,写路径与记录 reader=①),**不新增任何 `ALLOW` 或 `BASELINE` 条目**;计划的 3 条削减**已于 2026-10-25 兑现**(task/UI-rec-reader 落地 §7.2 契约,基线 6 → 3,详见 `docs/门禁说明/layer-deps.md` §1)。 - **页面框架**:`docs/UI设计/内容页架构.md` 的 `refresh` / `count_cb` 钩子**签名不变**,页面只是改为从 `ui_data` 取数。 - **页面清单**:`docs/UI设计/页面补齐规划.md` 的"批 1"第一项即本文 步骤1~步骤3。 - **数据真实性**:`docs/问题记录/采集与数据处理短板评测.md` 的标定(§4.1)与遥测链(§4.2)落地后,只需改 `ui_data_feed` 的取数来源与 `eng` 取值,页面零改动。 diff --git a/docs/门禁说明/README.md b/docs/门禁说明/README.md index 7ecdecd2..0a15fb5a 100644 --- a/docs/门禁说明/README.md +++ b/docs/门禁说明/README.md @@ -16,7 +16,7 @@ |---|---|---|---| | **改写型** | 不报错,直接改你的文件 | `trailing-whitespace`、`end-of-file-fixer` | 重新 `git add` 被改的文件再提交(它改的是工作区,不是索引) | | **硬拦截** | 违反即失败,没有存量豁免 | `cppcheck`、`coding-standard`、`doc-links`、`no-mojibake`、`mem-budget`、`ui-golden`、`font-charset`、`lv-conf-sync`、`task-table`、`mem-numbers`、`registration-check`、`cubemx-survival`、`test-suite-switch`、16 个主机单测、官方 5 个、`gitlint` | 只能改代码或改文档;**不要**找豁免开关 | -| **增量拦截** | 规则恒生效,但存量钉在基线/台账里,只许减不许增 | `layer-deps`(6 条)、`bsp-err`(38 条)、`id-check`(`scripts/id_known_backlog.json` 台账) | 报错先分清是**新增**还是**存量搬家**:`--verbose` 看归类,`--prune` 看已还清 | +| **增量拦截** | 规则恒生效,但存量钉在基线/台账里,只许减不许增 | `layer-deps`(3 条,2026-10-25 还清 UI 记录 3 条)、`bsp-err`(38 条)、`id-check`(`scripts/id_known_backlog.json` 台账) | 报错先分清是**新增**还是**存量搬家**:`--verbose` 看归类,`--prune` 看已还清 | ⚠ 增量拦截最容易误会的一点:**绿灯不等于没问题**,只等于"没有比上次更差"。 每个增量拦截门禁的基线数字都写进它自己的文档,读那篇时第一眼看的就是"现在在册多少条"。 diff --git a/docs/门禁说明/layer-deps.md b/docs/门禁说明/layer-deps.md index 5e86d715..f442c329 100644 --- a/docs/门禁说明/layer-deps.md +++ b/docs/门禁说明/layer-deps.md @@ -20,9 +20,12 @@ `App/log/console_log.h`(日志后端,BSP 的 `dbg_log.h` 本来就建在它上面)、 `App/util/sys_clock.h`(时间源,日志时间戳的唯一提供者)、`App/util/sha256.h`(纯算法、无状态)。 -**`BASELINE` 六条(2026-10-22 清点,只减不增)**:`NETCFG/net_cfg.c`、`NETCFG/ftp_cfg.c` -→ `App/cfg/cfg_file.h`(配置引擎属主是 defaultTask);`NET/lftpd/lftpd_io.c` → `App/fs/vol_lock.h`; -`UI/ui_page_runlog.c`、`UI/ui_page_selftest.c`、`UI/ui_w_records.h` → `App/log/sys_log.h`。 +**`BASELINE` 现存三条(2026-10-22 清点六条 → 2026-10-25 道B 还清 UI 记录三条 → 现三条;只减不增)**: +`NETCFG/net_cfg.c`、`NETCFG/ftp_cfg.c` → `App/cfg/cfg_file.h`(配置引擎属主是 defaultTask); +`NET/lftpd/lftpd_io.c` → `App/fs/vol_lock.h`。 +已还清:`UI/ui_page_runlog.c`、`UI/ui_page_selftest.c`、`UI/ui_w_records.h` → `App/log/sys_log.h` +(2026-10-25 task/UI-rec-reader:`ui_w_records` 改注入式 `ui_rec_reader_t`,契约见 +`docs/UI设计/UI_数据供给设计说明.md` §7.2,绑定在 `App/task/ui_task.c` 与 `simulator/main.c`)。 修法是**注入 / 传参**(上层把数据或回调递进 BSP),不是把上层服务搬进 BSP。 ## 2. 为什么要它 @@ -69,8 +72,8 @@ ## 6. 限制与盲区 1. **只查直接 include,查不到传递依赖**。BSP 的 `a.h` 里 include 了 App 头,BSP 的 `b.c` - 只 include `a.h`——`b.c` 这条边不出现,**但 `a.h` 那条会报**。基线里 `ui_w_records.h` 的 - 注释专门写着"(组件头,会外溢到 include 链)",就是提醒这种外溢要人来看。 + 只 include `a.h`——`b.c` 这条边不出现,**但 `a.h` 那条会报**。原基线 `ui_w_records.h` 的 + 注释专门写着"(组件头,会外溢到 include 链)"(该条 2026-10-25 已还清),就是提醒这种外溢要人来看。 2. 只认 `#include "引号"` 形式;`#include ` 这类写法不在管辖内(也违反 include 规范, 由 `coding-standard` 的 CODE-RULE-11 兜)。 3. **按 basename 匹配**:如果 `App/` 与别处存在同名头,会按同名候选放宽(先精确后同名), @@ -80,7 +83,7 @@ `--prune` 也就不会提示你收紧基线。 6. `git` 不可用时退回 `os.walk`(跳过 `.git/.venv/build`)——两条路径的清单可能不同, 在无 git 环境下跑出的"通过"不能当证据。 -7. 绿灯的含义只是"没有新增反向边":6 条存量债务仍然在那里。 +7. 绿灯的含义只是"没有新增反向边":现存 3 条存量债务仍然在那里(2026-10-25 还清 3 条)。 ## 7. 豁免与基线 @@ -97,3 +100,4 @@ | 日期 | 变更 | |---|---| | 2026-10-23 | 首篇逐项文档(在册 6 条基线逐条列出,含每条的属主背景) | +| 2026-10-25 | 道B(task/UI-rec-reader)还清 UI 记录 3 条:`ui_w_records` 注入式 reader(§7.2 契约落地),基线 6 → 3 | diff --git a/scripts/check_layer_deps.py b/scripts/check_layer_deps.py index 2562023e..a3d8eab9 100644 --- a/scripts/check_layer_deps.py +++ b/scripts/check_layer_deps.py @@ -43,15 +43,15 @@ ALLOW = { "App/util/sha256.h", # 纯算法工具:无状态、不依赖任何上层服务 } -# 存量基线(2026-10-22 清点,只减不增)。每条 = (引用方, 被引用的 App 头)。 +# 存量基线(2026-10-22 清点 6 条,只减不增)。每条 = (引用方, 被引用的 App 头)。 # 修法是"注入/传参",不是把上层服务搬进 BSP——详见报告 §0.4 的 S-1 行。 +# 2026-10-25 道B(task/UI-rec-reader)还清 UI 记录 3 条:ui_w_records 改注入式 +# ui_rec_reader_t(契约 UI_数据供给设计说明.md §7.2),runlog/selftest/records.h +# 不再 include sys_log.h,绑定在 App/task/ui_task.c 与 simulator/main.c。 BASELINE = { ("Drivers/BSP/NETCFG/net_cfg.c", "App/cfg/cfg_file.h"), # 配置引擎属主 = defaultTask ("Drivers/BSP/NETCFG/ftp_cfg.c", "App/cfg/cfg_file.h"), # 同上([ftp] 段注册) ("Drivers/BSP/NET/lftpd/lftpd_io.c", "App/fs/vol_lock.h"), # 卷锁在 App/fs - ("Drivers/BSP/UI/ui_page_runlog.c", "App/log/sys_log.h"), # 记录读取应由上层递进来 - ("Drivers/BSP/UI/ui_page_selftest.c", "App/log/sys_log.h"), # 同上 - ("Drivers/BSP/UI/ui_w_records.h", "App/log/sys_log.h"), # 同上(组件头,会外溢到 include 链) } INC_RE = re.compile(r'^[ \t]*#[ \t]*include[ \t]*"([^"]+)"', re.M) diff --git a/simulator/main.c b/simulator/main.c index 7cb8f82a..b0fdf790 100644 --- a/simulator/main.c +++ b/simulator/main.c @@ -68,6 +68,7 @@ #include "cfg_file.h" #include "cfg_file_store.h" #include "sys_log.h" +#include "ui_w_records.h" /* task-6 记录 reader 注入点(镜像 App/task/ui_task.c 的绑定) */ /* 屏幕尺寸(与 MCU 端一致) */ #define SIM_SCREEN_W 160 @@ -137,6 +138,39 @@ static void sim_time_cb(char *buf, size_t len) { tmv.tm_hour, tmv.tm_min, tmv.tm_sec); } +/* + * 函数功能:记录 reader 适配(task-6 注入,镜像 ui_task.c)——UI 编号 → syslog_id_t + * 入口参数:log_id - UI 记录源编号(UI_W_REC_LOG_*) uint8_t + * 返回值:记录条数;未知编号返回 0(页面空态) uint16_t + */ +static uint16_t sim_rec_count(uint8_t log_id) { + if (log_id == UI_W_REC_LOG_RUN) { + return (uint16_t)syslog_count(SYSLOG_RUN); + } + if (log_id == UI_W_REC_LOG_SELFTEST) { + return (uint16_t)syslog_count(SYSLOG_SELFTEST); + } + return 0u; +} + +/* + * 函数功能:记录 reader 适配(task-6 注入)——读记录字段直通 sys_log(错误码不改写) + * 入口参数:log_id/idx/ts/ts_len/desc/desc_len - 契约见 ui_w_records.h ui_rec_reader_t + * 返回值:0 成功;-1 编号/序号越界;-2 读失败 int + */ +static int sim_rec_get(uint8_t log_id, uint32_t idx, char *ts, uint32_t ts_len, + char *desc, uint32_t desc_len) { + if (log_id == UI_W_REC_LOG_RUN) { + return syslog_get_record(SYSLOG_RUN, idx, ts, (size_t)ts_len, desc, (size_t)desc_len); + } + if (log_id == UI_W_REC_LOG_SELFTEST) { + return syslog_get_record(SYSLOG_SELFTEST, idx, ts, (size_t)ts_len, desc, (size_t)desc_len); + } + return -1; +} + +static const ui_rec_reader_t s_rec_reader = { sim_rec_count, sim_rec_get }; + /* * 函数功能:无窗口离屏渲染(可注入键序列)并导出末帧像素 * 入口参数:keys - 键序列(u=上 d=下 l=左 r=右 e=确认 s=返回;空 = 不注键) const char * @@ -176,6 +210,9 @@ static int run_headless(const char * keys, const char * path, int standby) { * 使网口设置内容页显示与真机一致的工厂默认值 */ (void)net_cfg_load(); + /* task-6 记录 reader 注入(镜像 ui_task.c:先于 ui_menu_init,两端同形) */ + ui_w_records_bind(&s_rec_reader); + if (ui_menu_init() != 0) { return 1; } @@ -568,6 +605,9 @@ int main(int argc, char **argv) { (void)net_cfg_load(); /* 构建菜单 UI(与 MCU 端共用 ui_menu.c) */ + /* task-6 记录 reader 注入(镜像 ui_task.c:先于 ui_menu_init,两端同形) */ + ui_w_records_bind(&s_rec_reader); + if (ui_menu_init() != 0) { fprintf(stderr, "ui_menu_init failed\n"); SDL_Quit();