3. 显示管道与数据流：从用户态到硬件的像素数据流动路径、Vblank同步机制

显示管道（Display Pipeline）是 DRM/KMS 驱动中连接用户态应用与物理显示硬件的核心数据通路。理解像素数据如何从应用程序的帧缓冲区（Framebuffer）逐级传递到显示控制器，并最终在 Vblank 同步信号的驱动下刷新到屏幕，是掌握多图层合成与色彩管理的基础。

3.1 显示管道总体架构

一个典型的 DRM 显示管道由以下逻辑组件串联而成，每个组件对应 KMS 对象模型中的一个实体：

核心概念： DRM/KMS 将显示管道抽象为 Framebuffer → Plane → CRTC → Encoder → Connector 的流水线。用户态通过 Atomic Commit 一次性提交整个管道的状态变更，驱动在 Vblank 期间完成切换。
DRM/KMS 显示管道数据流架构 用户态应用 Framebuffer Plane CRTC Encoder Connector 硬件层：显示控制器（Display Controller）与 Timing Generator 用户态提交 Dumb Buffer / GEM 像素数据 内存地址 + 格式 图层合成 Alpha / Z-order 扫描输出 Timing 生成 信号编码 LVDS/DP/HDMI 物理接口 显示设备 Vblank 同步

3.2 像素数据流动路径详解

像素数据从用户态到硬件的完整流动路径可分为以下阶段：

阶段 组件 操作 关键数据结构/API
1. 缓冲区分配 用户态 → GEM 通过 DRM_IOCTL_MODE_CREATE_DUMB 或 GEM API 分配物理连续/非连续内存 struct drm_gem_object
2. 帧缓冲区创建 用户态 → KMS 将 GEM 对象绑定到 drm_framebuffer，指定像素格式、偏移、步幅 struct drm_framebuffer, drm_mode_addfb2
3. 图层配置 用户态 → Plane 设置 FB_ID, CRTC_ID, src_x/y/w/h, crtc_x/y/w/h, zpos, alpha struct drm_plane_state
4. 原子提交 用户态 → CRTC 通过 DRM_IOCTL_MODE_ATOMIC 一次性提交所有 Plane 和 CRTC 状态 struct drm_atomic_state
5. 硬件编程 KMS 驱动 → 硬件 在 Vblank 期间更新显示控制器寄存器，切换扫描缓冲区地址 atomic_flush, atomic_commit 回调
6. 扫描输出 硬件 CRTC 按行/帧从 Framebuffer 读取像素，经合成后输出到 Encoder 硬件 DMA 引擎
性能关键点： 阶段 3-5 必须在单个 Vblank 周期内完成，否则会导致画面撕裂（Tearing）。现代驱动使用 Atomic Commit + Vblank 等待 机制保证帧切换的原子性。

3.3 多图层合成路径

当显示管道包含多个 Plane 时，CRTC 内部的硬件合成器（Hardware Composer）负责将各图层按 Z-order 混合为最终帧。合成路径如下：

多图层硬件合成路径 Plane 0 (Primary) FB_ID=0, zpos=0 Plane 1 (Overlay) FB_ID=1, zpos=1 Plane 2 (Cursor) zpos=2 硬件合成器 Alpha Blending Color Key / 预乘 最终帧 → Encoder

硬件合成器通常支持以下混合模式：

  • Alpha Blending： 使用图层自带的 Alpha 通道进行逐像素混合，公式为 out = src * src_alpha + dst * (1 - src_alpha)。
  • 预乘 Alpha（Premultiplied Alpha）： 像素 RGB 值已乘以 Alpha，合成效率更高，避免边缘暗边。
  • Color Key（颜色键）： 将指定颜色视为透明，常用于视频叠加层。
  • Z-order 排序： 通过 zpos 属性决定图层覆盖顺序，数值越大越靠上。

3.4 Vblank 同步机制

Vblank（Vertical Blanking Interval）是显示控制器在完成一帧扫描后、开始下一帧扫描前的短暂空闲期。DRM/KMS 利用 Vblank 实现帧切换同步，避免撕裂。

3.4.1 Vblank 生命周期

事件 描述 驱动回调
Vblank 开始 CRTC 完成最后一行的扫描，进入消隐区 enable_vblank
Vblank 中断 硬件触发中断，通知内核进入 Vblank 窗口 中断处理函数
帧切换窗口 内核在此窗口内更新 CRTC/Plane 寄存器，切换 FB 地址 atomic_flush
Vblank 结束 消隐区结束，开始新一帧的扫描 disable_vblank

3.4.2 用户态 Vblank 等待

用户态通过以下 ioctl 等待 Vblank：

