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:
@@ -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");
|
||||
|
||||
@@ -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);
|
||||
|
||||
@@ -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` 取值,页面零改动。
|
||||
|
||||
+1
-1
@@ -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` 看已还清 |
|
||||
|
||||
⚠ 增量拦截最容易误会的一点:**绿灯不等于没问题**,只等于"没有比上次更差"。
|
||||
每个增量拦截门禁的基线数字都写进它自己的文档,读那篇时第一眼看的就是"现在在册多少条"。
|
||||
|
||||
+10
-6
@@ -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 <App/...>` 这类写法不在管辖内(也违反 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 |
|
||||
|
||||
@@ -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)
|
||||
|
||||
@@ -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();
|
||||
|
||||
Reference in New Issue
Block a user