如何快捷使用瑞芯微RK3568J開(kāi)發(fā)板

繁花之語(yǔ)

本文詳細介紹了RK3568在Linux、Android、Ubuntu系統編譯過(guò)程中可能遇到的問(wèn)題，包括設備樹(shù)路徑、源碼編譯不通過(guò)、內核編譯配置錯誤、buildroot編譯問(wèn)題、交叉編譯工具位置、編譯與燒寫(xiě)區別、rockdev目錄映像文件、串口數據丟失問(wèn)題、menuconfig配置不生效以及源碼解壓與編譯問(wèn)題等，并給出了相應的解決方案，對于開(kāi)發(fā)者在編譯RK3568系統時(shí)具有很好的指導意義。

目錄

1、Linux設備樹(shù)的路徑是什么？

2、Linux 源碼編譯不通過(guò)，是什么原因？

3、Linux單獨編譯內核提示Actions Semi Platforms (ARCH_ACTIONS) [N/y/?] (NEW)，導致編譯失敗，這是為什么？

4、Linux在buildroot編譯qt5webengine 5.14.2時(shí)出錯退出，是什么原因？

5：Linux在buildroot編譯linux-tools時(shí)報錯出錯退出，是什么原因？

6、Linux源碼目錄下的交叉編譯工具的位置在哪？

7、Linux交叉編譯配置的環(huán)境變量路徑： Linux執行./build.sh buildroot與執行全編譯的區別

8：Linux在rockdev目錄下的misc.img oem.img recovery.img userdata.img分別是什么意思?

9：Linux為什么運行我們官方的QT程序會(huì )報以下錯誤？

10：Linux系統在使用串口和其他傳感器模塊，會(huì )發(fā)生丟少量字節，怎樣保證串口不丟失數據？

11：Linux/Ubuntu 通過(guò)make ARCH=arm64 menuconfig 配置內核后沒(méi)有生效，是什么原因？

12：Linux/Ubuntu/Android源碼解壓失敗，報錯EOF歸檔失敗?

13：Android 源碼編譯不通過(guò)?

14：Android手冊?xún)葲](méi)有單獨燒寫(xiě)部分，是不是不支持單獨燒寫(xiě)？

15：源碼編譯圖形界面配置錯誤電壓。

--正文開(kāi)始--

本文基于飛凌嵌入式RK3568開(kāi)發(fā)板作為硬件平臺展開(kāi)論述，同時(shí)也對其他開(kāi)發(fā)板用戶(hù)提供了參考價(jià)值。文章深入探討了在編譯RK3568芯片所支持的Linux、Ubuntu及Android系統過(guò)程中，開(kāi)發(fā)者可能遇到問(wèn)題。通過(guò)對這些常見(jiàn)編譯問(wèn)題的細致剖析，并配以相應的解決思路，以期幫助開(kāi)發(fā)者在編譯RK3568相關(guān)系統時(shí)能更加順暢無(wú)阻。 在此過(guò)程中，我們特別提醒開(kāi)發(fā)者，面對編譯中的復雜性與不確定性，需保持高度的耐心與細致入微的態(tài)度。同時(shí)，鼓勵開(kāi)發(fā)者積極利用官方發(fā)布的詳盡文檔以及活躍的社區資源，希望各位開(kāi)發(fā)者都能成功構建出穩定可靠的RK3568 Linux、Ubuntu及Android系統。

1、Linux設備樹(shù)的路徑是什么？

當您的產(chǎn)品是飛凌嵌入式RK3568系列板卡時(shí)，在Linux內核中，設備樹(shù)的路徑通常位于kernel/arch/arm64/boot/dts/rockchip/目錄下，具體文件名為OK3568-C-common.dtsi。這個(gè)文件包含了與OK3568-C系列處理器相關(guān)的設備樹(shù)定義。

2：Linux 源碼編譯不通過(guò)，是什么原因？

問(wèn)題排查方向，你可以參考以下幾項。

①、源碼路徑與名稱(chēng)的穩定性：

全編譯流程結束后，請確保源碼的存儲路徑未發(fā)生變動(dòng)，且源碼文件夾的名稱(chēng)也未被更改。任何路徑或名稱(chēng)的修改都可能阻礙后續的源碼編譯進(jìn)程。

②、操作系統與虛擬環(huán)境的核查：

驗證您的電腦是否運行的是Windows 10操作系統。

檢查VMware虛擬機的版本是否為15。

核實(shí)Ubuntu操作系統的版本是否為18.04。

檢查電腦是否達到16G內存，虛擬機是否是達到8G內存，虛擬機處理器數量4，每個(gè)處理器內核數量1（如果編譯報錯，可以增大內存到10G，配置為4M倍數）。

