fireflyFace-RK3399定制固件介紹

定制 Android 固件

前言

定制 Android 固件，有兩種方法：

改源碼，然后編譯生成固件。

在現(xiàn)有固件的基礎(chǔ)上進(jìn)行裁剪。

前一種方法，可以從各個層面去定制 Android，自由度大，但對編譯環(huán)境和技術(shù)要求比較高，參見《編譯 Android 固件》一文。現(xiàn)在介紹后一種方法，分為解包、定制和打包三個階段。主機操作系統(tǒng)為 Linux，采用的工具為開源軟件。

固件格式

統(tǒng)一固件 release_update.img，內(nèi)含啟動加載器 loader.img 和真正的固件數(shù)據(jù) update.img

release_update.img |- loader.img `- update.img

update.img 是個復(fù)合文件，內(nèi)含多個文件，由 package-file 描述。一個典型的 package-file 為：

# NAME Relative path package-file package-file bootloader Image/MiniLoaderAll.bin parameter Image/parameter.txt trust Image/trust.img uboot Image/uboot.img misc Image/misc.img resource Image/resource.img kernel Image/kernel.img boot Image/boot.img recovery Image/recovery.img system Image/system.img backup RESERVED #update-script update-script #recover-script recover-script

package-file

update.img 的打包說明文件，update.img 里也含有一份 package-file。

Image/MiniLoaderAll.bin

啟動加載器，即 bootloader。

Image/parameter.txt

參數(shù)文件，可以設(shè)定內(nèi)核啟動參數(shù)，里面有重要的分區(qū)信息。

Image/trust.img，trust.img 是U-Boot作為二級loader 的打包。

Image/misc.img

misc 分區(qū)的映像，用來控制 Android 是正常啟動，還是進(jìn)入急救模式（Recovery Mode）。

Image/kernel.img

Android 內(nèi)核。

Image/resource.img

資源映像，內(nèi)有內(nèi)核開機圖片和內(nèi)核設(shè)備樹信息（Device Tree Blob）。

Image/boot.img

Android 內(nèi)核的內(nèi)存啟動盤（initrd），是內(nèi)核啟動后最先加載的根文件系統(tǒng)，包含重要的初始化動作，一般不需要改動。

Image/recovery.img

Android 急救模式的映像，內(nèi)含內(nèi)核和急救模式的根文件系統(tǒng)。

Image/system.img

對應(yīng)于 Android 的 /system 分區(qū)，是以下的定制對象。

解包，就是提取 release_update.img 里的 update.img， 然后解壓出內(nèi)含 package-file 所聲明的多個文件。打包，則是個逆過程，將 package-file 將所列的多個文件合成 update.img，加進(jìn) loader.img，最終生成 release_update.img 。

工具準(zhǔn)備

git clone https://github.com/TeeFirefly/rk2918_tools.git cd rk2918_tools make sudo cp afptool img_unpack img_maker mkkrnlimg /usr/local/bin

解包

解壓 release_update.img

$ cd /path/to/your/firmware/dir $ img_unpack Firefly-RK3399_20161027.img img rom version： 6.0.1 build time： 2016-10-27 14:58:18 chip： 33333043 checking md5sum.。..OK

解壓 update.img

$ cd img $ afptool -unpack update.img update Check file.。.OK ------- UNPACK ------- package-file 0x00000800 0x00000280 Image/MiniLoaderAll.bin 0x00001000 0x0003E94E Image/parameter.txt 0x00040000 0x00000350 Image/trust.img 0x00040800 0x00400000 Image/uboot.img 0x00440800 0x00400000 Image/misc.img 0x00840800 0x0000C000 Image/resource.img 0x0084C800 0x0003FE00 Image/kernel.img 0x0088C800 0x00F5D00C Image/boot.img 0x017EA000 0x0014AD24 Image/recovery.img 0x01935000 0x013C0000 Image/system.img 0x02CF5000 0x2622A000 RESERVED 0x00000000 0x00000000 UnPack OK！

查看 update 目錄下的文件樹

$ cd update/ $ tree 。 ├── Image │ ├── boot.img │ ├── kernel.img │ ├── MiniLoaderAll.bin │ ├── misc.img │ ├── parameter.txt │ ├── recovery.img │ ├── resource.img │ ├── system.img │ ├── trust.img │ └── uboot.img ├── package-file └── RESERVED 1 directory， 12 files

這樣，固件就解包成功了，下面就開始定制吧。

定制

定制 system.img

system.img 是個 ext4 文件系統(tǒng)格式的映像文件，可以直接掛載到系統(tǒng)進(jìn)行修改：

sudo mkdir -p /mnt/system sudo mount -o loop Image/system.img /mnt/system cd /mnt/system # 修改里面的東西，注意剩余空間，不能添加太多的 APK # 修改完畢，要卸載 cd / sudo umount /mnt/system

注意，該 system.img 的剩余空間基本為 0， 如果不是刪除文件，就需要對 system.img 進(jìn)行擴容，并根據(jù)最后的文件大小，相應(yīng)地調(diào)整 parameter 文件里的分區(qū)設(shè)置。以下是如何擴展空間的示例，在擴展前，先運行 mount 來查看系統(tǒng)掛載情況，確保 system.img 已經(jīng)卸載：

# 增加 128M 的空間 dd if=/dev/zero bs=1M count=128 》》 Image/system.img # 擴展文件系統(tǒng)信息 e2fsck -f Image/system.img resize2fs Image/system.img

打包

首先要檢查一下 system.img 的大小，對照 parameter 文件的分區(qū)情況（可參考文檔Parameter 文件格式，作必要的大小調(diào)整。例如，parameter.txt 文件里的 system 分區(qū)大小，可以找到 CMDLINE 一行，然后找到 system 字符串：

0x00200000@0x000B0000（system）

@ 前面就是分區(qū)的大小，單位是 512 字節(jié)，這樣該 system 分區(qū)的大小就是：

$ echo $（（ 0x00200000 * 512 / 1024 / 1024））M 1024M

只要 system.img 的大小不超過 1024M，parameter 文件就不用更改。如果分區(qū)不用更改，可以直接用燒寫工具將新的 system.img 燒寫到開發(fā)板的 system 分區(qū)上做試驗。否則，需要制作新固件并燒寫后再行測試。以下是打包成統(tǒng)一固件 update.img 所需要的步驟：

合成 update.img ：

# 當(dāng)前的目錄仍然為 update/ ，內(nèi)有 package-file， package-file 所列的文件均存在 # 將參數(shù)文件拷貝一份到 paramter， 因為 afptool 默認(rèn)要用到 $ cp Image/parameter.txt parameter $ afptool -pack 。 .。/update_new.img ------ PACKAGE ------ Add file： 。/package-file Add file： 。/Image/MiniLoaderAll.bin Add file： 。/Image/parameter.txt Add file： 。/Image/trust.img Add file： 。/Image/uboot.img Add file： 。/Image/misc.img Add file： 。/Image/resource.img Add file： 。/Image/kernel.img Add file： 。/Image/boot.img Add file： 。/Image/recovery.img Add file： 。/Image/system.img Add file： 。/RESERVED Add CRC.。. ------ OK ------ Pack OK！

合成 release_update.img ：

$ img_maker -rk33 loader.img update_new.img release_update_new.img generate image.。. append md5sum.。. success！

release_update_new.img 即為最終生成的可燒寫的統(tǒng)一固件文件。

常見問題

固件的版本在哪設(shè)置

在 parameter 文件中找到下行并修改即可，注意版本號為數(shù)字，中間兩個點號不能省略。

FIRMWARE_VER： 7.1.1