Compile Android Firmware
Prerequisites
Building the Android firmware requires a powerful host. Confirm the following conditions before compiling:
- 64-bit CPU, Ubuntu 20.04 or later
- 64 GB physical memory plus swap
- 400GB free disk space
- Run the build commands as a normal user, not root
For installing the build dependencies, refer to Set Up the Build Environment.
Download the SDK
The Android 16 SDK of Firefly-R3572A is provided by email. Send the order number to sales@t-firefly.com and state the required SDK name.
The SDK source archive is split into volumes, including firefly_rk3572_android16.0_git_20261112.7z.001 and the following parts. Download all volumes into the same directory before extraction.
Note
For the source archive name and the bundle name in this section, the actual file names, volume count and MD5 checksums are subject to the released SDK package.
Verify the MD5 checksums before extraction:
md5sum /path/to/firefly_rk3572_android16.0_git_20261112.7z.001
...Check the remaining volumes as well, and extract only after all checksums match those provided with the release:
cd ~/proj/
7z x ./firefly_rk3572_android16.0_git_20261112.7z.001 -oRK3572_Android16.0
cd ./RK3572_Android16.0
git reset --hardNote
Do not extract the SDK in a shared folder, a mounted directory or a path containing non-English characters, to avoid unnecessary errors.
Update the SDK
The SDK is updated through a bundle repository. Download the rk357x-android16-bundle archive from the resource download page, then run in the SDK root directory:
7z x rk357x-android16-bundle.7z* -r -o. && mv rk357x-android16-bundle .bundle
.bundle/update
git rebase FETCH_HEAD.bundle/update fetches the updates into FETCH_HEAD, and git rebase FETCH_HEAD merges them into the current branch.
Select the Product Configuration
Select the product configuration for Firefly-R3572A through lunch before compiling. The name has three parts and must not omit bp4a.
Run the following commands in the SDK root directory:
source build/envsetup.sh
lunch rk3572_firefly_r3572a-bp4a-userdebugFull Build
A full build compiles U-Boot, the kernel and Android and collects the images in one pass, then packs the unified firmware separately. It is suitable for the first build or a complete verification. Run the following in the SDK root directory:
./FFTools/make.sh -j8 -d rk3572-firefly-r3572a -l rk3572_firefly_r3572a-bp4a-userdebug
./FFTools/mkupdate/mkupdate.sh -l rk3572_firefly_r3572a-bp4a-userdebugThe command has two parts:
./FFTools/make.sh -j8 -d <dts> -l <lunch>: the full build entry, which sequentially builds U-Boot, the kernel and Android and collects the images.-dspecifies the kernel device tree (rk3572-firefly-r3572a), and-lspecifies the three-part lunch (rk3572_firefly_r3572a-bp4a-userdebug). With-lbut no stage argument, all three stages are built; this is not a single-module entry../FFTools/mkupdate/mkupdate.sh -l <lunch>: packs the unified firmware, wrapping existing images only without compiling or cleaning the build directory.
Partial Build
When only one part needs to be rebuilt, enter the corresponding directory and build it separately instead of doing a full build each time. The following commands all start from the SDK root directory.
Build the Kernel
In the kernel-6.12 directory, use mkboot.sh to build the kernel separately and generate boot.img:
cd kernel-6.12
./mkboot.sh rk3572-firefly-r3572a ../rockdev/Image-rk3572_firefly_r3572a/boot.img rk3572.configThe usage of mkboot.sh is ./mkboot.sh <dts name> <existing boot.img path> <chip config>: the first argument is the kernel device tree rk3572-firefly-r3572a; the second is the path of an existing boot.img (used as input — the script replaces the kernel and resource into it, it is not an output path); the third is the chip config rk3572.config. The build produces kernel-6.12/boot.img.
Build U-Boot
In the u-boot directory, use make.sh to build U-Boot separately:
cd u-boot
./make.sh rk3572Build Android
In the SDK root directory, build the Android upper layer:
source build/envsetup.sh
lunch rk3572_firefly_r3572a-bp4a-userdebug
make installclean
make -j8
./mkimage.sh./mkimage.sh repacks boot.img and super.img and copies the related images to the product directory under rockdev/.
Note
- To build the kernel or modules separately, use
mkboot.sh/make.shabove, not the-K/-Aarguments ofFFTools/make.sh— those are stage arguments of the full build entry and have different semantics. - After building a part separately, run
./FFTools/mkupdate/mkupdate.sh -l rk3572_firefly_r3572a-bp4a-userdebugagain to repack the unified firmware if needed. - The build toolchain is provided by the Android 16 SDK (Clang, Rust, kernel-build-tools, libelf / libdw); use the SDK's own environment.
Pack the Unified Firmware update.img
After the build, pack the unified firmware with the official Firefly script:
./FFTools/mkupdate/mkupdate.sh -l rk3572_firefly_r3572a-bp4a-userdebugThe unified firmware is generated in the rockdev/Image-rk3572_firefly_r3572a/ directory, with a file name in the format product_version_date.img, for example rk3572_firefly_r3572a_Android16_date.img (subject to the actual output).
Packing the unified firmware update.img on Windows is also simple: copy the built files into the rockdev\Image directory of AndroidTool, then run the mkupdate.bat batch file in the rockdev directory. This creates update.img and stores it in the rockdev\Image directory.
Build Output
After building and packing, the partition images are output to the rockdev/ directory. Common partition images are:
| Firmware | Description |
|---|---|
| boot.img | contains ramdisk, kernel and dtb |
| dtbo.img | Device Tree Overlays |
| MiniLoaderAll.bin | contains the first-stage loader |
| misc.img | contains the recovery-wipe boot flag |
| parameter.txt | contains the partition layout |
| recovery.img | contains recovery-ramdisk, kernel and dtb |
| super.img | contains odm, product, vendor, system and system_ext |
| uboot.img | contains the U-Boot firmware |
| vbmeta.img | contains AVB verification information |
| update.img | contains the above images for flashing the whole firmware |
The image output directory of Firefly-R3572A is rockdev/Image-rk3572_firefly_r3572a/, expected to contain boot.img, super.img, update.img and others.
Confirm the output with ls rockdev/. For flashing, refer to USB Firmware Upgrade.
OTA Build
Full OTA Package
Append the -o argument to the full build command to perform a global OTA build and generate a full OTA package:
./FFTools/make.sh -j8 -d rk3572-firefly-r3572a -l rk3572_firefly_r3572a-bp4a-userdebug -oThe generated full OTA package is located at:
out/target/product/rk3572-firefly-r3572a/rk3572-firefly-r3572a-ota-eng.xxx.zipThe base target-files package (used to generate a differential package) is located at:
out/target/product/rk3572-firefly-r3572a/obj/PACKAGING/target_files_intermediates/rk3572-firefly-r3572a-target_files-eng.xxx.zipCopy out the base package and rename it for later differential package creation:
mkdir -p ~/ota
cp out/target/product/rk3572-firefly-r3572a/obj/PACKAGING/target_files_intermediates/rk3572-firefly-r3572a-target_files-eng.xxx.zip ~/ota/v1.zipOTA Differential Package
A differential package requires two versions of the base package. First obtain the old v1.zip as above, then modify the kernel DTS or Android code and run the -o build again to generate a new base package, copied out as v2.zip:
./FFTools/make.sh -j8 -d rk3572-firefly-r3572a -l rk3572_firefly_r3572a-bp4a-userdebug -o
cp out/target/product/rk3572-firefly-r3572a/obj/PACKAGING/target_files_intermediates/rk3572-firefly-r3572a-target_files-eng.xxx.zip ~/ota/v2.zipThen generate the differential package:
out/host/linux-x86/bin/ota_from_target_files --block -v -i ~/ota/v1.zip -p out/host/linux-x86/ \
-k build/target/product/security/testkey ~/ota/v2.zip update.zipPut the generated update.zip in the device's /sdcard/ directory and reboot; the system will detect it and prompt to complete the OTA upgrade (full and differential packages are applied in the same way, by placing update.zip in /sdcard/ and rebooting).
Note
The OTA commands and paths above depend on the actual output of the Firefly-R3572A Android 16 SDK. For setting up an OTA server, refer to the OTA documentation provided with the SDK.
FAQ
Q1: git clone of the remote bundle repository fails while updating the SDK
A1: Increase the buffer size and retry:
git config --global https.postBuffer 1048576000
