1. 课程导入
在嵌入式 Linux 与移动设备中，DRM（Direct Rendering Manager）是内核态显示驱动的核心子系统。它负责管理显示控制器、帧缓冲、图层合成、连接器与显示模式，并向上为 Wayland、X11、Android SurfaceFlinger 等图形栈提供统一接口。很多开发者初学 DRM 时，容易把注意力集中在“怎么把画面点亮”上，却忽略了两个决定最终画质与稳定性的关键环节：色彩管理与VBlank 同步。前者决定“颜色是否正确”，后者决定“画面是否稳定、是否撕裂”。本课程将围绕这两条主线，结合真实驱动代码与调试手段，建立完整的显示驱动开发能力。
一、学习目标
完成本课程后，你应当能够独立完成以下工作：
- 理解 DRM 显示管线的整体架构，说清 CRTC、Plane、Encoder、Connector、Framebuffer 各自的职责与数据流向。
- 掌握色彩管理链路：从像素格式、gamma、色彩空间转换（CSC）、3D LUT 到 HDR 元数据的传递路径。
- 理解 VBlank 中断的产生机制，掌握 page flip、原子提交（atomic commit）与 VBlank 事件的同步关系。
- 能够定位并解决撕裂、闪烁、色彩偏差、掉帧、提交超时等典型显示问题。
- 能够使用 modetest、drm_info、内核日志与 trace 工具验证显示状态与同步行为。
二、DRM 显示驱动开发整体框架
DRM 驱动可以粗略分为三层：用户态接口层（ioctl、dumb buffer、atomic API）、核心框架层（drm_crtc、drm_plane、drm_connector 等对象与状态机）、硬件驱动层（厂商 CRTC/Plane/Encoder 实现、中断处理、寄存器操作）。显示数据从应用提交的 Framebuffer 出发，经 Plane 合成、CRTC 扫描输出、Encoder 编码、Connector 送到物理面板。色彩管理作用于像素从 Framebuffer 到面板的整条链路，而 VBlank 同步则决定了“何时把新帧交给硬件”这一时间维度。
三、色彩管理与 VBlank 同步在显示管线中的位置
从上面的管线图可以看到，色彩管理是一条空间维度的处理链：像素从 Framebuffer 取出后，依次经过格式解析、gamma 校正、色彩空间转换、3D LUT 校准，最终以正确的亮度和色度送到面板。而 VBlank 同步是一条时间维度的控制链：显示控制器每完成一帧扫描就产生一次 VBlank 中断，驱动借此机会提交下一帧的地址与属性，保证画面在扫描间隙切换，避免撕裂。
两条链路并非独立。色彩管理参数（如 gamma 表、CSC 矩阵、LUT）通常作为 CRTC 或 Plane 的 property，在 atomic commit 时与 Framebuffer 一起提交。如果提交时机不对，就会出现“颜色已改但画面还没换”或“画面换了但颜色还是旧的”这类中间态。因此，理解 VBlank 同步是正确应用色彩管理的前提。
四、核心概念速查表
| 对象 / 机制 | 所属维度 | 核心职责 | 常见调试点 |
|---|---|---|---|
| Plane | 空间 | 图层合成、像素格式与缩放 | 格式不支持、叠加顺序错误 |
| CRTC | 空间 + 时间 | 扫描输出、gamma / CSC / LUT 承载 | 色彩属性未生效、时序错误 |
| Connector | 空间 | 连接面板、EDID、色彩能力上报 | HDR 元数据丢失、色深协商失败 |
| VBlank 中断 | 时间 | 帧边界标志、触发 flip 完成 | 中断丢失、计数不递增 |
| Atomic Commit | 空间 + 时间 | 一次性提交 Framebuffer 与色彩属性 | 提交超时、状态校验失败 |
五、典型场景：一次 HDR 视频播放的完整链路
假设用户在设备上播放一段 HDR10 视频，图形栈需要完成以下动作：解码器输出 10bit P010 帧，SurfaceFlinger 将其作为 Plane 提交；驱动在 CRTC 上配置 PQ 曲线与 BT.2020 到面板色域的 CSC 矩阵；同时通过 Connector 把 HDR 静态元数据（MaxCLL、MaxFALL）写入 InfoFrame。这些属性必须与 Framebuffer 在同一次 atomic commit 中生效，并且等待 VBlank 到来后才真正切换。若分两次提交，观众会看到一帧“颜色过曝但内容还是旧画面”的异常帧。
六、常见误区与复盘提示
- 误区一：只调 gamma 就以为完成了色彩管理。gamma 只是链路中的一环，忽略 CSC 与 LUT 会导致色域映射错误。
- 误区二：用 sleep 代替 VBlank 等待。固定延时无法适配不同刷新率，必然导致撕裂或掉帧。
- 误区三：忽略 property 的提交时机。色彩属性与 Framebuffer 不同步提交，会产生中间态闪烁。
- 误区四：不检查返回值。atomic commit 失败往往只打印一行日志，需要主动检查
-EINVAL与-EBUSY。
在后续章节中，我们将逐层拆解这些对象与机制，从寄存器配置到内核代码，再到用户态验证命令，帮助你建立可落地的调试能力。下面这段命令可用于快速查看当前显示管线的对象与属性，是后续实验的基础：
# 查看 DRM 设备与连接器状态
modetest -M rockchip -c
# 查看 CRTC / Plane 支持的色彩相关属性
modetest -M rockchip -p
# 查看内核 DRM 调试信息
cat /sys/kernel/debug/dri/0/summary