在RK3399上用Buildroot定制Weston桌面：一份从环境变量到自启动的完整配置清单-创锋一号

在RK3399上用Buildroot定制Weston桌面：一份从环境变量到自启动的完整配置清单

当我们需要在嵌入式设备上实现轻量级图形界面时，Wayland协议和Weston合成器无疑是最佳选择之一。特别是在RK3399这样的高性能ARM平台上，Weston能够充分发挥硬件加速的优势，同时保持极低的内存占用。本文将带你从零开始，一步步完成Weston桌面的完整部署。

1. 环境准备与基础配置

在开始配置Weston之前，我们需要确保系统环境已经就绪。RK3399平台通常运行基于Linux内核的嵌入式系统，这里我们选择Buildroot作为构建工具链和根文件系统的基础。

1.1 系统依赖安装

首先确保以下依赖包已经安装：

sudo apt-get install build-essential libdrm-dev libinput-dev libxkbcommon-dev

对于Buildroot配置，需要在make menuconfig中启用以下选项：

Target packages → Graphic libraries and applications → wayland
Target packages → Graphic libraries and applications → weston
Target packages → Libraries → Graphics → libdrm
Target packages → Libraries → Hardware handling → libinput

1.2 关键环境变量设置

环境变量是Weston正常运行的基础，我们需要在/etc/profile.d/env.sh中配置：

#!/bin/sh export LC_ALL='zh_CN.utf8' export QT_QPA_PLATFORM=wayland export WESTON_DRM_KEEP_RATIO=1 export QT_GSTREAMER_WINDOW_VIDEOSINK=waylandsink mkdir -p /tmp/.xdg && chmod 0700 /tmp/.xdg export XDG_RUNTIME_DIR=/tmp/.xdg export QT_QPA_GENERIC_PLUGINS=evdevkeyboard

注意：XDG_RUNTIME_DIR是Wayland协议要求的运行时目录，必须确保该目录存在且权限正确。

2. Weston核心配置文件详解

Weston的配置文件weston.ini决定了桌面环境的行为和外观。默认位置在/etc/xdg/weston/weston.ini。

2.1 基本配置结构

一个典型的weston.ini文件包含多个section，每个section控制不同的功能模块：

[core] # 核心配置项 require-input=false repaint-window=15 [shell] # 桌面shell配置 panel-position=top background-color=0x002244 [output] # 显示输出配置 name=DSI-1 mode=1920x1080@60 transform=90

2.2 显示输出配置

RK3399平台通常支持多种显示接口，我们可以通过以下命令查看可用输出设备：

cat /var/log/weston.log | grep Output

在配置文件中，可以针对不同输出设备进行独立设置：

[output] name=DSI-1 mode=1280x800@60 transform=90 [output] name=HDMI-A-1 mode=1920x1080@60

提示：transform参数可以实现屏幕旋转，支持0(正常)、90(顺时针)、180(倒置)、270(逆时针)四种角度。

3. 输入设备配置

嵌入式设备的输入设备配置往往需要特别注意，特别是触摸屏和键盘。

3.1 触摸屏校准

对于旋转后的屏幕，触摸输入也需要相应调整：

[libinput] touchscreen_calibrator=1

可以通过evtest工具测试触摸设备：

evtest /dev/input/eventX

3.2 键盘布局设置

Weston支持多种键盘布局，可以通过xkeyboard-config进行配置：

[keyboard] keymap_rules=evdev keymap_model=pc105 keymap_layout=us,cn keymap_options=grp:alt_shift_toggle

4. 自启动服务配置

为了让Weston在系统启动时自动运行，我们需要创建一个init脚本。

4.1 创建自启动脚本

在/etc/init.d/S31weston中创建启动脚本：

#!/bin/sh case "$1" in start) printf "Starting weston" source /etc/profile.d/env.sh weston -c /etc/xdg/weston/weston.ini --tty=2 --idle-time=0 --log=/var/log/weston.log & ;; stop) killall weston printf "stop finished" ;; *) echo "Usage: $0 {start|stop}" exit 1 ;; esac exit 0

4.2 设置脚本权限

确保脚本具有可执行权限：

chmod +x /etc/init.d/S31weston

4.3 调试技巧

如果Weston启动失败，可以检查日志文件：

tail -f /var/log/weston.log

常见问题包括：

缺少必要的环境变量
显示设备权限问题
输入设备配置错误

5. 高级配置与优化

5.1 内存优化

Weston默认会启用一些可能不需要的功能，可以通过以下配置减少内存占用：

[core] modules=desktop-shell.so

5.2 多显示器配置

RK3399支持多显示器输出，可以通过以下方式配置：

[output] name=DSI-1 mode=1280x800 position=0,0 [output] name=HDMI-A-1 mode=1920x1080 position=1280,0

5.3 性能调优

对于性能敏感的应用程序，可以调整Weston的渲染参数：

[core] repaint-window=10 use-pixman=false

6. 常见问题解决方案

在实际部署中，我们可能会遇到各种问题。以下是几个典型问题的解决方法。

6.1 触摸屏不响应

检查/dev/input目录下的设备节点：

ls -l /dev/input/

确保Weston配置中启用了正确的输入设备：

[libinput] touchscreen=on

6.2 显示内容旋转但触摸不跟随

确保在weston.ini中同时配置了输出旋转和输入设备旋转：

[output] name=DSI-1 transform=90 [libinput] touchscreen_calibrator=1

6.3 应用程序无法启动

Wayland环境下，部分应用程序可能需要特殊环境变量：

export GDK_BACKEND=wayland export CLUTTER_BACKEND=wayland export SDL_VIDEODRIVER=wayland

7. 实际应用案例

7.1 嵌入式信息终端

在RK3399上部署Weston作为信息终端显示，配置如下：

[shell] locking=false panel-position=none background-image=/opt/background.png [launcher] icon=/opt/app-icon.png path=/opt/myapp

7.2 工业控制界面

对于工业控制场景，可能需要禁用某些交互功能：

[shell] locking=false panel-position=none

7.3 数字标牌系统

数字标牌通常需要全屏展示和自动启动应用：

[shell] panel-position=none [autolaunch] path=/usr/bin/digital-signage

在RK3399上部署Weston桌面环境时，我发现最关键的环节是确保显示输出和输入设备的正确配置。特别是在旋转屏幕时，需要同时考虑显示内容和触摸输入的同步旋转。通过合理的配置文件组织和自启动脚本设计，可以构建出稳定可靠的嵌入式图形界面解决方案。

企业官网建设流程全解析