feat(ui-pages): SOE 记录页接 soe_store 只读遍历(类型 7/8 首次上屏)
ui_w_soe 组件(task-14 落)此前两端都没绑 reader,只能显示"无记录"空态。本批补齐三件事:
App 侧只读遍历、两端 reader 绑定、SOE 记录页与菜单注册。
App/log/soe_store 只读 API(Lead 已放行,本批独占这两个文件)
- soe_store_count() / soe_store_read(idx, soe_rec_t*):与 syslog_count /
syslog_get_record 同构——8 条一窗(512 B)整块读、命中窗口零 I/O、卷锁 try(0 超时)
非阻塞;定长记录逐条 open 等于同一扇区开 4 次,SPI NAND 上这个差距是肉眼可见的卡顿
- 读者不得看到半成品记录,三道保障缺一不可(规则写进 soe_store.h 头注,不只是提交信息):
① 条数只数整条 64 B 槽(写者留下的半条尾槽天然不计入);② 窗口代数:写者每次成功落盘 /
容量重建在**卷锁区间内**自增代数,读者比对填窗时记下的代数,不符即重填(对齐 32 位读写
在 ARM 上原子,跨任务无需临界区,最坏多读一轮);③ 单条硬门槛:soe_rec_parse() 校版本 +
校验和,撕裂/半写一律拒收
- 容忍的竞态只有一个:count 与 read 之间新落一条 → 本轮少看一条,下轮重绘(200 ms)自然
追上;所以边界一律用锁内重取的条数,不信调用方传进来的旧值
- API **不带类型掩码**(Lead 裁定 2026-10-25):5 个记录页怎么分组是界面语义,不进日志存储
层;环容量小、页渲染全扫无成本,真变大了再加带 mask 的优化 API(YAGNI)
⚠ 顺带修掉一颗定时炸弹:菜单生成器与生成物漂移
- 提交里的 Drivers/BSP/UI/ui_menu_tab.h 带着 5 个表查询 API 的规范注释块,而
tools/menu_gen/gen_menu.py 只会输出"声明 + 行尾短注释"——说明历史上有人**手改生成物**
补注释、没回灌生成器。我这次加 #page=soe 后重新生成,等于把那些注释抹掉,bsp-err 立刻
报 5 条 return-doc
- 修法不是把生成物改回去(下次重新生成还会再抹一次),而是把注释块**回灌进生成器**;
回灌后重跑 gen_menu.py 产出的 ui_menu_tab.h 与 HEAD **逐字节一致**(git diff 为空),
漂移关闭。生成物里的手工优化 = 一定会被覆盖的优化,要么进生成器要么别改生成物
时标口径(跨模块陷阱,注释即防线)
- 页面时标取记录内的 CP56(事件自己的时标,不是"现在")。它与运行/自检记录页同口径,靠两条
事实叠出来:sys_clock 的 epoch 域本身就是本地时间(App/util/sys_clock.h 的
sys_clock_set_unix 注明"Unix epoch time (秒,本地时间)"),而 soe_rec.c 的 epoch→CP56
分解不加任何时区偏移。**谁"顺手补 8 小时",SOE 页就会和文本记录页差 8 小时**;要引显式
时区必须两侧一起改
显示名回正:类型 7 用源词"未标定闭锁"
- 组件名字表里原写作"标定闭锁"——缩掉一个"未"字后意思可以读成"把标定闭锁了",与"因未标定
而闭锁"几乎相反;源词见 App/log/soe_rec.h 与"数据可信"卡 5,UI 表现层无权改写事实词
- 模拟器的 3 条假记录刻意含一条 type 7 + ELM_NONE(非元件支路):这是 7/8 两个新类型
**真的接上屏**的第一个像素级证据——只有主机断言时,名字表写错也照样一片绿
- 主机测试的宽度护栏随之按"画到哪一列"分列:动作/返回进值列(4 汉字 = 12 字节),其余类型
名进名列(7 汉字 = 21 字节);原来一刀切 12 字节会把正常名字判成违规
页面与注册
- 新建 Drivers/BSP/UI/ui_page_soe.{c,h}:薄跳板,一条记录两行共用组件内单条读盘缓存,
实例独立(两页共用一份缓存会互相命中对方记录号,task-6 的教训)
- 菜单树 SOE记录 加 #page=soe;重生成 4 个生成物,uvprojx / CMakeLists 两处注册由生成器
自动写入(本批 uvprojx 只含这一条新增,无 UV4 抖动)
- reader 绑定在两端适配层:真机 App/task/ui_task.c(CP56 → UI 视图 + 容量钳位),
模拟器 simulator/main.c(固定 3 条、时标固定串,保证黄金参考可复现)
两处被门禁当场抓住的记录(都是有效拦截,不是噪音)
- id-check 拦下注释里裸引"P2-10":编号引用必须可判定归属,代码注释也一样 → 改为指向
App/log/sys_log_mcu.c 与事实本身,不留裸编号
- 又一次 BOM 铁律现场复现:一次编辑剥掉 ui_w_soe.c 的 BOM,ARMCC 立刻报一串 #8/#7/#20
假语法错(missing closing quote 之类),而 MSVC 侧 0 警告完全照不出来;补回 EF BB BF
即 0/0。本批提交前逐文件比 HEAD 做了 BOM 漂移审计(临时脚本,不入库)——建议把这条
审计固化进 ui-verify skill 或门禁(不在本道写域,已回报 Lead)
验证
- @build:0 错误 0 警告;模拟器:0 警告
- 内容页回归 15 项 PASS:新增 soe 页 9 条文本断言(两条时标、过流Ⅰ段+动作、+返回、
未标定闭锁、页码),其余 11 页逐字节不变;菜单 8 状态 PASS、池 5368 B
- soe 页刷新黄金参考前出图肉眼确认:6 行两两成对、19 字符时标在 94 px 名列内不越屏、
非元件行的类型名落在名列且值列为空
- test/host/ui_data 83/83、test/host/soe 32/32;13 个代码/文档/注册类钩子(含
coding-standard、bsp-err、id-check、cppcheck、registration-check、layer-deps、
font-charset、doc-links)全 Passed
- 全量钩子红项只有同族三条:mem-numbers / mem-budget / size-gate(L0c),root cause 一条:
Flash/RAM 台账与同码凭证回填归单写者 → 本批 --no-verify
体积(相对 b746a1f 台账 Code 217204 / RO 21504 / RW 1256 / ZI 132680)
- 实测 Code 219712、RO 21388、RW 1288、ZI 134272 → Code +2508、RO −116、RW +32、ZI +1592
→ Flash 合计 +2424 B、RAM +1624 B(含本批之前的三页回炉)
- 本批新增里约 1064 B ZI 是 SOE 读窗口(512 B)+ static FIL(528 B),一次性投入、页面打开
才用得到;RAM 再紧张可把窗口降到 4 条(256 B)拿回一半,代价是跨窗记录多一次 I/O
待台架实测:真机 /log/soe.log 有记录时的翻页与尾部行为、卷忙时该行退化显示、SOE 页与文本
记录页时标一致性(跨 8 小时口径的现场核对)、记录增长时窗口代数失效后的重读节拍。
gate: only mem-budget/mem-numbers/size-gate pending lead ledger backfill
(同族三条,root cause 一条:台账与同码凭证回填归单写者)
像素基线单独提交(下一笔新增 simulator/tests/ref/shot_soe.bin):本笔单独 checkout 时
ui-golden 会报"缺参考",属预期拆分;上述钩子结论取自"本笔 + 下一笔"的合并树。
自查:BOM 漂移审计 17 个改动文件全对齐 HEAD;CR = 0;U+FFFD = 0;字面量纯 ASCII。
This commit is contained in:
@@ -48,6 +48,16 @@ static osMessageQueueId_t s_queue; /* 运行期队列(drain 首次调
|
||||
static const osMessageQueueAttr_t s_queue_attr = { .name = "soe" };
|
||||
|
||||
static volatile uint32_t s_seq; /* 单调序号(RAM 生命周期内;仅复位重置) */
|
||||
|
||||
/* 只读遍历(UI 记录页)用的读盘窗口,与 App/log/sys_log_mcu.c 读侧同构:
|
||||
* 定长记录按 8 条一窗整块取回(8 × 64 B = 512 B),命中窗口零 I/O;
|
||||
* 代数由写者在卷锁区间内自增,读者也在卷锁区间内采样代数 → 窗口不会跨写失效 */
|
||||
#define SOE_RD_WINDOW 8u
|
||||
static uint8_t s_rd_win[SOE_RD_WINDOW][SOE_REC_SIZE];
|
||||
static uint32_t s_rd_win_base;
|
||||
static uint32_t s_rd_win_cnt;
|
||||
static volatile uint32_t s_rd_gen; /* 写者落盘/重建次数(对齐 32 位读写在 ARM 上原子) */
|
||||
static uint32_t s_rd_win_gen;
|
||||
static volatile uint32_t s_drop_cnt; /* 丢弃计数(队列满/环满) */
|
||||
static uint32_t s_drop_logged; /* 丢弃留痕水位(drain 侧差值上报) */
|
||||
static uint8_t s_fault_reported; /* 写故障留痕去重(成功写复位) */
|
||||
@@ -164,6 +174,9 @@ static int s_soe_append(const uint8_t *rec) {
|
||||
? ((uint32_t)finfo.fsize / SOE_REC_SIZE) : 0u;
|
||||
if (cnt >= SOE_STORE_MAX) {
|
||||
(void)f_unlink(SOE_PATH);
|
||||
/* 代数自增(读者窗口失效):**unlink 当场就加**,不等写成功——文件已没了,
|
||||
* 旧窗口里那几条记录在任何索引上都不再存在,晚一步都会有读者按陈旧窗口读数 */
|
||||
s_rd_gen++;
|
||||
DBG_INFO("cap full, recreate " SOE_PATH);
|
||||
}
|
||||
|
||||
@@ -193,6 +206,7 @@ static int s_soe_append(const uint8_t *rec) {
|
||||
}
|
||||
if (rc == 0) {
|
||||
s_fault_reported = 0u;
|
||||
s_rd_gen++; /* 落盘成功 → 读者窗口作废(在卷锁区间内自增,与读者同锁同调) */
|
||||
} else if (s_fault_reported == 0u) {
|
||||
s_fault_reported = 1u;
|
||||
DBG_ERROR("write " SOE_PATH " fail (%d)", (int)fr);
|
||||
@@ -254,3 +268,121 @@ void soe_store_drain(void) {
|
||||
uint32_t soe_store_dropped(void) {
|
||||
return s_drop_cnt;
|
||||
}
|
||||
/* ========================= 只读遍历(UI 记录页) ============================ */
|
||||
/*
|
||||
* 函数功能:已落盘的 SOE 记录条数(= filesize / SOE_REC_SIZE,O(1))
|
||||
* 入口参数:无
|
||||
* 返回值:条数;文件缺失、未挂载或 f_stat 失败返回 0 uint32_t
|
||||
* 限定条件:任意任务上下文可调(uiTask 的 SOE 记录页用);只做 f_stat,不取卷锁
|
||||
* ——与 App/log/sys_log_mcu.c 的 syslog_count() 同一口径,不另起第二套
|
||||
* 函数说明:条数按**整条 64 B 槽**相除,写者留下的半条尾槽天然不计入,这是
|
||||
* "读者看不到半成品记录"的第一道保障(另两道见 soe_store_read 头注)
|
||||
*/
|
||||
uint32_t soe_store_count(void) {
|
||||
FILINFO finfo;
|
||||
|
||||
if (f_stat(SOE_PATH, &finfo) != FR_OK) {
|
||||
return 0u;
|
||||
}
|
||||
return (uint32_t)finfo.fsize / SOE_REC_SIZE;
|
||||
}
|
||||
|
||||
/*
|
||||
* 函数功能:把包含 idx 的那一窗(最多 8 条)整块读进 RAM 并取出目标记录
|
||||
* 入口参数:idx - 记录序号 uint32_t(调用方已保证 < count)
|
||||
* p_rec - 目标记录输出(SOE_REC_SIZE 字节) uint8_t *
|
||||
* 返回值:0 - 成功;-1 - 卷忙 / 越界 / 打开定位读失败 / 短读 int
|
||||
* 限定条件:内部函数;卷锁 try 语义(0 超时),拿不到锁立即返回不阻塞
|
||||
* 函数说明:定长记录一次取 8 条(8 × 64 B = 512 B)而不是逐条 open/read:一页 8 行
|
||||
* = 4 条记录,逐条读等于同一扇区 open 四次。记录页只在开页与翻页时重算,命中
|
||||
* 窗口即零 I/O——整套"窗口 + 代数 + try 锁"结论与 App/log/sys_log_mcu.c 读侧
|
||||
* 同源,刻意不另起第二套读盘路径(两套读盘规则必然漂移,是本仓反复在防的)
|
||||
*/
|
||||
static int s_rd_fill(uint32_t idx, uint8_t *p_rec) {
|
||||
static FIL f; /* static:FF_FS_TINY=0 → FIL=528 B 栈;
|
||||
* open~close 全程在卷锁区间内,跨任务由卷锁串行化 */
|
||||
FRESULT fr;
|
||||
UINT br = 0u;
|
||||
uint32_t total;
|
||||
uint32_t base;
|
||||
uint32_t want;
|
||||
|
||||
if (vol_lock_wait(0u) == 0u) {
|
||||
return -1; /* 卷忙不是故障:uiTask 下一轮重绘自然重试 */
|
||||
}
|
||||
/* 等锁期间写者可能已推进(甚至已 unlink 重建)→ 锁内重新取条数再校验边界 */
|
||||
total = soe_store_count();
|
||||
if ((total == 0u) || (idx >= total)) {
|
||||
vol_lock_release();
|
||||
return -1;
|
||||
}
|
||||
base = (idx / SOE_RD_WINDOW) * SOE_RD_WINDOW;
|
||||
want = total - base;
|
||||
if (want > SOE_RD_WINDOW) {
|
||||
want = SOE_RD_WINDOW;
|
||||
}
|
||||
fr = f_open(&f, SOE_PATH, FA_READ);
|
||||
if (fr == FR_OK) {
|
||||
fr = f_lseek(&f, (FSIZE_t)base * SOE_REC_SIZE);
|
||||
if (fr == FR_OK) {
|
||||
fr = f_read(&f, s_rd_win, want * SOE_REC_SIZE, &br);
|
||||
}
|
||||
(void)f_close(&f);
|
||||
}
|
||||
if ((fr != FR_OK) || (br != (UINT)(want * SOE_REC_SIZE))) {
|
||||
s_rd_win_cnt = 0u; /* 作废窗口:坏窗口留着会让后续行继续读到垃圾 */
|
||||
s_rd_win_gen = 0u;
|
||||
vol_lock_release();
|
||||
return -1;
|
||||
}
|
||||
s_rd_win_base = base;
|
||||
s_rd_win_cnt = want;
|
||||
/* 代数在**卷锁区间内**采样:写者也只在持锁时自增,二者同侧 → 窗口与代数一致 */
|
||||
s_rd_win_gen = s_rd_gen;
|
||||
vol_lock_release();
|
||||
|
||||
(void)memcpy(p_rec, (const uint8_t *)s_rd_win + ((size_t)(idx - base) * SOE_REC_SIZE),
|
||||
SOE_REC_SIZE);
|
||||
return 0;
|
||||
}
|
||||
|
||||
/*
|
||||
* 函数功能:读取第 idx 条 SOE 记录(解析后的结构体;idx 0 = 最早一条)
|
||||
* 入口参数:idx - 记录序号 uint32_t
|
||||
* p_out - 输出(不可为 NULL) soe_rec_t *
|
||||
* 返回值:0 - 成功;-1 - p_out 为空 / 越界 / 卷忙 / I/O 失败 / 记录校验不过 int
|
||||
* 限定条件:uiTask 上下文(记录页逐行取数);**不阻塞**——卷忙立即 -1,页面这行
|
||||
* 退化显示"读失败",下一轮重绘再试;SOE 页坏不得拖住主界面节拍
|
||||
* 函数说明:读者不得看到半成品记录,三道保障缺一不可:
|
||||
* ① count 只数整条 64 B 槽(半条尾槽不计入);
|
||||
* ② 窗口代数:写者每次成功落盘/重建在卷锁区间内自增 s_rd_gen,读者
|
||||
* 比对填充时记下的代数,不匹配即重填——对齐 32 位读写在 ARM 上原子,
|
||||
* 跨任务无需临界区,最坏多读一轮(同 syslog 读侧结论);
|
||||
* ③ 单条硬门槛:soe_rec_parse() 校版本 + 校验和,撕裂/半写一律 -3 拒收。
|
||||
* count 与 read 之间新落一条的竞态**容忍**为"本次遍历少看到一条"
|
||||
* (200 ms 重绘自然追上),绝不容忍读到半条——所以边界一律以锁内
|
||||
* 重取到的 total 为准,不用调用方传进来的旧 total。
|
||||
* soe_rec_parse 的 -1/-2/-3 在本 API 折成一个 -1:调用方(UI)对三者
|
||||
* 的处理完全相同(这行显示读不到),把内部码外溢只会诱导页面写死分支
|
||||
*/
|
||||
int soe_store_read(uint32_t idx, soe_rec_t *p_out) {
|
||||
uint8_t rec[SOE_REC_SIZE];
|
||||
|
||||
if (p_out == NULL) {
|
||||
return -1;
|
||||
}
|
||||
/* 快路径:同代数且落在窗口内 → 零 I/O(代数比较用无锁读,最坏多刷一轮) */
|
||||
if ((s_rd_win_cnt != 0u) && (s_rd_win_gen == s_rd_gen) &&
|
||||
(idx >= s_rd_win_base) && (idx < s_rd_win_base + s_rd_win_cnt)) {
|
||||
(void)memcpy(rec, (const uint8_t *)s_rd_win
|
||||
+ ((size_t)(idx - s_rd_win_base) * SOE_REC_SIZE), SOE_REC_SIZE);
|
||||
} else if (s_rd_fill(idx, rec) != 0) {
|
||||
return -1;
|
||||
} else {
|
||||
/* 窗口未命中的分支已在 s_rd_fill 里完成取数与校验,这里不重复读盘 */
|
||||
}
|
||||
if (soe_rec_parse(rec, p_out) != 0) {
|
||||
return -1;
|
||||
}
|
||||
return 0;
|
||||
}
|
||||
|
||||
Reference in New Issue
Block a user