4. DRM/KMS 框架概述：架构分层与色彩管理数据结构

DRM (Direct Rendering Manager) 是 Linux 内核中负责图形显示和渲染的子系统。KMS (Kernel Mode Setting) 是 DRM 的核心部分，负责显示模式设置、平面合成、Gamma 校正和色彩管理。理解 DRM/KMS 的架构分层和核心对象角色，是配置 CRTC Gamma 校正和色彩管理的基础。

4.1 DRM 架构分层

DRM 框架从上到下分为三层：用户空间接口层、核心抽象层和硬件驱动层。每一层都有明确的职责边界。

4.2 核心 KMS 对象角色

KMS 框架定义了四个核心对象：CRTC、Encoder、Connector 和 Plane。它们共同构成显示流水线。

4.3 色彩管理相关数据结构

DRM 核心层定义了一系列与色彩管理相关的数据结构，它们通过 property 机制暴露给用户空间。以下是关键结构体及其字段说明。

4.3.1 struct drm_crtc 中的色彩管理字段

struct drm_crtc {
    struct drm_device *dev;
    struct drm_mode_object base;

    /* Gamma LUT 相关 */
    struct drm_property_blob *gamma_lut;      // Gamma 校正查找表
    struct drm_property_blob *degamma_lut;    // Degamma 查找表（可选）
    struct drm_property_blob *ctm;            // 色彩变换矩阵

    /* 色彩管理属性 */
    struct drm_property *gamma_lut_property;
    struct drm_property *degamma_lut_property;
    struct drm_property *ctm_property;

    /* 其他字段省略 */
};

4.3.2 struct drm_color_lut 查找表结构

struct drm_color_lut {
    __u16 red;    // 红色通道值 (0-65535)
    __u16 green;  // 绿色通道值 (0-65535)
    __u16 blue;   // 蓝色通道值 (0-65535)
    __u16 reserved; // 保留位
};

4.3.3 struct drm_color_ctm 色彩变换矩阵

struct drm_color_ctm {
    /*
     * 3x3 矩阵，以 S31.32 定点格式存储
     * 矩阵排列顺序：row-major
     * matrix[0] = c00, matrix[1] = c01, matrix[2] = c02
     * matrix[3] = c10, matrix[4] = c11, matrix[5] = c12
     * matrix[6] = c20, matrix[7] = c21, matrix[8] = c22
     */
    __s64 matrix[9];
};

4.3.4 Plane 层色彩属性

4.4 色彩管理属性与 Atomic 接口

现代 DRM 驱动推荐使用 Atomic API 进行色彩管理配置。Atomic 接口允许在一次事务中同时设置多个属性，保证状态切换的原子性。

4.5 数据结构关系总结

下表总结了色彩管理相关数据结构与 KMS 对象的对应关系：