2. DRM框架基础：DRM架构与核心数据结构

DRM（Direct Rendering Manager）是Linux内核中负责图形显示和渲染管理的核心框架。它向上提供统一的用户空间接口（通过/dev/dri/card0等设备节点），向下抽象不同GPU和显示控制器的硬件差异。理解DRM的架构和核心数据结构，是掌握KMS组件初始化流程的前提。

2.1 DRM架构分层

DRM框架在Linux内核中位于字符设备层与硬件驱动层之间，其架构可分为三个层次：

1. 用户空间接口层： 提供ioctl系统调用，用户态程序（如Xorg、Wayland compositor、Mesa）通过/dev/dri/card0访问DRM功能。
2. DRM核心层： 实现设备注册、文件操作、缓冲区管理、帧缓冲（FB）、模式设置（KMS）、同步对象（fence）等通用逻辑。
3. 硬件驱动层： 由具体GPU厂商（Intel、AMD、NVIDIA、Qualcomm等）实现，填充drm_driver结构体中的回调函数，操作具体硬件寄存器。

2.2 核心数据结构：drm_device

drm_device是DRM框架中最重要的核心结构体，代表一个DRM设备实例。每个物理GPU或显示控制器对应一个drm_device对象。该结构体聚合了所有子系统的状态信息。

2.3 核心数据结构：drm_driver

drm_driver是驱动开发者需要重点实现的结构体。它定义了一组回调函数指针，DRM核心层在特定时机调用这些回调，驱动通过填充这些回调来操作硬件。

2.4 设备初始化流程

一个典型的DRM设备初始化流程包含以下步骤：

1. 平台驱动探测： 内核调用驱动的probe()函数，传入struct platform_device或struct pci_dev。
2. 分配drm_device： 调用drm_dev_alloc()分配并初始化drm_device，同时绑定drm_driver。
3. 硬件初始化： 驱动进行寄存器映射、时钟使能、中断注册等硬件操作。
4. KMS组件初始化： 创建crtc、encoder、connector、plane等KMS对象，并添加到mode_config。
5. 注册设备： 调用drm_dev_register()创建设备节点，暴露给用户空间。

2.5 代码示例：最小DRM驱动骨架

以下代码展示了一个最小DRM驱动的初始化骨架，重点展示drm_driver和drm_device的使用：

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

static int my_driver_open(struct drm_device *dev, struct drm_file *file)
{
    pr_info("DRM device opened\n");
    return 0;
}

static void my_driver_postclose(struct drm_device *dev, struct drm_file *file)
{
    pr_info("DRM device closed\n");
}

static struct drm_driver my_drm_driver = {
    .driver_features    = DRIVER_MODESET | DRIVER_GEM,
    .open               = my_driver_open,
    .postclose          = my_driver_postclose,
    .name               = "my_drm_driver",
    .desc               = "My Minimal DRM Driver",
    .date               = "20250101",
    .major              = 1,
    .minor              = 0,
};

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

    drm = drm_dev_alloc(&my_drm_driver, &pdev->dev);
    if (IS_ERR(drm))
        return PTR_ERR(drm);

    /* 硬件初始化代码在此 */

    ret = drm_dev_register(drm, 0);
    if (ret) {
        drm_dev_put(drm);
        return ret;
    }

    platform_set_drvdata(pdev, drm);
    return 0;
}

static int my_remove(struct platform_device *pdev)
{
    struct drm_device *drm = platform_get_drvdata(pdev);
    drm_dev_unregister(drm);
    drm_dev_put(drm);
    return 0;
}

static struct platform_driver my_pdrv = {
    .probe  = my_probe,
    .remove = my_remove,
    .driver = {
        .name = "my_drm_driver",
    },
};
module_platform_driver(my_pdrv);

MODULE_LICENSE("GPL");
MODULE_AUTHOR("KMS Expert");
MODULE_DESCRIPTION("Minimal DRM Driver Example");

2.6 关键概念对比