1. 课程导入
在嵌入式 Linux 产品中，显示往往是最直观、也最容易“看起来简单、调起来复杂”的模块。点亮一块屏幕，表面上是背光亮起、图像出现，背后却涉及 framebuffer、DRM/KMS、显示控制器（VOP）、MIPI DSI/DP/HDMI 编码器、PHY、面板时序以及设备树配置等多层协作。瑞芯微（Rockchip）平台在平板、商显、工业 HMI、车载与 AI 边缘设备中应用广泛，其显示子系统既遵循 Linux DRM/KMS 通用框架，又带有明显的平台特色。本课程以“配置 + 调试”为主线，帮助工程师从能点亮屏幕，进阶到能定位黑屏、花屏、闪屏、分辨率异常、多屏不同步等典型问题。
一、从 Framebuffer 到 DRM/KMS：显示子系统的演进
早期 Linux 显示以 fbdev（framebuffer device）为主，/dev/fb0 提供一块线性显存，应用通过 ioctl 设置分辨率、像素格式并直接写显存。它的优点是模型简单，缺点是缺少统一的模式设置、图层合成、原子提交和多屏管理能力，难以适应现代 SoC 的多图层、多显示通路需求。
DRM（Direct Rendering Manager）最初服务于 GPU 渲染与显存管理，后来通过 KMS（Kernel Mode Setting）接管显示模式设置。KMS 把显示抽象为一条清晰的管线：framebuffer 提供像素数据，plane 负责图层合成，CRTC 负责扫描输出与时序，encoder 把像素流转换为 HDMI、MIPI DSI、DP 等信号，connector 连接物理显示设备，最后到达 panel 或显示器。相比 fbdev，KMS 支持原子提交、多图层、多 CRTC、热插拔与统一调试接口，因此成为当前 Linux 显示的主流方案。
二、DRM/KMS 核心对象与数据流
理解 KMS，关键是理解对象之间的“连接关系”和“提交关系”。framebuffer 是像素来源；plane 把 framebuffer 贴到某个 CRTC 上，并支持位置、缩放、旋转、alpha 等属性；CRTC 对应显示控制器的一次扫描输出，决定分辨率、刷新率、时序；encoder 把 CRTC 的像素流编码为具体接口信号；connector 表示物理连接器或面板，负责读取 EDID、检测热插拔、报告连接状态。用户空间通过 atomic commit 一次性提交这些对象的属性变化，内核在垂直消隐期生效，从而避免撕裂和中间状态。
调试时，常用工具包括 modetest、kmscube、drm_info 以及内核 debugfs。例如查看当前显示状态：
# 查看 DRM 设备与连接器状态
modetest -M rockchip -c
modetest -M rockchip -p
# 查看内核 DRM 调试信息
cat /sys/kernel/debug/dri/0/summary
cat /sys/kernel/debug/dri/0/state这些输出能直接反映 connector 是否 connected、当前 mode 是多少、plane 是否使能、CRTC 是否 active。很多“黑屏”问题，第一步不是改代码，而是先确认 KMS 状态是否已经正确建立。
三、瑞芯微平台显示特点
瑞芯微平台通常使用 VOP（Video Output Processor）作为显示控制器，不同芯片系列在 VOP 版本、图层数量、最大分辨率、支持的接口组合上存在差异。其显示子系统常见特点包括：
- 多显示通路： 一颗 SoC 可能同时支持 MIPI DSI、HDMI、eDP、DP、RGB 等多种输出，部分型号支持双屏异显。
- 设备树强相关： 屏幕时序、背光、电源、复位、DSI 通道数、lane 速率等大量参数通过设备树描述，配置错误会直接导致无显示。
- 面板与桥接芯片多样： 常见 MIPI 面板、LVDS 桥接、HDMI 桥接、Type-C 转 DP 等，需要正确匹配 panel 驱动与 bridge 驱动。
- 调试接口丰富： 可通过 debugfs 查看 VOP 寄存器、时钟、电源域、连接器状态，也常结合示波器测量 MIPI 时钟与数据线。
四、课程学习路径与实战目标
本课程共 30 章，整体按“认知—配置—调试—优化—实战”推进。前段建立 DRM/KMS 与瑞芯微显示子系统的整体认知；中段围绕设备树、VOP、DSI、HDMI、panel、backlight 等关键节点进行配置讲解；后段进入调试实战，包括黑屏、花屏、闪屏、分辨率异常、多屏配置、性能与功耗优化等典型场景。
| 阶段 | 核心内容 | 实战目标 |
|---|---|---|
| 认知建立 | DRM/KMS 架构、对象模型、瑞芯微显示特点 | 能说清一条显示通路的完整链路 |
| 配置入门 | 设备树、VOP、DSI/HDMI、panel、backlight | 能独立完成一块屏幕的点亮配置 |
| 调试进阶 | modetest、debugfs、日志分析、时序测量 | 能定位黑屏、花屏、闪屏等常见问题 |
| 多屏与优化 | 双屏异显、图层合成、带宽与功耗 | 能完成多屏场景配置与基础性能调优 |
| 综合实战 | 完整项目案例复盘与排障流程 | 形成可复用的显示调试方法论 |
五、常见误区与学习建议
初学者最容易陷入三个误区：第一，只关注应用层，不理解 KMS 对象关系，导致看到 modetest 输出却不知道问题在哪；第二，忽略设备树与硬件连接，把黑屏简单归因于驱动 bug；第三，缺少分层排查意识，一上来就改内核代码，反而掩盖了时钟、电源或时序问题。
完成本章学习后，你应当能够描述 Linux 显示从 fbdev 到 DRM/KMS 的演进逻辑，画出 framebuffer、plane、CRTC、encoder、connector 与瑞芯微 VOP 的对应关系，并明确本课程后续的配置与调试主线。接下来的内容将围绕真实平台配置与问题场景展开，逐步建立可落地的工程能力。