3. Linux显示子系统概述

在排查 encoder 连接故障之前，必须先建立一张“显示通路地图”。Linux 内核显示子系统以 DRM（Direct Rendering Manager）为核心框架，KMS（Kernel Mode Setting）是其负责显示模式设置与像素流管理的子模块。理解 DRM/KMS 的组件划分与数据流方向，才能判断故障发生在应用层、内核驱动层、物理接口层还是显示端。

一、核心原理：DRM/KMS 的分层与对象模型

DRM 将显示硬件抽象为一组可枚举、可连接的内核对象。KMS 部分主要包含以下对象：

• Framebuffer（FB）：描述一块内存中的像素数据，包含格式、宽高、pitch 等信息。
• Plane：图层，负责从 Framebuffer 取像素，可进行缩放、旋转、格式转换，并叠加到 CRTC 上。
• CRTC：显示控制器，负责时序生成（行场同步、消隐区）、扫描输出，是“像素流的发动机”。
• Encoder：编码器，把 CRTC 输出的并行像素时序转换为特定接口信号（如 MIPI DSI、LVDS、HDMI TMDS、eDP）。
• Connector：连接器，代表物理输出口，负责探测显示端是否插入、读取 EDID、维护连接状态。
• Bridge：桥接芯片抽象，用于连接 SoC 内部 encoder 与外部转换芯片（如 DSI 转 HDMI、DP 转 eDP）。

这些对象通过“可能连接关系”组成拓扑：Framebuffer → Plane → CRTC → Encoder → Connector → 显示面板。内核在 modeset 时，会沿着这条链路逐级配置，任何一级缺失或状态异常，都会导致黑屏、无信号或分辨率错误。

二、数据流与信号链：从应用提交到屏幕点亮

用户空间通过 DRM ioctl 或原子提交（atomic commit）把绘制好的 buffer 交给内核。内核 DRM 框架将 buffer 映射为 Framebuffer，Plane 在扫描时读取像素，CRTC 按当前 mode 生成时序，Encoder 把时序编码为接口信号，最终由 Connector 输出到显示端。整个过程可概括为“内存像素 → 图层合成 → 时序生成 → 接口编码 → 物理连接 → 面板显示”。

下面这张图展示了 DRM/KMS 的组件拓扑与数据流方向，也是排查 encoder 连接故障时最常用的“定位地图”：

三、方法流程：用 sysfs 与 debugfs 观察链路状态

排查 encoder 连接问题，第一步不是改代码，而是“看状态”。DRM 在 sysfs 和 debugfs 中暴露了完整的对象状态，常用命令如下：

# 查看所有 DRM 卡
ls /sys/class/drm/

# 查看 connector 状态（connected / disconnected / unknown）
cat /sys/class/drm/card0-DSI-1/status

# 查看当前 mode 与 EDID
cat /sys/class/drm/card0-HDMI-A-1/modes
cat /sys/class/drm/card0-HDMI-A-1/edid | hexdump -C

# 查看 encoder 与 CRTC 的绑定关系
cat /sys/kernel/debug/dri/0/encoder_0/possible_crtcs
cat /sys/kernel/debug/dri/0/encoder_0/crtc_id

# 查看完整拓扑
cat /sys/kernel/debug/dri/0/state

如果 status 为 disconnected，问题通常在 Connector 探测或热插拔检测；如果 status 为 connected 但 crtc_id 为 -1，说明 encoder 没有被成功绑定到 CRTC，常见于 encoder 驱动 probe 失败、bridge 未就绪或 DT 中 remote-endpoint 写错。

四、案例场景：DSI encoder 绑定失败导致黑屏

某嵌入式设备使用 MIPI DSI 屏幕，开机后背光亮但无图像。dmesg 中出现：

[    2.345678] msm_dsi: probe failed: -517
[    2.345690] panel-dsi: failed to find dsi host
[    2.345700] drm: encoder bind failed, crtc_id = -1

分析：-517 是 -EPROBE_DEFER，说明 DSI host 尚未就绪，panel 驱动提前 probe。由于 panel 是 DSI encoder 的下游，panel 未就绪会导致 encoder 无法完成绑定，最终 CRTC 找不到可用 encoder，显示通路断裂。解决方式是检查设备树中 DSI host、panel、bridge 的依赖顺序，确保 remote-endpoint 双向匹配，必要时在 panel 驱动中正确返回 -EPROBE_DEFER。

五、误区与复盘