前 言

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

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

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

Linux開(kāi)發(fā)環(huán)境：VMware16.2.5、Ubuntu22.04.564bit

系統(tǒng)版本：Tronlong-Desktop 22.04（類Ubuntu）、Linux-6.1.115、U-Boot-2017.09

sysroot：rk3576-Tronlong-Desktop-22.04-sysroot-[版本號(hào)].tar.gz

應(yīng)用開(kāi)發(fā)交叉編譯工具：gcc-11-aarch64-linux-gnu_11.4.0-1ubuntu1~22.04cross1_amd64.tar.gz

Qt版本：5.15.11

備注：本文基于2GByte LPDDR4X、16GByte eMMC配置單板機(jī)進(jìn)行演示。

術(shù)語(yǔ)表

為便于閱讀，下表對(duì)文檔出現(xiàn)的關(guān)鍵術(shù)語(yǔ)進(jìn)行解釋；對(duì)于廣泛認(rèn)同釋義的術(shù)語(yǔ)，在此不做注釋。

Qt組件支持

Qt組件支持情況如下，詳情請(qǐng)查看產(chǎn)品資料“4-軟件資料LinuxFilesystemrootfs-feature-support”文件。

注意事項(xiàng)

無(wú)特殊說(shuō)明情況下，本文默認(rèn)從eMMC啟動(dòng)系統(tǒng)，使用DEBUG作為調(diào)試串口，使用HDMI顯示屏作為顯示輸出。

如需使用網(wǎng)絡(luò)調(diào)試Qt工程，請(qǐng)將單板機(jī)通過(guò)路由器與PC機(jī)進(jìn)行網(wǎng)絡(luò)連接，并確保上位機(jī)Ubuntu系統(tǒng)可正常訪問(wèn)互聯(lián)網(wǎng)。

1Qt開(kāi)發(fā)說(shuō)明

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

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

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

1.1基于QtCreator開(kāi)發(fā)

1.1.1安裝QtCreator工具

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

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

Host# sudoaptinstallqtcreator

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

Host# qtcreator -version

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

Host# sudo apt install gdb-multiarch

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

Host# gdb-multiarch --version

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

Host# source /home/tronlong/RK3576/environment

1.1.2配置交叉編譯工具鏈

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

Host# qtcreator

啟動(dòng)Qt Creator工具后，點(diǎn)擊菜單欄"Tools->Options…"。

點(diǎn)擊"Kits"，打開(kāi)配置選擇頁(yè)面。

點(diǎn)擊"Compilers->Add->GCC->C++ ->Browse…"，選擇平臺(tái)交叉編譯工具鏈中的aarch64-linux-gnu-g++，然后點(diǎn)擊Open確認(rèn)。具體路徑為：

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

選擇后，Name修改為"RK3576-GCC"，ABI選擇"arm-linux-generic-elf-64bit"，再點(diǎn)擊Apply，如下圖所示。

1.1.3配置Debuggers

點(diǎn)擊"Debuggers ->Add -> Browse…"，選擇GNU調(diào)試器，然后點(diǎn)擊Open確認(rèn)。具體路徑為：

/usr/bin/gdb-multiarch

選擇后，Name修改為"gdb-multiarch"，再點(diǎn)擊Apply，如下圖所示。

1.1.4配置Qt Versions

點(diǎn)擊"Qt Versions->Add"，選擇平臺(tái)qmake，然后點(diǎn)擊Open確認(rèn)。具體路徑為：

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

選擇后，Version name修改為"RK3576-qt5"再點(diǎn)擊Apply，如下圖所示。

1.1.5配置Kits

請(qǐng)參照下圖配置Kits各選項(xiàng)。點(diǎn)擊"Kits ->Add"，將Name修改為"RK3576"，Device type選擇"Generic Linux Device"，Compiler的C++選擇"RK3576-GCC"，Debugger選擇"gdb-multiarch"，Qtversion選擇"RK3576-qt5"，點(diǎn)擊Apply，然后點(diǎn)擊OK完成配置。

1.1.6編譯Qt工程

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

請(qǐng)?jiān)赒tCreator界面，點(diǎn)擊"Open"。

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

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

點(diǎn)擊"Configure Project"進(jìn)行工程配置，如下圖所示。

右擊Qt工程，點(diǎn)擊Build進(jìn)行Qt工程編譯，生成可在單板機(jī)上正常運(yùn)行的ARM端Qt程序鏡像，如下圖所示。

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

審核編輯 黃宇