RK3568常見問題手冊-如何快捷的使用瑞芯微RK3568J開發板

原創

飛凌嵌入式 2024-12-19 16:19:00 rk3568 rk3568手冊 rk3568問題

概述

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

硬件平臺：飛凌嵌入式RK3568/RK3568J 開發板

操作系統：Linux、Android、Ubuntu

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

1、Linux設備樹的路徑是什么？

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

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

問題排查方向，你可以參考以下幾項。

①、源碼路徑與名稱的穩定性：

全編譯流程結束后，請確保源碼的存儲路徑未發生變動，且源碼文件夾的名稱也未被更改。任何路徑或名稱的修改都可能阻礙后續的源碼編譯進程。

②、操作系統與虛擬環境的核查：

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

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

核實Ubuntu操作系統的版本是否為18.04。

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

③、編譯過程中的內存與線程管理：

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

④、源碼完整性的校驗：

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

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

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

⑥、網絡連接的穩定性：

使用ping m.tkbv.cn命令或打開瀏覽器訪問網頁，以驗證網絡連接是否穩定。網絡連接問題可能會影響編譯過程中的文件下載或更新。

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

若您在首次編譯RK3568 Linux時遇到錯誤，建議再次執行./build.sh腳本進行嘗試。有時，初次編譯中的某些錯誤可能由于環境或配置的小幅波動而產生，再次執行腳本可能會解決這些問題。

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

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

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

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

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

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

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

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

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

如果/usr/bin/python指向的是Python 3，那么你需要將其更改為指向Python 2。可以通過刪除現有的軟鏈接并重新創建一個指向Python 2的軟鏈接來完成。具體的命令如下：

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

sudorm/usr/bin/python

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

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

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

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

A：在正常使用情況下，我們推薦用戶采用位于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目錄下。用戶可以在Buildroot的配置中實時更新或添加所需的編譯庫。

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

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

7：Linux交叉編譯配置的環境變量路徑：

配置環境變量：

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環境下執行./build.sh buildroot與執行全編譯的區別

執行./build.sh buildroot

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

執行全編譯：

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

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

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

misc.img：

解釋：此映像文件包含了一些雜項（miscellaneous）信息，這些信息通常與設備啟動和配置相關。例如，bootloader的狀態（如鎖定或解鎖），以及其他與設備安全和啟動流程相關的參數。

oem.img：

解釋：此映像文件包含了設備制造商（OEM）定制的數據。這些數據一般包括設備制造商的LOGO、特定的驅動程序、配置文件，以及用于設備初始化或特定功能的腳本。

recovery.img：

解釋：此映像文件包含了Recovery模式的文件系統。Recovery模式是一個獨立于主操作系統的環境，用于設備的恢復、更新、修復問題，或創建/恢復備份。它通常提供了一個簡單的用戶界面，允許用戶在沒有主操作系統的情況下執行這些操作。

userdata.img：

解釋：此映像文件包含了用戶數據，如應用程序數據、用戶設置、任務信息等。這是用戶在使用設備時創建和存儲的數據，對于設備的個性化配置和用戶體驗至關重要。

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

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

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

A：此情況屬于正常現象，在編譯命令執行完畢后，RK3568開發板連接顯示屏時即可觀察到QT程序的界面已正常呈現。

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

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

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

通過啟用DMA模式，可以更有效地管理串口數據的傳輸，進而減少數據丟失的風險。

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

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

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

①、直接編輯defconfig文件：

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

②、修改編譯腳本：

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

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

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

①、驗證MD5碼：

首先，需要確認你下載的壓縮包的MD5碼是否與提供的一致。MD5碼是一種校驗和，用于驗證文件的完整性和真實性。可以使用md5sum命令（在Linux/Ubuntu上）來計算下載的壓縮包的MD5碼，并將其與提供的MD5碼進行比較。

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

②、檢查壓縮包數量：

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

③、合并壓縮包：

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

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

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

請確保在執行這些步驟時，你有足夠的磁盤空間和正確的權限來訪問和修改這些文件。如果問題仍然存在，請檢查你的系統環境是否支持解壓該類型的壓縮包，或者嘗試在不同的系統或環境中進行解壓。

14：Android 源碼編譯不通過?

有用戶反饋，在編譯3568Android源碼的過程中，首次編譯會遇到錯誤，但再次編譯時卻能成功，且之前的報錯似乎并未對最終的編譯結果產生影響。

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

②、lunch ok3568_r-userdebug

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

15：Android手冊內沒有單獨燒寫部分，是不是不支持單獨燒寫？

A：Android系統在經歷過一次全編譯后，是支持單獨編譯和燒寫的。

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

在源碼編譯過程中，若因圖形界面配置錯誤電壓域而導致內核編譯失敗，首先，確認你正在編譯的是Linux系統、Forlinx Desktop系統還是Android系統，這幾個操作系統的編譯和修復步驟略有不同。可按照以下步驟進行故障排查與修復

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

定位并刪除臨時文件：

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

重新編譯內核鏡像：

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

②、針對Android系統

定位并刪除臨時文件：

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

設置編譯環境并重新編譯：

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

source build/envsetup.sh：設置Android編譯環境變量。

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

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