③、編譯過(guò)程中的內存與線(xiàn)程管理：

編譯失敗的一個(gè)常見(jiàn)原因是編譯過(guò)程中線(xiàn)程數量過(guò)多，導致內存資源被過(guò)度占用。因此，合理管理編譯線(xiàn)程的數量，以避免內存耗盡。

④、源碼完整性的校驗：

在拷貝并合并文件后，請利用md5sum OK3568-linux-source.tar.bz2命令生成校驗碼，并將其與OK3568-linux-source.tar.bz2.checksum.txt文件中的內容進(jìn)行比對，以確保源碼的完整性。

⑤、虛擬機庫文件的安裝情況：

請檢查虛擬機中是否已安裝所有基本庫和必要的開(kāi)發(fā)庫，這些庫文件對于編譯過(guò)程至關(guān)重要。

⑥、網(wǎng)絡(luò )連接的穩定性：

使用ping www.forlinx.com命令或打開(kāi)瀏覽器訪(fǎng)問(wèn)網(wǎng)頁(yè)，以驗證網(wǎng)絡(luò )連接是否穩定。網(wǎng)絡(luò )連接問(wèn)題可能會(huì )影響編譯過(guò)程中的文件下載或更新。

⑦、特定編譯錯誤的應對措施：

若您在首次編譯RK3568 Linux時(shí)遇到錯誤，建議再次執行./build.sh腳本進(jìn)行嘗試。有時(shí)，初次編譯中的某些錯誤可能由于環(huán)境或配置的小幅波動(dòng)而產(chǎn)生，再次執行腳本可能會(huì )解決這些問(wèn)題。

3：在Linux系統中單獨編譯內核時(shí)，提示“Actions Semi Platforms (ARCH_ACTIONS) [N/y/?] (NEW)”，并且導致編譯失敗，這是為什么？

這種情況的原因是 .config 文件中的架構配置被錯誤地修改為X86架構。通常發(fā)生在用戶(hù)直接在內核源代碼目錄下執行 make menuconfig 命令時(shí)，沒(méi)有指定正確的目標架構。正確的命令應該是 make ARCH=arm64 menuconfig，其中 ARCH=arm64 指定了目標架構為ARM64。

為了解決這個(gè)問(wèn)題，可以取消之前對編譯腳本所做的修改，讓編譯腳本能夠重新生成 .config 文件。重新生成 .config 文件后，使用正確的命令執行配置過(guò)程，這樣就可以確保使用正確的架構配置進(jìn)行內核編譯。

4：在Buildroot環(huán)境中編譯Qt5WebEngine 5.14.2時(shí)，Linux系統報錯并退出，可能的原因是什么？

編譯Qt5WebEngine 5.14.2時(shí)出錯并退出的原因通常是由于虛擬機（VM）可用的運行內存不足。推薦的最低VM配置是8GB運行內存和200GB存儲空間。然而，很多用戶(hù)的宿主機只有8GB運行內存，這在實(shí)際操作中會(huì )導致問(wèn)題。即使VM被設置為使用8GB運行內存，宿主機本身也需要占用一定的運行內存來(lái)維持其正常運行，因此實(shí)際上VM可用的內存會(huì )少于8GB。

此外，有些用戶(hù)可能會(huì )修改產(chǎn)品資料中提供的VM鏡像配置，比如增加內核數或調整運存大小。在某些情況下，為了成功編譯Qt5WebEngine，用戶(hù)可能需要將VM的運存增加到10GB或更高。

因此，如果在編譯Qt5WebEngine時(shí)遇到內存不足的報錯，解決方法通常是增加VM可用的運存空間。建議確保宿主機的運行內存在16GB及以上，以便為VM分配足夠的內存資源。如果宿主機內存不足，可以嘗試關(guān)閉一些不必要的應用程序或服務(wù)，或者升級宿主機的硬件配置。

5、在Buildroot環(huán)境中編譯linux-tools時(shí)，Linux系統報錯并退出，可能的原因是什么？

A：在Buildroot環(huán)境中編譯linux-tools時(shí)遇到報錯并退出，通常是因為當前開(kāi)發(fā)環(huán)境中的/usr/bin/python軟鏈接指向了Python 3，而linux-tools的源碼編譯過(guò)程可能需要使用Python 2。為了驗證這一點(diǎn)，可以使用ls -l /usr/bin/python命令來(lái)查看/usr/bin/python軟鏈接實(shí)際指向的是哪個(gè)Python版本。

