1. 问题背景与解决思路
最近在RK3568平台上开发QML应用时,遇到了一个让人头疼的问题:界面卡顿严重,简直像看PPT一样。供应商建议我们换用RK3588,但我觉得RK3568运行一个简单的QML界面不应该这么卡。经过排查,发现是Qt库没有启用OpenGL ES2支持导致的。RK3568的Mali-G52 GPU本身支持OpenGL ES2,但供应商提供的Qt库没有编译进OpenGL支持,导致QML无法利用GPU加速。
这个问题其实很常见,很多嵌入式开发板提供的Qt库都是基础版本,缺少图形加速支持。自己交叉编译带OpenGL ES2的Qt库是解决这个问题的根本方法。不过这个过程确实有点复杂,我踩了不少坑,特别是sysroot的构建和Qt配置环节。下面我就把完整的实践过程分享给大家,包括一些容易出错的地方和解决方法。
2. 环境准备与工具链配置
2.1 交叉编译器选择
RK3568是64位ARM架构,需要aarch64-linux-gnu交叉编译器。我推荐使用Linaro的GCC 7.5.0版本,这个版本比较稳定,与RK3568的兼容性也很好。下载地址可以在Linaro官网找到,选择最新版本即可。下载后解压到/opt目录下,方便后续使用。
sudo tar -xvf gcc-linaro-7.5.0-2019.12-x86_64_aarch64-linux-gnu.tar.xz -C /opt/
记得把交叉编译器的bin目录添加到PATH环境变量中,这样后续编译时就不需要每次都指定完整路径了。可以在~/.bashrc文件中添加:
export PATH=/opt/gcc-linaro-7.5.0-2019.12-x86_64_aarch64-linux-gnu/bin:$PATH
2.2 Qt源码下载
我选择的是Qt 5.14.2版本,这个版本比较稳定,与RK3568的兼容性也很好。可以从Qt官网下载源码包,文件名为qt-everywhere-src-5.14.2.tar.xz。下载后建议校验一下MD5值,确保文件完整性。
wget http://download.qt.io/official_releases/qt/5.14/5.14.2/single/qt-everywhere-src-5.14.2.tar.xz
md5sum qt-everywhere-src-5.14.2.tar.xz
解压源码到工作目录,我一般放在/opt/qt5rk目录下:
mkdir -p /opt/qt5rk
tar -xvf qt-everywhere-src-5.14.2.tar.xz -C /opt/qt5rk/
2.3 开发板环境准备
开发板需要安装一些依赖库,这些库在后续的Qt编译过程中会被用到。通过ssh登录开发板,执行以下命令安装:
apt-get update
apt-get upgrade
apt-get build-dep qt5-qmake
apt-get install libudev-dev libinput-dev libts-dev libmtdev-dev libjpeg-dev libfontconfig1-dev
apt-get install libssl-dev libdbus-1-dev libglib2.0-dev libxkbcommon-dev libegl1-mesa-dev
apt-get install libgbm-dev libgles2-mesa-dev mesa-common-dev libvpx-dev libsnappy-dev
apt-get install libnss3-dev "^libxcb.*" libfreetype6-dev libicu-dev libsqlite3-dev
这些库包含了图形、输入、多媒体等各个方面的依赖,确保Qt能够正常编译和运行。安装完成后,建议重启开发板使所有配置生效。
3. 构建sysroot环境
3.1 同步开发板库文件
sysroot的作用是在编译主机上模拟目标板的运行环境。首先在虚拟机中创建sysroot目录结构:
mkdir -p /opt/qt5rk/sysroot/usr
mkdir -p /opt/qt5rk/sysroot/usr/lib
mkdir -p /opt/qt5rk/sysroot/usr/include
使用rsync同步开发板上的库文件和头文件到虚拟机中。确保开发板和虚拟机在同一个局域网内,并且可以通过ssh连接:
rsync -avz root@192.168.3.105:/usr/lib /opt/qt5rk/sysroot/usr/
rsync -avz root@192.168.3.105:/usr/include /opt/qt5rk/sysroot/usr/
这个过程可能会花费一些时间,取决于网络速度和开发板上的文件数量。同步完成后,需要创建必要的符号链接:
cd /opt/qt5rk/sysroot
ln -s usr/lib lib
ln -s usr/lib aarch64-linux-gnu
3.2 处理符号链接
同步过来的库文件中包含很多绝对路径的符号链接,这些链接在主机环境下是无效的。需要将这些绝对链接转换为相对链接。创建一个Python脚本来处理这个问题:
#!/usr/bin/env python
import sys
import os
if len(sys.argv) != 2:
print("Usage: " + sys.argv[0] + " <directory>")
sys.exit(1)
topdir = os.path.abspath(sys.argv[1])
def handlelink(filep, subdir):
link = os.readlink(filep)
if link[0] != "/":
return
if link.startswith(topdir):
return
new_link = os.path.relpath(topdir + link, subdir)
os.unlink(filep)
os.symlink(new_link, filep)
for subdir, dirs, files in os.walk(topdir):
for f in files:
filep = os.path.join(subdir, f)
if os.path.islink(filep):
handlelink(filep, subdir)
保存为sysroot.py,然后执行:
chmod +x sysroot.py
./sysroot.py /opt/qt5rk/sysroot
这个脚本会遍历sysroot目录下的所有文件,将绝对路径的符号链接转换为相对路径。
3.3 虚拟机环境配置
虚拟机也需要安装一些编译所需的工具和库:
sudo apt-get update
sudo apt-get upgrade -y
sudo apt-get install gcc git bison python gperf pkg-config
sudo apt-get install libclang-dev mesa-common-dev build-essential
sudo apt-get install libgl1-mesa-dev libxcb-xinerama0-dev
这些包包含了编译工具链、开发库和图形相关的依赖项。安装完成后,建议重启虚拟机以确保所有环境变量生效。
4. Qt配置与交叉编译
4.1 修改平台配置文件
进入Qt源码目录,修改平台配置文件。这个文件决定了如何为目标平台编译Qt:
cd /opt/qt5rk/qt-everywhere-src-5.14.2
vi qtbase/mkspecs/linux-aarch64-gnu-g++/qmake.conf
配置文件需要修改为以下内容:
MAKEFILE_GENERATOR = UNIX
CONFIG += incremental
QMAKE_INCREMENTAL_STYLE = sublib
include(../common/linux.conf)
include(../common/gcc-base-unix.conf)
include(../common/g++-unix.conf)
QMAKE_CFLAGS_ISYSTEM = -I
QMAKE_LFLAGS += -Wl,-rpath-link,$$[QT_SYSROOT]/usr/lib/aarch64-linux-gnu
QMAKE_LIBS_EGL += -lEGL
QMAKE_LIBS_OPENGL_ES2 += -lGLESv2 -lEGL
QMAKE_INCDIR_EGL = $$[QT_SYSROOT]/usr/include \
$$[QT_SYSROOT]/usr/lib/aarch64-linux-gnu
QMAKE_LIBDIR_OPENGL_ES2 = $$[QT_SYSROOT]/usr/lib/aarch64-linux-gnu
QMAKE_LIBDIR_EGL = $$QMAKE_LIBDIR_OPENGL_ES2
QMAKE_CC = /opt/gcc-linaro-7.5.0-2019.12-x86_64_aarch64-linux-gnu/bin/aarch64-linux-gnu-gcc
QMAKE_CXX = /opt/gcc-linaro-7.5.0-2019.12-x86_64_aarch64-linux-gnu/bin/aarch64-linux-gnu-g++
QMAKE_LINK = /opt/gcc-linaro-7.5.0-2019.12-x86_64_aarch64-linux-gnu/bin/aarch64-linux-gnu-g++
QMAKE_LINK_SHLIB = /opt/gcc-linaro-7.5.0-2019.12-x86_64_aarch64-linux-gnu/bin/aarch64-linux-gnu-g++
QMAKE_AR = /opt/gcc-linaro-7.5.0-2019.12-x86_64_aarch64-linux-gnu/bin/aarch64-linux-gnu-ar cqs
QMAKE_OBJCOPY = /opt/gcc-linaro-7.5.0-2019.12-x86_64_aarch64-linux-gnu/bin/aarch64-linux-gnu-objcopy
QMAKE_NM = /opt/gcc-linaro-7.5.0-2019.12-x86_64_aarch64-linux-gnu/bin/aarch64-linux-gnu-nm -P
QMAKE_STRIP = /opt/gcc-linaro-7.5.0-2019.12-x86_64_aarch64-linux-gnu/bin/aarch64-linux-gnu-strip
load(qt_config)
关键配置包括指定EGL和GLES2库的路径、设置交叉编译器路径、配置链接器选项等。这些配置确保了Qt能够找到目标平台的图形库并使用正确的编译器。
4.2 配置Qt编译选项
现在可以开始配置Qt的编译选项了。创建一个配置脚本或者直接运行configure命令:
./configure -opengl es2 \
-xplatform linux-aarch64-gnu-g++ \
-device-option CROSS_COMPILE=/opt/gcc-linaro-7.5.0-2019.12-x86_64_aarch64-linux-gnu/bin/aarch64-linux-gnu- \
-sysroot /opt/qt5rk/sysroot \
-prefix /opt/qt5rk/qt5build \
-opensource -confirm-license \
-skip qtscript \
-skip qtdatavis3d \
-skip macextras \
-nomake examples \
-make libs \
-pkg-config \
-no-use-gold-linker \
-tslib \
-v
各个参数的含义:
-opengl es2:启用OpenGL ES2支持,这是解决QML卡顿的关键-xplatform:指定目标平台配置-sysroot:指定sysroot目录路径-prefix:指定安装目录-skip:跳过不需要的模块,加快编译速度-tslib:启用触摸屏支持
配置过程需要几分钟时间,完成后会显示配置摘要。一定要检查OpenGL ES2.0是否显示为"yes",这表示OpenGL支持已正确启用。
4.3 编译与安装
配置成功后,就可以开始编译了。使用make命令启动编译过程:
make -j8
这里的-j8参数表示使用8个线程并行编译,可以根据你的CPU核心数调整。编译过程比较漫长,可能需要1-2小时,取决于你的机器性能。
在编译过程中可能会遇到一些问题,最常见的是库冲突。如果之前开发板上安装过Qt,sysroot中可能会有冲突的库文件。解决方法是在sysroot中删除这些冲突的库:
cd /opt/qt5rk/sysroot/usr/lib
rm -f libQt*
编译完成后,进行安装:
make install
安装过程会将编译好的Qt库和工具复制到prefix指定的目录中。安装完成后,可以在/opt/qt5rk/sysroot/opt/qt5rk/qt5build目录中找到完整的Qt工具链。
5. 部署与测试
5.1 部署到开发板
将编译好的Qt库部署到开发板上。首先将整个qt5build目录拷贝到开发板:
scp -r /opt/qt5rk/sysroot/opt/qt5rk/qt5build root@192.168.3.105:/opt/
在开发板上设置库路径,让系统能够找到新编译的Qt库。编辑/etc/ld.so.conf.d/qt.conf文件:
echo "/opt/qt5build/lib" > /etc/ld.so.conf.d/qt.conf
ldconfig
设置环境变量,确保使用新编译的Qt版本:
export QT_ROOT=/opt/qt5build
export PATH=$QT_ROOT/bin:$PATH
export LD_LIBRARY_PATH=$QT_ROOT/lib:$LD_LIBRARY_PATH
export QT_QPA_PLATFORM_PLUGIN_PATH=$QT_ROOT/plugins
export QT_QPA_PLATFORM=eglfs
可以将这些环境变量添加到开发板的~/.bashrc文件中,这样每次登录都会自动设置。
5.2 测试QML性能
创建一个简单的QML应用来测试性能。新建一个test.qml文件:
import QtQuick 2.12
import QtQuick.Window 2.12
Window {
visible: true
width: 800
height: 480
title: "QML Performance Test"
Rectangle {
width: 200
height: 200
color: "red"
rotation: 45
Behavior on rotation {
NumberAnimation { duration: 1000 }
}
MouseArea {
anchors.fill: parent
onClicked: parent.rotation += 90
}
}
Text {
text: "QML Performance Test"
font.pixelSize: 24
color: "white"
anchors.centerIn: parent
}
}
使用qmlscene运行测试:
qmlscene test.qml
现在应该能看到流畅的动画效果,点击红色矩形时会平滑旋转。如果之前没有OpenGL支持,这个动画会非常卡顿,现在应该很流畅了。
5.3 性能对比与优化
为了量化性能提升,可以编写一个简单的性能测试程序:
import QtQuick 2.12
import QtQuick.Window 2.12
Window {
visible: true
width: 800
height: 480
property int frameCount: 0
property date lastTime: new Date()
onFrameSwapped: {
frameCount++
var currentTime = new Date()
if (currentTime - lastTime >= 1000) {
console.log("FPS:", frameCount)
frameCount = 0
lastTime = currentTime
}
}
Repeater {
model: 50
Rectangle {
width: 50
height: 50
color: Qt.rgba(Math.random(), Math.random(), Math.random(), 1)
x: Math.random() * 750
y: Math.random() * 430
rotation: Math.random() * 360
NumberAnimation on rotation {
from: 0
to: 360
duration: 2000 + Math.random() * 3000
loops: Animation.Infinite
}
}
}
}
这个测试程序会创建50个随机颜色的旋转矩形,并在控制台输出帧率。在没有OpenGL支持的情况下,帧率可能只有个位数,而启用OpenGL后应该能达到30-60FPS。
6. 常见问题与解决方案
6.1 编译错误处理
在编译过程中可能会遇到各种错误,以下是一些常见错误及解决方法:
错误1:找不到OpenGL相关头文件
fatal error: GLES2/gl2.h: No such file or directory
解决方法:确保开发板上安装了libgles2-mesa-dev包,并且sysroot同步时包含了这些头文件。
错误2:链接时找不到库
cannot find -lGLESv2
解决方法:检查sysroot中是否有libGLESv2.so文件,确保符号链接正确。
错误3:版本冲突
multiple definition of symbol
解决方法:删除sysroot中冲突的库文件,特别是之前安装的Qt库。
6.2 运行时问题
问题1:无法创建OpenGL上下文
Failed to create OpenGL context for format QSurfaceFormat
解决方法:确保开发板上的Mali驱动正常工作,检查/dev/mali0设备是否存在。
问题2:黑屏或无显示
Unable to query physical screen size, using 100x100.
解决方法:设置正确的QT_QPA_PLATFORM环境变量,尝试使用eglfs或linuxfb平台。
问题3:触摸屏不响应
Unable to open touch device
解决方法:检查tslib配置,确保触摸屏设备权限正确。
6.3 性能调优技巧
- 启用垂直同步:在QML中设置vsync可以避免画面撕裂
ApplicationWindow {
visibility: "FullScreen"
flags: Qt.FramelessWindowHint
// 启用垂直同步
onAfterRendering: {
if (typeof GL !== 'undefined') {
GL.finish()
}
}
}
-
使用硬件加速的图形元素:优先使用Image而不是BorderImage,使用ShaderEffect进行复杂效果渲染
-
减少JavaScript计算:将复杂计算移到C++端,使用WorkerScript进行后台处理
-
优化资源加载:使用异步图像加载,预编译QML文件
经过这些优化后,QML应用在RK3568上应该能够流畅运行,充分发挥硬件加速的优势。
828



被折叠的 条评论
为什么被折叠?



