RK3308-編譯根文件系統

編譯根文件系統

準備工作

開發環境搭建

除了系統要求外，還有其他軟硬方面的要求。

• 64 位系統
• 硬盤空間大於 40G，如果您進行多個構建，將需要更大的硬盤空間。

推薦使用Ubuntu 16.04 的系統進行編譯。其他版本沒有具體測試，可能需要對軟件包做相應調整。

軟件包安裝

操作系統安裝好後，且用戶已自行配置好網絡環境，則可繼續如下步驟完成相關軟件包的安裝。

• apt-get update

$ sudo apt-get update

• 安裝 Kernel 及 U-Boot 編譯需要依賴的軟件包

$ sudo apt-get install git-core gnupg flex bison gperf build-essential zip curl \
zlib1g-dev gcc-multilib g++-multilib libc6-dev-i386 lib32ncurses5-dev \
x11proto-core-dev libx11-dev lib32z1-dev ccache libgl1-mesa-dev \
libxml2-utils xsltproc unzip device-tree-compiler

• 安裝 Buildroot 編譯需要依賴的軟件包

$ sudo apt-get install libfile-which-perl sed make binutils gcc g++ bash \
patch gzip bzip2 perl tar cpio python unzip rsync file bc libmpc3 \
git repo texinfo pkg-config cmake tree

• 必要工具安裝

$ sudo apt install genext2fs

注意：編譯若遇到報錯，可以視報錯信息，安裝對應的軟件包。

交叉編譯工具鏈介紹

鑑於 Rockchip Buildroot SDK 目前只在 Linux 下編譯，我們也僅提供了 Linux 下的交叉編譯工具鏈。其中 U-Boot 及 Kernel 使用的編譯工具鏈預置目錄在 prebuilt/gcc下，buildroot 使用該開源軟件中編譯出來的工具鏈。

U-Boot 及 Kernel 編譯工具鏈

prebuilts/gcc/linux-x86/aarch64/gcc-linaro-6.3.1-2017.05-x86_64_aarch64-linux-gnu/bin/aarch64-linux-gnu-

對應版本

gcc version 6.3.1 20170404 (Linaro GCC 6.3-2017.05)

Buildroot 編譯工具鏈

buildroot/output/rockchip_rk3308_release/host/bin/aarch64-rockchip-linux-gnu-

對應版本

gcc version 6.4.0 (Buildroot 2018.02-rc3-00017-g9c68ede)

如果需要其他平臺或版本的工具鏈，需自行編譯。

下載 SDK

由於 SDK 比較大，我們提供了一個打包好的.git以供下載：

• Firefly-RK3308_Linux_SDK

下載完成後先驗證一下 MD5 碼：

$ md5sum Firefly-RK3308_Linux_SDK_git_20181008.7z
3800278cc016d117eec8c0381ba66769  Firefly-RK3308_Linux_SDK_git_20181008.7z

確認無誤後，就可以解壓：

$ mkdir -p ~/prj/Firefly-RK3308
$ cd ~/prj/Firefly-RK3308
$ 7zr x Firefly-RK3308_Linux_SDK_git_20181008.7z
$ git reset --hard

解壓出來的SDK，已經默認添加遠程倉庫

$ git remote -v
gitlab	https://gitlab.com/TeeFirefly/rk3308-linux.git (fetch)
gitlab	https://gitlab.com/TeeFirefly/rk3308-linux.git (push)

以後就可以直接從 gitlab 處更新：

$ git pull gitlab firefly:firefly

也可以到 https://gitlab.com/TeeFirefly/rk3308-linux 在線瀏覽源碼

SDK 目錄結構

.
├── buildroot
├── build.sh -> device/rockchip/common/build.sh
├── device
├── envsetup.sh -> buildroot/build/envsetup.sh
├── external
├── kernel
├── Makefile -> buildroot/build/Makefile
├── mkfirmware.sh -> device/rockchip/rk3308/mkfirmware.sh
├── prebuilts
├── rkbin
├── rockdev
├── tools
├── u-boot
└── yocto

其中:

• Buildroot 目錄存放 buildroot 開源項目代碼，可定製根文件系統
• build.sh 爲系統編譯腳本，執行可進行 SDK 的完整編譯
• device 目錄存放板級配置及一些預置文件，開機腳本等
• external 目錄存放 SDK 相關庫及工具源碼
• kernel 爲內核部分源碼
• mkfirmware.sh 腳本可對鏡像文件進行打包，並統一拷貝至 rockdev/ 目錄
• prebuilts 目錄存放 U-Boot、Kernel 編譯使用的交叉編譯工具鏈
• rkbin 目錄存放 Rockchip 平臺一些關鍵性二進制文件，包括ddr.bin，miniloader.bin，bl31.bin，在 U-Boot 編譯過程中會用到
• rockdev 執行 mkfirmware.sh 會把系統編譯的生成的鏡像,統一拷貝至 rockdev/
• tools 目錄存放着 Windows 及 Linux 環境下的開發工具、調試工具、量產工具
• u-boot 目錄存放着 U-Boot 部分的源碼

編譯 Uboot

編譯 Uboot：

$ cd u-boot/
$ ./make.sh roc-rk3308-cc

編譯完，會生成 trust.img、rk3308_loader_xxx.bin、uboot.img 三個鏡像文件。

編譯 Kernel

編譯 Kernel：

$ cd kernel/
$ make arch=arm64 firefly-rk3308_linux_defconfig
$ make arch=arm64 rk3308-roc-cc-dmic-pdm_emmc.img