// 等待指定 CRTC 的下一个 Vblank
struct drm_wait_vblank vbl;
vbl.request.type = DRM_VBLANK_RELATIVE;
vbl.request.sequence = 1;  // 等待 1 个 Vblank
vbl.request.signal = 0;
ioctl(fd, DRM_IOCTL_WAIT_VBLANK, &vbl);

// 获取当前 Vblank 计数
struct drm_wait_vblank vbl;
vbl.request.type = _DRM_VBLANK_FLAGS_GET_COUNT;
ioctl(fd, DRM_IOCTL_WAIT_VBLANK, &vbl);
uint32_t current_seq = vbl.reply.sequence;

3.4.3 Atomic Commit 与 Vblank 同步

现代 DRM 驱动使用 Atomic Commit 机制，将帧切换与 Vblank 绑定：

  1. 非阻塞提交（Non-blocking）： 用户态调用 DRM_IOCTL_MODE_ATOMIC 并设置 DRM_MODE_ATOMIC_NONBLOCK 标志，ioctl 立即返回，驱动在下一个 Vblank 异步切换。
  2. 阻塞提交（Blocking）： 不设置 NONBLOCK 标志，ioctl 会阻塞直到 Vblank 切换完成。
  3. Page Flip 事件： 驱动在 Vblank 切换完成后，通过 drm_crtc_send_vblank_event 向用户态发送事件，用户态通过 poll() 或 drmHandleEvent() 接收。
常见陷阱： 如果用户态在 Vblank 窗口之外提交帧切换，驱动必须等待下一个 Vblank，导致帧延迟增加。使用 DRM_MODE_ATOMIC_ALLOW_MODESET 时，驱动可能触发完整的模式切换，耗时更长。

3.5 数据流与 Vblank 的时序关系

下图展示了像素数据流与 Vblank 同步在时间轴上的配合关系：

Vblank 同步下的帧切换时序 t0 t1 t2 t3 帧 N 扫描 Vblank 区间 帧 N+1 扫描 Vblank 用户态提交 等待 Vblank 寄存器更新 Page Flip 事件

3.6 驱动实现要点

在驱动开发中，实现显示管道与 Vblank 同步需要关注以下核心回调：

// 1. 定义 CRTC 的 Vblank 相关回调
static const struct drm_crtc_funcs my_crtc_funcs = {
    .set_config       = drm_atomic_helper_set_config,
    .page_flip        = drm_atomic_helper_page_flip,
    .atomic_duplicate_state = my_crtc_duplicate_state,
    .atomic_destroy_state   = my_crtc_destroy_state,
    .atomic_flush     = my_crtc_atomic_flush,   // Vblank 期间调用
    .enable_vblank    = my_enable_vblank,       // 使能 Vblank 中断
    .disable_vblank   = my_disable_vblank,      // 关闭 Vblank 中断
};

// 2. 在 atomic_flush 中更新硬件寄存器
static void my_crtc_atomic_flush(struct drm_crtc *crtc, struct drm_atomic_state *state)
{
    struct my_crtc_state *crtc_state = to_my_crtc_state(crtc->state);

    // 更新帧缓冲区地址
    my_hw_set_fb_addr(crtc, crtc_state->fb_addr);

    // 更新图层合成参数
    my_hw_set_plane_config(crtc, crtc_state->plane_states);

    // 发送 Vblank 事件（非阻塞提交时）
    if (crtc->state->event) {
        spin_lock_irq(&crtc->dev->event_lock);
        drm_crtc_send_vblank_event(crtc, crtc->state->event);
        crtc->state->event = NULL;
        spin_unlock_irq(&crtc->dev->event_lock);
    }
}

// 3. Vblank 中断处理
irqreturn_t my_vblank_irq_handler(int irq, void *dev_id)
{
    struct drm_device *dev = dev_id;
    struct my_device *mydev = to_my_device(dev);

    // 读取硬件 Vblank 状态寄存器
    if (my_hw_is_vblank_occurred(mydev)) {
        drm_crtc_handle_vblank(&mydev->crtc);
        my_hw_clear_vblank_flag(mydev);
    }

    return IRQ_HANDLED;
}
调试建议： 使用 cat /sys/kernel/debug/dri/0/crtc-0/vblank_count 查看 Vblank 计数是否持续增长，确认 Vblank 中断正常工作。使用 drm_info 工具查看 Plane 和 CRTC 的当前状态。

3.7 本章小结

显示管道与数据流是 DRM/KMS 驱动的核心骨架。从用户态分配 Framebuffer、配置 Plane、提交 Atomic Commit，到驱动在 Vblank 期间更新硬件寄存器、完成帧切换，每个环节都紧密耦合。理解像素数据的流动路径和 Vblank 同步机制，是后续学习多图层合成、色彩管理、以及性能优化的基础。

← 上一章 📖 返回目录 下一章 →