1. 课程导入
欢迎进入《Wayland车载显示系统开发》课程。在智能座舱快速演进的今天，车载显示系统已经从“单屏仪表”发展为“多屏互动、多应用并行、多操作系统协同”的复杂图形平台。Wayland 作为现代 Linux 图形栈的核心显示协议，正在逐步替代传统 X11，成为车载 IVI、仪表、HUD、后排娱乐屏等场景的主流选择。本课程的目标，是帮助学习者建立从协议原理到工程落地的完整能力体系，能够独立完成 Wayland 合成器配置、客户端开发、多屏管理、性能调优与问题排查。
本节核心问题：Wayland 在车载显示中到底解决什么问题？学习路径如何安排？哪些概念必须先掌握，哪些工具必须动手实践？
一、学习目标：从“会用”到“能调能排”
本课程不是单纯讲解 Wayland 协议文档，而是围绕车载显示系统的真实开发链路展开。完成课程后，学习者应达到以下目标：
- 理解架构：掌握 Wayland 客户端、合成器、后端、DRM/KMS、输入设备之间的职责边界与数据流向。
- 掌握协议：熟悉 wl_surface、wl_buffer、xdg_shell、wl_output、wl_seat 等核心接口，理解 commit、frame callback、buffer release 等关键机制。
- 能够开发：使用 C/C++ 或 Qt/GTK 等工具链编写 Wayland 客户端，完成窗口创建、渲染提交、输入响应。
- 能够配置：基于 Weston、Sway、KWin 或自研合成器，完成多屏布局、分辨率适配、缩放与旋转配置。
- 能够调优：定位撕裂、卡顿、掉帧、输入延迟、显存泄漏等问题，并使用 weston-info、wayland-info、drm_info、perf 等工具分析。
- 能够落地：理解车载场景下的安全隔离、启动时序、热插拔、多用户与功能安全要求。
二、核心概念：先建立一张“图形栈地图”
Wayland 不是单一程序，而是一套协议加一组实现。车载显示系统中，最常见的角色包括：
| 概念 | 职责 | 车载场景示例 |
|---|---|---|
| Wayland Client | 应用进程，创建 surface、提交 buffer、接收输入 | 仪表应用、导航、媒体播放器 |
| Wayland Compositor | 显示服务器，管理窗口、合成、输入分发 | Weston、Sway、自研合成器 |
| wl_surface | 客户端可绘制区域，承载像素内容 | 每个应用窗口对应一个 surface |
| wl_buffer | 像素数据载体，通常由 DMA-BUF 或共享内存提供 | GPU 渲染结果、视频帧 |
| xdg_shell | 桌面窗口语义，定义窗口状态与层级 | 全屏仪表、浮动提示框 |
| wl_output | 物理显示输出，描述分辨率、刷新率、缩放 | 中控屏、副驾屏、HUD |
| DRM/KMS | 内核显示子系统，负责扫描输出与图层合成 | 多屏异显、硬件叠加层 |
| wl_seat | 输入设备抽象，管理键盘、鼠标、触摸 | 触摸屏、方向盘按键 |
理解这些概念的关键，是抓住一条主线：客户端把像素写入 buffer，合成器决定何时、何地、以何种方式把 buffer 送到显示输出。这条主线贯穿整个课程。
三、整体知识框架：五层递进
课程内容按照“协议层—客户端层—合成器层—内核显示层—车载场景层”五层递进组织。每一层都对应明确的学习任务：
- 协议层：理解 Wayland 通信模型、对象模型、请求与事件、版本协商。重点掌握 wl_registry、wl_compositor、wl_shm、linux-dmabuf。
- 客户端层：完成 surface 创建、buffer 分配、渲染提交、输入处理。推荐从最小 C 客户端开始，再过渡到 Qt Wayland 插件。
- 合成器层：学习 Weston 配置、shell 插件、输出管理、输入策略，理解合成器如何决定“谁显示、显示在哪、何时显示”。
- 内核显示层：掌握 DRM/KMS 基本概念，理解 plane、crtc、connector、framebuffer 与 Wayland 合成器的关系。
- 车载场景层：多屏异显、启动优化、安全隔离、热插拔、功能安全与性能指标。
四、实战路线图：从最小客户端到多屏座舱
为了避免“只看不练”，课程设计了循序渐进的实战路线。建议按以下阶段推进：
阶段 1：环境搭建
- 安装 Weston / wayland-protocols / libdrm
- 运行 weston-info、wayland-info 确认协议支持
阶段 2：最小客户端
- 创建 wl_surface + xdg_toplevel
- 使用 wl_shm 提交纯色 buffer
- 观察 commit 与 frame callback 时序
阶段 3：GPU 渲染
- 接入 EGL + OpenGL ES
- 使用 linux-dmabuf 实现零拷贝
- 对比 wl_shm 与 DMA-BUF 性能差异
阶段 4：多屏与输入
- 配置 wl_output 多屏布局
- 处理触摸、按键、焦点切换
- 验证缩放、旋转、分辨率切换
阶段 5：车载调优
- 使用 perf、drm_info、weston-debug 分析
- 优化启动时间、掉帧、输入延迟
- 完成多应用并行与安全隔离验证五、案例场景：一个典型车载多屏启动链路
假设车辆上电后，仪表屏需要在 1.5 秒内显示安全提示，中控屏在 3 秒内进入桌面。典型链路如下：
- Bootloader 加载内核，DRM/KMS 初始化显示管线。
- Weston 作为合成器启动，读取 weston.ini 中的 output 配置。
- 仪表客户端通过 xdg_shell 创建全屏 surface，提交首帧。
- 合成器将仪表 surface 分配到主 plane，中控桌面分配到叠加 plane。
- 触摸事件通过 wl_seat 分发到当前焦点客户端。
实践建议：不要一开始就追求复杂合成器。先用 Weston 跑通最小客户端，再逐步替换为自研合成器或 Qt 方案。每改一个配置，都用 wayland-info 和 drm_info 验证实际生效状态。
六、常见误区与复盘
误区一：把 Wayland 当成“另一个 X11”。Wayland 没有全局坐标和全局窗口树，客户端不能直接查询其他窗口位置。多屏布局由合成器决定，客户端只能感知自己所在的 output。
误区二：忽略 buffer 生命周期。客户端提交 buffer 后不能立即复用，必须等待 release 事件。否则会出现花屏、撕裂或 GPU 同步错误。
误区三：只调应用不调合成器。车载掉帧往往来自合成器调度策略、plane 分配或 VSync 对齐，而不是应用渲染本身。
误区四：忽视启动时序。显示初始化、合成器启动、客户端就绪之间存在依赖关系，必须用日志和 trace 明确每个阶段耗时。