RK3576 单板机嵌入式 Qt 界面与多屏异显开发手册（一）

旅游文化 2026-04-22 chy123 3566

前 言

本文是创龙科技专为 RK3576 单板机编写的图形用户界面（GUI）开发手册，基于 Qt 5.15.11 框架提供完整开发指引。文档涵盖 Qt Creator 环境配置、交叉编译、网络远程调试、程序开机自启动、GPU 图形加速等核心内容，并附带 LED 控制、图片显示、多屏同显 / 异显等实战案例。创龙科技以清晰步骤与可直接运行的源码，帮助开发者快速完成嵌入式 GUI 项目开发。

开发环境

Windows开发环境：Windows10 64bit、Windows764bit

Linux开发环境：VMware16.2.5、Ubuntu22.04.564bit

系统版本：Tronlong-Desktop 22.04（类Ubuntu）、Linux-6.1.115、U-Boot-2017.09

sysroot：rk3576-Tronlong-Desktop-22.04-sysroot-[版本号].tar.gz

应用开发交叉编译工具：gcc-11-aarch64-linux-gnu_11.4.0-1ubuntu1~22.04cross1_amd64.tar.gz

Qt版本：5.15.11

备注：本文基于2GByte LPDDR4X、16GByte eMMC配置单板机进行演示。

术语表

为便于阅读，下表对文档出现的关键术语进行解释；对于广泛认同释义的术语，在此不做注释。

wKgZPGnoLKeAOyvxAAAd5ato9co199.png

Qt组件支持

Qt组件支持情况如下，详情请查看产品资料“4-软件资料LinuxFilesystemrootfs-feature-support”文件。

注意事项

无特殊说明情况下，本文默认从eMMC启动系统，使用DEBUG作为调试串口，使用HDMI显示屏作为显示输出。

如需使用网络调试Qt工程，请将单板机通过路由器与PC机进行网络连接，并确保上位机Ubuntu系统可正常访问互联网。

1Qt开发说明

Qt开发环境主要包括Qt Creator工具、X86端Qt环境、ARM端Qt环境、交叉编译工具链等。当用户使用Qt Creator工具和X86端Qt环境编写并编译Qt工程后，生成的Qt程序镜像仅可在X86端运行。必须使用适配单板机的ARM端Qt环境、交叉编译工具链编译Qt工程，生成的Qt程序镜像方可在ARM端（即单板机）上正常运行。

我司提供的rk3576-Tronlong-Desktop-22.04-sysroot-[版本号].tar.gz压缩包已提供适配单板机的ARM端Qt环境（Qt5.15.11，含qmake工具），请先参考《应用开发手册》的“开发环境搭建说明”章节安装应用开发交叉编译工具链、sysroot压缩包。可基于命令行或Qt Creator工具对已有Qt工程进行编译，生成ARM端Qt程序镜像。

我司提供的Qt工程位于产品资料“4-软件资料Demoqt-demos”目录下，其中src目录下包含Qt工程源码，bin目录下包含ARM端Qt程序镜像。请将整个qt-demos文件夹拷贝至Ubuntu工作目录下，如下图所示。

wKgZO2noLLqAeg8sAAF7zTXFjXo684.png

1.1基于QtCreator开发

1.1.1安装QtCreator工具

Qt Creator是一款专为Qt框架设计的跨平台集成开发环境(IDE)，提供代码编辑、调试、项目管理和界面设计等功能，支持高效开发Qt应用程序。

执行如下命令，安装QtCreator。

Host# sudoaptinstallqtcreator

执行如下命令，查看QtCreator版本。

Host# qtcreator -version

wKgZO2noLMeAW2meAAEIRZMmNac643.png

执行如下命令，安装GNU调试器。

Host# sudo apt install gdb-multiarch

wKgZPGnoLM-AdQ2nAABVKf4GlqQ621.png

执行如下命令，查看调试器版本。

Host# gdb-multiarch --version

wKgZO2noLNaAJF86AAB0eJ8_vV4563.png

