在嵌入式開發(fā)中，經(jīng)常遇到需要定制固件的場(chǎng)景：更新 RT-Thread 應(yīng)用程序、替換 Linux 內(nèi)核或設(shè)備樹、修改根文件系統(tǒng)配置等。這些需求都離不開對(duì) Rockchip update.img 整包固件的解包與重打包操作。

本文以睿擎派 RC3562 為例，詳細(xì)介紹整包固件從解包、修改分區(qū)內(nèi)容、重新打包到燒錄驗(yàn)證的完整操作流程。

一、準(zhǔn)備工作

1.1 所需工具

睿擎派整包固件制作依賴 Rockchip 官方工具鏈，主要包括：

1.2 獲取原始固件

從睿擎官方渠道下載最新的量產(chǎn)固件包，以 AMP 雙系統(tǒng)固件為例：

Ruiching_RC-Pi-3562_Firmware_EMMC_AMP_FACRTORY_V1.1.0.img.7z

使用 7-Zip 解壓后得到原始固件文件 Ruiching_RC-Pi-3562_Firmware_EMMC_AMP_FACRTORY_V1.1.0.img，即需要處理的 update.img 原始鏡像。

1.3 了解 update.img 結(jié)構(gòu)

Rockchip 平臺(tái)的整包固件采用雙層結(jié)構(gòu)：

update.img├── boot.bin 第一層 Loader（芯片級(jí)初始化）└── firmware.img 第二層固件包 └── Android/ （Rockchip 歷史目錄命名） ├── package-file 分區(qū)配置表（定義各分區(qū)的打包順序和名稱） ├── loader.img MiniLoader 鏡像 ├── dtb.img 設(shè)備樹二進(jìn)制文件 ├── boot.img Linux 內(nèi)核 + 設(shè)備樹打包鏡像 ├── rootfs.img Linux 根文件系統(tǒng)鏡像 ├── app.dtb 睿擎 RT-Thread 應(yīng)用固件 └── ...其他分區(qū)

解包后，Android/ 目錄下的每個(gè) .img 文件對(duì)應(yīng)閃存上的一個(gè)獨(dú)立分區(qū)，可單獨(dú)替換修改。

二、解包固件

解包完成后，在 Output/ 目錄下生成以下文件：

Output/├── boot.bin # 芯片第一層 Loader 鏡像├── firmware.img # 第二層固件包（待進(jìn)一步解包）└── Android/ # 分區(qū)鏡像目錄 ├── package-file # 分區(qū)配置表 ├── loader.img # MiniLoader ├── dtb.img # 設(shè)備樹 ├── boot.img # Linux 啟動(dòng)鏡像 ├── rootfs.img # 根文件系統(tǒng) ├── app.img # ★ 睿擎 RT-Thread 應(yīng)用固件 └── ...

其中 Android/ 目錄下的文件即為目標(biāo)分區(qū)的可編輯鏡像文件。

三、修改分區(qū)內(nèi)容

根據(jù)實(shí)際需求，選擇對(duì)應(yīng)的分區(qū)進(jìn)行修改。以下說明三種最常見的修改場(chǎng)景。

3.1 替換 RT-Thread 應(yīng)用固件（app.img/app.dtb）

適用場(chǎng)景：通過 RuiChing Studio 更新了 RT-Thread 應(yīng)用程序及設(shè)備樹，需要燒錄到開發(fā)板驗(yàn)證?；蛘咧谱髁慨a(chǎn)固件，用于量產(chǎn)生產(chǎn)。

操作步驟：

第一步：將新編譯生成的 app.img/app.dtb 文件復(fù)制到 Output/Android/ 目錄，并將app.dtb文件名改為 dtb.img：

Output/Android/├──app.img ←放入新的 app.img└──dtb.img ←放入新的 app.dtb，并改名

重要說明：睿擎平臺(tái)中，app.dtb 對(duì)應(yīng)的固件分區(qū)名就是 dtb.img。

第二步：進(jìn)入第四章，執(zhí)行重新打包。

3.2 替換 Linux 內(nèi)核或設(shè)備樹

適用場(chǎng)景：修改了 Linux 內(nèi)核配置或設(shè)備樹dts文件，重新編譯后需要驗(yàn)證。

Output/Android/├──boot.img ←替換為新編譯的Linux啟動(dòng)鏡像└──dtb.img ←替換為新編譯的設(shè)備樹文件

3.3 替換根文件系統(tǒng)

適用場(chǎng)景：新增了系統(tǒng)庫(kù)、工具鏈或應(yīng)用配置文件，需要整體更新根文件系統(tǒng)。

Output/Android/└──rootfs.img ←替換為更新后的根文件系統(tǒng)鏡像

四、重新打包

4.1 回包腳本說明

睿擎提供了標(biāo)準(zhǔn)回包腳本 repack_update_img.bat，位于工具根目錄。該腳本封裝了兩步打包操作，無(wú)需手動(dòng)執(zhí)行底層命令。

腳本內(nèi)容如下：

