4. VBlank中断注册与使能：drm_vblank_init()、drm_crtc_vblank_on/off()、中断处理函数注册流程

VBlank中断是DRM显示子系统的时间基准信号，它标记了显示控制器完成一帧画面扫描、开始消隐区的时刻。本章深入剖析VBlank中断从初始化、注册到使能/禁用的完整生命周期，涵盖核心API的调用时机、参数含义以及中断处理函数的注册流程。

4.1 drm_vblank_init()：VBlank核心数据结构初始化

drm_vblank_init() 是VBlank子系统的入口函数，通常在DRM设备的load或bind回调中调用。它负责分配并初始化每个CRTC对应的VBlank状态结构体。

函数内部执行的关键操作：

• 为每个CRTC分配struct drm_vblank_crtc结构体，存储计数、时间戳、使能状态等。
• 初始化每个CRTC的等待队列（wait_queue_head_t），用于阻塞等待VBlank事件的用户态进程。
• 设置dev->vblank_disable_allowed标志，控制是否允许在无用户监听时自动关闭VBlank中断以节省功耗。
• 初始化自旋锁（spinlock_t）保护VBlank状态数据。

// 典型调用示例（位于驱动程序 bind 回调中）
int my_driver_bind(struct drm_device *dev)
{
    int ret;

    // 其他初始化...

    ret = drm_vblank_init(dev, 2);  // 假设硬件有2个CRTC
    if (ret) {
        DRM_ERROR("Failed to initialize vblank\n");
        return ret;
    }

    // 继续注册中断处理函数...
    return 0;
}

4.2 drm_crtc_vblank_on/off()：中断使能与禁用

drm_crtc_vblank_on() 和 drm_crtc_vblank_off() 是VBlank中断的运行时控制接口，通常在CRTC的enable/disable回调中成对调用。它们控制VBlank中断的硬件使能状态，并维护软件计数的一致性。

关键设计细节：

• 计数连续性： drm_crtc_vblank_off() 会保存关闭前的VBlank计数，drm_crtc_vblank_on() 恢复时基于该计数继续递增，避免用户态获取到跳跃的计数序列。
• 时间戳重置： 每次 drm_crtc_vblank_on() 会清零上次时间戳，确保重新使能后第一个VBlank事件的时间戳准确反映当前硬件状态。
• 引用计数： 内部维护 refcount，防止在多个用户态监听者存在时意外关闭中断。

// 驱动 CRTC enable/disable 回调中的典型用法
static void my_crtc_enable(struct drm_crtc *crtc)
{
    // 硬件初始化代码...
    my_hw_crtc_power_up(crtc);
    my_hw_crtc_set_mode(crtc);

    // 使能 VBlank 中断
    drm_crtc_vblank_on(crtc);
}

static void my_crtc_disable(struct drm_crtc *crtc)
{
    // 先关闭 VBlank 中断
    drm_crtc_vblank_off(crtc);

    // 硬件关闭代码...
    my_hw_crtc_power_down(crtc);
}

4.3 中断处理函数注册流程

VBlank中断处理函数的注册涉及DRM核心框架与具体硬件驱动的协作。完整的注册流程分为三个步骤：

1. 驱动实现中断回调： 在 struct drm_driver 中填充 irq_handler 和 irq_preinstall/irq_postinstall/irq_uninstall 回调。
2. 调用 drm_irq_install()： 该函数注册Linux中断处理函数，并在安装前后调用驱动的预处理和后处理回调。
3. 中断处理函数内部调用 drm_handle_vblank()： 当硬件VBlank中断触发时，驱动中断处理函数调用此核心API更新计数和时间戳，并唤醒等待队列。

// 驱动中断回调实现示例
static irqreturn_t my_irq_handler(int irq, void *arg)
{
    struct drm_device *dev = arg;
    uint32_t vblank_status;

    // 1. 读取硬件中断状态寄存器
    vblank_status = readl(my_hw_base + INT_STATUS);

    // 2. 检查是否为 VBlank 中断
    if (vblank_status & VBLANK_INT_BIT) {
        // 清除中断标志（硬件相关）
        writel(VBLANK_INT_BIT, my_hw_base + INT_CLEAR);

        // 3. 调用 DRM 核心 VBlank 处理函数
        drm_handle_vblank(dev, 0);  // CRTC 索引 0

        return IRQ_HANDLED;
    }

    return IRQ_NONE;
}

// 驱动 irq_postinstall 回调
static int my_irq_postinstall(struct drm_device *dev)
{
    // 使能 VBlank 中断掩码
    writel(VBLANK_INT_ENABLE, my_hw_base + INT_MASK);
    return 0;
}

// 注册中断（通常在 bind 回调中）
static int my_driver_bind(struct drm_device *dev)
{
    // ... drm_vblank_init 等初始化 ...

    // 注册中断处理函数
    ret = drm_irq_install(dev, platform_get_irq(pdev, 0));
    if (ret) {
        DRM_ERROR("Failed to install IRQ\n");
        return ret;
    }

    return 0;
}

4.4 完整初始化序列与避坑指南

将上述三个环节串联起来，一个完整的VBlank中断初始化序列如下：

// 完整初始化序列（驱动 bind 回调中）
int my_driver_bind(struct drm_device *dev)
{
    int ret;

    // 1. 初始化 VBlank 核心数据结构（必须在中断注册之前）
    ret = drm_vblank_init(dev, 2);
    if (ret)
        return ret;

    // 2. 注册中断处理函数（触发 irq_preinstall → request_irq → irq_postinstall）
    ret = drm_irq_install(dev, platform_get_irq(pdev, 0));
    if (ret)
        return ret;

    // 3. 后续在 CRTC enable 时调用 drm_crtc_vblank_on()
    //    在 CRTC disable 时调用 drm_crtc_vblank_off()
    return 0;
}

通过以上三个核心API的协同配合，DRM子系统能够为显示栈提供精确、高效的VBlank时间基准信号，为后续的HDR色彩参数更新和帧同步奠定基础。