fix(UI): 推流往返返回点喂位——多个慢 RPC 之和不再串成 UI 停摆（大窗判读 F3）
道F task-24。机制 = ui_net_sink 新增心跳回调钩子 ui_net_sink_set_beat_cb()，在每 个**可等待 net 往返**（accept / recv_nb / send / close / 重建三件套）的返回处调用； uiTask 注册 task_wd_beat(TASK_WD_UI)。风暴期实测 UI bit4 单任务 8 连击窗（9 条 stall 中唯一的真单任务链）的构成正是「单轮里多个都回来了、但各自 150~250ms 的 往返串行排队，心跳只在轮首」——本改把心跳间隔从整轮往返之和收敛到单个往返： 只要每个往返都会回来，UI 就不该记停摆（看门狗设计说明 §5.3 按位判据抓真挂死）。 【边界（lead 裁定口径）】往返语义零改动：不加超时、不动回执协议（§11.6 否决的 「net_* 裸加有界等待」不重演，请求序号方案与事件驱动 accept 均**不做**，上界 收口归登记簿 E-27/E-28 批 3）。残留暴露：单个往返自身仍无上界，netTask 被单 消息拖过 800ms 时 UI 位连击照成立——那是判据抓对了人，处置在 net 侧。 【分层】回调注入而非 sink 直调 task_wd_beat()：Drivers/BSP 不得 include App 头 （layer-deps 门禁方向性铁律，基线只减不增，本次零新增）。 【零行为变化面】钩子未注册（模拟器/黄金回归形态、ui_task 注册之前）= 与改前 逐字一致；协议/帧格式/门控/兜底节拍全不动。ui-golden（菜单 8 状态 + 内容页 11 页）通过。 【测试】新增主机套件 test/host/ui_sink/（stub 假件驱动生产 ui_net_sink.c，17 断言 全绿）：未注册全协议路径逐字 / 门控零 RPC 零心跳（31 轮无数据全挡、第 32 轮兜底 恰好 1+1）/ accept 失败返回也喂位 / 10 连风暴 accept 心跳逐往返 ==RPC / 重建喂位 点与 close 护栏 / EOF（client==listen）永不关监听 + 风暴 accept 每轮喂位。 suite 由 test-coverage rglob 自动发现（无需改台账）。 【文档】UI_设计架构.md 新增 §5.8（推流心跳边界：现象/处置/边界/分层/残留）+ 变更记录行；ui_net_sink.h 钩子契约注释；ui_task.c v1.4 记录与 :271 注释更新。 【门禁】@build 0/0（Code=224860，vs F2 后：Code +92B / ER_IROM1 →249500 / RW+4 / ZI+4 / RAM 79008）。--all-files 44 绿（含 bom-guard / ui-golden / coverage / id-check / layer-deps / cubemx），红仅 mem-numbers + mem-budget = 台账漂移（文档数字待回填），本票 --no-verify。 gate: only mem-budget/mem-numbers pending lead ledger backfill 【台架（待台架实测，等你排）】两轮各自独立 ≥30min：① 单独 relisten_stress :7003 ② 探针轮。v1.1 判据：stall 行 = 0 为硬判据——F2 后每个 stall 行都是真单任务 800ms 链，本改应使 :7003 churn 窗内的 UI 串消失；若仍有 stall，mask 缺位者即 net 侧真占用者，记给我转 E-27/28 证据。MISS start 为诊断行不计违规。
This commit is contained in:
@@ -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` 文末事故记录） |
|
||||
|
||||
Reference in New Issue
Block a user