Linux内核显示驱动开发实战 - 第4节

4.1 DRM/KMS 核心概念

DRM (Direct Rendering Manager) 是 Linux 内核中负责图形显示和渲染的子系统。KMS (Kernel Mode Setting) 是 DRM 的一部分，负责显示模式设置、分辨率切换、平面合成等显示控制功能。理解 DRM/KMS 架构是开发显示驱动的第一步。

4.1.1 DRM 与 KMS 的关系

4.2 DRM 子系统架构

DRM 子系统采用分层架构设计，从上到下依次为：用户空间接口层、DRM 核心框架、KMS 模式设置层、硬件驱动层。每一层都定义了清晰的接口和回调函数。

4.2.1 架构组件详解

• DRM Core (drm_core.c)：提供设备注册、文件操作、ioctl 分发、内存管理基础框架。
• DRM GEM (Graphics Execution Manager)：通用图形内存管理器，负责 buffer 分配、映射、共享。
• DRM KMS Helper (drm_kms_helper)：简化 KMS 驱动开发的辅助层，提供 atomic commit 框架。
• DRM Driver：具体硬件驱动，实现 struct drm_driver 中的回调函数。

4.3 DRM 核心对象详解

KMS 的核心在于四个对象：CRTC、Encoder、Connector、Plane。它们共同描述了从帧缓冲区到显示面板的完整数据通路。

4.3.1 核心对象职责

4.3.2 数据通路与对象连接关系

典型的显示数据流为：Framebuffer → Plane → CRTC → Encoder → Connector → Display。每个对象通过 possible_crtcs、possible_clones 等掩码字段建立连接关系。

4.4 核心对象编程接口

4.4.1 CRTC 操作

CRTC 是显示控制器的核心，驱动需要实现 struct drm_crtc_helper_funcs 中的回调：

struct drm_crtc_helper_funcs {
    void (*mode_valid)(struct drm_crtc *crtc,
                       const struct drm_display_mode *mode);
    void (*mode_set)(struct drm_crtc *crtc,
                     struct drm_display_mode *mode,
                     struct drm_display_mode *adjusted_mode);
    void (*atomic_enable)(struct drm_crtc *crtc,
                          struct drm_crtc_state *old_state);
    void (*atomic_disable)(struct drm_crtc *crtc,
                           struct drm_crtc_state *old_state);
};

4.4.2 Encoder 与 Connector 配对

Encoder 和 Connector 通过 drm_connector_attach_encoder() 建立绑定关系：

struct drm_encoder *encoder;
struct drm_connector *connector;

/* 初始化 encoder */
drm_encoder_init(drm_dev, encoder, &encoder_funcs,
                 DRM_MODE_ENCODER_TMDS, NULL);

/* 初始化 connector */
drm_connector_init(drm_dev, connector, &connector_funcs,
                   DRM_MODE_CONNECTOR_HDMIA);

/* 建立连接 */
drm_connector_attach_encoder(connector, encoder);

4.4.3 Plane 配置

Plane 支持多种类型，驱动初始化时需指定：

struct drm_plane *primary_plane;
struct drm_plane *overlay_plane;

/* 主平面 — 必须存在 */
drm_universal_plane_init(drm_dev, primary_plane, 0,
                         &primary_plane_funcs,
                         primary_formats, ARRAY_SIZE(primary_formats),
                         NULL, DRM_PLANE_TYPE_PRIMARY, NULL);

/* 叠加平面 — 可选 */
drm_universal_plane_init(drm_dev, overlay_plane, 0,
                         &overlay_plane_funcs,
                         overlay_formats, ARRAY_SIZE(overlay_formats),
                         NULL, DRM_PLANE_TYPE_OVERLAY, NULL);

4.5 对象初始化流程

在驱动 probe 函数中，核心对象的初始化顺序至关重要：

1. 初始化 DRM 设备：调用 drm_dev_alloc() 或 devm_drm_dev_alloc()。
2. 初始化 CRTC：调用 drm_crtc_init_with_planes() 绑定主平面和光标平面。
3. 初始化 Encoder：调用 drm_encoder_init()，指定编码器类型。
4. 初始化 Connector：调用 drm_connector_init()，实现 .get_modes 回调读取 EDID。
5. 建立连接：调用 drm_connector_attach_encoder() 绑定 Encoder。
6. 注册设备：调用 drm_dev_register() 暴露给用户空间。

4.6 常见问题与调试技巧

4.6.1 调试命令