編譯 kenrel 的時候可以直接 make dts-name.img (如 rk3308-roc-cc-dmic-pdm_emmc.img)，即可生成對應的 resource.img(包含 dtb 數據)。

最終生成的kernel.img和resource.img將會被打包進zboot.img，更換內核的時候，只需燒寫zboot.img即可

編譯 Buildroot

注意：凡是有大更新或者個別軟件更新，需要清掉舊版本的相關內容，但編譯腳本是不會自動覆蓋的。因此需要手動解決。最省事的方法就是刪掉 buildroot/output/ 目錄，然後再重新編譯SDK。

$ rm buildroot/output -rf

編譯 Buildroot，envsetup.sh 是終端環境變量設置腳本：

$ source buildroot/build/envsetup.sh
You're building on Linux
Lunch menu...pick a combo:

1. firefly_rk3308_release
2. firefly_rk3308_recovery
3. firefly_rk3308_pcba

Which would you like? [1] 1
===========================================

如選擇 firefly_rk3308_release，輸入對應序號 1

執行編譯：

$ make

完成編譯後執行 SDK 根目錄下的 mkfirmware.sh 腳本生成固件。

$ ./mkfirmware.sh

所有燒寫所需的鏡像都將會拷貝於 rockdev 目錄。

rockdev/
├── boot.img
├── MiniLoaderAll.bin
├── misc.img
├── oem.img
├── parameter.txt
├── recovery.img
├── rootfs.img
├── trust.img
├── uboot.img
└── userdata.img

得到了所有鏡像文件後，爲了方便燒寫及量產，通常可手動將這些單獨的鏡像通過腳本打包成爲一個統一固件：update.img。打包方法見下文。

全自動編譯腳本

爲了提高編譯的效率，降低人工編譯可能出現的誤操作，該 SDK 中集成了全自動化編譯腳本，方便固件編譯、備份。

該全自動化編譯腳本原始文件存放於:

device/rockchip/common/build.sh

在SDK根目錄創建了相應軟鏈接build.sh。

可通過修改 device/rockchip/rk3308/BoardConfig.mk 腳本中的特定變量，以編出對應產品固件

#=========================
# Compile Config
#=========================
# Target arch
ARCH=arm64
# Uboot defconfig
UBOOT_DEFCONFIG=roc-rk3308-cc
# Kernel defconfig
KERNEL_DEFCONFIG=firefly-rk3308_linux_defconfig
# Kernel dts
KERNEL_DTS=rk3308-roc-cc-dmic-pdm_emmc
# Buildroot config
CFG_BUILDROOT=firefly_rk3308_release
# Recovery config
CFG_RECOVERY=firefly_rk3308_recovery
# Pcba config
CFG_PCBA=firefly_rk3308_pcba
# Build jobs
JOBS=12

執行自動編譯腳本:

$ ./build.sh

該腳本會自動配置環境變量，並自動編譯 U-Boot，編譯 Kernel，編譯Buildroot，編譯 Recovery 繼而生成固件。

模塊編譯

爲了方便開發調試，上文說到的“全自動化編譯腳本”，也支持單獨模塊進行編譯，方便模塊調試，可指定並編譯部分模塊。

部分編譯可參見使用說明：

$ ./build.sh -h
====USAGE: build.sh modules====
uboot              -build uboot
kernel             -build kernel
rootfs             -build default rootfs, currently build buildroot as default
buildroot          -build buildroot rootfs
yocto              -build yocto rootfs, currently build ros as default
ros                -build ros rootfs
debian             -build debian rootfs
pcba               -build pcba
recovery           -build recovery
all                -build uboot, kernel, rootfs, recovery image
cleanall           -clean uboot, kernel, rootfs, recovery
firmware           -pack all the image we need to boot up system
updateimg          -pack update image
save               -save images, patches, commands used to debug
default            -build all modules

如單獨編譯 kernel，只需要執行以下命令：

$ ./build.sh kernel

統一固件打包工具

固件打包工具可將各零散鏡像文件，打包成一個完整的 update.img 形式，方便量產燒寫及升級。

Windows 下打包

Windows 系統下，打包工具存放在 tools\windows\AndroidTool\rockdev，打包步驟如下：

1. 打開 rockdev 目錄，編輯 package-file。按照 package-file 進行配置，package-file 裏面配置 img 鏡像放在 Image 目錄底下的，將需要放到 Image 目錄的鏡像拷貝進去即可。且注意配置時，鏡像名字的準確。其中注意bootloader選項，應該根據自己生成的 loader 名稱進行修改。
2. 編輯 mkupdate.bat。 需要修改 loader 名稱爲實際存放的loader 名稱即可。
3. 點擊 mkupdate.bat 運行即可，運行完會在當前目錄生成一個 update.img。

Linux 下打包

打包工具存放在 SDK/tools/linux/Linux_Pack_Firmware/rockdev/，打包步驟如下：

1. 打開 rockdev 目錄，編輯 package-file。 按照 package-file 進行配置，package-file 裏面配置 img 鏡像放在 Image 目錄底下的，將需要放到 Image 目錄的鏡像拷貝進去即可。且注意配置時，鏡像名字的準確。其中注意bootloader選項，應該根據自己生成的 loader 名稱進行修改。
2. 編輯 mkupdate.sh。 需要修改 loader 名稱爲實際存放的loader 名稱即可。
3. 在 rockdev 目錄下，執行以下命令，運行完會在當前目錄生成一個 update.img。

$ ./mkupdate.sh

另外，Linux下，SDK有提供一鍵打包工具，自動生成統一固件 rockdev/update.img

$ ./build.sh updateimg

燒寫鏡像文件

請參照《升級固件》來燒寫分區映像文件。