Welcome to Firefly
English
English
Firefly Docsss
Last Updated: 2026-11-13 16:38:16

Compile Android firmware

In order to run Android 11.0 normally, Core-3568J needs to meet the following conditions:

  • DDR requires at least 2 GB
  • eMMC requires at least 16 GB

Android SDK

Download SDK

  • Due to the larger SDK, you can choose the cloud disk to download Firefly-RK356X_Android11.0_git from the download page.

  • After downloading, verify the MD5 code:

    $ md5sum /path/to/Firefly-RK356X_Android11.0_git_20210824.7z.001
$ md5sum /path/to/Firefly-RK356X_Android11.0_git_20210824.7z.002
$ md5sum /path/to/Firefly-RK356X_Android11.0_git_20210824.7z.003
$ md5sum /path/to/Firefly-RK356X_Android11.0_git_20210824.7z.004
$ md5sum /path/to/Firefly-RK356X_Android11.0_git_20210824.7z.005

b4c3d014a688d230bb25156a4c5aea26  Firefly-RK356X_Android11.0_git_20210824.7z.001
1ddfec58d0d69aee6029982fcbe4343c  Firefly-RK356X_Android11.0_git_20210824.7z.002
d08b16c244545ac68b496e2980d3c6a7  Firefly-RK356X_Android11.0_git_20210824.7z.003
2b628cc10a55214b8d9a3619673c01c3  Firefly-RK356X_Android11.0_git_20210824.7z.004
6f7e63955c96ca3c9ba6e4e49d52c90c  Firefly-RK356X_Android11.0_git_20210824.7z.005

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

Attention

To avoid unnecessary errors, please do not unzip the SDK in shared folders, mounted folders or non-English directories.

    $ mkdir ~/proj
    $ mv /path/to/Firefly-RK356X_Android11.0_git_20210824.7z.* ~/proj
    $ cd ~/proj/
    $ 7z x ./Firefly-RK356X_Android11.0_git_20210824.7z.001 -oRK356X_Android11.0
    $ cd ./RK356X_Android11.0
    $ git reset --hard

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/RK356X_Android11.0


2. Download remote bundle repository
git clone https://gitlab.com/TeeFirefly/rk356x-android11-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 rk356x-android11-bundle.7z  -r -o. && mv rk356x-android11-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 Drive bundle download.

Core-3568J product compilation method

Note: if the Android product is compiled for the first time, please use the public compilation command for a complete compilation

Compile configuration overview

Module info

Modules used in this section: displays DM-M10R800 V2 / DM-M10R800 V3S, dual camera CAM-2MS2MF, HDMI-TO-MIPI_CSI driver board (RK628D); the IPC build targets IPC-M10R800-A3568J.

ConfigurationModuleDTS (-d parameter)lunch (-l parameter)
Public Compile (HDMI)—rk3568-firefly-aiojrk3568_firefly_aioj-userdebug
IPC-M10R800-A3568J CompileIPC-M10R800-A3568Jrk3568-firefly-aioj-ipc-mipi_BSD1218_A101KL68rk3568_firefly_aioj_ipc-userdebug
Display DM-M10R800 V2 Compile (MIPI_DSI0+HDMI)DM-M10R800 V2rk3568-firefly-aioj-mipi101_M101014_BE45_A1rk3568_firefly_aioj_mipi-userdebug
Display DM-M10R800 V3S Compile (MIPI_DSI0+HDMI)DM-M10R800 V3Srk3568-firefly-aioj-mipi101_BSD1218_A101KL68rk3568_firefly_aioj_mipi-userdebug
Dual Camera CAM-2MS2MF Compile (HDMI+CAM-2MS2MF)CAM-2MS2MFrk3568-firefly-aioj (modify dts first)rk3568_firefly_aioj-userdebug
HDMI-TO-MIPI_CSI(RK628D) CompileRK628Drk3568-firefly-aioj (modify dts first)rk3568_firefly_aioj-userdebug

Public Compile

HDMI

./FFTools/make.sh -d rk3568-firefly-aioj -j8 -l rk3568_firefly_aioj-userdebug
./FFTools/mkupdate/mkupdate.sh -l rk3568_firefly_aioj-userdebug

Display Compile

DM-M10R800 V2

MIPI_DSI0+HDMI

./FFTools/make.sh -d rk3568-firefly-aioj-mipi101_M101014_BE45_A1 -j8 -l rk3568_firefly_aioj_mipi-userdebug
./FFTools/mkupdate/mkupdate.sh -l rk3568_firefly_aioj_mipi-userdebug

DM-M10R800 V3S

MIPI_DSI0+HDMI

./FFTools/make.sh -d rk3568-firefly-aioj-mipi101_BSD1218_A101KL68 -j8 -l rk3568_firefly_aioj_mipi-userdebug
./FFTools/mkupdate/mkupdate.sh -l rk3568_firefly_aioj_mipi-userdebug

Camera Compile

HDMI+CAM-2MS2MF

  • modify dts

    diff --git a/kernel/arch/arm64/boot/dts/rockchip/rk3568-firefly-aioj.dts b/kernel/arch/arm64/boot/dts/rockchip/rk3568-firefly-aioj.dts
index 7e2a8b2..14fa027 100755
--- a/kernel/arch/arm64/boot/dts/rockchip/rk3568-firefly-aioj.dts
+++ b/kernel/arch/arm64/boot/dts/rockchip/rk3568-firefly-aioj.dts
@@ -7,6 +7,15 @@
- #include "rk3568-firefly-aioj-cam-8ms1m.dtsi"
+//#include "rk3568-firefly-aioj-cam-8ms1m.dtsi"
- //#include "rk3568-firefly-aioj-cam-2ms2m.dtsi"
+ #include "rk3568-firefly-aioj-cam-2ms2m.dtsi"

  • Compile

    ./FFTools/make.sh -d rk3568-firefly-aioj -j8 -l rk3568_firefly_aioj-userdebug
