2. DRM 核心数据结构：drm_device、drm_driver、drm_file、drm_minor 的关系与初始化流程

DRM 子系统通过四个核心数据结构来管理显示设备、驱动实例、用户态会话以及设备节点访问。理解 drm_device、drm_driver、drm_file 和 drm_minor 之间的关系，是编写 GPU 驱动的基础。它们共同构成了从硬件抽象到用户空间接口的完整链路。

2.1 结构体定义与职责

2.2 四者之间的引用关系

下图展示了四个核心结构体之间的指针引用与层级关系：

2.3 初始化流程详解

DRM 驱动的初始化遵循严格的顺序，从静态定义到动态注册，再到用户态交互。以下是标准流程：

1. 定义全局 drm_driver：在驱动源码中声明一个静态的 struct drm_driver 实例，填充 driver_features、fops、gem_create_object 等回调。
2. 分配 drm_device：在 probe() 函数中调用 drm_dev_alloc()，传入 drm_driver 指针和父设备 struct device *。
3. 初始化驱动私有数据：通过 devm_drm_dev_init() 或手动设置 dev_private，完成 GPU 硬件特定的初始化（如 MMIO 映射、中断注册）。
4. 注册设备：调用 drm_dev_register()，该函数内部会创建 drm_minor 实例（primary、render、control），并在 sysfs 中创建设备节点。
5. 用户打开设备：当用户态调用 open() 时，VFS 层调用 drm_stub_open()，分配 drm_file 并调用 drm_driver->open 回调。

2.4 drm_minor 的三种类型

每个 drm_device 最多可以关联三个 drm_minor，分别对应不同的设备节点：

2.5 初始化流程的代码示例

以下是一个简化的 GPU 驱动 probe 函数，展示核心数据结构的初始化顺序：

#include <drm/drm_drv.h>
#include <drm/drm_device.h>

static const struct drm_driver mygpu_driver = {
    .driver_features = DRIVER_GEM | DRIVER_MODESET | DRIVER_RENDER,
    .fops = &mygpu_fops,
    .gem_create_object = mygpu_gem_create_object,
    .open = mygpu_open,
    .postclose = mygpu_postclose,
    .name = "mygpu",
    .desc = "My GPU DRM Driver",
    .date = "20250101",
    .major = 1,
    .minor = 0,
};

static int mygpu_probe(struct platform_device *pdev)
{
    struct drm_device *drm;
    struct mygpu_private *priv;
    int ret;

    /* 步骤1: 分配 drm_device，传入静态 drm_driver */
    drm = drm_dev_alloc(&mygpu_driver, &pdev->dev);
    if (IS_ERR(drm))
        return PTR_ERR(drm);

    /* 步骤2: 分配并初始化驱动私有数据 */
    priv = devm_kzalloc(&pdev->dev, sizeof(*priv), GFP_KERNEL);
    if (!priv) {
        ret = -ENOMEM;
        goto err_free;
    }
    drm->dev_private = priv;

    /* 步骤3: 硬件初始化（MMIO、IRQ、Fence 等） */
    ret = mygpu_hw_init(priv, pdev);
    if (ret)
        goto err_free;

    /* 步骤4: 注册 DRM 设备，内部创建 drm_minor */
    ret = drm_dev_register(drm, 0);
    if (ret)
        goto err_hw_fini;

    platform_set_drvdata(pdev, drm);
    return 0;

err_hw_fini:
    mygpu_hw_fini(priv);
err_free:
    drm_dev_put(drm);
    return ret;
}

2.6 drm_file 的创建与销毁

当用户态进程打开 DRM 设备节点时，内核调用 drm_stub_open()，其内部流程如下：

drm_file 的生命周期与文件描述符绑定。关键字段 driver_priv 允许驱动存储每个会话的私有数据（如命令队列、同步对象）。当用户调用 close() 时，内核调用 drm_lastclose() 或 driver->postclose() 进行清理。

2.7 关系总结