2. Linux图形栈全景

Linux图形栈是一条跨越用户态与内核态的完整数据通路。应用绘制出的像素，要经过图形API、显示服务器、合成器、Mesa驱动、DRM子系统、GPU硬件，最终才出现在屏幕上。理解这条通路的层次划分与各层职责，是故障诊断的第一性原理：只有知道数据"应该"怎么走，才能判断它"卡"在了哪一层。

一、核心原理：五层职责划分

从下往上，Linux图形栈可划分为五个逻辑层次，每层都有明确的边界与接口：

• 硬件层：GPU核心、显存、显示控制器（CRTC）、编码器（Encoder）、连接器（Connector）与物理接口（HDMI/DP/eDP）。
• 内核DRM/KMS层：DRM负责显存管理与命令提交，KMS负责显示模式设置与管线编排。GEM/TTM是显存管理子系统，GEM偏向小对象与句柄抽象，TTM偏向显存迁移与放置策略。
• 内核GPU驱动层：如i915、amdgpu、nouveau、msm，实现具体硬件的命令流、中断、电源管理与固件加载。
• 用户态驱动层（Mesa）：把OpenGL/Vulkan/EGL调用翻译为GPU命令，通过libdrm的ioctl与内核交互，管理缓冲区与同步对象。
• 显示服务与合成器层：X11/Xorg或Wayland合成器（Mutter、KWin、Sway）负责窗口管理、输入分发与最终合成，再通过KMS提交扫描输出。

二、方法流程：一次帧提交的完整路径

以Wayland合成器提交一帧为例，数据流大致如下：

1. 应用通过EGL/OpenGL渲染到缓冲区，Mesa将命令写入GPU环形缓冲。
2. Mesa通过drmIoctl提交命令，内核GPU驱动调度执行。
3. 合成器收集各窗口缓冲区，调用EGL合成到最终帧缓冲。
4. 合成器通过KMS原子提交（Atomic Commit）请求页翻转。
5. DRM校验Plane、CRTC、Connector状态，驱动配置显示控制器。
6. 显示控制器在垂直消隐期切换扫描地址，新帧上屏。
7. 页翻转完成中断回传，合成器收到Frame Callback，准备下一帧。

# 查看当前显示管线状态
$ sudo cat /sys/kernel/debug/dri/0/state
# 查看KMS连接器与模式
$ modetest -M i915 -c
# 查看GPU错误与重置记录
$ dmesg | grep -iE "drm|gpu|i915|amdgpu"

三、案例场景：黑屏故障的分层定位

某笔记本外接显示器后黑屏，但系统日志正常。按分层排查：

• 硬件层：lsusb或lspci确认接口识别，检查线缆与显示器电源。
• KMS层：modetest查看Connector状态是否为connected，是否有可用模式。
• 驱动层：dmesg检查是否有link training失败或EDID读取错误。
• 合成器层：确认输出是否被合成器启用，是否被设置为镜像或扩展模式。
• 应用层：检查是否因分辨率不匹配导致画面超出范围。

四、误区与复盘

复盘要点：图形栈的每一层都有独立的日志与调试接口。内核层看dmesg与debugfs，用户态看Mesa的MESA_DEBUG与合成器日志，显示层看modetest与drm_info。建立"症状—层次—工具"的映射表，才能把黑屏、撕裂、卡顿、花屏等模糊现象快速收敛到具体层与具体组件。