如果/usr/bin/python指向的是Python 3，那么你需要將其更改為指向Python 2�？梢酝ㄟ^(guò)刪除現有的軟鏈接并重新創(chuàng )建一個(gè)指向Python 2的軟鏈接來(lái)完成。具體的命令如下：

首先，刪除現有的/usr/bin/python軟鏈接（需要管理員權限）：

sudorm/usr/bin/python

然后，創(chuàng )建一個(gè)新的軟鏈接指向/usr/bin/python2（同樣需要管理員權限）：

sudoln-s /usr/bin/python2 /usr/bin/python

注意，在執行這些命令之前，確保你的系統中已經(jīng)安裝了Python 2，并且/usr/bin/python2是可用的。此外，更改系統級的軟鏈接可能會(huì )影響其他依賴(lài)于特定Python版本的程序，因此進(jìn)行此類(lèi)更改之前，請備份重要數據。

6、Linux源碼目錄下的交叉編譯工具的位置在哪？

A：在正常使用情況下，我們推薦用戶(hù)采用位于OK3568-linux-source/buildroot/output/OK3568/host/bin目錄下的aarch64-linux-gcc和aarch64-linux-g++作為交叉編譯工具。

該編譯器查找的庫文件路徑位于OK3568-linux-source/buildroot/output/OK3568/host/aarch64-buildroot-linux-gnu/sysroot/usr目錄下。用戶(hù)可以在Buildroot的配置中實(shí)時(shí)更新或添加所需的編譯庫。

值得注意的是，因為源碼的第一次編譯耗時(shí)較長(cháng)，對于某些用戶(hù)而言可能并不希望進(jìn)行全編譯。針對這種情況，用戶(hù)可以嘗試使用位于OK3568-linux-source/prebuilts/gcc/linux-x86/aarch64/gcc-linaro-6.3.1-***-gnu/bin目錄下的aarch64-linux-gnu-gcc和aarch64-linux-gnu-g++作為交叉編譯工具。

關(guān)于gcc-linaro-6.3.1和gcc-buildroot-9.3.0的詳細信息，用戶(hù)可以查閱OK3568-linux-source/docs/Rockchip_Developer_Guide_Linux_Software_CN.pdf這一瑞芯微官方文檔。在該文檔的5.2.4章節中，用戶(hù)可以找到關(guān)于交叉編譯工具的詳細介紹和使用指南。

7：Linux交叉編譯配置的環(huán)境變量路徑：

配置環(huán)境變量：

export PATH=$PATH:/home/forlinx/linux-3568/OK3568-linux-source/buildroot/output/OK3568/host/bin

設置交叉編譯并運行程序的命令行：

export PATH=/home/forlinx/3568/OK3568-linux-source/buildroot/output/OK3568/host/bin/PATH

aarch64-linux-gcc test.c -o test

8：Linux環(huán)境下執行./build.sh buildroot與執行全編譯的區別

執行./build.sh buildroot

執行./build.sh buildroot只會(huì )在/OK3568-linux-source/buildroot/output/OK3568/images目錄下生成文件系統鏡像；

執行全編譯：

執行全編譯才會(huì )在/OK3568-linux-source/IMAGE/OK3568-C-LINUX_20230714.0034_RELEASE_TEST/IMAGES目錄下生成各個(gè)分區文件和update.img文件。

執行./build.sh buildroot與進(jìn)行全編譯的主要區別在于它們的目標和輸出。前者可能只生成一個(gè)或幾個(gè)特定的文件系統鏡像文件，而后者則生成一個(gè)完整的、可用于部署的軟件包或鏡像文件集合。使用RK3568進(jìn)行開(kāi)發(fā)或部署時(shí)，您應根據具體需求選擇適當的構建方式。

9：Linux在rockdev目錄下的misc.img oem.img recovery.img userdata.img分別是什么意思?

misc.img：

解釋?zhuān)捍擞诚裎募�包含了一些雜項（miscellaneous）信息，這些信息通常與設備啟動(dòng)和配置相關(guān)。例如，bootloader的狀態(tài)（如鎖定或解鎖），以及其他與設備安全和啟動(dòng)流程相關(guān)的參數。

oem.img：

解釋?zhuān)捍擞诚裎募�包含了設備制造商（OEM）定制的數據。這些數據一般包括設備制造商的LOGO、特定的驅動(dòng)程序、配置文件，以及用于設備初始化或特定功能的腳本。

recovery.img：

