📚 课程目录第4章 VBlank机制

4. VBlank机制

在DRM显示子系统中，VBlank（垂直消隐）是连接显示控制器与用户空间最关键的时序锚点。无论是HDR元数据的逐帧切换、视频播放的帧率匹配，还是游戏渲染的帧提交节奏，都依赖VBlank事件来建立稳定的同步关系。理解VBlank的硬件来源、内核事件分发路径以及时间戳语义，是排查撕裂、卡顿和HDR闪烁问题的前提。

一、垂直消隐区间的物理含义

显示器并非连续不断地扫描像素。以典型的逐行扫描为例，一帧图像由若干行组成，电子束（或等效的像素输出逻辑）从左到右、从上到下逐行输出。当扫描完最后一行后，需要回到左上角开始下一帧，这段“回程”时间就是垂直消隐区间（VBlank）。同理，每行结束后的回程是水平消隐（HBlank）。

VBlank区间内不输出有效像素，但显示控制器仍在工作：它需要完成帧缓冲切换、更新扫描地址、加载新的时序参数。对驱动而言，VBlank是一段“安全窗口”——此时修改显示寄存器不会造成画面撕裂。因此，VBlank中断本质上是一个硬件定时信号，告诉软件“当前帧已结束，可以安全地准备下一帧”。

关键时序参数包括：

HTotal / VTotal：一行/一帧的总像素时钟数或行数，包含有效区和消隐区。
VActive：垂直有效行数，即实际可见的图像高度。
VBlank：VTotal − VActive，垂直消隐行数。
刷新率：由像素时钟除以HTotal×VTotal得到，例如148.5MHz / (2200×1125) ≈ 60Hz。

二、VBlank中断的产生与内核分发路径

显示控制器（如Intel i915的Display Engine、Rockchip VOP、Allwinner DE）在进入VBlank区间时置位中断状态寄存器，并通过中断线通知CPU。内核DRM框架的中断处理分为上下半部：

硬中断（hardirq）：读取中断状态寄存器，确认是VBlank中断，清除中断标志，然后调度下半部。
下半部（threaded IRQ / tasklet）：调用drm_crtc_handle_vblank()，更新VBlank计数器，唤醒等待队列，并向用户空间发送事件。
事件队列：通过drm_vblank_event将事件挂入文件描述符的event list，用户空间通过read()或poll()获取。

以下是一个典型的内核日志片段，展示VBlank中断计数与时间戳：

[  120.456789] i915 0000:00:02.0: vblank wait on pipe A: count=3600, ts=120.456780
[  120.473456] i915 0000:00:02.0: vblank wait on pipe A: count=3601, ts=120.473450
[  120.490123] i915 0000:00:02.0: vblank wait on pipe A: count=3602, ts=120.490120

可以看到，相邻VBlank事件的时间间隔约为16.67ms，对应60Hz刷新率。时间戳由内核在中断处理时读取高精度时钟（ktime_get()）获得，精度通常在微秒级。

三、VBlank事件与时间戳语义

用户空间通过drmWaitVBlank或drmCrtcGetSequence获取VBlank信息。核心结构体drm_vblank_sequence包含三个字段：

字段	含义	典型用途
sequence	VBlank计数器，每发生一次VBlank递增1	判断帧序号、计算丢帧
tv_sec	时间戳秒部分	与系统时间对齐
tv_usec	时间戳微秒部分	精确计算帧间隔

时间戳的语义是“VBlank中断发生的时刻”，而非“帧扫描完成的时刻”。在HDR场景中，如果驱动在VBlank中断中切换HDR元数据，那么元数据生效时间与时间戳之间存在固定延迟（通常为几行扫描时间）。调试时需要区分“事件时间戳”与“实际显示时间”。

提示：使用drmModeCrtcGetSequence可以同时获取当前sequence和纳秒级时间戳，比drmWaitVBlank更适合做精确的帧率统计。

四、同步与撕裂避免：从VBlank到Page Flip

