4. DRM 驱动模型：DRM 驱动注册流程与 struct drm_driver 结构体详解

DRM 驱动模型是 Linux 显示子系统从 Framebuffer 演进到现代图形栈的核心。与传统的 fbdev 驱动不同，DRM 驱动需要遵循一套标准化的注册流程，并通过 struct drm_driver 结构体向内核框架暴露驱动能力。本节将深入剖析 DRM 驱动的初始化路径与关键数据结构。

4.1 DRM 驱动注册全流程

一个典型的 DRM 设备驱动从硬件探测到用户空间可见，需要经历以下关键阶段：

1. 平台设备匹配：驱动通过 platform_driver 或 pci_driver 与硬件设备树/ACPI 表匹配，触发 probe() 回调。
2. 核心数据结构分配：调用 drm_dev_alloc() 分配 struct drm_device，并初始化 struct drm_driver 回调表。
3. 硬件资源初始化：映射 I/O 内存、注册中断、初始化 CRTC/Encoder/Connector/Plane 等显示管道组件。
4. DRM 设备注册：调用 drm_dev_register() 将设备注册到 DRM 核心，创建设备节点 /dev/dri/cardX。
5. fbdev 兼容层（可选）：通过 drm_fbdev_generic_setup() 或自定义 fbdev 模拟层，为遗留应用提供 /dev/fbX 接口。

4.2 struct drm_driver 结构体详解

struct drm_driver 是 DRM 驱动的“身份证”与“功能清单”，它定义了驱动名称、支持的 IOCTL、内存管理方式、GEM 操作、fops 文件操作等核心回调。该结构体在 include/drm/drm_drv.h 中定义，是每个 DRM 驱动必须填充的入口。

4.2.1 核心成员分类

4.2.2 典型驱动实例代码

以下是一个嵌入式 DRM 驱动的 struct drm_driver 填充示例，展示了从 fbdev 移植时的关键适配点：

static const struct drm_driver xxx_drm_driver = {
    .driver_features    = DRIVER_GEM | DRIVER_MODESET | DRIVER_ATOMIC,
    .name               = "xxx_display",
    .desc               = "XXX SoC Display Controller DRM Driver",
    .date               = "20250101",
    .major              = 1,
    .minor              = 0,

    /* GEM 相关回调 */
    .gem_create_object  = xxx_gem_create_object,
    .gem_prime_import_sg_table = xxx_gem_prime_import_sg_table,
    .dumb_create        = xxx_dumb_create,
    .dumb_destroy       = xxx_dumb_destroy,
    .dumb_map_offset    = xxx_dumb_map_offset,

    /* 文件操作 */
    .fops               = &xxx_drm_fops,

    /* 中断与 VBLANK */
    .irq_handler        = xxx_irq_handler,
    .get_vblank_timestamp = xxx_get_vblank_timestamp,

    /* 调试 */
    .debugfs_init       = xxx_debugfs_init,
};

4.3 DRM 设备注册核心 API

驱动在 probe() 函数中需要按顺序调用以下 API 完成注册：

• drm_dev_alloc(&xxx_drm_driver, &pdev->dev)：分配并初始化 struct drm_device，绑定驱动结构体。
• dmm_xxx_init(drm)：自定义函数，初始化显示控制器硬件、创建 CRTC/Encoder/Connector/Plane。
• drm_dev_register(drm, 0)：将设备注册到 DRM 子系统，生成 /dev/dri/card0 节点。
• drm_fbdev_generic_setup(drm, 32)：创建 fbdev 兼容层，32 表示 bpp。

4.4 移植适配关键点

4.4.1 从 fbdev 到 DRM 的成员映射

4.5 注册流程代码骨架

以下是一个完整的 probe() 函数骨架，展示了 DRM 驱动注册的标准写法：

static int xxx_drm_probe(struct platform_device *pdev)
{
    struct drm_device *drm;
    int ret;

    /* 1. 分配 DRM 设备 */
    drm = drm_dev_alloc(&xxx_drm_driver, &pdev->dev);
    if (IS_ERR(drm))
        return PTR_ERR(drm);

    platform_set_drvdata(pdev, drm);

    /* 2. 硬件初始化：CRTC、Encoder、Connector、Plane */
    ret = xxx_display_init(drm);
    if (ret)
        goto err_free;

    /* 3. 注册 DRM 设备 */
    ret = drm_dev_register(drm, 0);
    if (ret)
        goto err_deinit;

    /* 4. 创建 fbdev 兼容层 */
    drm_fbdev_generic_setup(drm, 32);

    dev_info(&pdev->dev, "XXX DRM driver loaded successfully\n");
    return 0;

err_deinit:
    xxx_display_deinit(drm);
err_free:
    drm_dev_put(drm);
    return ret;
}