1. 课程导入

在嵌入式Linux设备上，从“能启动内核”到“能像桌面一样操作窗口”，中间隔着一整套图形栈。Weston正是这套图形栈中最关键的一环：它是Wayland协议参考实现Weston的合成器（compositor），负责把多个客户端应用的表面（surface）合成到屏幕上，并管理输入、输出、窗口与显示后端。本课程面向已经具备Linux基础、C语言基础与嵌入式开发经验的工程师，目标是让你能够独立完成Weston在嵌入式平台上的移植、配置、裁剪、调试与产品化集成。

一、学习目标：从“能跑”到“可交付”

完成本课程后，你应当具备以下能力：第一，能够解释Wayland与X11的本质差异，说明为什么嵌入式设备更倾向Wayland/Weston；第二，能够根据硬件平台（DRM/KMS、fbdev、headless、RDP等）选择并配置Weston后端；第三，能够编写和调试weston.ini，控制输出分辨率、缩放、旋转、输入设备与Shell行为；第四，能够将Qt、GTK、SDL、Chromium等客户端接入Weston，并处理EGL/GLES、DMABUF、共享内存等缓冲路径；第五，能够对Weston进行裁剪、启动优化与内存优化，满足嵌入式产品的启动时间与资源约束；第六，能够使用weston-info、wayland-scanner、weston-debug、GDB/Perf等工具定位黑屏、花屏、输入无响应、崩溃等典型问题。

二、核心概念：Wayland、Weston与Shell

Wayland是一套显示服务器协议，定义了客户端与合成器之间的通信接口。客户端通过libwayland-client创建surface、提交buffer、接收输入事件；合成器负责合成、显示与输入分发。Weston是Wayland协议的参考合成器实现，它同时提供后端抽象、Shell策略、输入处理、输出管理与调试工具。Shell决定窗口如何被摆放与装饰，例如desktop shell适合桌面式交互，kiosk shell适合全屏单应用，ivi-shell适合车载IVI场景。理解“协议—合成器—Shell—客户端”四层关系，是后续所有配置与排障的基础。

三、方法流程：一条可复用的工程主线

嵌入式Weston开发通常遵循“环境确认—后端选择—配置编写—客户端验证—性能与稳定性优化”的主线。第一步确认内核已启用DRM/KMS、输入子系统与必要的GPU驱动；第二步根据产品形态选择后端，例如带屏幕的设备优先使用DRM后端，无屏设备可用headless或RDP后端；第三步编写weston.ini，明确output、input、shell、core等段落；第四步用weston-simple-egl、weston-terminal或Qt应用验证合成与输入；第五步通过日志、weston-info与性能工具定位问题，并逐步裁剪不需要的模块。

[core]
shell=desktop
idle-time=0

[output]
name=HDMI-A-1
mode=1920x1080
scale=1
transform=normal

[input]
seat=default

[shell]
background-color=0xff1e1e2e
panel-position=top

上述配置片段展示了最常用的输出与Shell控制项。实际项目中，输出名称、模式与缩放需要根据硬件手册和EDID动态调整；idle-time设为0可避免产线测试时自动黑屏；background-color与panel-position则直接影响最终用户体验。

四、案例场景：从黑屏到可交互桌面

假设你拿到一块i.MX8M Mini开发板，内核已支持DRM，但启动Weston后屏幕始终黑屏。按照本课程的方法，你会先检查weston.log中是否出现“failed to create backend”或“no outputs found”；再用weston-info确认output是否被识别；接着检查weston.ini中output名称是否与DRM实际输出一致；最后确认GPU驱动与EGL库是否匹配。若输出被识别但无画面，则进一步检查客户端是否成功创建surface、buffer是否提交、合成器是否选择正确的渲染路径。这个过程正是本课程要训练的核心能力：把“黑屏”拆解为可验证的链路节点。

五、常见误区与复盘

误区一：把Weston当成“窗口管理器”。Weston首先是合成器，窗口装饰与布局由Shell决定，二者不可混为一谈。误区二：认为Wayland客户端可以像X11一样随意抓屏或注入事件。Wayland的安全模型限制了跨客户端访问，调试需要借助合成器提供的调试接口。误区三：忽略缓冲路径差异。共享内存、DMABUF与EGLImage在性能与兼容性上差异明显，嵌入式产品必须根据GPU能力选择。误区四：只关注功能，不关注启动时间与内存占用。量产设备往往要求Weston在数秒内完成启动，并控制常驻内存，因此裁剪与优化必须从第一天就纳入计划。