执行如下命令，加载环境变量。

Host# source /home/tronlong/RK3576/environment

wKgZPGnoLNuASgjMAAAmFnmrkDQ072.png

1.1.2配置交叉编译工具链

执行如下命令启动QtCreator。

Host# qtcreator

wKgZPGnoLOGAPBcHAAAt8Dn7zQM740.png

启动Qt Creator工具后，点击菜单栏"Tools->Options…"。

wKgZO2noLOeAYl-mAAEsy97pVkk592.png

点击"Kits"，打开配置选择页面。

wKgZPGnoLO2AOavuAADoRjXhBHc748.png

点击"Compilers->Add->GCC->C++ ->Browse…"，选择平台交叉编译工具链中的aarch64-linux-gnu-g++，然后点击Open确认。具体路径为：

/usr/bin/aarch64-linux-gnu-g++

wKgZPGnoLPWAMzfSAAF2kYPULOQ857.png

wKgZO2noLPWABA5_AAJLHv8Gq5k541.png

选择后，Name修改为"RK3576-GCC"，ABI选择"arm-linux-generic-elf-64bit"，再点击Apply，如下图所示。

wKgZPGnoLQOAdlOaAAHISYRkd1s706.png

1.1.3配置Debuggers

点击"Debuggers ->Add -> Browse…"，选择GNU调试器，然后点击Open确认。具体路径为：

/usr/bin/gdb-multiarch

wKgZO2noLQ-AbKs8AAFJ2VMLGHU560.png

wKgZO2noLQ-AHqNGAAIsGD8wmDw788.png

选择后，Name修改为"gdb-multiarch"，再点击Apply，如下图所示。

wKgZPGnoLRyAc2i8AAFff6OaMz8786.png

1.1.4配置Qt Versions

点击"Qt Versions->Add"，选择平台qmake，然后点击Open确认。具体路径为：

/home/tronlong/RK3576/sysroots/x86_64-linux/bin/qmake

wKgZPGnoLSSAayQvAACBqJ2mv0w550.png

wKgZO2noLSSAaL0AAACBqJ2mv0w909.png

选择后，Version name修改为"RK3576-qt5"再点击Apply，如下图所示。

wKgZPGnoLS2AAQyFAAGbm2sF64c262.png

1.1.5配置Kits

请参照下图配置Kits各选项。点击"Kits ->Add"，将Name修改为"RK3576"，Device type选择"Generic Linux Device"，Compiler的C++选择"RK3576-GCC"，Debugger选择"gdb-multiarch"，Qtversion选择"RK3576-qt5"，点击Apply，然后点击OK完成配置。

wKgZO2noLTOAU2HIAAHerABBHkI045.png

1.1.6编译Qt工程

本章节以led_control案例为例，演示基于QtCreator工具开发Qt程序的方法。

请在QtCreator界面，点击"Open"。

wKgZO2noLTmAYlDNAADzQj7kytM284.png

选中Qt工程源码目录的led_control.pro文件，点击Open。

wKgZPGnoLT-AB1KNAACA5GpqMJ0542.png

勾选RK3576平台Kits，点击"Browse…"选择Qt程序镜像生成的路径，选择好后点击"Open"，如下图所示。

wKgZPGnoLUqAdQ-HAAHhCwX-qn4251.png

wKgZO2noLUqAcpk8AACDswyRfAk877.png

点击"Configure Project"进行工程配置，如下图所示。

wKgZPGnoLVKAVwMYAAHKpgShixo045.png

右击Qt工程，点击Build进行Qt工程编译，生成可在单板机上正常运行的ARM端Qt程序镜像，如下图所示。

wKgZO2noLVmANt2CAAHKHgCTuqc636.png

wKgZPGnoLVqAH5baAAMa7ux3HWw252.png

编译完成后，将生成可在单板机上运行的ARM端Qt程序镜像，如下图所示。

wKgZO2noLWGALg0fAABUK0zZoAY712.png

审核编辑 黄宇