./FFTools/mkupdate/mkupdate.sh -l rk3568_firefly_aioj-userdebug

RK628D Compile

  • modify dts

    diff --git a/kernel/arch/arm64/boot/dts/rockchip/rk3568-firefly-aioj.dts b/kernel/arch/arm64/boot/dts/rockchip/rk3568-firefly-aioj.dts
index 14fa027..5bc904f 100755
--- a/kernel/arch/arm64/boot/dts/rockchip/rk3568-firefly-aioj.dts
+++ b/kernel/arch/arm64/boot/dts/rockchip/rk3568-firefly-aioj.dts
@@ -13,9 +13,9 @@
* using dual camera gc2053/gc2093   ----> rk3568-firefly-aioj-cam-2ms2m.dtsi
* using hdmi-in module rk628d   ----> rk3568-firefly-aioj-tf-hdmi-mipi-rk628.dtsi
*/
-#include "rk3568-firefly-aioj-cam-8ms1m.dtsi"
+//#include "rk3568-firefly-aioj-cam-8ms1m.dtsi"
//#include "rk3568-firefly-aioj-cam-2ms2m.dtsi"
-//#include "rk3568-firefly-aioj-tf-hdmi-mipi-rk628.dtsi"
+#include "rk3568-firefly-aioj-tf-hdmi-mipi-rk628.dtsi"

  • Compile

    ./FFTools/make.sh -d rk3568-firefly-aioj -j8 -l rk3568_firefly_aioj-userdebug
./FFTools/mkupdate/mkupdate.sh -l rk3568_firefly_aioj-userdebug

IPC-M10R800-A3568J Compile

./FFTools/make.sh -d rk3568-firefly-aioj-ipc-mipi_BSD1218_A101KL68 -j8 -l rk3568_firefly_aioj_ipc-userdebug
./FFTools/mkupdate/mkupdate.sh -l rk3568_firefly_aioj_ipc-userdebug

Note

The AIO-3568J hardware version must be V1.3 and later to support the use of HDMI-TO-MIPI_CSI drive board.

Manually compile Core-3568J Android 11.0

Before compiling, execute the following command to configure environment variables:

export JAVA_HOME=/usr/lib/jvm/java-8-openjdk-amd64
export PATH=$JAVA_HOME/bin:$PATH
export CLASSPATH=.:$JAVA_HOME/lib:$JAVA_HOME/lib/tools.jar
  • Compile the kernel:
cd ~/proj/RK356X/kernel/
make ARCH=arm64 firefly_defconfig android-11.config rk356x.config firefly_wifi.config
make ARCH=arm64 BOOT_IMG=../rockdev/Image-rk3568_firefly_aioj/boot.img rk3568-firefly-aioj.img -j8

Note

When debugging the kernel, if there is a run error in the single compilation of boot.img, please refer to the FAQs.

  • Compile uboot:
cd ~/proj/RK356X/u-boot/
./make.sh rk3568
  • Compile Android:
cd ~/proj/RK356X/
source build/envsetup.sh
lunch rk3568_firefly_aioj-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 rk3568_firefly_aioj-userdebug

After packaging, it will be in rockdev/Image-XXX/ 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 update.img and store it in rockdev \ Image directory.

OTA Compilation

Firefly full OTA compilation and upgrade

Add the -o parameter for OTA full compilation

./FFTools/make.sh -d rk3568-firefly-aioj -j8 -l rk3568_firefly_aioj-userdebug -o

Generate the full package path

out/target/product/rk3568_firefly_aioj/rk3568_firefly_aioj-ota-eng.xxx.zip

Generate the base material package path

out/target/product/rk3568_firefly_aioj/obj/PACKAGING/target_files_intermediates/rk3568_firefly_aioj-target_files-eng.xxx.zip

Copy the base material package and rename it, mainly for subcontracting upgrades.

cp out/target/product/rk3568_firefly_aioj/obj/PACKAGING/target_files_intermediates/rk3568_firefly_aioj-target_files-eng.xxx.zip ~/ota/v1.zip

Package compiled firmware and upgrades

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

In the rockdev/Image-rk3568_firefly_aioj/ directory, find the corresponding firmware and burn it to the machine, then the machine can carry out the full package upgrade and the difference package upgrade. Put update.zip into /sdcard/ and restart the full package as prompted.

Generate the incremental OTA package

Generate a new base material package

The v1.zip basic material package has been made, and another v2.zip material package needs to be made to generate the difference package. You need to modify the kernel DTS code or Android code, and then run the command again.

./FFTools/make.sh -d rk3568-firefly-aioj -j8 -l rk3568_firefly_aioj-userdebug -o

Regenerate a new base material package that we can copy.

cp out/target/product/rk3568_firefly_aioj/obj/PACKAGING/target_files_intermediates/rk3568_firefly_aioj-target_files-eng.xxx.zip  ~/ota/v2.zip

Generate the incremental OTA package command

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.zip

Upgrade OTA incremental OTA package

Put update.zip to the machine sdcard directory reboot, it will automatically recognize, and then click the steps to complete the upgrade.

OTA server setup

Refer to OTA Documentation to set up the server.

On this page

Compile Android firmware
Android SDK
1Download SDK
2Update SDK
3Core-3568J product compilation method
Full compilation
Compile configuration overview
1Public Compile
2Display Compile
3Camera Compile
4RK628D Compile
IPC-M10R800-A3568J Compile