1. 课程导入
欢迎进入《DRM显示驱动开发 GPU渲染与多平面合成实践》课程。本课程面向已经具备一定 Linux 内核基础、希望深入显示子系统与图形栈的开发者。我们将以 DRM（Direct Rendering Manager）为主线，把 GPU 渲染、KMS 显示管线、多平面合成、内存管理与调试手段串成一条完整的工程路径。学完本课程，你应当能够读懂主流显示驱动的关键代码路径，能够定位黑屏、花屏、撕裂、掉帧等典型问题，并具备独立完成一个简单显示驱动或合成方案的能力。
一、学习目标：从“会用”到“能改、能调、能优化”
本课程的学习目标分为四个层次。第一层是概念清晰：理解 DRM 与 KMS、GEM、Framebuffer、Plane、CRTC、Encoder、Connector 之间的关系，理解为什么现代显示栈要把“渲染”和“显示”解耦。第二层是代码可读：能够沿着 drm_atomic_commit、drm_mode_set_config_internal、drm_gem_handle_create 等入口，追踪一次显示更新的完整生命周期。第三层是问题可调：掌握 modetest、drm_info、debugfs、ftrace、GPU 厂商调试工具的使用方法，能区分是渲染侧、合成侧还是显示时序侧的问题。第四层是方案可做：能够基于 atomic API 实现多平面合成，理解 overlay、cursor、primary 的分配策略，并能对带宽、延迟、功耗做初步权衡。
二、核心概念：一张图看清 DRM 显示栈
DRM 显示栈的核心对象可以按“数据”和“控制”两条线理解。数据线围绕 GEM（Graphics Execution Manager）和 Framebuffer 展开：GEM 管理显存对象，Framebuffer 描述一块可以被扫描输出的像素缓冲，Plane 则把 Framebuffer 绑定到某个显示层上。控制线围绕 CRTC、Encoder、Connector 展开：CRTC 负责扫描时序与合成，Encoder 把像素流转换为 HDMI、DP、MIPI DSI 等信号，Connector 表示物理接口及其连接状态。Atomic API 把这两条线统一到一次不可分割的提交中，保证显示状态的一致性。
下面这张图展示了本节最值得先建立的整体框架：从用户空间到内核 DRM 子系统，再到 GPU 渲染与显示硬件的信号链关系。请重点观察“渲染结果如何变成 Framebuffer”“Plane 如何进入 CRTC 合成”“Connector 如何把最终画面送出”这三条路径。
三、方法流程：一次显示更新的完整生命周期
理解 DRM 显示驱动，最有效的方法是抓住“一次显示更新”的完整流程。下面用清单形式列出关键阶段，建议你在阅读代码时反复对照。
- 准备阶段：用户空间通过 libdrm 创建 GEM 对象、分配 Framebuffer，并准备 Plane 属性（位置、尺寸、格式、旋转、alpha）。
- 提交阶段：调用
drmModeAtomicCommit，把 CRTC、Plane、Connector 的新状态打包成 atomic 请求，设置DRM_MODE_ATOMIC_TEST_ONLY可先做校验。 - 校验阶段：DRM 核心调用驱动的
atomic_check，检查带宽、缩放能力、格式支持、Plane 与 CRTC 的匹配关系。 - 提交阶段：校验通过后进入
atomic_commit，驱动把新状态写入硬件寄存器，并可能触发 page flip。 - 完成阶段：硬件在 vblank 时刻切换扫描缓冲，产生 flip 完成事件，用户空间收到回调后可以复用旧缓冲。
# 典型调试命令：查看当前 KMS 状态
modetest -M rockchip -c
modetest -M rockchip -p
drm_info | grep -E "CRTC|Plane|Connector"
# 查看 atomic 提交与 flip 事件
cat /sys/kernel/debug/dri/0/summary
cat /sys/kernel/debug/dri/0/state四、案例与场景：多平面合成中的典型决策
假设一个视频播放场景：底层是视频帧，上层是字幕，最上层是鼠标光标。显示驱动需要决定哪些层走硬件 overlay，哪些层走 GPU 合成。如果视频层和字幕层都支持独立 Plane，且格式与缩放能力满足要求，就可以让 CRTC 直接混合，GPU 几乎不参与合成，功耗和延迟都更优。如果字幕层需要复杂 alpha 混合或旋转，而硬件 Plane 不支持，则必须回退到 GPU 合成，把结果写入一个 Framebuffer 再交给 primary Plane 显示。
| 场景 | 推荐路径 | 关键检查点 | 常见风险 |
|---|---|---|---|
| 视频 + 字幕 | 视频走 overlay，字幕走 cursor/overlay | 格式、缩放、Z-order、带宽 | Plane 数量不足导致回退 GPU |
| 游戏全屏 | GPU 渲染到 primary Plane | fence 同步、page flip 时序 | 撕裂、掉帧、延迟增加 |
| 多屏异显 | 每个 CRTC 独立绑定 Plane 与 Connector | 时钟资源、带宽分配、EDID | 热插拔后状态未重建 |
| UI 合成 | Wayland 合成器决定 overlay 或 GPU | damage 区域、alpha、色彩空间 | 过度合成导致功耗升高 |
五、误区与复盘：初学者最容易踩的坑
复盘时建议按“渲染—合成—显示”三段排查：先确认 GPU 是否按时完成渲染并发出 fence；再确认合成器是否把正确的 Framebuffer 绑定到 Plane；最后确认 CRTC 时序、Connector 状态与硬件寄存器是否一致。掌握这条排查链路，比记住零散 API 更有价值。
六、实战路线图：30 章如何学
本课程后续将沿着“基础对象 → 渲染路径 → 合成策略 → 调试优化”推进。建议你每学完一章，都在开发板上跑一次对应实验：用 modetest 验证 KMS 对象，用 kmscube 验证 GPU 渲染，用 perf 与 ftrace 观察提交延迟。遇到黑屏先查 Connector 状态，遇到花屏先查格式与 stride，遇到撕裂先查 page flip 与 vblank。把每一章的知识点落到一次可复现的实验上，你就能真正把 DRM 显示驱动开发变成可迁移的工程能力。