当前位置：首页 > news >正文

保姆级教程：在Ubuntu 20.04上为全志T507构建Qt5.12.5交叉编译环境（含GPU加速配置）

news 2026/4/19 0:40:45

全志T507 Qt5.12.5交叉编译实战：从环境搭建到GPU加速配置

在嵌入式开发领域，全志T507/T7处理器凭借其出色的性能和丰富的接口资源，成为工业控制、智能终端等场景的热门选择。而Qt框架作为跨平台应用开发的利器，其5.12.5 LTS版本在稳定性和功能完整性上达到了一个理想的平衡点。本文将手把手指导开发者，在Ubuntu 20.04系统上构建完整的Qt5.12.5交叉编译环境，并特别针对T507的Mali-G31 GPU实现OpenGL ES2硬件加速支持。

1. 环境准备与工具链配置

在开始之前，我们需要准备一台运行Ubuntu 20.04 LTS的x86_64主机。这个版本的系统经过验证，能够完美支持后续所需的各项工具。首先安装基础开发工具：

sudo apt update sudo apt install -y build-essential git python2.7 python3.8 \ libgl1-mesa-dev libglu1-mesa-dev libxkbcommon-dev \ libxcb-xinerama0-dev libxcb-icccm4-dev libxcb-image0-dev \ libxcb-keysyms1-dev libxcb-render-util0-dev \ libxcb-xinput-dev libxcb-xkb-dev libxkbcommon-x11-dev

全志官方提供了针对T507的交叉编译工具链，我们需要将其安装到系统中。假设工具链已下载到~/toolchains目录：

tar xvf gcc-linaro-7.4.1-2019.02-x86_64_aarch64-linux-gnu.tar.xz -C /opt

然后配置环境变量，将工具链路径加入PATH：

echo 'export PATH=/opt/gcc-linaro-7.4.1-2019.02-x86_64_aarch64-linux-gnu/bin:$PATH' >> ~/.bashrc source ~/.bashrc

验证工具链是否安装成功：

aarch64-linux-gnu-gcc --version

提示：如果开发过程中需要切换不同版本的工具链，建议使用update-alternatives进行管理，避免环境变量冲突。

2. Qt源码获取与基础配置

Qt5.12.5是长期支持版本，我们需要从官方镜像获取源码：

wget https://download.qt.io/archive/qt/5.12/5.12.5/single/qt-everywhere-src-5.12.5.tar.xz tar xvf qt-everywhere-src-5.12.5.tar.xz cd qt-everywhere-src-5.12.5

创建编译配置脚本setenv-t507.sh，这是整个编译过程的核心：

#!/bin/bash # 基础路径配置 export AW_QT_INSTALL_DIR=/opt/Qt-5.12.5-t507 export QT_BUILD_ROOT=$(pwd) export SYSROOT=/path/to/t507/sysroot # 替换为实际的sysroot路径 # 工具链配置 export CROSS_COMPILE=aarch64-linux-gnu- export PATH=/opt/gcc-linaro-7.4.1-2019.02-x86_64_aarch64-linux-gnu/bin:$PATH # 编译函数定义 function configure_qt { ./configure \ -prefix $AW_QT_INSTALL_DIR \ -extprefix $AW_QT_INSTALL_DIR \ -release \ -opensource \ -confirm-license \ -xplatform linux-aarch64-gnu-g++ \ -sysroot $SYSROOT \ -no-pch \ -qt-zlib \ -qt-libpng \ -qt-libjpeg \ -qt-freetype \ -qt-harfbuzz \ -no-opengl \ -no-xcb \ -no-eglfs \ -no-directfb \ -no-linuxfb \ -no-kms \ -no-gbm \ -nomake examples \ -nomake tests \ -skip qtdoc \ -skip qtwebengine }

这个初始配置暂时禁用了所有图形后端，我们将在后续步骤中专门配置GPU加速支持。

3. Mali GPU加速配置实战

全志T507集成的是Mali-G31 MP2 GPU，支持OpenGL ES 3.2、Vulkan 1.1等图形API。我们需要准备GPU驱动和头文件：

从全志SDK中获取以下内容：
- libmali.so- Mali GPU驱动库
- fbdev_window.h- FrameBuffer设备接口定义
- EGL/- EGL头文件目录
- GLES2/,GLES3/- OpenGL ES头文件

将这些文件部署到sysroot的相应位置：

