3. DRM基础概念：DRM架构概览、核心组件

DRM（Direct Rendering Manager）是Linux内核中现代图形显示子系统的核心框架，它取代了传统的Framebuffer架构，为GPU、显示控制器和内存管理提供了统一的抽象层。理解DRM的架构和核心组件，是从Framebuffer向DRM移植适配的关键第一步。

3.1 DRM架构概览

DRM架构采用分层设计，从上到下依次为：用户空间应用程序、libdrm库、DRM内核驱动层以及硬件设备层。内核中的DRM子系统由三个核心模块组成：DRM Core、KMS（Kernel Mode Setting）和GEM（Graphics Execution Manager）。

3.2 核心组件详解

3.2.1 DRM Core

DRM Core是整个DRM框架的基础设施，负责设备注册、文件操作接口、ioctl调度、缓冲区管理以及驱动生命周期管理。它向上对用户空间暴露/dev/dri/card0设备节点，向下通过drm_driver结构体与具体硬件驱动交互。

3.2.2 KMS (Kernel Mode Setting)

KMS是DRM中负责显示输出管理的子系统，它替代了传统Framebuffer中fb_set_par和fb_blank等分散的回调。KMS将显示管线抽象为五个核心对象：CRTC、Encoder、Connector、Plane和FB。驱动通过实现这些对象的回调函数来控制显示时序、像素时钟、色彩空间和图层合成。

3.2.3 GEM (Graphics Execution Manager)

GEM是DRM的显存管理子系统，负责分配、释放和管理GPU/显示控制器使用的缓冲区对象（BO）。GEM提供了基于句柄（handle）和文件描述符（FD）的共享机制，支持CPU映射和DMA-BUF导出。对于没有GPU的嵌入式平台，DRM提供了dumb buffer机制作为GEM的简化实现。

3.2.4 Dumb Buffer

Dumb buffer是DRM为简单显示控制器（如嵌入式LCD控制器）提供的轻量级显存分配方案。它不需要GPU或复杂的显存管理器，驱动只需实现drm_driver.dumb_create、drm_driver.dumb_destroy和drm_driver.dumb_map_offset三个回调。用户空间通过ioctl创建dumb buffer后，可以直接mmap到用户空间进行像素填充，然后通过KMS的page flip提交显示。

/* dumb buffer 典型使用流程（用户空间） */
int fd = open("/dev/dri/card0", O_RDWR);

/* 1. 创建 dumb buffer */
struct drm_mode_create_dumb create = {
    .width = 1024,
    .height = 600,
    .bpp = 32,
};
ioctl(fd, DRM_IOCTL_MODE_CREATE_DUMB, &create);

/* 2. 获取 mmap 偏移 */
struct drm_mode_map_dumb map = {
    .handle = create.handle,
};
ioctl(fd, DRM_IOCTL_MODE_MAP_DUMB, &map);

/* 3. mmap 到用户空间 */
uint32_t *fb_ptr = mmap(NULL, create.size, PROT_READ | PROT_WRITE,
                        MAP_SHARED, fd, map.offset);

/* 4. 填充像素数据（例如填充为红色） */
for (int i = 0; i < 1024 * 600; i++)
    fb_ptr[i] = 0x00FF0000;  /* ARGB: 红色 */

/* 5. 通过 KMS 提交显示（需要先设置 CRTC 和 Connector） */
/* ... 省略 KMS 配置代码 ... */

3.3 核心组件协作流程

一个典型的DRM显示提交流程如下：

1. 初始化阶段：DRM Core加载驱动，注册drm_device；KMS探测Connector和Encoder，读取EDID获取显示模式；GEM初始化显存分配器。
2. 缓冲区分配：用户空间通过DRM_IOCTL_MODE_CREATE_DUMB（或GEM）创建帧缓冲，驱动分配物理连续内存并返回句柄。
3. FB绑定：用户空间通过DRM_IOCTL_MODE_ADDFB将dumb buffer句柄注册为KMS的FB对象，指定像素格式和步长。
4. 模式设置：用户空间通过DRM_IOCTL_MODE_SETCRTC或DRM_IOCTL_MODE_ATOMIC将FB绑定到CRTC，设置显示分辨率和刷新率。
5. Page Flip：用户空间通过DRM_IOCTL_MODE_PAGE_FLIP提交新帧，驱动在VBlank中断中切换显示缓冲区地址，实现无撕裂显示。

3.4 从Framebuffer到DRM的组件映射

为了帮助开发者快速理解DRM与Framebuffer的对应关系，下表列出了关键概念的映射：