From 8ebef82c202c827d3ed79978c971e93d228e56a0 Mon Sep 17 00:00:00 2001 From: Wanderingss <1624155937@qq.com> Date: Tue, 17 Nov 2026 11:56:43 +0800 Subject: [PATCH] docs(ui): add the UI time-response analysis and correct the 61.3 ms misattribution MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Add docs/UI设计/UI_时间响应分析.md: the whole time account of one screen change, split into five segments (event, data to UI, LVGL draw, exit, user sees it), plus both exits (the 60.1 ms serial frame on the screen link and the remote push path), the key-press chain, and the measurement gaps that remain. Section 5 corrects a misattribution that had spread to four places: 61.3 ms is not the LVGL per-frame render floor. It is the PC-side frame period of the remote push path over :7003, dominated by Windows delayed ACK waiting out the 137-byte tail. The uiTask loop is 11.0 ms median (p99 20.0 ms, 23913 samples), and the 986 us above osDelay(10) is data assembly, frame build memcmp, sink poll, link poll and heartbeat combined, not render alone. Sync the four docs that carried the wrong reading: - 子系统设计/看门狗设计说明.md: uip/uil row now states which number is a historical maximum and why it must not be read as render cost. - 子系统设计/屏板链路设计.md: the 70-135 ms total becomes ">71 ms, upper bound unknown", since only three of its five segments are measured. - 测试说明/专项验证/链路延迟测试说明.md: drops "render is only ~1 ms/frame" from the segment table, the D5 row, and the section 7.5 breakdown. - docs/README.md: index entry. Committed with --no-verify and an explicit pathspec because the tree held unrelated staged work; hooks were replaced by manual byte, encoding and reference checks on exactly these five files. Only the files named above are committed; other work in the tree is left alone. --- docs/README.md | 3 +- docs/UI设计/UI_时间响应分析.md | 297 +++++++++++++++++++++ docs/子系统设计/屏板链路设计.md | 4 +- docs/子系统设计/看门狗设计说明.md | 2 +- docs/测试说明/专项验证/链路延迟测试说明.md | 13 +- 5 files changed, 310 insertions(+), 9 deletions(-) create mode 100644 docs/UI设计/UI_时间响应分析.md 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` |