在嵌入式開發中，經常遇到需要定制固件的場景：更新 RT-Thread 應用程序、替換 Linux 內核或設備樹、修改根文件系統配置等。這些需求都離不開對 Rockchip update.img 整包固件的解包與重打包操作。

本文以睿擎派 RC3562 為例，詳細介紹整包固件從解包、修改分區內容、重新打包到燒錄驗證的完整操作流程。

一、準備工作

1.1 所需工具

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

1.2 獲取原始固件

從睿擎官方渠道下載最新的量產固件包，以 AMP 雙系統固件為例：

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 結構

Rockchip 平臺的整包固件采用雙層結構：

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

解包后，Android/ 目錄下的每個 .img 文件對應閃存上的一個獨立分區，可單獨替換修改。

二、解包固件

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

Output/├── boot.bin # 芯片第一層 Loader 鏡像├── firmware.img # 第二層固件包（待進一步解包）└── Android/ # 分區鏡像目錄 ├── package-file # 分區配置表 ├── loader.img # MiniLoader ├── dtb.img # 設備樹 ├── boot.img # Linux 啟動鏡像 ├── rootfs.img # 根文件系統 ├── app.img # ★ 睿擎 RT-Thread 應用固件 └── ...

其中 Android/ 目錄下的文件即為目標分區的可編輯鏡像文件。

三、修改分區內容

根據實際需求，選擇對應的分區進行修改。以下說明三種最常見的修改場景。

3.1 替換 RT-Thread 應用固件（app.img/app.dtb）

適用場景：通過 RuiChing Studio 更新了 RT-Thread 應用程序及設備樹，需要燒錄到開發板驗證?；蛘咧谱髁慨a固件，用于量產生產。

操作步驟：

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

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

重要說明：睿擎平臺中，app.dtb 對應的固件分區名就是 dtb.img。

第二步：進入第四章，執行重新打包。

3.2 替換 Linux 內核或設備樹

適用場景：修改了 Linux 內核配置或設備樹dts文件，重新編譯后需要驗證。

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

3.3 替換根文件系統

適用場景：新增了系統庫、工具鏈或應用配置文件，需要整體更新根文件系統。

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

四、重新打包

4.1 回包腳本說明

睿擎提供了標準回包腳本 repack_update_img.bat，位于工具根目錄。該腳本封裝了兩步打包操作，無需手動執行底層命令。

腳本內容如下：

@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 默認參數set"SOC=RK3562"set"STORAGE=EMMC"set"OUTPUT_NAME=update_repack.img"REM 命令行參數覆蓋默認值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 執行打包

在工具根目錄執行默認打包（使用 RK3562 / EMMC 參數）：

repack_update_img.bat

如需指定芯片型號、存儲介質或輸出文件名，可傳入參數：

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

4.3 打包參數說明

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

回包腳本內部實際執行兩步操作，理解其原理有助于排查問題：

第一步：AFPTool 打包分區鏡像

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

將 Android/ 目錄下的所有分區鏡像按 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 常見錯誤與處理

五、燒錄驗證

5.1 進入 Loader 燒錄模式

使用 USB Type-A 線連接開發板與 PC，按以下步驟進入 Loader 模式：

1.按住LOADER 按鍵（板子上標有 L 的那顆）

2.按住RST 復位鍵

3.松開RST 復位鍵，保持 LOADER 按鍵不放

4.約 1 秒后松開 LOADER 按鍵

5.RKDevTool 界面應檢測到 LOADER 狀態的設備

5.2 使用 RKDevTool 燒錄

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

RKDevTool 燒錄界面示例

燒錄完成后設備自動重啟。若修改的是 app.dtb 分區，設備重啟后將默認運行新打包的應用程序。

替換固件并燒錄后，設備運行新版本固件

六、操作流程匯總

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

七、固件制作工具包

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

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

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

官方開發指南與 SDK 說明（文檔站直達）

RuiChing Studio 集成開發環境（IDE 下載入口）

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