1. 课程导入

在嵌入式、桌面与服务端 Linux 系统中，显示输出往往是最直观、也最容易暴露问题的部分。从早期直接操作帧缓冲（framebuffer）的 /dev/fb0，到如今以 DRM/KMS 为核心的现代显示栈，Linux 显示子系统经历了从“能显示”到“可组合、可管理、可调试”的演进。本课程聚焦 KMS（Kernel Mode Setting，内核模式设置）组件的故障排查与调试工程，帮助你把“黑屏、花屏、分辨率异常、多屏错乱”等表象，还原为可定位、可验证、可复现的工程问题。

一、从 Framebuffer 到 DRM/KMS：显示子系统的演进

早期 Linux 显示依赖 fbdev（framebuffer device），它把显存抽象成一块线性缓冲区，用户空间通过 mmap 写入像素即可显示。fbdev 简单直接，但存在明显局限：模式设置（分辨率、刷新率、时序）通常由驱动在初始化时固定，运行时切换困难；多图层、硬件光标、页面翻转（page flip）等能力缺乏统一抽象；多显示设备之间也缺少统一的资源管理。

现代显示栈以 DRM（Direct Rendering Manager）为框架，KMS 是其负责显示模式设置与输出管理的子系统。KMS 把显示链路抽象为一条清晰的“对象流水线”：framebuffer 提供像素数据，plane 负责图层合成，CRTC 负责扫描输出与时序，encoder 负责信号编码，connector 负责物理接口与连接状态。用户空间通过 /dev/dri/card0 上的 ioctl 或原子（atomic）接口提交显示配置，内核在垂直消隐期安全地应用新状态。

二、KMS 的核心价值：为什么它是显示故障排查的主战场

KMS 的价值不只是“设置分辨率”，而是把显示输出变成可管理、可验证的状态机。它带来四个关键能力：

• 统一对象模型：framebuffer、plane、CRTC、encoder、connector 各自有明确职责，故障可以按对象逐层排查，而不是面对一团寄存器。
• 原子提交：一次 ioctl 提交完整显示状态，内核先校验再应用，避免中间态导致闪烁或花屏；失败时能返回具体错误。
• 热插拔与连接状态：connector 的 connected/disconnected 状态、EDID 读取结果，是判断“有没有信号”的第一手依据。
• 可观测性：debugfs、sysfs、dmesg 与用户态工具共同构成调试面，让问题从“猜”变成“看”。

三、故障排查工程的学习路径与方法流程

本课程不是零散命令的堆砌，而是一条工程化路径：先建立对象模型，再掌握观测工具，最后形成“现象→假设→验证→定位”的闭环。建议按以下流程推进：

1. 确认现象：黑屏、花屏、分辨率错误、多屏错乱、闪烁、无信号，分别对应不同对象层。
2. 收集证据：先看 dmesg 中的 DRM 日志，再看 connector 状态与 EDID，最后看 CRTC/plane 配置。
3. 缩小范围：用 modetest 或 drm_info 枚举对象，确认是“没有 connector”还是“connector 有但模式不对”。
4. 验证假设：手动设置模式、切换 plane、强制 connector 状态，观察变化。
5. 定位根因：区分驱动、固件、硬件、用户空间配置四类来源。

# 常用排查入口示例
dmesg | grep -i -E "drm|kms|hdmi|dp|edid"
ls /sys/class/drm/
cat /sys/class/drm/card0-HDMI-A-1/status
modetest -M rockchip -c
drm_info | head -n 40

四、典型场景与常见误区

场景一：设备启动后 HDMI 无输出。常见原因是 connector 状态为 disconnected，或 EDID 读取失败导致模式列表为空。此时应先确认物理连接与供电，再检查 dmesg 中是否有 HPD（热插拔检测）事件。

场景二：分辨率被限制在 1024x768。往往不是驱动不支持，而是 EDID 未正确解析，或用户空间未提交 preferred mode。可通过 modetest 查看 connector 的 modes 列表来验证。

场景三：多屏显示错位。需要检查 plane 与 CRTC 的绑定关系，以及每个 connector 对应的 encoder 是否被正确分配。

五、本课程的目标与复盘视角

学完本课程，你应当能够：独立读取 KMS 对象状态，使用 modetest、drm_info、debugfs 等工具定位显示问题；能够区分“驱动问题”与“配置问题”；能够把一次故障排查沉淀为可复用的检查清单。复盘时重点问三个问题：现象对应哪一层对象？证据是否支持假设？修复后是否验证了回归？