Welcome to Firefly
Switch language
Switch language
Firefly Docsss
Last Updated: 2026-07-31 14:12:51

Compile Android12.0 firmware

Download Android12.0 SDK

SDK source code and bundle compression package are stored in the Google Drive.

Download Android SDK

  • The SDK can be obtained by email. Send the order number to sales@t-firefly.com and indicate the required SDK name firefly_rk3588_android12_git_20240704

  • After downloading, verify the MD5 code:

     $ md5sum /path/to/firefly_rk3588_android12_git_20240704.7z.001
 $ md5sum /path/to/firefly_rk3588_android12_git_20240704.7z.002
 $ md5sum /path/to/firefly_rk3588_android12_git_20240704.7z.003
 $ md5sum /path/to/firefly_rk3588_android12_git_20240704.7z.004
 $ md5sum /path/to/firefly_rk3588_android12_git_20240704.7z.005
 $ md5sum /path/to/firefly_rk3588_android12_git_20240704.7z.006
 $ md5sum /path/to/firefly_rk3588_android12_git_20240704.7z.007

 1ce2a5ab4e3a9f0a4d6d8cd47ca4981d  firefly_rk3588_android12_git_20240704.7z.001
 553fb5ee2cc5623d97bfb19ba299605b  firefly_rk3588_android12_git_20240704.7z.002
 cb9cce227a79356fa57c0781a426fd89  firefly_rk3588_android12_git_20240704.7z.003
 1461a09bacbef0cb3c9a9008e8483e93  firefly_rk3588_android12_git_20240704.7z.004
 d154b39087bbf410a7973da97a6a9ecb  firefly_rk3588_android12_git_20240704.7z.005
 7cfc42443caa57cb4cf474bf3e78b5ce  firefly_rk3588_android12_git_20240704.7z.006
 9ad4374d89212a882dc00541769732f8  firefly_rk3588_android12_git_20240704.7z.007

  • After confirming that it is correct, we can unzip:

     cd ~/proj/
 7z x ./firefly_rk3588_android12_git_20240704.7z.001 -oRK3588_Android12.0
 cd ./RK3588_Android12.0
 git reset --hard
    Attention: To avoid unnecessary errors, please do not unzip the SDK in shared folders, mounted folders or non-english directories.

Second, Update SDK

Note: Be sure to update the remote warehouse after decompression. The following is how to update from gitlab:

1. Enter the SDK root directory
cd ~/proj/RK3588_Android12.0

2. Download remote bundle repository
git clone https://gitlab.com/T-Firefly/rk3588-android12.0-bundle.git .bundle

3. If the download warehouse fails, it may be stuck or failed problems during synchronization. 
we can download and unzip it from the cloud disk link below to the SDK root directory.

7z x rk3588-android12.0-bundle.7z  -r -o. && mv rk3588-android12.0-bundle .bundle

4. Update the SDK, and subsequent updates do not need to pull the remote warehouse again, just execute the following command
.bundle/update

5. Follow the prompts to update the content to FETCH_HEAD, synchronize FETCH_HEAD to the firefly branch
git rebase FETCH_HEAD

Google Driver Android12.0 Bundle。

Core-3588J product compilation method

The overall compilation

HDMI Firmware Compilation

./FFTools/make.sh -d rk3588-firefly-itx-3588j -j8 -l rk3588_firefly_itx_3588j-userdebug
./FFTools/mkupdate/mkupdate.sh -l rk3588_firefly_itx_3588j-userdebug

10.1‘ MIPI DSI0 Firmware Compilation：

./FFTools/make.sh -d rk3588-firefly-itx-3588j-mipi101-M101014-BE45-A1 -j8 -l rk3588_firefly_itx_3588j_mipi-userdebug
./FFTools/mkupdate/mkupdate.sh -l rk3588_firefly_itx_3588j_mipi-userdebug

Dual Camera CAM-2MS2MF Compile

HDMI+CAM-2MS2MF
  • modify dts
--- a/kernel-5.10/arch/arm64/boot/dts/rockchip/rk3588-firefly-itx-3588j.dts
+++ b/kernel-5.10/arch/arm64/boot/dts/rockchip/rk3588-firefly-itx-3588j.dts
@@ -8,8 +8,8 @@

 #include "rk3588-firefly-itx-3588j.dtsi"
-#include "rk3588-firefly-itx-cam-8ms1m.dtsi"
-//#include "rk3588-firefly-itx-cam-2ms2mf.dtsi"
+//#include "rk3588-firefly-itx-cam-8ms1m.dtsi"
+#include "rk3588-firefly-itx-cam-2ms2mf.dtsi"
 #include "rk3588-firefly-demo.dtsi"
  • Compile
./FFTools/make.sh -d rk3588-firefly-itx-3588j -j8 -l rk3588_firefly_itx_3588j-userdebug
./FFTools/mkupdate/mkupdate.sh -l rk3588_firefly_itx_3588j-userdebug

HDMI TO MIPI_CSI(RK628D) Compile

  • modify dts
--- a/kernel-5.10/arch/arm64/boot/dts/rockchip/rk3588-firefly-itx-3588j.dts
+++ b/kernel-5.10/arch/arm64/boot/dts/rockchip/rk3588-firefly-itx-3588j.dts
@@ -7,9 +7,9 @@
 /dts-v1/;

 #include "rk3588-firefly-itx-3588j.dtsi"
-#include "rk3588-firefly-itx-cam-8ms1m.dtsi"
+//#include "rk3588-firefly-itx-cam-8ms1m.dtsi"
 //#include "rk3588-firefly-itx-cam-2ms2mf.dtsi"
