📚 课程目录第4章 DRM VBlank机制

4. DRM VBlank机制：核心结构与事件处理

VBlank（Vertical Blanking Interval，垂直消隐期）是显示驱动与用户态应用同步的关键时间窗口。DRM子系统围绕drm_vblank结构体构建了一套完整的计数器、使能/禁用与事件分发机制，确保页面翻转、光标更新与垂直同步的精确配合。

4.1 drm_vblank结构体：每个CRTC的垂直同步状态

每个CRTC（显示控制器）在DRM中对应一个drm_vblank实例，该结构体记录了该CRTC的VBlank状态、计数器、时间戳与等待队列。其核心字段如下表所示：

字段名	类型	说明
`count`	`atomic64_t`	VBlank事件累计计数器，每次VBlank中断+1
`time`	`ktime_t`	最近一次VBlank事件发生的精确时间戳
`enabled`	`bool`	当前VBlank中断是否已使能
`refcount`	`atomic_t`	使能引用计数，防止重复开关中断
`queue`	`wait_queue_head_t`	等待VBlank事件的进程睡眠队列
`disable_timer`	`struct timer_list`	延迟禁用定时器，避免频繁开关中断

设计要点：drm_vblank结构体位于drm_device->vblank[]数组中，数组索引即CRTC索引。驱动初始化时通过drm_vblank_init()分配并初始化该数组。

下图展示了drm_vblank结构体与DRM核心、硬件中断、用户态应用之间的数据流关系：

4.2 VBlank计数器：单调递增的帧序号

VBlank计数器是DRM提供的最基础同步工具。每次垂直消隐中断触发时，驱动调用drm_crtc_handle_vblank()，该函数自动递增drm_vblank->count并记录时间戳。用户态可通过DRM_IOCTL_GET_VBLANK_COUNTER查询当前计数值。

  计数器特性：
  单调性：计数器只增不减，即使VBlank中断被禁用，重新使能后计数器从当前硬件值恢复。
64位宽度：使用atomic64_t保证在多核环境下读取不撕裂，理论上不会溢出。
与硬件同步：驱动在中断处理中调用drm_crtc_handle_vblank()，确保软件计数器与硬件帧脉冲严格对齐。

计数器更新流程如下：

硬件CRTC产生垂直消隐中断。
驱动中断处理函数调用drm_crtc_handle_vblank(dev, crtc_index)。
DRM核心内部调用drm_handle_vblank()，执行atomic64_inc(&vblank->count)。
同时记录当前ktime_get()到vblank->time。
唤醒所有在vblank->queue上等待的进程。

// 驱动中断处理示例
irqreturn_t my_crtc_vblank_handler(int irq, void *dev_id)
{
    struct drm_device *dev = dev_id;
    int crtc_index = 0; // 假设只有一个CRTC

    // 核心调用：递增计数器、记录时间戳、唤醒等待队列
    drm_crtc_handle_vblank(dev, crtc_index);

    return IRQ_HANDLED;
}

4.3 VBlank使能与禁用：引用计数与延迟策略

VBlank中断的使能/禁用不是简单的开关操作，而是通过引用计数机制管理，避免频繁开关硬件中断带来的性能抖动。

函数	作用	引用计数变化
`drm_vblank_get(dev, crtc)`	获取VBlank引用，若refcount从0→1则调用驱动enable_vblank回调	+1
`drm_vblank_put(dev, crtc)`	释放VBlank引用，若refcount从1→0则启动延迟禁用定时器	-1
`drm_crtc_vblank_off(dev, crtc)`	强制关闭VBlank，用于CRTC关闭或DPMS时	重置为0
`drm_crtc_vblank_on(dev, crtc)`	重新开启VBlank，恢复计数器与时间戳	恢复之前状态

延迟禁用机制：当refcount降为0时，DRM不会立即关闭中断，而是启动一个5ms（默认值）的定时器。若在定时器到期前又有新的drm_vblank_get()调用，则取消定时器，避免中断频繁开关。这种策略在页面翻转频繁的场景下显著降低硬件中断抖动。

使能/禁用状态转换如下图所示：

4.4 VBlank事件处理：从硬件中断到用户态通知

VBlank事件处理是DRM显示驱动中最关键的同步路径。它连接了硬件中断、内核事件队列和用户态阻塞等待。整个处理流程分为三个层次：

硬件层：CRTC产生垂直消隐中断，驱动调用drm_crtc_handle_vblank()。
核心层：DRM核心递增计数器、记录时间戳、唤醒等待队列，并调用已注册的VBlank回调函数。
用户层：通过DRM_IOCTL_WAIT_VBLANK阻塞等待，或通过drmEventContext接收异步事件。

  事件类型：
  阻塞等待：用户态调用drmWaitVBlank，内核将进程加入vblank->queue，中断发生后唤醒。
异步事件：用户态通过DRM_IOCTL_PAGE_FLIP提交翻转请求时，可附带VBlank事件标志，翻转完成后通过DRM事件队列通知用户态。
序列化回调：驱动可通过drm_crtc_vblank_helper_funcs注册自定义回调，在每次VBlank时执行硬件光标更新或帧统计。

完整的VBlank事件处理流程如下图所示：

4.5 驱动适配要点：实现VBlank回调

驱动开发者需要实现两个关键回调函数，DRM核心通过它们控制硬件中断的开关：

static const struct drm_driver my_driver = {
    .driver_features = DRIVER_MODESET,
    .enable_vblank = my_enable_vblank,   // 使能指定CRTC的VBlank中断
    .disable_vblank = my_disable_vblank, // 禁用指定CRTC的VBlank中断
};

int my_enable_vblank(struct drm_device *dev, unsigned int crtc)
{
    // 操作硬件寄存器，使能垂直消隐中断
    writel(1, mmio + VBLANK_ENABLE_REG);
    return 0;
}

void my_disable_vblank(struct drm_device *dev, unsigned int crtc)
{
    // 操作硬件寄存器，禁用垂直消隐中断
    writel(0, mmio + VBLANK_ENABLE_REG);
}

常见陷阱：

中断共享：多个CRTC可能共享同一物理中断线，驱动需在中断处理中判断中断源。
时间戳精度：drm_crtc_handle_vblank()应在中断上下文中尽早调用，避免调度延迟导致时间戳偏差。
电源管理：CRTC关闭（DPMS off）时必须调用drm_crtc_vblank_off()，恢复时调用drm_crtc_vblank_on()。

4.6 本章小结

VBlank机制是DRM显示同步的基石。drm_vblank结构体通过计数器、时间戳、引用计数和延迟禁用策略，为页面翻转、光标更新和用户态同步提供了精确且高效的垂直同步服务。理解VBlank的使能/禁用状态机与事件处理流程，是开发高质量显示驱动的必要条件。