merge: task/uibound-wait 合入 v2-on-ui

任务 uibound(1 个提交)经 task-worktree 回收:
- fix(UI): 推流往返返回点喂位——多个慢 RPC 之和不再串成 UI 停摆(大窗判读 F3)
This commit is contained in:
2026-10-25 18:42:56 +08:00
12 changed files with 505 additions and 2 deletions
+23
View File
@@ -267,6 +267,28 @@ ENTER/→ 进子框:
- 主循环若再 `SDL_PollEvent`,会**先消费**事件队列 → 驱动定时器轮询时队列已空 → 键盘全部失效
- 关窗退出由驱动 `LV_SDL_DIRECT_EXIT=1` 自动 `exit(0)`,主循环无需处理 SDL_QUIT
### 5.8 推流往返的心跳边界(F3,2026-10-25 大窗判读)
- **现象**:netTask 监听重建风暴期,`ui_net_sink_poll()` 内「单个可等待往返都回来了、
但一轮里串了好几个」,把 uiTask 两次心跳之间的间隔顶过 800ms——看门狗按位连击
判据(`docs/子系统设计/看门狗设计说明.md` §5.3)抓到 bit4 单任务 8 连击窗
(2026-10-25 台架实测,uisn=154ms 仍在段内样本,`:7003` churn 与探针重建并发叠加)。
- **处置(本票 = 心跳面)**:`ui_net_sink_set_beat_cb()` 回调注入——sink 在每次
accept / recv_nb / send / close / 重建三件套的**返回处**调用钩子,uiTask 注册
`task_wd_beat(TASK_WD_UI)`。效果 = 心跳间隔从「整轮往返之和」收敛到「单个往返」;
只要每次往返都会回来,UI 就不该被记停摆。往返本身**不改**(有界化/请求序号 =
`docs/任务规划/README.md` 的 E-27/E-28 跨上下文收口,批 3;§11.6 否决过的
「给 net_* 裸加超时」不重演)。
- **分层**:Drivers/BSP 不得 include App 头(layer-deps),故心跳经回调注入而非直调;
钩子内只做置位类动作、不阻塞(契约写在 `Drivers/BSP/UI/ui_net_sink.h`)。
- **零行为变化面**:钩子未注册(模拟器 / 黄金回归 / start 之前)= 与 F3 之前逐字一致;
协议、帧格式、门控、兜底节拍全部不动。回归钉 = `test/host/ui_sink/`(17 断言:
未注册全协议路径 / 门控零 RPC 零心跳 / 每往返恰好一次心跳 / 重建与 EOF 的 close
护栏不变)。
- **残留暴露**(刻意不归本票):单个往返自身仍无上界(osMessageQueuePut(osWaitForever)
+ xTaskNotifyWait(portMAX_DELAY)),netTask 若被单消息拖 >800ms,UI 位连击照成立——
那是「判据抓对了人」,处置在 net 侧(E-27/E-28),不在心跳侧。
## 六、变更记录(简表)
| 日期 | 变更 |
@@ -285,4 +307,5 @@ ENTER/→ 进子框:
| 2026-09-09 | 用户密钥密码页落地(首个表单/操作页,§4.7 / `内容页架构.md` §4.1):框架描述符新增 title_y/hide_deco/hide_footer/key_intercept + 新 API `ui_content_page_invalidate`;新模块 `ui_page_password`(3 数字框反显光标 + arm API);菜单受保护叶子路由(arm→开密码页,确认一致后回调**先关页再续做进入动作**);字体 97→102 汉字(198 字形);双端注册;回归扩至 7 页 + 往返水位,五门禁全绿 |
| 2026-09-10 | 网口设置内容页(§4.7 / `内容页架构.md`):新增 `Drivers/BSP/NETCFG`(Flash 持久化 + CRC-16,工厂默认 192.168.1.100/24)+ 页面插件 `ui_page_net_cfg`(5 行动态值 + 可编辑:↑↓调字节/←→移光标/ENTER 确认,保存行 ENTER → `net_cfg_save` 下次上电生效);框架新增钩子 `init_cb` + API `ui_content_page_selected_row`;`net_init` 增 `mac` 参数、netTask 等 `SYS_EVT_STORAGE_READY` → `net_cfg_load` → `net_init(ip,mask,gw,mac)` → 回写实际 MAC 影子;字体 102→111 字符(208 字形,修复低码位符号丢失);双端注册;回归扩至 11 页,五门禁全绿 |
| 2026-09-14 | 运行记录/自检记录内容页 + 待机显示模块:新增 `App/log/sys_log`(定长 64B 文本记录引擎,MCU 落 NAND `/log/run.log`、`/log/selftest.log`,FTP 可直下)+ 页面插件 `ui_page_runlog` / `ui_page_selftest`(动态列表:count_cb + refresh,每条 2 行时间戳/描述)+ `ui_standby`(空闲超时自动切待机屏,仅确认键回菜单);密码页错误提示"密码输入错误"+清空重输;字体 111→122 字(217 字形);详见 `docs/子系统设计/运行与自检记录设计说明.md` |
| 2026-10-25 | **F3 推流心跳边界(§5.8)**:`ui_net_sink_set_beat_cb()` 回调注入,accept/recv_nb/send/close/重建三件套返回处喂 UI 心跳(2026-10-25 大窗 bit4 8 连击实证:单轮多慢往返之和串成 800ms 缺席);往返语义不改(上界归 E-27/E-28);未注册 = 零行为变化(模拟器/黄金回归形态);新增 `test/host/ui_sink/` 主机套件 17 断言 |
| 2026-10-25 | 字库扩充(页面扩充规划预置字 +60,含罗马数字 Ⅰ/Ⅱ/Ⅲ):默认字体升至 179 字符/274 字形,像素基线不变,ROM +1,528 B、RAM 0;修复生成器 `make_font.py` 的 cmap 插入顺序缺陷——LVGL `get_glyph_dsc_id()` 线性扫描首个包含即返回,补回字形(▶)单码位条目被下探后的宽稀疏 range 吞掉即全渲染方框,现按首命中语义插位/守卫/校验(详见 `docs/UI设计/UI_中文字体生成与配置.md` 文末事故记录) |