解包/打包 RK 固件

RK 固件格式

RK 固件 release_update.img 包含引導(dǎo)加載程序 loader.img 和實(shí)際的固件數(shù)據(jù)update.img:

release_update.img

|- loader.img `- update.img

update.img 是打包工具讀取 package-file 索引文件從而將多個(gè)映像文件打包而成固件 。一個(gè)典型的 package-file 文件的內(nèi)容為:

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

package-file：update.img 的索引文件，也包含在 update.img 中。

Image/MiniLoaderAll.bin：通過(guò) CPU ROM 代碼加載的第一個(gè) bootloader。

Image/parameter.txt：參數(shù)文件，可以在其中設(shè)置內(nèi)核啟動(dòng)參數(shù)和分區(qū)布局。

Image/trust.img：Arm trust file (ATF) 映像，用于安全啟動(dòng)。

Image/misc.img：misc 分區(qū)映像，用于控制 Android 的啟動(dòng)模式。

Image/kernel.img：Android 內(nèi)核映像。

Image/resource.img：具有啟動(dòng)圖片和內(nèi)核設(shè)備樹的資源映像。

Image/boot.img：Android initramfs，一個(gè)在正常啟動(dòng)時(shí)加載的根文件系統(tǒng)，包含重要的初始化和服務(wù)描述。

Image/recovery.img：Recovery 模式映像。

Image/system.img：Android 系統(tǒng)分區(qū)映像。

Image/baseparameter.img：

Image/oem.img：

Image/vendor.img：包含所有不可分發(fā)給 Android 開源項(xiàng)目 (AOSP) 的二進(jìn)制文件。如果沒(méi)有專有信息，則可以省略此分區(qū)

解包是從 release_update.img 中提取 update.img，然后解開里面的所有映像文件。 重新打包時(shí)，則是相反的過(guò)程。它將由 package-file 描述的所有映像文件合成到 update.img 中，該文件將與 bootloader 一起打包以創(chuàng)建最終的 release_update.img。

安裝工具

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

解包 RK 固件

解包 release_update.img:

$ cd /path/to/your/firmware/dir $ img_unpack ROC-RK3399-PC-Android8_1_xxx.img img rom version: 8.0.0 build time: 2018-08-14 11:18:00 chip: 33323248 checking md5sum....OK

解包 update.img:

$ cd img $ afptool -unpack update.img update Check file...OK ------- UNPACK ------- package-file 0x00000800 0x000002D4 Image/MiniLoaderAll.bin 0x00001000 0x0002794E Image/parameter.txt 0x00029000 0x000003E1 Image/trust.img 0x00029800 0x00400000 Image/uboot.img 0x00429800 0x00400000 Image/misc.img 0x00829800 0x0000C000 Image/baseparameter.img 0x00835800 0x00100000 Image/resource.img 0x00935800 0x007DF600 Image/kernel.img 0x01115000 0x01217814 Image/boot.img 0x0232D000 0x0016C200 Image/recovery.img 0x02499800 0x008D5020 Image/system.img 0x02D6F000 0x2B2700F4 Image/vendor.img 0x2DFDF800 0x092B707C Image/oem.img 0x37297000 0x0002907C RESERVED 0x00000000 0x00000000 UnPack OK!

在 update 目錄檢查目錄樹:

$ cd update/ $ tree . ├── Image │ ├── baseparameter.img │ ├── boot.img │ ├── kernel.img │ ├── MiniLoaderAll.bin │ ├── misc.img │ ├── oem.img │ ├── parameter.txt │ ├── recovery.img │ ├── resource.img │ ├── system.img │ ├── trust.img │ ├── uboot.img │ └── vendor.img ├── package-file └── RESERVED 1 directory, 15 files

打包 RK 固件

首先, 確保在 parameter.txt 文件中的 system 分區(qū)足以容納 system.img. 參考 《Parameter 文件格式》 了解分區(qū)布局。

例如，在 parameter.txt 的前綴為 “CMDLINE” 的行中，可以找到類似于以下內(nèi)容的 system 分區(qū)的描述:

0x00200000@0x000B0000(system)

“@”之前的十六進(jìn)制字符串是分區(qū)的大?。ㄒ陨葏^(qū)為單位，此處為 1 扇區(qū)= 512 字節(jié)），因此系統(tǒng)分區(qū)的大小為:

$ echo $(( 0x00200000 * 512 / 1024 / 1024 ))M 1024M

創(chuàng)建 release_update_new.img:

# 當(dāng)前目錄仍然是 update/，package-file 文件 # 以及所描述的所有映像文件均在此目錄下。 # 將參數(shù)文件復(fù)制為 "parameter" 文件，afptool 默認(rèn)使用此名。 $ cp package-file 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/baseparameter.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: ./Image/vendor.img Add file: ./Image/oem.img Add file: ./RESERVED Add CRC... ------ OK ------ Pack OK! $ img_maker -rk33 loader.img update_new.img release_update_new.img generate image... append md5sum... success!

自定義

自定義 system.img

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

sudo mkdir -p /mnt/system sudo mount Image/system.img /mnt/system cd /mnt/system # Modify the contents of the inside. # Pay attention to the free space, # You can not add too many APKs # 結(jié)束時(shí)，需要卸載 cd / sudo umount /mnt/system

請(qǐng)注意，system.img 的可用空間幾乎為 0，如果需要擴(kuò)展映像文件，請(qǐng)相應(yīng)地調(diào)整 parameter.txt 中的分區(qū)布局。

以下是如何將映像文件的大小增加 128MB 的示例。

擴(kuò)展之前先確保 system.img 沒(méi)有被系統(tǒng)掛載上:

mount | grep system

改變映像文件及其內(nèi)在文件系統(tǒng)的大小:

dd if=/dev/zero bs=1M count=128 >> Image/system.img # Expand file system information e2fsck -f Image/system.img resize2fs Image/system.img