1 概述

介绍在ED-HMI系列上使用Wayland的背景和范围。

1.1 背景

部分用户所使用的系统版本默认使用的是X11架构，X11由于复杂的架构和多层次的通信，使其性能不如现代的显示服务器协议，并且由于需要经过X服务器中转，会导致设备的图形操作的延迟较高。

如果用户在使用产品时遇到屏幕撕裂、画面卡顿的问题，可以尝试使用具有高性能、安全性和现代化特性的Wayland架构。Raspberry Pi标准的bookworm和bullseye系统均支持Wayland。

1.2 适用范围

本应用适用的产品型号包含ED-HMI2120-070C、ED-HMI2120-101C、ED-HMI2020-070C、ED-HMI2020-101C、ED-HMI2220-070C、ED-HMI2220-101C、ED-HMI3010-070C、ED-HMI3010-101C、ED-HMI3020-070C和ED-HMI3020-101C。

2 应用指导

介绍在ED-HMI系列产品上使用Wayland的操作步骤。

  • 在系统中切换Wayland
  • 在Raspberry Pi OS (Lite)上安装Wayland和桌面

2.1 在系统中切换Wayland

不同版本的操作系统对应的操作步骤不同，在切换Wayland之前需要先查看系统的版本，再按照对应的操作步骤来执行。

查看系统版本：

设备正常启动后进入桌面，打开终端命令窗格中执行如下命令，查看系统版本。

lsb_release -a
image-20240606174802209

2.1.1 Debian11 (bullseye)

前提条件：

  • 已获取可以正常使的Raspberry Pi设备、HDMI显示器、鼠标、键盘和电源适配器。
  • 已获取可以正常使用的网络。

操作步骤：

  1. 打开终端命令窗格，执行如下命令。
echo $XDG_SESSION_TYPE
image-20240606175246408
  1. 执行如下命令，打开配置界面。
`sudo raspi-config
  1. 选择“6 Advanced Options”，按” Enter “键确认。
image-20240606175746694
  1. 选择“A9 Wayland”，按“ Enter “键确认。
image-20240606175840968
  1. 选择 “Yes”，按“ Enter “键确认。
image-20240606175928368
  1. 按“ Enter “键确认，使能Wayland。
image-20240606180053207
  1. 选择“Finish”，按“ Enter “键确认。
image-20240606180214925
  1. 选择 “Yes”，按“ Enter “键确认，重启设备。
image-20240606180258328
  1. 执行如下命令，查询系统类型，如下图所示表示已成功切换至Wayland。
echo $XDG_SESSION_TYPE
image-20240606180335222

2.1.2 Debian12 (bookworm)

Debian12系统默认已开启Wayland，可在终端窗格执行如下命令查看。

echo $XDG_SESSION_TYPE
image-20240606180438336

2.2 在Raspberry Pi OS (Lite)上安装Wayland和桌面

前提条件：

  • 已准备一台ED-HMI系列设备。
  • 已获取可以正常使用的屏幕（带HDMI线）、鼠标、键盘和电源适配器。
  • 已获取可以正常使用的网络。
  • 已烧录好Raspberry Pi OS (Lite)镜像。

操作步骤：

  1. 通过网线将设备接入网络，通过HDMI线连接显示器，再连接鼠标、键盘和电源适配器。
  2. 设备正常启动后，在终端窗格依次执行如下命令，更新系统。
sudo apt update
sudo apt upgrade -y
  1. 执行如下命令，重启设备。
sudo reboot
  1. 执行如下命令，安装rpi-wayland。
sudo apt install rpi-wayland
image-20240606181442425
  1. 执行如下命令，安装lightdm。
sudo apt install lightdm
image-20240606181503898
  1. 执行如下命令安装xserver-xorg和raspberrypi-ui-mods。
sudo apt install xserver-xorg raspberrypi-ui-mods
image-20240606181522814
  1. 执行如下命令，打开配置界面。
sudo raspi-config
  1. 选择“Advanced Options”，按“ Enter ”键确认。
image-20240606181732192
  1. 选择“Wayland”，按“ Enter ”键确认。
image-20240606181801089
  1. 选择“Yes”，按“Enter”键确认。
image-20240606181837196
  1. 选择“System Options”，按“ Enter ”键确认。
image-20240606181905357
  1. 选择“Boot / Auto Login”，按“ Enter ”键确认。
image-20240606181937011
  1. 选择“Desktop Autologin”，按“ Enter ”键确认。
image-20240606182001008
  1. 选择“Finish” ，按“ Enter ”键确认。
image-20240606182034241
  1. 按“ Enter ”键确认重启。
image-20240606182105250
  1. 重启后可进入桌面。
image-20240606182134593
  1. 在终端执行
echo $XDG_SESSION_TYPE
image-20240606182158254

可以查看到当前使用Wayland架构。