解釋?zhuān)捍擞诚裎募�包含了Recovery模式的文件系統。Recovery模式是一個(gè)獨立于主操作系統的環(huán)境，用于設備的恢復、更新、修復問(wèn)題，或創(chuàng )建/恢復備份。它通常提供了一個(gè)簡(jiǎn)單的用戶(hù)界面，允許用戶(hù)在沒(méi)有主操作系統的情況下執行這些操作。

userdata.img：

解釋?zhuān)捍擞诚裎募�包含了用�?hù)數據，如應用程序數據、用戶(hù)設置、任務(wù)信息等。這是用戶(hù)在使用設備時(shí)創(chuàng )建和存儲的數據，對于設備的個(gè)性化配置和用戶(hù)體驗至關(guān)重要。

這些映像文件通常在設備刷機或升級時(shí)被使用。因此，在進(jìn)行相關(guān)操作時(shí)，須格外小心謹慎，以避免因操作不當而導致的設備損壞或數據丟失。

10：Linux為什么運行我們官方的QT程序會(huì )報以下錯誤？

qt.qpa.wayland: No shell integration named “xdg-shell” found

A：此情況屬于正�，F象，在編譯命令執行完畢后，RK3568開(kāi)發(fā)板連接顯示屏時(shí)即可觀(guān)察到QT程序的界面已正常呈現。

11：Linux系統在使用串口和其他傳感器模塊，會(huì )發(fā)生丟少量字節，怎樣保證串口不丟失數據？

可嘗試修改設備樹(shù)中與串口相關(guān)的配置，以啟用直接內存訪(fǎng)問(wèn)（DMA）模式。具體操作步驟包括在對應的串口配置函數中，添加如下配置：

dma-names = “tx” , “rx”;

通過(guò)啟用DMA模式，可以更有效地管理串口數據的傳輸，進(jìn)而減少數據丟失的風(fēng)險。

12：Linux/Ubuntu 通過(guò)make ARCH=arm64 menuconfig 配置內核后沒(méi)有生效，是什么原因？

在Linux內核編譯過(guò)程中，使用menuconfig命令主要是用于生成和修改.config文件，該文件包含了內核編譯時(shí)的各種配置選項。然而，如果在執行menuconfig后，又通過(guò)編譯腳本（如build.sh）來(lái)生成鏡像，且該腳本中包含make defconfig命令，那么原本通過(guò)menuconfig設置的.config文件可能會(huì )被make defconfig命令重新生成的.config文件覆蓋。

基于這一原理，要使menuconfig的配置生效，可以采取以下兩種方法：

①、直接編輯defconfig文件：

找到與你的目標硬件（如飛凌嵌入式RK3568開(kāi)發(fā)板）相對應的配置文件，通常位于kernel/arch/arm64/configs/目錄下，文件名為OK3568-C-linux_defconfig。你可以直接編輯這個(gè)文件，將需要的配置選項添加進(jìn)去，或者基于這個(gè)文件創(chuàng )建一個(gè)新的配置文件。然后，在編譯時(shí)，使用make ARCH=arm64 OK3568-C-linux_defconfig命令來(lái)生成.config文件，這樣.config文件就會(huì )包含你在defconfig文件中設置的配置選項。

②、修改編譯腳本：

打開(kāi)你的build.sh編譯腳本，找到其中包含make defconfig命令的行（第509行），并將其注釋掉。這樣，在執行編譯腳本時(shí)，就不會(huì )再執行make defconfig命令，從而避免覆蓋通過(guò)menuconfig設置的.config文件。

13：在Linux/Ubuntu系統上解壓Android源碼時(shí)遇到“EOF歸檔失敗”的錯誤

遇到“EOF歸檔失敗”的錯誤通常意味著(zhù)壓縮包在下載或傳輸過(guò)程中可能已損壞，或者解壓時(shí)使用的文件不完整。為了解決這個(gè)問(wèn)題，請按照以下步驟操作：

①、驗證MD5碼：

首先，需要確認你下載的壓縮包的MD5碼是否與提供的一致。MD5碼是一種校驗和，用于驗證文件的完整性和真實(shí)性�？梢允褂胢d5sum命令（在Linux/Ubuntu上）來(lái)計算下載的壓縮包的MD5碼，并將其與提供的MD5碼進(jìn)行比較。

如果MD5碼不一致，那么很可能是文件在下載過(guò)程中出現了損壞，或者下載的不是正確的文件。此時(shí)，應該重新下載文件，并確保下載過(guò)程中沒(méi)有中斷。

②、檢查壓縮包數量：

如果MD5碼一致，但解壓時(shí)仍然出現錯誤，那么需要注意，RK3568系板卡的源碼包是以切包的方式存儲的，即生成了多個(gè)壓縮包（如.aa, .ab, .ac等，統稱(chēng)為a*壓縮包）。在解壓前，需要將這些壓縮包合并成一個(gè)完整的壓縮包。

