fireflyAIO-3128C主板定制Android固件簡介

定制 Android 固件

前言

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

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

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

前一種方法，可以從各個(gè)層面去定制 Android，自由度大，但對編譯環(huán)境和技術(shù)要求比較高，?，F(xiàn)在介紹后一種方法，分為解包、定制和打包三個(gè)階段。主機(jī)操作系統(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 是個(gè)復(fù)合文件，內(nèi)含多個(gè)文件，由 package-file 描述。一個(gè)典型的 package-file 為：

# NAME Relative path # #HWDEF HWDEF package-file package-file bootloader rk3128MiniLoaderAll(L)_V2.20.bin parameter rk312x.parameter.txt 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。

rk3128MiniLoaderAll(L)_V2.20.bin, Image/uboot.img

啟動加載器，即 bootloader。

rk312x.parameter.txt

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

Image/misc.img

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

Image/kernel.img

Android 內(nèi)核。

Image/resource.img

資源映像，內(nèi)有內(nèi)核開機(jī)圖片和內(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 所聲明的多個(gè)文件。打包，則是個(gè)逆過程，將 package-file 將所列的多個(gè)文件合成 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 Fireprime_Android5.1.img img

解壓 update.img

$ cd img $ afptool -unpack update.img update Check file...OK ------- UNPACK ------- package-file 0x00000800 0x00000285 rk3128MiniLoaderAll(L)_V2.20.bin 0x00001000 0x0004694E rk312x.parameter.txt 0x00048000 0x000005A1 Image/misc.img 0x00048800 0x0000C000 Image/kernel.img 0x00055000 0x00578E3C Image/resource.img 0x005CE000 0x0001C400 Image/uboot.img 0x005EA800 0x0011F6CF Image/boot.img 0x005EA800 0x0011F6CF Image/recovery.img 0x0070A000 0x0040F6AE Image/system.img 0x00B19800 0x180EF000 RESERVED 0x00000000 0x00000000 update-script 0x18C09000 0x000003A5 recover-script 0x18C09800 0x0000010A UnPack OK!

查看 update 目錄下的文件樹

$ cd update/ $ tree . ├── Image │ ├── boot.img │ ├── kernel.img │ ├── misc.img │ ├── recovery.img │ ├── resource.img │ ├── uboot.img │ └── system.img ├── package-file ├── recover-script ├── RESERVED ├── rk312x.parameter.txt ├── rk3128MiniLoaderAll(L)_V2.20.bin └── update-script

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

定制

定制 system.img

system.img 是個(gè) 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)行擴(kuò)容，并根據(jù)最后的文件大小，相應(yīng)地調(diào)整 parameter 文件里的分區(qū)設(shè)置。以下是如何擴(kuò)展空間的示例，在擴(kuò)展前，先運(yùn)行 mount 來查看系統(tǒng)掛載情況，確保 system.img 已經(jīng)卸載：

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

打包

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

0x00180000@0x00092000(system)

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

$ echo $(( 0x00180000 * 512 / 1024 / 1024))M 768M

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

合成 update.img ：

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

合成 release_update.img ：

$ img_maker -rk31 loader.img update_new.img release_update_new.img generate image... append md5sum... success!

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

常見問題

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

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

FIRMWARE_VER:5.1.0