diff --git a/docs/README.md b/docs/README.md index e820b443..aa235f2b 100644 --- a/docs/README.md +++ b/docs/README.md @@ -237,7 +237,8 @@ docs/ | [`LVGL模拟器部署与使用说明.md`](UI设计/LVGL模拟器部署与使用说明.md) | PC 端 LVGL 模拟器部署与使用 | | [`RemoDispBus协议与接收设计说明.md`](UI设计/RemoDispBus协议与接收设计说明.md) | 远端显示总线协议与接收设计 | | [`页面补齐规划.md`](UI设计/页面补齐规划.md) | 内容页现状:43 节点 / 30 叶 / 已绑 27,逐页形态与数据来源,未绑三叶的原因 | -| [`UI_数据供给设计说明.md`](UI设计/UI_数据供给设计说明.md) | 页面实时数据的高内聚低耦合方案:快照推送(rt/par 双通道)、写路径、记录 reader 注入(2026-10-23) | +| [`UI_数据供给设计.md`](UI设计/UI_数据供给设计.md) | App→UI 数据供给架构权威:三快照帧契约(rt/par/info)+ 注入执行侧(定值写/维护/遥测整定/通讯/录波/记录/SOE)、并发模型、测试策略 | +| [`UI_时间响应分析.md`](UI设计/UI_时间响应分析.md) | **UI 时间账的唯一权威**:一次界面变化分五段各花多少、屏内 LVGL 绘制(含脏区短路机制)、两个出口(屏板串口 60.1 ms 物理常数 / 远端推流阻塞缺陷)、按键全链路耗时、测量缺口、数字性质三标签(真值 / 历史极值 / 推算);**§5 = 「61.3 ms 是 LVGL 渲染地板」两处误归因的裁定** | | [`页面扩充详细方案.md`](UI设计/页面扩充详细方案.md) | 27 个空叶子 + 3 页回炉的逐页方案:行表、数据源、组件、分批与预算(2026-10-23) | | `mockups/` | 各页面参考图与说明 | diff --git a/docs/UI设计/UI_时间响应分析.md b/docs/UI设计/UI_时间响应分析.md new file mode 100644 index 00000000..cc980b92 --- /dev/null +++ b/docs/UI设计/UI_时间响应分析.md @@ -0,0 +1,297 @@ +# UI 时间响应分析 + +> **这篇文档回答什么**:一次界面变化,从"事件发生"到"用户看见",中间每一段各花多少时间、这个数字是怎么测出来的、哪些数字可信哪些不可信。 +> +> **这篇文档不回答什么**:屏板串口帧格式与时序协议的细节见 `docs/子系统设计/屏板链路设计.md`;`[PROF]` 探针本身的字段定义见该文与 `docs/子系统设计/看门狗设计说明.md` 第 11.4 节;页面怎么画见 `docs/UI设计/内容页架构.md`。 + +**先读这一段,后面才好读**:本仓的 UI 有两个物理出口——一是**屏板**(`USART1` + 自定义帧,700 kbaud),二是**远端推流**(以太网 `:7003`,给 PC 端查看器)。两个出口的耗时特征完全不同,容易混为一谈。用户体感到的"慢"绝大多数发生在**出口**,不是发生在这块 MCU 画界面的过程中。本文把他们分开算。 + +--- + +## 1. 一次界面变化的时间都花在哪 + +**你需要知道**:任何一次"画面变了",时间都花在下面五段之一;排查慢的时候先定位是哪一段,不要一上来就怀疑 LVGL。 + +``` +① 事件产生 ──► ② 数据到 UI ──► ③ LVGL 绘制 ──► ④ 出口 ──► ⑤ 用户看见 + (按键/阈值) (快照层) (脏区渲染) (屏板串口 / 推流) +``` + +| 段 | 谁在做 | 触发方式 | 本文对应章节 | +|---|---|---|---| +| ① 事件产生 | 屏板中断(按键)、adcTask(数据变化) | 异步 | 第 3 节 | +| ② 数据到 UI | `ui_data_feed_tick()` | uiTask 每圈,内部 200 ms 自分频 | 第 2 节 | +| ③ LVGL 绘制 | `lv_timer_handler()` / `lv_refr_now()` | 20 ms 刷新定时器,或注键时同步立即 | 第 2、3 节 | +| ④ 出口 | `sb_link_frame_update()`(屏板)/ `ui_net_sink_poll()`(推流) | 每圈 / 有变化才组帧 | 第 4 节 | +| ⑤ 用户看见 | 屏板固件显示 / PC 端解码 | 异步 | 第 4 节 | + +**一句话结论**:在本仓实测数据里,③ LVGL 绘制从未成为瓶颈;④ 出口里**屏板串口**是 60 ms 量级的恒定成本(物理传输,绕不过去),**远端推流**则可能因为 `portMAX_DELAY` 阻塞到 100 ms 量级(这是缺陷,不是物理限制)。 + +--- + +## 2. 屏内耗时:LVGL 绘制与刷新 + +**你需要知道**:LVGL 在这块板上的稳态稳态开销是**每圈 11 ms 的循环周期**,其中绝大部分不是画图。判断"渲染是不是瓶颈",看 `uil` 这一个数就够了。 + +### 2.1 配置与缓冲布局 + +| 项 | 值 | 出处 | +|---|---|---| +| 颜色深度 | `LV_COLOR_DEPTH 1`(单色,1 bpp) | `Lib/lv_conf.h` | +| 刷新周期 | `LV_DEF_REFR_PERIOD 20`(ms) | `Lib/lv_conf.h` | +| LVGL 堆 | `LV_MEM_SIZE (16 * 1024)` | `Lib/lv_conf.h` | +| 绘制缓冲 | `UI_DRAW_BUF_SIZE` = `UI_FB_SIZE + UI_DRAW_BUF_PALETTE` = 3200 + 8 = **3208 B** | `Drivers/BSP/UI/ui_port.h` | +| 渲染模式 | `LV_DISPLAY_RENDER_MODE_FULL`(整帧渲染) | `Drivers/BSP/UI/ui_port.c` 的 `ui_port_init()` | +| 缓冲个数 | 单缓冲(第二参数为 `NULL`) | 同上 | +| 任务节拍 | `UI_TASK_TICK_MS 10`(uiTask 每圈 `osDelay(10)`) | `Drivers/BSP/UI/ui_tokens.h` | + +**这 8 字节 palette 头不是可有可无的**:I1 格式的绘制缓冲头部有 8 字节调色板,flush 回调里取像素必须用 `color_p + UI_DRAW_BUF_PALETTE`。漏掉它就会整帧错位 8 像素、并在尾部越界。这是本仓踩过的实证坑。 + +### 2.2 无变化时不绘制:LVGL 的脏区短路 + +**这是理解"为什么稳态不慢"的关键机制。** + +`lv_display_refr_timer()`(在 `Lib/lvgl/src/core/lv_refr.c`)的执行顺序是: + +1. `lv_obj_update_layout()` —— 只有 `scr_layout_inv` 被置位才真正重算布局,否则立即返回; +2. 合并/同步脏区; +3. **`if(disp_refr->inv_p == 0) goto refr_finish;`** —— **一个脏区都没有就直接结束,不绘制、不 flush**。 + +`lv_obj_update_layout()` 本身(在 `Lib/lvgl/src/core/lv_obj_pos.c`)是一个 `while(scr->scr_layout_inv)` 循环:没有布局失效,第一轮判断就退出。 + +**含义**:界面静止时,20 ms 一次的刷新定时器几乎不花时间。所以"画面没变也慢"这个现象,原因一定不在 LVGL 绘制。 + +### 2.3 脏区策略(已做过的优化) + +| 场景 | 做法 | 代价 | +|---|---|---| +| 菜单选中行上下移动、且未触发滚动 | `view_apply_sel()` 只失效新旧两行所在的竖带(`lv_obj_invalidate_area(box, &band)`) | 无效区域 = 2 × `MENU_ROW_H`(15) 高 | +| 菜单滚动、或首次绘制 | `lv_obj_invalidate(box)` 整框兜底 | 整个列表区域重绘 | +| 内容页任何变化 | 整页失效(`lv_obj_invalidate(s_cont)`) | 整页重绘 | + +**注意一个易错点**:即使脏区只有两行,**flush 回调拿到的仍是整帧**。因为在 `LV_DISPLAY_RENDER_MODE_FULL` 下,LVGL 把整个屏幕渲染进这个 3208 B 缓冲,`ui_flush_cb` 里那句 `memcpy(g_ui_fbuf, color_p + UI_DRAW_BUF_PALETTE, UI_FB_SIZE)` **固定拷贝 3200 B**。所以"局部失效省的是绘制时间,不省拷贝时间"。3200 B 的 `memcpy` 在 168 MHz 上属于微秒到几十微秒量级。 + +### 2.4 实测数字 + +采样条件:**本机开机后约 42 s,屏板在连,无远端客户端,无按键**(会随场景变化,务必连条件一起引用)。 + +| 指标 | 值 | 性质 | +|---|---|---| +| `uil`(uiTask 循环周期**最近值**) | **中位 11.0 ms / p99 20.0 ms**(约 2.4 万个样本) | **真值**,长期稳定 | +| `uip`(循环周期**开机以来最坏值**) | 170.0~221.9 ms(**随运行时间继续爬升**) | **历史极值,不是基线** | +| `uiw`(单轮工作**最坏值**,不含 `osDelay`) | 138.2 ms | **历史极值** | +| 组帧耗时 `[SBLINK] us=` | **中位 509 µs / p99 704 µs / 最大 893 µs**(9599 样本) | **真值**,长期稳定(机制与预算见 `屏板链路设计.md`) | + +**`uil` 的分布比它的瞬时值更有说服力**:约 2.4 万个样本的中位数是 11.0 ms,p99 是 20.0 ms。也就是说 99% 的循环在 20 ms 内完成——**这是"渲染不可能是瓶颈"最硬的证据**,因为它统计的是整圈周期,而不是某一次的读数。 + +**`uip` 为什么不能当基线**:它是"开机以来最大值"这个单调上升的统计量。实测同一台机器,早先快照读到 170.0 ms,随后又读到 221.9 ms,还会继续涨。任何把它当稳态周期引用的写法都会立刻过期。 + +**为什么 `uil ≈ 11.0 ms` 就能反证渲染不是瓶颈**:uiTask 每圈 `osDelay(10)`,加上实际工作,周期中位数是 11.0 ms。如果 LVGL 每帧真花 61 ms,这个数不可能是 11。这是"从已知推已知",比没有探针就下结论可靠得多。 + +--- + +## 3. 按键到可见的一条完整路径 + +**你需要知道**:按键响应是本仓唯一能直接度量"用户体感"的场景,它的每一段耗时都有实测或明确上界。 + +### 3.1 屏板侧(本地屏) + +| 段 | 量值 | 性质 | 依据 | +|---|---|---|---| +| 召唤 → 下一拍 uiTask 取走 | ≤ 10 ms | 上界(节拍决定) | `UI_TASK_TICK_MS = 10` | +| 注键 + 同步重绘(`ui_port_service_keys()` 内 `lv_refr_now()`) | **未实测** | **测量缺口**,见第 6 节 | — | +| 组帧 | 中位 509 µs / p99 704 µs / 最大 893 µs | 真值 | `[SBLINK] us=` 字段统计 | +| 放行(TIM3 1 kHz 节拍) | ≤ 1 ms | 上界 | TIM3 周期 1 ms | +| 线上传输 | **60.1 ms** | 真值(计算值,可闭合) | 4208 B × 10 bit ÷ 700 kbaud | +| **合计** | **≥ 71 ms,上界未知** | 见下方说明 | — | + +**线上 60.1 ms 是怎么来的、为什么绕不过去**:帧 B 全长 `SB_FRAME_B_LEN = 4208` 字节(点阵 3200 B + 帧头/校验/填充),每字节 10 bit(8 数据 + 起始 + 停止),波特率 `SB_LINK_BAUD = 700000`。`4208 × 10 ÷ 700000 = 60.1 ms`。只要帧长和波特率不变,这个数就是常数。它与 MCU 画得快不快**完全无关**,而且**不阻塞 uiTask**(DMA 后台发送)。 + +**关于"注键 + 重绘"这一段**:它目前**没有独立探针**。旧文档里曾写"换页地板 61.3 ms",那是误归因,已经在本文第 5 节更正。 + +### 3.2 远端推流侧 + +**这一段的数据来自 `docs/测试说明/专项验证/链路延迟测试说明.md` 第 7 节**。那份文档是链路时延的权威出处,本节只取与 UI 时间账相关的结论,**推导、实验设计与芯片机理不在本文重复**。 + +| 段 | 量值 | 性质 | 依据 | +|---|---|---|---| +| 请求拾取(uiTask 10 ms 拍 + netTask 调度) | 2.3 ms | 真值 | 链路延迟测试说明 第 7.1 节 | +| MCU 净处理(取 1bpp + 组帧 + `net_send` 四分块) | **6.7 ms** | 真值 | 同上 | +| 芯片协议栈 → 线上 → PC | 52.6 ms | 真值(其中大部分是 Windows 延迟 ACK 在等帧尾) | 同上 | +| **完整帧周期** | **61.6 ms** | 真值 | 同上 | + +**这三段相加闭合到 61.6 ms**,因此 **MCU 侧只占 6.7 ms**——即使把 UI 渲染优化到零,这一路也只能快 6.7 ms 以内,剩下 54.9 ms 全在别处。 + +**那 52.6 ms 为什么不是设备的错**:帧长 3209 B = 3×1024 + 137 B,最后那 137 B 是不满 MSS 的尾段,被芯片的 Nagle 行为扣住等对端 ACK,而 Windows 的延迟 ACK 让这个 ACK 晚到约 50 ms。该文第 7.3 节用四组带内实验确认了这一点,第 7.4 节给出解法且**生产客户端已实装**(关延迟 ACK 后帧耗时降到 20.7 ms)。本文不重复实验细节。 + +**对 UI 的启示**:这条出口的延迟主体在客户端与芯片,**不在 LVGL**。UI 侧无论怎么优化都动不了这里的 52.6 ms。 + +--- + +## 4. 两个出口的对比 + +**你需要知道**:屏板和推流不是"两个选项",是**同时存在、互不替代**的两条下行路径。它们的瓶颈位置完全不同。 + +| 维度 | 屏板(`USART1`) | 远端推流(`:7003`) | +|---|---|---| +| 物理介质 | 串口 700 kbaud | 以太网 | +| 每帧字节 | 4208 B | 3209 B | +| 单帧线上时间 | **60.1 ms**(物理常数) | 61.6 ms(其中 52.6 ms 是 PC 侧 ACK 等待) | +| MCU 侧占用 | 组帧 509 µs(DMA 发送,不阻塞) | 6.7 ms | +| 是否阻塞 uiTask | **否**(`s_tx_busy` 忙则直接返回 `BSP_ERR_BUSY`) | **是**,见 4.1 | +| 帧率上限 | 约 16 帧/s(60 ms/帧) | 取决于阻塞情况 | + +### 4.1 远端推流为什么会阻塞 uiTask —— 一个真实存在的缺陷 + +**这是本仓 UI 响应最危险的已知问题**,比"渲染慢"重要得多。 + +`Drivers/BSP/UI/ui_net_sink.c` 的 `ui_net_sink_poll()` 由 uiTask 每圈调用。当没有远端客户端在连时,它每圈都调 `net_accept()`。 + +而 `Drivers/BSP/NET/net_socket.c` 的 `net_accept()` 是**同步阻塞式**的: + +- 先 `osMessageQueuePut(s_net_msg_queue, &msg, 0, osWaitForever)` 把请求塞给 netTask; +- 再 `net_wait_result("acc", sockfd)` 等回执; +- `net_wait_result()` 内部先零等待试取一次,取不到就 `xTaskNotifyWait(0xFFFFFFFFU, 0xFFFFFFFFU, &v, portMAX_DELAY)` —— **无限期阻塞**。 + +**后果**:uiTask 在这一步上可以停住几十到上百毫秒。实测证据: + +| 字段 | 值 | 含义 | +|---|---|---| +| `uis`(推流往返最坏值) | **117.0 ms** | 开机以来,这一段最长堵了 117 ms | +| `uiw`(单轮工作最坏值) | 138.2 ms | 其中 `uis` 占大头 | +| 开机第一行 | `uis=92808 uisn=92984` | 开机时就堵过 92.8 ms | + +**`uis` 与 `uiw` 的 85% 关系要谨慎引用**:这两个数是**各自独立的最大值**,不在同一拍发生,只能说"量级上是主因",不能说"某一拍的 85% 花在推流上"。 + +### 4.2 当前实测快照 + +采样条件:本机开机后约 42 s,屏板在连,无远端客户端,无按键。下面两行是本文引用时日志里的**原文**(日志持续滚动,这些数会变,引用时请连采集条件一起引): + +``` +[PROF] t=42330678 uic=3722345 uip=169963 uipn=12338 uil=11000 uiw=138183 uis=116986 uisn=0 +[SBLINK] tx=150894 done=150894 drop=7 kerr=0 abor=0 fb=119062 bad=0 us=509 max=116709 kq=0 off=0 dfok=0 dfold=0 +``` + +开机第一行(`t=140577`)为 `uip=119507 uiw=93518 uis=92808 uisn=92984`:`uisn` 非 0 说明那一刻仍在推流段内、尚未结算,所以它与 `uis` 同时非零,代表开机期发生了多次推流往返。 + +`dfok=0 dfold=0 kq=0` 说明**开机至今一次按键都没有发生过**,换页/选中移动这条路径在本机从未被真实触发过。任何关于按键响应延迟的实测结论,在没有按键的情况下都不成立。 + +--- + +## 5. 三处需要更正的误归因 + +**你需要知道**:本文写作过程中发现三处既有文档把数字归到了错误的来源上,这里给出裁定,避免后来的人继续引用错误结论。 + +- **5.1~5.4**:`61.3 ms` 被当成 "LVGL 整帧渲染"(两处文档,同一个数不同错法) +- **5.5**:`渲染只占约 1ms` 由合并指标倒推单项,方向对但推导不成立 + +### 5.1 事实认定 + +`61.6 ms` 在本仓有明确出处,且唯一:`docs/测试说明/专项验证/链路延迟测试说明.md` 第 7.1 节,它是**远端推流 `:7003` 的 PC 端帧周期**。该节有完整的四段分解并闭合: + +``` +客户端发 9B LCDMEM 请求 + T+2.3ms 请求拾取 + T+9.6ms 首字节到达(MCU 净处理 6.7ms) + T+61.6ms 全帧收齐 —— 最后的 137B 尾巴比前三批晚 52.6ms +``` + +慢的那 52.6 ms 是 **Windows 延迟 ACK** 在等帧尾,与 LVGL 渲染、与 MCU 都没有关系。 + +### 5.2 两处错误引用 + +| 文档 | 原文 | 问题 | +|---|---|---| +| `docs/子系统设计/看门狗设计说明.md` 第 11.4 节 | `uip` 基线 "**61.3 ms** / 10.0 ms——⚠ 地板是 **LVGL 整帧渲染**(独立实测帧周期 61.6 ms),**与网络无关**" | 把推流的 PC 端帧周期说成了 LVGL 渲染周期,结论正好反了 | +| `docs/子系统设计/屏板链路设计.md` 第 7.1 节 | "注键 + 重绘:选中移动几 ms;**换页地板 61.3 ms**" | 同一个数字,换了个错误归因 | + +**61.3 与 61.6 只差 0.3 ms,这个巧合是致错的源头。** + +### 5.3 为什么可以断定 61.3 ms 不是 LVGL 渲染 + +三条独立证据: + +1. **`uil` 的中位数是 11.0 ms、p99 是 20.0 ms**(约 2.4 万个样本)。uiTask 循环周期表征的是"一整圈"的耗时,LVGL 每帧若真占 61 ms,这 99% 的循环不可能都在 20 ms 内完成。 +2. **`uip` 是"开机以来最大值"这个单调上升的统计量**,实测随运行时间从 170.0 ms 爬到 221.9 ms。把它某一次的读数当作"渲染地板",等于把一个还在涨的历史极值当成了物理常数。 +3. **`dfok=0 dfold=0 kq=0`**。本机至今 0 次按键,换页路径从未被触发过,"换页地板"这个数在本机根本测不出来。 + +### 5.4 处置 + +- `看门狗设计说明.md` 第 11.4 节、`屏板链路设计.md` 第 7.1 节的错误归因**已在同笔修正**,具体口径以本文为准。 +- "典型合计 ≈70–135 ms" 这个区间同样要撤回:它的下沿来自未实测的"几 ms",上沿来自已证伪的 61.3 ms,两头都不成立。 + +### 5.5 第三处:「LVGL 渲染只占约 1 ms/帧」是合并指标倒推单项 + +`docs/测试说明/专项验证/链路延迟测试说明.md` 的分段表和 `App/task/ui_task.c` 里 `ui_loop` 探针的注释都说"渲染 ≈ 1 ms/帧",推导是: + +> uiTask 周期 10986 µs = `osDelay(10)` 的 10000 µs + 渲染开销 ≈ 986 µs + +**方向是对的**(渲染确实不是瓶颈),**但把 986 µs 整个扣给渲染并不成立**。看 `ui_task_func` 的实际结构就清楚:这一圈里除了 LVGL,还有 + +- `ui_data_feed_tick()` 数据装配 +- `sb_link_frame_update()` 组帧(内容变了才组,但 `memcmp` 是每圈都付) +- `task_wd_beat()` 心跳 +- `ui_net_sink_poll()` 推流轮询 +- `sb_link_poll()` 链路轮询 + +**这 986 µs 是上述全部开销之和,不是渲染一家的**。把它整体命名为"渲染开销",和 5.2 节那两处是同一类错误——只不过 61.3 那条是把别人的数算给了渲染,这条是把一圈的杂项全算给了渲染。 + +**结论不变、口径要改**:渲染**不是**瓶颈(整圈 11 ms 已封顶),但"渲染占几毫秒"本文给不出——这正是第 6 节第一条测量缺口。该文那两处表述已加注指向本节,不再单独作为渲染耗时依据。 + +--- + +## 6. 测量缺口(诚实地列出还不知道的) + +**你需要知道**:本文能给出的每一个数字都已经标了性质。下表列出**没有探针、因而无法给出**的部分——把它们当"未知",不要用别的数字去填补。 + +| 缺口 | 现状 | 补法 | +|---|---|---| +| **LVGL 渲染段** | `ui_port_step()` 被包在 `TASK_PROF_UI_WORK` 里,与数据装配、组帧、心跳混在一起,无法单独读 | 在 `ui_port_step()` 前后各加一对 `task_prof_enter/exit(TASK_PROF_UI_RENDER)` | +| **注键 + 同步重绘段** | `ui_port_service_keys()` 内 `lv_refr_now()` 的耗时完全未知,且本机 0 次按键 | 在上面的基础上,单独包住 `ui_port_service_keys()` | +| **数据装配段** | `ui_data_feed_tick()` 耗时未知(内部 200 ms 自分频) | 同上,单独包一段 | +| **`uip` 极值的具体成因** | 170 ms 的具体触发事件未逐一定位;已知它总与 `uisn≠0` 同时出现 | 让 `task_prof` 在结算 max 时同时打印发生时刻的其它段值 | + +**为什么这些缺口不阻碍结论**:第 2.4 节的 `uil = 11.0 ms` 是一个**足够强的反证**——它从"整圈周期"这个已知量的角度排除了"渲染占大头"的可能。缺的是"渲染具体占几毫秒",不是"渲染是不是瓶颈"。 + +探针改造属于可执行改动,不在本文范围内,待办登记在 `docs/任务规划/README.md`(语义条目「UI 分段耗时探针」)。 + +--- + +## 7. 结论与优先级 + +**你需要知道**:如果要改善响应速度,按下面顺序动手,这个顺序来自实测数据而不是直觉。 + +| 优先级 | 事项 | 依据 | 预期收益 | +|---|---|---|---| +| **一** | 解耦 `ui_net_sink_poll()` 与 uiTask | `uis` 最坏 117 ms,`portMAX_DELAY` 无限期阻塞 | 消除 100 ms 量级的不确定停顿 | +| 二 | 给 UI 各段加独立探针 | 第 6 节四条缺口 | 不直接提速,但让后续优化有据 | +| 三 | 评估降低屏板帧长或提高波特率 | 线上 60.1 ms 是物理常数 | 每降 1/6 帧长约省 10 ms,但需改屏板固件协议,属外部工程 | + +**明确不建议做的**:优化 LVGL 绘制、调 `LV_DEF_REFR_PERIOD`、优化脏区策略。实测表明显卡不在这一层(`uil` = 11.0 ms,其中渲染占比未测但已被整圈周期封顶)。 + +--- + +## 8. 引用这些数字时的口径 + +**你需要知道**:本文的数字有三种性质,混用会得出错误结论。 + +| 性质 | 含义 | 本文中的例子 | +|---|---|---| +| **真值** | 长期稳定、可重复测量 | `uil` 中位 11.0 ms / p99 20.0 ms、组帧 509 µs、线上 60.1 ms、MCU 净处理 6.7 ms | +| **历史极值** | 开机以来最大值,**会随时间继续爬升**,只能定上界,禁止写成"当前" | `uip`(实测 170.0 → 221.9 ms 仍在涨)、`uiw` 138.2 ms、`uis` 117.0 ms | +| **推算 / 上界** | 由节拍或协议常数推出,未实测 | 召唤→下一拍 ≤10 ms、放行 ≤1 ms、注键+重绘(无实测) | + +**引用任何最大值时,必须连采集条件一起引用**,模板:「本机开机后约 42 s,屏板在连、无远端客户端、无按键」。离开这个条件,同一个字段会给出完全不同的数。 + +--- + +## 9. 相关文档 + +| 主题 | 去处 | +|---|---| +| 屏板串口帧格式、协议、按键应答时序 | `docs/子系统设计/屏板链路设计.md` | +| `[PROF]` / `[PROF2]` 探针字段定义 | `docs/子系统设计/看门狗设计说明.md` 第 11.4 节 | +| 远端推流端到端延迟的完整实验 | `docs/测试说明/专项验证/链路延迟测试说明.md` | +| UI 数据供给(快照层) | `docs/UI设计/UI_数据供给设计.md` | +| 内容页架构与绘制 | `docs/UI设计/内容页架构.md` | +| 远端显示协议 | `docs/UI设计/RemoDispBus协议与接收设计说明.md` | \ No newline at end of file diff --git a/docs/子系统设计/屏板链路设计.md b/docs/子系统设计/屏板链路设计.md index ca4be03a..7aa7f0f9 100644 --- a/docs/子系统设计/屏板链路设计.md +++ b/docs/子系统设计/屏板链路设计.md @@ -187,11 +187,11 @@ flowchart TB | 段 | 量值 | 说明 | |---|---|---| | 召唤 → 下一拍 uiTask | ≤10 ms | 10 ms 节拍 | -| 注键 + 重绘 | 选中移动几 ms;换页地板 61.3 ms | `view_apply_sel()` 选中移动且滚动未变时只 invalidate 两行带,整框 invalidate 退为滚动 / 首刷兜底 | +| 注键 + 重绘 | **未实测**(本机开机至今 0 次按键,`dfok=0 kq=0`) | `view_apply_sel()` 选中移动且滚动未变时只 invalidate 两行带,整框 invalidate 退为滚动 / 首刷兜底。**曾写「换页地板 61.3 ms」是误归因**,那是远端推流 PC 端帧周期,见 `docs/UI设计/UI_时间响应分析.md` 第 5 节 | | 组帧 | 典型 509 µs / 峰值 812 µs | 见上表 | | 放行 | ≤1 ms | TIM3 节拍 | | 线上 | 59.6 ms | 4208 B @ 700 kbaud | -| **典型合计** | **≈70–135 ms** | uiTask 饿死场景 ≈200 ms 保底发旧帧 | +| **典型合计** | **≥71 ms,上界未知** | 只有「召唤→下一拍 ≤10 ms」「放行 ≤1 ms」「线上 60.1 ms」三段有据;注键+重绘段无实测,故只能给下界。uiTask 饿死场景 ≈200 ms 保底发旧帧。**全量分解见 `docs/UI设计/UI_时间响应分析.md`** | **可观测**:`[SBLINK]` 统计行 `dfok=` 新帧放行次数、`dfold=` 扣满 140 ms 发旧帧次数。**`dfold` 在涨 = uiTask 被饿 ≥140 ms 的直接证据**(对时 reconcile 突发那类,见 `docs/网络/网络自愈架构设计.md` §4.1 `net_reconcile_tick`)。 diff --git a/docs/子系统设计/看门狗设计说明.md b/docs/子系统设计/看门狗设计说明.md index 14bdcec3..7093cf85 100644 --- a/docs/子系统设计/看门狗设计说明.md +++ b/docs/子系统设计/看门狗设计说明.md @@ -609,7 +609,7 @@ enter/exit 段还能读出"此刻仍在段内已多久"——**永久阻塞的 | 字段 | 探针 | 含义 | 基线(2026-10-10 v2.8,无客户端,开机 29 s) | |---|---|---|---| -| `uip` / `uil` | UI_PERIOD | uiTask 循环周期最坏 / 最近值 | **61.3 ms** / 10.0 ms——⚠ 地板是 **LVGL 整帧渲染**(独立实测帧周期 61.6 ms),**与网络无关** | +| `uip` / `uil` | UI_PERIOD | uiTask 循环周期最坏 / 最近值 | 无客户端无按键实测:`uil` 中位 **11.0 ms**、p99 20.0 ms(23913 样本);`uip` **170.0~221.9 ms 且随运行时间继续爬升**——⚠ **两者都不能当 LVGL 渲染耗时读**:`uil` 是整圈周期(含 `osDelay(10)`),`uip` 是开机以来最大值且只反映启动期网络/监听重建的停顿,**不是稳态周期,引用必然过期**。曾把 `uip` 记成「地板是 LVGL 整帧渲染 61.3 ms」是**误归因**,来源与裁定见 `docs/UI设计/UI_时间响应分析.md` 第 5 节 | | `uiw` | UI_WORK | 本轮起点→心跳前(含 LVGL) | **11.4 ms**(改前 ≈50 ms 且 ≈`uis` → 当时单轮几乎全是推流) | | `uis` / `uisn` | UI_SINK | 推流往返最坏 / 此刻仍在段内 | **1 µs** / 0(改前 ≈50 ms);**`uisn` 持续非 0 = "客户端在连且 netTask 拥塞"这一格真发生的铁证** | | `adcm` | ADC_BEAT | adcTask 单拍(含心跳日志) | 2.0~2.25 ms——⚠ 峰值来自**每 10 s 一次的心跳日志**,不是采集,勿混读 | diff --git a/docs/测试说明/专项验证/链路延迟测试说明.md b/docs/测试说明/专项验证/链路延迟测试说明.md index df6ca943..76a7e011 100644 --- a/docs/测试说明/专项验证/链路延迟测试说明.md +++ b/docs/测试说明/专项验证/链路延迟测试说明.md @@ -63,7 +63,7 @@ sequenceDiagram C-->>N: RECV 中断 → net_poll Note over N: D3 netMsgQueue 头阻塞窗口(已两阶段修复:分片 → 挂起 recv 零占用) U->>N: net_recv(64B)(队列 + TaskNotify) - Note over U: D5 最多 10ms 相位 + LVGL 渲染占时(渲染实测 ~1ms) + Note over U: D5 最多 10ms 相位 + LVGL 渲染占时(渲染非瓶颈,见下注) N-->>U: 按键注入 UI Note over U: D9 下一拍才渲染(step 在 poll 之前) U->>N: net_send 3209B @@ -120,7 +120,7 @@ sequenceDiagram | 生产路径帧周期 | **真实 uiTask + 真实 `ui_net_sink`**(:7003)完整帧周期:请求拾取(10ms 拍)+ 队列 + 发送 + 芯片→线上+PC + peer 侧编码 | MCU 探针 + PC,Phase 14 | 真机 61.6ms / 模拟器 6.8ms(含 peer 100ms 节拍) | 全段(用户真实体感) | | 连接/重监听 | connect→ESTABLISHED;close→relisten 成功 | MCU(net_poll 观测点),Phase 14 | relisten **89ms**(D10 修复后) | 握手/队列;**≥500ms = D10 回归** | | 日志税 | 一行 60 字符 `printf`(现 fputc 逐字节 @115200)耗时 | MCU,Phase 13 附带 | **4402µs/行** | D6(per-recv 日志已删 2026-09-22;非阻塞日志仍待办) | -| uiTask 节拍 | 生产循环实测周期(`osDelay(10)` 之外多花多少 = LVGL 渲染 + 渲染中排空) | MCU 探针,Phase 14 | **10986µs**(渲染仅 ~1ms/帧) | D5/D9(实测均非瓶颈) | +| uiTask 节拍 | 生产循环实测周期(`osDelay(10)` 之外多花多少 = 渲染 + 数据装配 + 组帧 + 推流轮询 + 链路轮询 + 心跳) | MCU 探针,Phase 14 | **10986µs**(渲染非瓶颈,单项耗时尚无探针——见 `docs/UI设计/UI_时间响应分析.md` 第 6 节) | D5/D9(实测均非瓶颈) | | CH395F 净贡献 | `生产路径帧周期(真机) − 生产路径帧周期(模拟器)`,同一 peer 交替跑 | PC,Phase 14 | **54.8ms**(阈值 ≤80ms) | 直接回答"网络延迟"占多少 | --- @@ -554,8 +554,10 @@ peer 侧 = `../测试数据/m3_data/m3_pending_*.json`(发送分块握手重 属**调度周期**而非排队拥塞(旧收值 5997µs 含 per-recv 日志税 4.4ms/行,已移除); `queue_rt_send` 988µs ≈ 1 个循环周期,发送路径没有额外排队; - **发送分块握手 chunk 级**:219µs ≈ 每 chunk SPI 成本的 1/7 → **芯片 TX 缓冲不是瓶颈**,SPI 搬运才是; -- **uiTask 节拍 uiTask 周期**:10986µs(= osDelay(10) + 渲染开销 ≈ 1ms)→ **LVGL 渲染只占约 1ms/帧**, - uiTask 不是延迟来源; +- **uiTask 节拍 uiTask 周期**:10986µs(= `osDelay(10)` 的 10000µs + 约 986µs 杂项:数据装配、组帧 `memcmp`、 + 推流轮询、链路轮询、心跳)。这 986µs **不是渲染一家**,本表不给渲染单项耗时——单项分解见 + `docs/UI设计/UI_时间响应分析.md` 第 6 节(该节列明渲染段尚无独立探针)。 + 可断定的是 **LVGL 渲染不是延迟来源**:整圈 11ms 已把渲染封顶在 11ms 以内。uiTask 不是延迟来源; - **结论:调优先级/栈不会改善体感**——预算应花在尾批解法(已做)与 D20(§8.2)。 --- @@ -686,7 +688,7 @@ sock4 auto-relisten ok / relisten retry ok ← 监听器随后自行恢复 | D2 | 3209B × 1KB 发送 FIFO 停止等待(4 次串行分块握手,期间 netTask 全程占用) | `chunk_wait` 219µs/块 ≈ SPI 搬运成本的 1/7 → 握手本身**不是瓶颈**;每帧固定成本小(MCU 净 7.1ms) | 基线成本,可接受;根治 = 差量/RLE + 帧版本号(待办) | | D3 | netMsgQueue 头阻塞 | 已量化:一条空闲 FTP 控制连接冻结全网 17.7s | **两阶段闭环**:① 5ms 分片有界读 + 让出(f8d6e90/4a1605b,缓解)② **挂起 recv 化**(`a45c0cb`,结构性——执行器零占用,缺陷类消灭,§8.3 要点 4) | | D4 | PC 端延迟 ACK 与"每段等 ACK"停止等待交互 | `--ack-fast` 带内实验证实:关掉延迟 ACK 尾批自行消失(52→3.9ms) | **已客户端侧解决**(生产客户端关延迟 ACK/轻推兜底,§7.4) | -| D5 | uiTask 节拍:10ms 循环 + 每拍一次 64B recv + step 在 poll 前 | `ui_loop` 10986µs ≈ 设计值(渲染 ~1ms);拾取调度 ~2.3ms(P0-b 删 per-recv 日志后,原 ~6.8ms) | 基线行为;可选优化(poll 前置 + while 排空),低优先 | +| D5 | uiTask 节拍:10ms 循环 + 每拍一次 64B recv + step 在 poll 前 | `ui_loop` 10986µs ≈ 设计值(渲染非瓶颈,单项耗时未测);拾取调度 ~2.3ms(P0-b 删 per-recv 日志后,原 ~6.8ms) | 基线行为;可选优化(poll 前置 + while 排空),低优先 | | D6 | 阻塞式日志在关键路径(fputc 逐字节 @115200) | `logtax_line` 4402µs/行;per-recv 日志已删(2026-09-22):`queue_rt_recv` 5997→1223µs、帧周期 66.0→61.6ms、首字节 13.9→9.6ms | **部分已修(P0-b,2026-09-22)**;非阻塞日志仍待办(同时是开机日志并发丢行 §9.2 的根治项) | | D7 | 物理链路:强制 100M 全双工 vs 交换机自协商 → 双工不匹配静默丢包 | 台架 `PHY: 100M FULL` 成立、零尖峰 → 台架干净 | 现场排查项:核对开机日志 PHY 行 + 交换机端口强制全双工 + 验证 PC 有线直连 | | D8 | 客户端固定成本:100ms 拉取节拍、按键后不立即取帧、1bpp→PNG→base64→WS 编码链 | 生产客户端优化后:帧耗时 20.7ms、显示帧率 ~9fps | 部分已优化(延迟确认抑制已上线);其余待办(按键后立即取帧/不传 PNG/自适应节拍)——客户端仓库 | @@ -773,6 +775,7 @@ sock4 auto-relisten ok / relisten retry ok ← 监听器随后自行恢复 |---|---| | RemoDispBus 协议与接收设计(含 INIT 8B 勘误) | `docs/UI设计/RemoDispBus协议与接收设计说明.md` | | UI 设计架构(离屏渲染 + 推流) | `docs/UI设计/UI_设计架构.md` | +| **UI 时间响应分析**(本文 §7 的推流延迟在 UI 侧总账中的位置;`uip`/`uil` 口径与"渲染约 1ms"归因的裁定) | `docs/UI设计/UI_时间响应分析.md` | | BSD Socket API 与双端后端 | `docs/网络/BSD_Socket_API_使用指南.md` | | CH395F 陷阱史(TRAP-NET-09/-16 等) | `docs/问题记录/CH395F_Trap_Records.md` | | CH395F 测试套件(吞吐 Phase 8 等) | `docs/测试说明/板级测试/CH395F_Test_Guide.md` |