# 假设驱动文件位于全志SDK的gpu目录 cp -r /path/to/sdk/gpu/include/EGL $SYSROOT/usr/include/ cp -r /path/to/sdk/gpu/include/GLES2 $SYSROOT/usr/include/ cp /path/to/sdk/gpu/include/fbdev_window.h $SYSROOT/usr/include/EGL/ cp /path/to/sdk/gpu/lib/libmali.so $SYSROOT/usr/lib/

修改Qt的mkspec文件qtbase/mkspecs/linux-aarch64-gnu-g++/qmake.conf，添加GPU支持：

# 在文件末尾添加以下内容 QMAKE_INCDIR_OPENGL_ES2 = $$[QT_SYSROOT]/usr/include QMAKE_LIBDIR_OPENGL_ES2 = $$[QT_SYSROOT]/usr/lib QMAKE_LIBS_OPENGL_ES2 = -lGLESv2 -lEGL -lmali # 修改编译器标志 QMAKE_CFLAGS += -DEGL_API_FB=1 -DEGL_FBDEV=1 QMAKE_CXXFLAGS += -DEGL_API_FB=1 -DEGL_FBDEV=1

更新配置脚本，启用EGLFS和OpenGL ES支持：

function configure_qt { ./configure \ # 保留之前的参数... -opengl es2 \ -eglfs \ -qpa eglfs \ -device-option CROSS_COMPILE=$CROSS_COMPILE \ # 其他参数... }

4. 编译与安装

现在可以开始编译Qt库了。首先应用环境配置：

source setenv-t507.sh configure_qt make -j$(nproc) sudo make install

编译完成后，检查生成的EGLFS插件：

ls $AW_QT_INSTALL_DIR/plugins/egldeviceintegrations/

应该能看到libqeglfs-mali-integration.so文件，这表明Mali GPU支持已成功编译。

将编译好的Qt库部署到目标板：

rsync -avz $AW_QT_INSTALL_DIR root@target:/usr/local/

在目标板上设置环境变量：

export QT_ROOT=/usr/local/Qt-5.12.5-t507 export PATH=$QT_ROOT/bin:$PATH export LD_LIBRARY_PATH=$QT_ROOT/lib:$LD_LIBRARY_PATH export QT_QPA_PLATFORM=eglfs export QT_QPA_EGLFS_INTEGRATION=eglfs_mali

5. 常见问题解决方案

在实际部署过程中，可能会遇到以下典型问题：

问题1：应用程序启动时报错"Failed to load EGL device integration eglfs_mali"

解决方案：

确认libqeglfs-mali-integration.so已部署到目标板的正确位置
检查目标板的libmali.so是否存在且版本匹配
确保环境变量QT_QPA_EGLFS_INTEGRATION=eglfs_mali已设置

问题2：触摸屏输入不响应

解决方案：创建/etc/qt5/eglfs.json配置文件：

{ "device": "/dev/fb0", "inputs": [ { "device": "/dev/input/event2", "type": "touchscreen", "spec": "/sys/class/input/input2" } ] }

问题3：OpenGL ES2程序编译时报错"GLES3/gl3.h not found"

解决方案：在应用程序的.pro文件中明确指定OpenGL ES版本：

QT += opengl QMAKE_CXXFLAGS += -I$$[QT_SYSROOT]/usr/include LIBS += -lGLESv2

6. 性能优化技巧

为了充分发挥T507的GPU性能，可以考虑以下优化措施：

帧缓冲配置优化：

export QT_QPA_EGLFS_FB=/dev/fb0 export QT_QPA_EGLFS_WIDTH=1280 export QT_QPA_EGLFS_HEIGHT=800 export QT_QPA_EGLFS_PHYSICAL_WIDTH=216 export QT_QPA_EGLFS_PHYSICAL_HEIGHT=135

渲染线程优化：

QCoreApplication::setAttribute(Qt::AA_ShareOpenGLContexts); QCoreApplication::setAttribute(Qt::AA_UseOpenGLES);

内存管理优化：

export QT_QUICK_BACKEND=software export QT_QUICK_NO_MULTITHREADED_RENDERER=1

GPU驱动参数调优：

echo "performance" > /sys/devices/platform/13040000.gpu/devfreq/13040000.gpu/governor echo 600000000 > /sys/devices/platform/13040000.gpu/devfreq/13040000.gpu/max_freq

通过以上步骤，开发者可以在全志T507平台上建立完整的Qt5.12.5开发环境，并充分利用Mali GPU的硬件加速能力。实际项目中，建议根据具体应用场景进一步调整EGLFS的参数配置，以达到最佳的性能表现。

查看全文

http://www.jsqmd.com/news/663258/