③、合并壓縮包：

使用cat命令將多個(gè)壓縮包合并成一個(gè)完整的壓縮包。例如 cat OK3568-linux-source.tar.bz2.a* > OK3568-linux-source.tar.bz2，這條命令會(huì )將所有以OK3568-linux-source.tar.bz2.a開(kāi)頭的文件合并成一個(gè)名為OK3568-linux-source.tar.bz2的完整壓縮包。

④、解壓合并后的壓縮包：

使用tar命令 tar -xvf OK3568-linux-source.tar.bz2 解壓合并后的壓縮包，這條命令會(huì )解壓OK3568-linux-source.tar.bz2文件，并將其內容提取到當前目錄下。

請確保在執行這些步驟時(shí)，你有足夠的磁盤(pán)空間和正確的權限來(lái)訪(fǎng)問(wèn)和修改這些文件。如果問(wèn)題仍然存在，請檢查你的系統環(huán)境是否支持解壓該類(lèi)型的壓縮包，或者嘗試在不同的系統或環(huán)境中進(jìn)行解壓。

14：Android 源碼編譯不通過(guò)?

有用戶(hù)反饋，在編譯3568Android源碼的過(guò)程中，首次編譯會(huì )遇到錯誤，但再次編譯時(shí)卻能成功，且之前的報錯似乎并未對最終的編譯結果產(chǎn)生影響。

針對用戶(hù)反饋的這一問(wèn)題，我們注意到Android源碼編譯前需要執行兩條關(guān)鍵命令，它們分別是： ①、source build/envsetup.sh

②、lunch ok3568_r-userdebug

這兩條命令的主要作用是配置編譯所需的環(huán)境變量，這些配置是臨時(shí)的，它們與當前的終端窗口緊密相關(guān)。若用戶(hù)在新建的終端窗口中執行編譯操作，那么需要重新執行這兩條命令，以確保環(huán)境變量得到正確配置。

15：Android手冊?xún)葲](méi)有單獨燒寫(xiě)部分，是不是不支持單獨燒寫(xiě)？

A：Android系統在經(jīng)歷過(guò)一次全編譯后，是支持單獨編譯和燒寫(xiě)的。

Q：源碼編譯過(guò)程中電壓域配置錯誤導致內核編譯失敗的解決方案

在源碼編譯過(guò)程中，若因圖形界面配置錯誤電壓域而導致內核編譯失敗，首先，確認你正在編譯的是Linux系統、Forlinx Desktop系統還是Android系統，這幾個(gè)操作系統的編譯和修復步驟略有不同�？砂凑找韵虏襟E進(jìn)行故障排查與修復

①、針對Linux系統與Forlinx Desktop系統

定位并刪除臨時(shí)文件：

首先，需定位至內核設備樹(shù)（DTS）文件所在的目錄。在Ubuntu系統中，若使用飛凌嵌入式提供的OK3568開(kāi)發(fā)板源碼，該目錄通常位于~/OK3568-linux-source/kernel/arch/arm64/boot/dts/rockchip。在此目錄下，查找名為.OK3568-C-linux.dtb.dts.tmp.domain的臨時(shí)文件，并使用rm命令將其刪除。執行ls -a命令可確認文件是否已成功刪除。

重新編譯內核鏡像：

刪除臨時(shí)文件后，返回至Linux源碼的根目錄（如~/OK3568-linux-source），并執行編譯腳本（如./build.sh）以重新編譯內核鏡像。

②、針對Android系統

定位并刪除臨時(shí)文件：

對于A(yíng)ndroid系統，同樣需定位至內核設備樹(shù)（DTS）文件所在的目錄，該目錄在A(yíng)ndroid源碼中通常位于~/android-ok3568/OK3568-android11-source/kernel/arch/arm64/boot/dts/rockchip。在此目錄下，查找名為.OK3568-C-android.dtb.dts.tmp.domain的臨時(shí)文件，并使用rm命令將其刪除。執行ls -a命令確認文件刪除情況。

設置編譯環(huán)境并重新編譯：

刪除臨時(shí)文件后，返回至Android源碼的根目錄（如~/android-ok3568/OK3568-android11-source），并執行以下命令以設置編譯環(huán)境、選擇編譯目標并重新編譯鏡像：

source build/envsetup.sh：設置Android編譯環(huán)境變量。

lunch ok3568_r-userdebug：選擇編譯目標配置。

./build.sh -UKAup：執行編譯命令，其中-UKAup參數可能根據具體編譯需求而有所調整。