撕裂（tearing）的根源是：显示控制器正在扫描旧帧缓冲时，软件提交了新帧缓冲并立即生效。避免撕裂的标准做法是“在VBlank期间切换扫描地址”。DRM提供了两种机制：

Legacy Page Flip：通过drmModePageFlip提交，驱动在下一个VBlank中断中完成切换，并发送DRM_EVENT_FLIP_COMPLETE事件。
Atomic Commit：通过drmModeAtomicCommit提交，配合DRM_MODE_ATOMIC_NONBLOCK和DRM_MODE_PAGE_FLIP_EVENT，实现多图层同步更新。

无论哪种方式，核心逻辑都是：用户空间提交新帧 → 驱动将新帧地址写入pending寄存器 → VBlank中断到来 → 硬件切换到新帧 → 驱动发送flip complete事件。用户空间收到事件后，才认为该帧已显示，可以提交下一帧。

以下是一个典型的双缓冲同步流程：

用户空间：
  drmModePageFlip(fd, crtc_id, new_fb_id, DRM_MODE_PAGE_FLIP_EVENT, &data);
  poll(fd);  // 等待VBlank事件
  read(fd, &event, sizeof(event));
  // 收到DRM_EVENT_FLIP_COMPLETE后，提交下一帧

内核驱动：
  drm_crtc_vblank_on(crtc);
  drm_crtc_arm_vblank_event(crtc, e);
  // VBlank中断中：
  drm_crtc_handle_vblank(crtc);
  drm_crtc_send_vblank_event(crtc, e);

五、HDR场景下的VBlank特殊考量

HDR元数据（如HDR10的静态元数据、HDR10+的动态元数据）通常通过Infoframe随帧发送。如果元数据在VBlank之外更新，可能导致显示器在帧中间切换色调映射曲线，造成亮度突变或闪烁。因此，HDR元数据的更新必须与Page Flip绑定，确保在VBlank窗口内生效。

在调试HDR闪烁问题时，可以检查以下参数：

vblank_count是否连续递增，有无丢中断。
HDR元数据提交是否与flip事件在同一原子提交中。
时间戳间隔是否稳定，有无因中断延迟导致的抖动。

注意：部分SoC的VBlank中断可能被其他高优先级中断抢占，导致时间戳抖动超过1ms。此时应检查中断亲和性设置，或将VBlank处理线程绑定到独立CPU核心。

六、常见误区与复盘

误区1：认为VBlank事件等于“帧已显示”。实际上，VBlank中断发生在消隐区开始，此时新帧尚未开始扫描。flip complete事件表示“切换已完成”，但实际像素输出要等到VActive区。精确测量显示延迟需要结合光电传感器或GPU时间戳。

误区2：忽略时间戳的单调性。在多CRTC系统中，不同pipe的VBlank时间戳可能来自不同时钟源。如果驱动未做统一，跨pipe同步会出现偏差。调试时应确认drm_crtc_vblank_get()返回的时间戳是否基于同一时钟。

误区3：在VBlank中断中做耗时操作。VBlank中断频率高（60Hz~240Hz），中断处理必须短小。任何耗时操作（如打印日志、内存分配）都应移到工作队列或用户空间。否则会导致中断丢失，进而引发帧率不稳和撕裂。

复盘一个实际案例：某HDR视频播放器在4K@60Hz下出现周期性闪烁。通过drmWaitVBlank统计发现，每约5秒有一次VBlank时间戳间隔异常（从16.67ms跳变到33.34ms），对应一次丢帧。进一步检查发现，GPU在提交HDR元数据时触发了同步等待，阻塞了VBlank下半部。解决方案是将元数据提交改为非阻塞原子提交，并在flip complete回调中更新下一帧元数据，问题消失。

总结来说，VBlank机制是DRM显示同步的基石。理解垂直消隐区间的物理意义、掌握VBlank中断的内核分发路径、正确解读时间戳语义，并在HDR场景中将元数据更新与Page Flip绑定，才能有效避免撕裂和闪烁。调试时应优先检查VBlank计数连续性、时间戳间隔稳定性以及flip complete事件的到达时机，这三者构成了显示同步的“铁三角”。