@echooffsetlocal ENABLEEXTENSIONS ENABLEDELAYEDEXPANSIONREM Repack Rockchip update image from Output\AndroidREM Usage: repack_update_img.bat [SOC] [STORAGE] [OUTPUT_IMG_NAME]REM Example: repack_update_img.bat RK3562 EMMC update_repack.imgset"ROOT_DIR=%~dp0"set"BIN_DIR=%ROOT_DIR%\bin"set"OUTPUT_DIR=%ROOT_DIR%\Output"set"ANDROID_DIR=%OUTPUT_DIR%\Android"set"AFP_TOOL=%BIN_DIR%\AFPTool.exe"set"RK_MAKER=%BIN_DIR%\RKImageMaker.exe"set"BOOT_BIN=%OUTPUT_DIR%\boot.bin"set"TEMP_FIRMWARE=%OUTPUT_DIR%\firmware_repack.img"REM 默認(rèn)參數(shù)set"SOC=RK3562"set"STORAGE=EMMC"set"OUTPUT_NAME=update_repack.img"REM 命令行參數(shù)覆蓋默認(rèn)值ifnot"%~1"==""set"SOC=%~1"ifnot"%~2"==""set"STORAGE=%~2"ifnot"%~3"==""set"OUTPUT_NAME=%~3"set"OUTPUT_IMG=%OUTPUT_DIR%\%OUTPUT_NAME%"echo [STEP1/2] Packing firmware image..."%AFP_TOOL%"-pack"%ANDROID_DIR%""%TEMP_FIRMWARE%"iferrorlevel1( echo [ERROR] AFPToolpackfailed. Checkpackage-fileandimage files. exit/b2)echo [STEP2/2] Packing final update image..."%RK_MAKER%"-%SOC%"%BOOT_BIN%""%TEMP_FIRMWARE%""%OUTPUT_IMG%"-os_type:ANDROIDOS -storage:%STORAGE%iferrorlevel1( echo [ERROR] RKImageMakerpackfailed. Check parameters (SOC, STORAGE). exit/b3)echo [SUCCESS] Repack complete.echo [SUCCESS] Output:%OUTPUT_IMG%exit/b0

4.2 執(zhí)行打包

在工具根目錄執(zhí)行默認(rèn)打包（使用 RK3562 / EMMC 參數(shù)）：

repack_update_img.bat

如需指定芯片型號(hào)、存儲(chǔ)介質(zhì)或輸出文件名，可傳入?yún)?shù)：

# RK3562 + eMMC + 自定義輸出文件名repack_update_img.bat RK3562 EMMC my_update_v1.2.0.img

4.3 打包參數(shù)說明

4.4 底層兩步流程（可選了解）

回包腳本內(nèi)部實(shí)際執(zhí)行兩步操作，理解其原理有助于排查問題：

第一步：AFPTool 打包分區(qū)鏡像

AFPTool.exe -pack"Output\Android""Output\firmware_repack.im

將 Android/ 目錄下的所有分區(qū)鏡像按 package-file 配置打包為 firmware_repack.img。

第二步：RKImageMaker 合成最終鏡像

RKImageMaker.exe-RK3562"Output\boot.bin""Output\firmware_r

將 boot.bin（第一層 Loader）與 firmware_repack.img（第二層固件包）合并為最終的 update_repack.img。

4.5 常見錯(cuò)誤與處理

五、燒錄驗(yàn)證

5.1 進(jìn)入 Loader 燒錄模式

使用 USB Type-A 線連接開發(fā)板與 PC，按以下步驟進(jìn)入 Loader 模式：

1.按住LOADER 按鍵（板子上標(biāo)有 L 的那顆）

2.按住RST 復(fù)位鍵

3.松開RST 復(fù)位鍵，保持 LOADER 按鍵不放

4.約 1 秒后松開 LOADER 按鍵

5.RKDevTool 界面應(yīng)檢測(cè)到 LOADER 狀態(tài)的設(shè)備

5.2 使用 RKDevTool 燒錄

打開 RKDevTool.exe，在設(shè)備列表中選中檢測(cè)到的 LOAD 設(shè)備，然后在右側(cè)路徑欄選擇重新打包生成的 update_repack.img 文件，點(diǎn)擊"執(zhí)行"開始燒錄。

RKDevTool 燒錄界面示例

燒錄完成后設(shè)備自動(dòng)重啟。若修改的是 app.dtb 分區(qū)，設(shè)備重啟后將默認(rèn)運(yùn)行新打包的應(yīng)用程序。

替換固件并燒錄后，設(shè)備運(yùn)行新版本固件

六、操作流程匯總

① 準(zhǔn)備工具和原始固件 └─ RKDevTool_Release_v2.96+ 官方固件包（.7z 解壓）② 解包原始固件 └─ unpack_update_img.bat └─ Output/boot.bin+ Output/Android/（各分區(qū)鏡像）③ 修改目標(biāo)分區(qū) ├─ 替換 app.dtb→ 改名 dtb.img（最常見） ├─ 或替換 boot.img（Linux 內(nèi)核） └─ 或替換 rootfs.img（根文件系統(tǒng)）④ 重新打包 └─ repack_update_img.bat[SOC][STORAGE][OUTPUT_NAME] └─ Output/update_repack.img⑤ 燒錄驗(yàn)證 └─ RKDevTool → 選中 update_repack.img→ 執(zhí)行燒錄

七、固件制作工具包

想親手操作卻懶得整理工具？我們幫你打包好了：

RKDevTool 固件制作工具包（含 AFPTool / RKImageMaker / 燒錄工具）

睿擎官方回包腳本（repack_update_img.bat，開箱即用）

官方開發(fā)指南與 SDK 說明（文檔站直達(dá)）

RuiChing Studio 集成開發(fā)環(huán)境（IDE 下載入口）

掃碼下方二維碼，填寫簡(jiǎn)單表單（1分鐘），工具包及文檔鏈接將發(fā)送至郵箱。