1. KMS概述：KMS在Linux图形栈中的位置、核心作用、与DRM的关系
1.1 Linux图形栈全景
Linux图形栈从用户态到内核态可划分为四个主要层次。KMS（Kernel Mode Setting）位于内核空间，是图形栈中连接显示硬件与上层图形框架的桥梁。
关键层次： 用户态应用 → 窗口系统/合成器 → DRM/KMS 内核子系统 → 显示硬件
| 层次 | 组件 | 职责 |
|---|---|---|
| 用户态应用 | GUI程序、游戏、视频播放器 | 生成图形内容，提交渲染请求 |
| 窗口系统/合成器 | Wayland/Weston、Xorg/XWayland | 管理窗口布局、合成最终画面、与KMS交互 |
| 内核图形子系统 | DRM + KMS | 提供显存管理、模式设置、页面翻转、fence同步 |
| 显示硬件 | GPU、Display Controller、Encoder、Connector | 实际像素输出到显示器 |
1.2 KMS的核心作用
KMS（Kernel Mode Setting）将显示模式设置从用户态X服务器移入内核，解决了多显示服务器共存时的模式冲突问题。其核心职责包括：
- 显示模式管理： 配置分辨率、刷新率、像素格式、扫描时序等显示参数。
- 显示管道配置： 管理CRTC（显示控制器）、Encoder（编码器）、Connector（连接器）、Plane（图层）之间的连接关系。
- 页面翻转（Page Flip）： 在VBlank期间原子切换帧缓冲，避免撕裂。
- 原子操作（Atomic）： 将多个显示更新打包为一个原子提交，保证状态一致性。
- 电源管理： 处理DPMS、休眠/唤醒、热插拔事件。
调试要点： KMS故障排查的核心是检查CRTC-Encoder-Connector管道是否完整连接、时序参数是否正确、以及页面翻转是否在VBlank窗口内完成。
1.3 DRM与KMS的关系
DRM（Direct Rendering Manager）是Linux内核中图形显示子系统的总框架，KMS是DRM框架中的一个核心功能模块。二者是包含与被包含的关系。
| 维度 | DRM | KMS |
|---|---|---|
| 全称 | Direct Rendering Manager | Kernel Mode Setting |
| 定位 | 图形显示子系统的整体框架 | DRM框架中的模式设置模块 |
| 主要功能 | 显存分配（GEM）、命令提交（Command Submission）、同步对象（Fence）、KMS | 显示模式配置、CRTC/Encoder/Connector管理、页面翻转、原子操作 |
| 用户态接口 | /dev/dri/card0（主设备）、/dev/dri/renderD128（渲染设备） | /dev/dri/card0 上的DRM_IOCTL_MODE_* 命令 |
| 依赖关系 | KMS是DRM的子模块 | 依赖DRM的GEM显存管理和设备模型 |
1.4 KMS的硬件抽象模型
KMS通过一组标准化的内核对象抽象显示硬件，这些对象通过DRM IOCTL暴露给用户态。理解这些对象是KMS调试的基础。
| KMS对象 | 硬件对应 | 关键属性 |
|---|---|---|
| CRTC | 显示控制器（Display Controller） | 扫描时序、分辨率、像素时钟、背景色 |
| Encoder | 编码器（TMDS、LVDS、DP、HDMI） | 编码类型、支持的连接器、电源状态 |
| Connector | 物理接口（HDMI、DP、VGA、eDP） | 连接状态、EDID、物理尺寸、热插拔状态 |
| Plane | 硬件图层（Overlay、Primary、Cursor） | 帧缓冲、位置、大小、透明度、Z-order |
| Framebuffer | 显存中的像素缓冲区 | 宽度、高度、像素格式、stride、handle |
1.5 KMS在调试中的重要性
在显示子系统故障排查中，KMS是第一个需要检查的环节。常见的KMS故障现象包括：
- 黑屏/无显示： CRTC未使能、Connector未连接、时序参数错误。
- 显示花屏/偏移： Framebuffer stride不匹配、像素格式错误、Plane位置异常。
- 屏幕撕裂： 页面翻转未在VBlank窗口内完成、缺少fence同步。
- 分辨率异常： EDID读取失败、模式列表为空、时钟频率不支持。
- 热插拔不响应： Connector状态检测失败、uevent未正确上报。
调试原则： 遇到显示问题时，首先通过
cat /sys/kernel/debug/dri/0/state 或 modetest 检查KMS对象状态，确认CRTC-Encoder-Connector管道是否完整，再逐层向上排查。
1.6 常用KMS调试工具
| 工具 | 来源 | 用途 |
|---|---|---|
| modetest | libdrm测试工具 | 枚举KMS对象、测试模式设置、页面翻转 |
| drm_info | drm_info项目 | 显示DRM设备、KMS对象、属性详细信息 |
| kmscube | mesa示例程序 | 验证KMS+GPU渲染管道是否正常 |
| igt-gpu-tools | Intel GPU工具集 | KMS测试套件，包含kms_flip、kms_atomic等 |
| /sys/kernel/debug/dri/ | 内核debugfs | 查看KMS对象状态、帧缓冲信息、fence状态 |
快速验证命令：
# 查看DRM设备列表
ls /dev/dri/
# 使用modetest枚举KMS对象
modetest -M xxxx -c
# 查看当前KMS状态（需要root）
cat /sys/kernel/debug/dri/0/state