嵌入式图形支持
Wayland 是一个新一代的图形显示服务器协议,旨在替代 X Window System,提供更好的性能、更简单的代码和更好的安全性;weston 是一个开源的 Wayland 协议的参考实现,是一个基于 OpenGL ES 的图形栈,提供了一个完整的桌面环境,包括窗口管理器、应用程序启动器、通知系统等。
Qt 是常见的嵌入式图形库之一,是一个跨平台的 C++ 应用程序开发框架,提供了丰富的图形界面组件和工具,可以用于开发桌面应用程序、嵌入式应用程序等;QtWayland 是 Qt 框架中的一个模块,用于支持 Wayland 协议,QtWayland 模块提供了一组 API,使 Qt 应用程序能够与 Wayland 协议兼容的显示服务器进行交互。
OpenEuler Embedded 系统支持使用 weston 作为窗口管理器,支持 Qt5 作为嵌入式图形库。
Wayland 框架简介
Wayland 框架示意图
部分模块介绍:
KMS/DRM:
用于管理显示器与显卡;
evdev:
输入设备驱动程序,可以处理各种输入设备,如键盘、鼠标、触摸屏等;
libinput:
开源输入设备处理库,主要用于处理输入设备事件;
OpenGL:
Open Graphics Library,跨平台的图形库,用于渲染2D和3D图形;
Mesa:
开源图形库,实现了OpenGL API的大部分功能,并且可以在多种操作系统和硬件平台上运行;
Wayland:
狭义上讲只是一种显示协议, 可以不依赖于任何具体的 CPU/GPU 架构, 但具体的显示功能是由 Wayland Compositor 的实现而定;
openEuler Embedded 图形栈主要组成包
wayland:
一个用于图形栈合成器(Compositor)与客户端对话的协议,也是该协议的 C 库实现;Compositor 是 wayland 的核心组件,负责管理显示器、窗口和输入设备等硬件资源,并将客户端的图形输出合成为最终的显示图像;客户端是 wayland 的应用程序,通过 Wayland 协议与 Compositor 进行通信,可以是任何类型的应用程序,例如浏览器、文本编辑器、游戏等;
weston:
Wayland Compositor 的参考实现;
qtbase:
提供 Qt 程序应用开发所需的基础功能,是 Qt 应用开发的基础;
qtsensors:
用于访问和管理传感器硬件;
qtwayland:
封装了 wayland 功能的 Qt 模块,分为 client 端与 server 端;客户端提供了运行 wayland 客户端 Qt 程序的方法,服务端提供了 Qt Wayland Compositor 应用程序接口,后续可支持用户创建自己的 Compositor;
mesa:
OpenGL API 的免费实现;
libdrm:
基础用户态操作 DRM 运行库;
libinput:
转换 evdev 事件为 wayland 事件。
构建指南
构建结合了 meta-openeuler、poky/meta、meta-raspberrypi、meta-qt5、meta-oe 等层,目前只支持 systemd 的启动方式,支持在树梅派、rk3568平台构建,构建流程如下:
# 树梅派构建
$ oebuild generate -p raspberrypi4-64 -f systemd -f openeuler-qt -d ras-qt
# ok3568构建
$ oebuild generate -p ok3568 -f systemd -f openeuler-qt -d ok3568-qt
# ryd-3568构建
$ oebuild generate -p ryd-3568 -f systemd -f openeuler-qt -d ryd-3568-qt
# 进入交互构建终端
$ oebuild bitbake
# 执行构建
$ bitbake openeuler-image
# sdk构建
$ bitbake openeuler-image -c populate_sdk
目前 rk3568 平台对 Qt 支持尚不完善,正在开发改进中!!!
image 中集成了一些 demo 程序用于测试功能是否正常,如下:
Qt 交叉编译需要使用交叉编译工具链和交叉编译的 Qt 库,而这些库和工具链的路径通常与本地开发环境不同。为了让 Qt 在交叉编译环境中正确地找到所需的库和工具链,需要在 Qt 安装目录(qmake程序同级目录)下创建一个名为 qt.conf
的文件,该文件包含了 Qt 在交叉编译环境中需要的配置信息。
编写 qt.conf
文件,源码如下:
[Paths]
Prefix = /sdk_path/sysroots/cortexa72-openeuler-linux
Headers = /sdk_path/sysroots/cortexa72-openeuler-linux/usr/include
Libraries = /sdk_path/sysroots/cortexa72-openeuler-linux/usr/lib64
HostData = /sdk_path/sysroots/cortexa72-openeuler-linux/usr/lib64
Sysroot = /sdk_path/sysroots/cortexa72-openeuler-linux
TargetSpec = linux-oe-g++
/sdk_path/
表示 SDK 所在目录的前缀。
可通过 qt.conf
设置 Binaries 字节来配置二进制所在路径,若为 /usr/bin
可不设置,如 qttools 提供二进制所在路径为 /usr/lib/qt5/bin/
,则 qt.conf
需新增如下行:
Binaries = /usr/lib/qt5/bin
HostBinaries = /usr/lib/qt5/bin
编写 hello.cpp
文件,源码如下:
#include<QApplication>
#include<QLabel>
int main(int argc,char * argv[])
QApplication app(argc,argv);
QLabel * label=new QLabel("<h2><i>Hello</i><font color=red>Qt!</font></h2>");
label->show();
return app.exec();
编写 hello.pro
,和 hello.cpp
文件放在同一个目录;也可使用 qmake 命令自动生成 pro 文件,但需要手动补充部分内容,示例:
$ qmake -project
把编译好的 qt 程序拷贝到 openEuler Embedded 系统的 /tmp/
某个目录下(例如 /tmp/myfiles/
)。如何拷贝可以参考前文所述共享文件系统场景。
运行用户态程序
在 openEuler Embedded 系统中运行 qt 程序。
# cd /tmp/myfiles/
# ./hello --platform eglfs or wayland
如运行成功,则会输出 Hello Qt!
。
目前对 Qt5 SDK 工具支持尚不完善,正在开发改进中!!!