📚 课程目录第3章 Wayland架构总览

3. Wayland架构总览

在车载多屏座舱中，显示系统需要同时处理仪表、中控、副驾娱乐、HUD 与后排屏等多个独立表面，并保证低延迟、低抖动、强隔离与可恢复性。Wayland 作为现代显示协议栈，其核心价值并不只是“替代 X11”，而是把显示合成、输入分发、缓冲区管理与安全隔离重新组织成一套更适合嵌入式与多屏场景的架构。理解 Wayland 的关键，是分清协议、合成器、客户端与服务端之间的职责边界。

一、核心原理：协议是契约，合成器是执行者

Wayland 本身是一套通信协议，定义了客户端与服务端之间如何交换对象、请求与事件。它不直接负责绘制，也不直接管理 GPU，而是规定“谁可以创建表面、提交缓冲区、接收输入、绑定输出”。在 Wayland 架构中，真正承担显示管理职责的是合成器，例如 Weston、KWin、Mutter 或车载定制合成器。合成器同时扮演服务端角色，负责接收客户端请求、管理输出、合成最终画面并提交给 DRM/KMS。

客户端通常是应用程序或 UI 框架，例如 Qt、Flutter、Android 容器或自研 HMI。客户端通过 wl_surface 创建表面，通过 wl_buffer 提交像素数据，通过 wl_output 感知屏幕信息，通过 wl_seat 接收输入事件。服务端则维护全局对象注册表，把输出、输入、合成器接口暴露给客户端。二者之间通过 Unix domain socket 传输二进制消息，避免 X11 时代复杂的网络透明与间接渲染路径。

一句话理解：Wayland 协议规定“怎么说话”，合成器决定“怎么显示”，客户端负责“画什么”，服务端负责“管什么”。

二、架构分层与数据流

从车载系统视角看，Wayland 架构可以划分为四层：应用层、协议层、合成层与内核显示层。应用层包含多个客户端；协议层负责对象与事件传递；合成层负责场景图、输入焦点、输出布局与缓冲区生命周期；内核显示层通过 DRM/KMS 管理 CRTC、plane、connector 与多屏时序。下图展示了这一关系，并突出多屏输出与输入分发路径。

图中可以看到，客户端并不直接操作 DRM，而是把缓冲区提交给合成器；合成器根据输出布局决定每个表面出现在哪块屏幕上，再通过 KMS 提交到硬件。输入事件则反向从内核到合成器，再由合成器根据焦点分发给对应客户端。这种“客户端只画自己的，合成器统一调度”的模式，使多屏座舱的窗口管理、层级控制和故障隔离更加清晰。

三、与 X11 的对比：为什么车载更倾向 Wayland

X11 的设计年代早于现代 GPU 与嵌入式多屏需求。它采用客户端-服务器模型，但服务器同时承担窗口管理、绘制、输入和合成职责，客户端通过 X 协议间接控制显示。Wayland 则把合成职责交给合成器，客户端直接提交缓冲区，路径更短、延迟更低。下表从车载关注点对比两者差异。

对比维度	X11	Wayland	车载影响
显示路径	客户端 → X Server → 合成器 → 内核	客户端 → 合成器 → 内核	Wayland 延迟更低，适合仪表实时刷新
合成职责	可由独立合成器承担，但历史包袱重	合成器是核心，职责明确	多屏布局与层级控制更可控
输入分发	X Server 统一处理，焦点模型复杂	合成器按表面与 seat 分发	多屏多用户场景更易隔离
安全隔离	客户端可窥探全局输入与窗口	默认隔离，客户端只能访问自己的表面	仪表与娱乐域隔离更安全
多屏支持	依赖 Xinerama/RandR，配置复杂	wl_output 原生多输出模型	仪表、中控、副驾、HUD 独立输出
嵌入式适配	依赖较多传统组件，启动慢	可裁剪，适合 Weston/定制合成器	启动快、资源占用低

四、车载适配优势与典型场景

在座舱域控制器中，Wayland 的优势主要体现在四个方面。第一，多屏独立输出：每个 wl_output 可对应一块物理屏，合成器可独立设置分辨率、刷新率、旋转与缩放，满足仪表 60fps、中控 60fps、HUD 高亮低延迟等差异化需求。第二，强隔离：客户端只能访问自己被授予的表面与输入 seat，娱乐应用无法直接读取仪表输入，降低安全风险。第三，低延迟与低抖动：客户端直接提交 DMA-BUF，合成器可走硬件叠加层，减少拷贝与合成开销。第四，可恢复性：某个客户端崩溃时，合成器可移除其表面并保留其他屏幕内容，避免整屏黑屏。

典型场景：仪表客户端以 60fps 提交关键驾驶信息，中控客户端运行导航与媒体，副驾客户端播放视频，HUD 客户端以低延迟提交车速与报警。合成器统一管理四块输出，输入按 seat 分发，任一娱乐客户端异常退出不影响仪表与 HUD。

五、常见误区与排障思路

误区一：把 Wayland 当成“另一个 X Server”。实际上 Wayland 只是协议，合成器才是服务端实现，不同合成器行为差异很大。误区二：认为客户端可以直接控制屏幕。客户端只能提交表面与缓冲区，输出布局由合成器决定。误区三：忽略缓冲区同步。若客户端未正确处理 wl_buffer 的 release 事件，容易出现卡顿、撕裂或内存暴涨。

排障时可从以下命令入手，观察协议对象与输出状态：

# 查看 Wayland 显示与输出信息
wayland-info

# 查看 DRM/KMS 连接器与 CRTC 状态
modetest -M rockchip -c

# 查看合成器日志中的表面提交与帧回调
journalctl -u weston --no-pager | grep -E "surface|output|frame"

# 检查客户端是否使用 DMA-BUF 路径
WAYLAND_DEBUG=1 ./hmi_client 2>&1 | grep wl_buffer

注意：车载多屏场景下，不要只关注“能否显示”，还要关注帧同步、输入焦点、崩溃恢复与安全域隔离。Wayland 的架构优势只有在合成器正确配置、客户端正确提交缓冲区时才能体现。

总结来看，Wayland 架构以协议为契约、以合成器为核心、以客户端为内容生产者、以服务端为资源管理者，形成了比 X11 更短、更安全、更适合多屏座舱的显示路径。理解这四者关系，是后续学习合成器定制、多屏布局、输入分发与性能优化的基础。