前 言

本文是創(chuàng)龍科技專為 RK3576 單板機編寫的圖形用戶界面（GUI）開發(fā)手冊，基于 Qt 5.15.11 框架提供完整開發(fā)指引。文檔涵蓋 Qt Creator 環(huán)境配置、交叉編譯、網絡遠程調試、程序開機自啟動、GPU 圖形加速等核心內容，并附帶 LED 控制、圖片顯示、多屏同顯 / 異顯等實戰(zhàn)案例。創(chuàng)龍科技以清晰步驟與可直接運行的源碼，幫助開發(fā)者快速完成嵌入式 GUI 項目開發(fā)。

開發(fā)環(huán)境

Windows開發(fā)環(huán)境：Windows10 64bit、Windows764bit

Linux開發(fā)環(huán)境：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

應用開發(fā)交叉編譯工具：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-軟件資料LinuxFilesystemrootfs-feature-support”文件。

注意事項

無特殊說明情況下，本文默認從eMMC啟動系統，使用DEBUG作為調試串口，使用HDMI顯示屏作為顯示輸出。

如需使用網絡調試Qt工程，請將單板機通過路由器與PC機進行網絡連接，并確保上位機Ubuntu系統可正常訪問互聯網。

1Qt開發(fā)說明

Qt開發(fā)環(huán)境主要包括Qt Creator工具、X86端Qt環(huán)境、ARM端Qt環(huán)境、交叉編譯工具鏈等。當用戶使用Qt Creator工具和X86端Qt環(huán)境編寫并編譯Qt工程后，生成的Qt程序鏡像僅可在X86端運行。必須使用適配單板機的ARM端Qt環(huán)境、交叉編譯工具鏈編譯Qt工程，生成的Qt程序鏡像方可在ARM端（即單板機）上正常運行。

我司提供的rk3576-Tronlong-Desktop-22.04-sysroot-[版本號].tar.gz壓縮包已提供適配單板機的ARM端Qt環(huán)境（Qt5.15.11，含qmake工具），請先參考《應用開發(fā)手冊》的“開發(fā)環(huán)境搭建說明”章節(jié)安裝應用開發(fā)交叉編譯工具鏈、sysroot壓縮包?？苫诿钚谢騋t Creator工具對已有Qt工程進行編譯，生成ARM端Qt程序鏡像。

我司提供的Qt工程位于產品資料“4-軟件資料Demoqt-demos”目錄下，其中src目錄下包含Qt工程源碼，bin目錄下包含ARM端Qt程序鏡像。請將整個qt-demos文件夾拷貝至Ubuntu工作目錄下，如下圖所示。

1.1基于QtCreator開發(fā)

1.1.1安裝QtCreator工具

Qt Creator是一款專為Qt框架設計的跨平臺集成開發(fā)環(huán)境(IDE)，提供代碼編輯、調試、項目管理和界面設計等功能，支持高效開發(fā)Qt應用程序。

執(zhí)行如下命令，安裝QtCreator。

Host# sudoaptinstallqtcreator

執(zhí)行如下命令，查看QtCreator版本。

Host# qtcreator -version

執(zhí)行如下命令，安裝GNU調試器。

Host# sudo apt install gdb-multiarch

執(zhí)行如下命令，查看調試器版本。

Host# gdb-multiarch --version

執(zhí)行如下命令，加載環(huán)境變量。

Host# source /home/tronlong/RK3576/environment

1.1.2配置交叉編譯工具鏈

執(zhí)行如下命令啟動QtCreator。

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"，Qtversion選擇"RK3576-qt5"，點擊Apply，然后點擊OK完成配置。

1.1.6編譯Qt工程

本章節(jié)以led_control案例為例，演示基于QtCreator工具開發(fā)Qt程序的方法。

請在QtCreator界面，點擊"Open"。

選中Qt工程源碼目錄的led_control.pro文件，點擊Open。

勾選RK3576平臺Kits，點擊"Browse…"選擇Qt程序鏡像生成的路徑，選擇好后點擊"Open"，如下圖所示。

點擊"Configure Project"進行工程配置，如下圖所示。

右擊Qt工程，點擊Build進行Qt工程編譯，生成可在單板機上正常運行的ARM端Qt程序鏡像，如下圖所示。

編譯完成后，將生成可在單板機上運行的ARM端Qt程序鏡像，如下圖所示。

審核編輯 黃宇