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

陈工-创龙科技

前  言

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

开发环境

Windows开发环境：Windows10 64bit、Windows7 64bit

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

系统版本：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配置单板机进行演示。

术语表

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

Qt组件支持

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

注意事项

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

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

1 Qt开发说明

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环境（Qt 5.15.11，含qmake工具），请先参考《应用开发手册》的“开发环境搭建说明”章节安装应用开发交叉编译工具链、sysroot压缩包。可基于命令行或Qt Creator工具对已有Qt工程进行编译，生成ARM端Qt程序镜像。

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

1.1基于Qt Creator开发1.1.1安装Qt Creator工具

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

执行如下命令，安装Qt Creator。

Host# sudo apt install qtcreator

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

Host# qtcreator -version

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

Host# sudo apt install gdb-multiarch

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

Host# gdb-multiarch --version

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

Host# source /home/tronlong/RK3576/environment

1.1.2配置交叉编译工具链

执行如下命令启动Qt Creator。

Host# qtcreator

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

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

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

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

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

1.1.3配置Debuggers

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

/usr/bin/gdb-multiarch

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

1.1.4配置Qt Versions

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

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

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

1.1.5配置Kits

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

1.1.6编译Qt工程

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

请在Qt Creator界面，点击"Open"。

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

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

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

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

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