-//#include "rk3588-firefly-itx-3588j-tf-hdmi-mipi-rk628.dtsi"
+#include "rk3588-firefly-itx-3588j-tf-hdmi-mipi-rk628.dtsi"
 #include "rk3588-firefly-demo.dtsi"
  • Compile
./FFTools/make.sh -d rk3588-firefly-itx-3588j -j8 -l rk3588_firefly_itx_3588j-userdebug
./FFTools/mkupdate/mkupdate.sh -l rk3588_firefly_itx_3588j-userdebug

Step by step to compile

  • Compile the kernel:
cd ~/proj/RK3588_Android12.0/kernel-5.10
export PATH=../prebuilts/clang/host/linux-x86/clang-r416183b/bin:$PATH
alias msk='make CROSS_COMPILE=aarch64-linux-gnu- LLVM=1 LLVM_IAS=1'
msk ARCH=arm64  firefly_defconfig android-11.config pcie_wifi.config
msk ARCH=arm64   BOOT_IMG=../rockdev/Image-rk3588_firefly_itx_3588j/boot.img rk3588-firefly-itx-3588j.img -j8
  • Compile uboot:
cd ~/proj/RK3588_Android12.0/u-boot/
./make.sh rk3588
  • Compile Android：
cd ~/proj/RK3588_Android12.0/
source build/envsetup.sh
lunch rk3588_firefly_itx_3588j-userdebug
make installclean
make -j8
./mkimage.sh

Packaged into unified firmware update.img

After compilation, you can use Firefly official scripts to package into unified firmware, execute the following command：

./FFTools/mkupdate/mkupdate.sh -l rk3588_firefly_itx_3588j-userdebug

After packaging, it will be in rockdev/Image-rk3588_firefly_itx_3588j/ Generate unified firmware under the directory: (product name )XXX_XXX_date XXX.img

It is also very simple to package the unified firmware update.img under Windows. Copy the generated files to the rockdev \ Image directory of AndroidTool, and then run the mkupdate.bat batch file under the rockdev directory to create up date.img and store it in rockdev \ Image directory.

Some Introduction about Compiling

Android12.0 can’t be upgraded directly kernel.img and resource.img

kernel.img and resource.img for Android12.0 are included in boot.img, After compiling the kernel, you need to run the ./mkimage.sh command in the android root directory to repackage boot.img, and then upgrade boot.img of the rockdev/Image-rk3588_firefly_itx_3588j/ directory.

Compiling kernel generation separately boot.img

Principle of compilation: in the kernel directory, the generated kernel.img And resource.img Replace with old boot.img, so you need to use BOOT_IMG=XXX parameter specification boot.img when compiling. The command is as follows:

cd ~/proj/RK3588_Android12.0/kernel-5.10
export PATH=../prebuilts/clang/host/linux-x86/clang-r416183b/bin:$PATH
alias msk='make CROSS_COMPILE=aarch64-linux-gnu- LLVM=1 LLVM_IAS=1'
msk ARCH=arm64  firefly_defconfig android-11.config pcie_wifi.config
msk ARCH=arm64   BOOT_IMG=../rockdev/Image-rk3588_firefly_itx_3588j/boot.img rk3588-firefly-itx-3588j.img -j8

After compiling, boot.img in the kernel directory can be directly upgrade.

Partition image

When compiling, executing ./mkimage.sh will repackage boot.img and super.img, and copy other related image files to the directory rockdev/Image-rk3588_firefly_itx_3588j/. The following lists the image files used by general firmware:

ImageInstruction
boot.imgincluding ramdis、kernel、dtb
dtbo.imgDevice Tree Overlays
MiniLoaderAll.binincluding first level loader
misc.imgincluding recovery-wipe boot symbol information, after flashing it will enter recovery
parameter.txtincluding partition information
recovery.imgincluding recovery-ramdis、kernel、dtb
super.imgincluding the contents of odm、vendor、system partitions
uboot.imgincluding uboot image
vbmeta.imgincluding avb verification information, used for AVB verification
update.imgincluding the above img files to be flashed, can be used for the tool to directly flash the whole image package

For details about how to upgrade a partition image file, see Upgrade the firmware via USB cable.

OTA Compilation

Refer to the OTA Compilation section

FAQs

git clone remote bundle repository failed

Q: Error occurred in git clone remote bundle repository while updating SDK:

$ git clone https://gitlab.com/T-Firefly/rk3588-android12.0-bundle.git .bundle
Cloning into '.bundle'...
remote: Enumerating objects: 20, done.
remote: Counting objects: 100% (20/20), done.
remote: Compressing objects: 100% (18/18), done.
error: RPC failed; curl 56 GnuTLS recv error (-9): A TLS packet with unexpected length was received.
fatal: the remote end hung up unexpectedly
fatal: early EOF
fatal: unpack-objects failed

A: The buffer size is insufficient and needs to be enlarged:

git config --global https.postBuffer 1048576000

Compile environment to build

Previous Page

Compile Android14.0 firmware

Next Page

On this page

Compile Android12.0 firmwareDownload Android12.0 SDKDownload Android SDKSecond, Update SDKCore-3588J product compilation methodThe overall compilationHDMI Firmware Compilation10.1‘ MIPI DSI0 Firmware Compilation：Dual Camera CAM-2MS2MF CompileHDMI+CAM-2MS2MFHDMI TO MIPI_CSI(RK628D) CompileStep by step to compilePackaged into unified firmware update.imgSome Introduction about CompilingAndroid12.0 can’t be upgraded directly kernel.img and resource.imgCompiling kernel generation separately boot.imgPartition imageOTA CompilationFAQsgit clone remote bundle repository failed