显示驱动项目部署：weston合成器与KMS框架配置 - 第1节
1.1 显示驱动项目背景
嵌入式显示系统正从简单的帧缓冲（Framebuffer）向硬件合成、多平面叠加、高刷新率演进。现代嵌入式设备（车载仪表、智能家居、工业 HMI）要求同时处理多个显示图层——导航地图、视频流、触控反馈——且不能出现撕裂或延迟。这推动显示驱动从“单缓冲区输出”升级为“基于 KMS 的原子化显示栈”。
项目驱动因素：
- 多图层合成：硬件 overlay 平面替代软件合成，降低 CPU 负载。
- 原子提交：一次 ioctl 完成所有 plane/crtc/connector 状态切换，消除闪烁。
- DRM leasing：VR/AR 设备独占显示管线成为可能。
- 安全隔离：Weston 的 IVI 扩展实现多客户端互不干扰。
本课程选取 Weston 合成器与 KMS（Kernel Mode Setting）作为核心实践对象，因为它们是 Linux 桌面与嵌入式显示事实上的标准层。完成本课程后，你将能独立部署一套支持多图层、零撕裂、低延迟的显示驱动系统。
1.2 Weston 与 KMS 在 Linux 图形栈中的位置
Linux 图形栈从底层到用户空间可划分为 4 个层次。Weston 与 KMS 分别位于用户空间合成层和内核显示驱动层，中间通过 DRM 接口通信。
| 层次 | 组件 | 职责 | 本课程覆盖 |
|---|---|---|---|
| 应用层 | Qt / GTK / SDL / Flutter | UI 渲染、事件处理 | 否（仅作为 Weston 客户端） |
| 合成层 | Weston / Mutter / KWin | 多客户端合成、输入分发、协议实现 | 是 |
| 图形库层 | libdrm / Mesa EGL / GB | DRM ioctl 封装、GPU 加速合成 | 部分（libdrm 接口） |
| 内核层 | KMS (DRM) / GPU 驱动 | 显示模式设置、平面管理、VBlank 控制 | 是 |
关键理解：Weston 不直接操作硬件寄存器。它通过 libdrm 调用 KMS 的 atomic ioctl 来配置 CRTC、Plane、Connector。KMS 负责将合成后的帧缓冲（Framebuffer）输出到显示面板。两者分工明确：Weston 决定“画什么”，KMS 决定“怎么显示”。
1.3 课程目标与学习路径
课程总目标
完成本课程后，学员将能够：
- 独立编译部署 Weston 合成器到嵌入式 Linux 目标板。
- 配置 KMS 驱动，实现多平面叠加、原子提交、VBlank 同步。
- 诊断并解决 显示撕裂、帧率不稳、平面分配失败等常见问题。
- 编写自定义 Weston 后端，适配非标准显示硬件。
- 执行性能基准测试，量化合成延迟与 CPU/GPU 负载。
学习路径（30 章结构）
| 阶段 | 章节范围 | 核心产出 |
|---|---|---|
| 基础准备 | 第 1–5 章 | 开发环境搭建、DRM 概念理解、libdrm 编程入门 |
| KMS 深度实践 | 第 6–12 章 | 原子 API 使用、多平面配置、VBlank 与 Page Flip |
| Weston 部署与定制 | 第 13–22 章 | Weston 编译、后端开发、IVI 扩展、输入集成 |
| 调优与项目实战 | 第 23–30 章 | 性能分析、故障排查、完整项目交付 |
前置要求：学员应具备 C 语言基础、Linux 内核模块基本概念、以及嵌入式 Linux 交叉编译经验。如果对 DRM 完全陌生，建议先阅读
drm-howto 内核文档（Documentation/gpu/drm-howto.rst）。
推荐学习方式
- 边学边练：每章结束后，在目标板上运行对应的代码示例。
- 使用 QEMU 模拟：如果没有物理开发板，可使用
qemu-system-arm配合 virtio-gpu 模拟 KMS 环境。 - 阅读源码：Weston 源码位于
git://gitlab.freedesktop.org/wayland/weston.git，KMS 示例参考libdrm/tests/。 - 加入社区：遇到问题可查阅 wayland-devel 邮件列表或 #wayland IRC 频道。