Welcome to Firefly
English
Firefly Docsss
Last Updated: 2026-11-19 22:11:26

Compile Linux Firmware

Download the SDK

Please contact sales@t-firefly.com to get SDK download link and read the readme file

Compilation Notes

Notice:

1. SDK use cross-compilation, so use SDK in x86_64 PC, do not download SDK to the device

2. We suggest to use Ubuntu20.04 (real PC or docker) to build, other OS may cause building failure

3. Do not place or decompress the SDK archive in Virtual Machine share folder or non-english folder

4. Please use the regular user to get/compile the SDK, use root privilege may cause building failure

SDK Introduction

Compile Firmware

Build Ubuntu Firmware

Preparations

Run these two commands to install necessary tools

sudo apt update
sudo apt install repo git ssh make gcc libssl-dev liblz4-tool \
expect g++ patchelf chrpath gawk texinfo chrpath diffstat binfmt-support \
qemu-user-static live-build bison flex fakeroot cmake gcc-multilib g++-multilib \
unzip device-tree-compiler ncurses-dev p7zip-full

Download rootfs here Ubuntu rootfs(64-bit) Kernel6.12, please use rootfs under kernel-6.12 folder.

After download, decompress and move the rootfs image to SDK/prebuilt_rootfs/, then create a symbolic link.

# Decompress
7z x Ubuntu24.04-xxxx.7z
mkdir ./SDK/prebuilt_rootfs/
mv Ubuntu24.04-xxxx.img ./SDK/prebuilt_rootfs/
cd ./SDK/prebuilt_rootfs/
ln -sf Ubuntu22.04-xxxx.img rk3588_ubuntu_rootfs.img
cd ..

Configurations

Run ./build.sh lunch to list all available configs, enter a number to select. Please choose one with "ubuntu" keyword:

./build.sh lunch
\n############### Rockchip Linux SDK ###############\n
Manifest: common_linux6.12_next.xml
GIT commit: "c5b718df fix: oem add 1828 sodimm deb and set default"
Log colors: message notice warning error fatal
Log saved at /home4/lhj/arm64/rockchip/rk3588_6.12.69_sdk/output/sessions/2026-11-17_17-48-59
Pick a defconfig:\n
1. rockchip_defconfig
2. firefly_rk3588_aio-3588jd4_ubuntu_defconfig
3. firefly_rk3588_aio-3588l-qua_rk182x_debian_defconfig
4. firefly_rk3588_aio-3588l-qua_rk182x_ubuntu_defconfig
5. firefly_rk3588_aio-3588l_ubuntu_defconfig
6. firefly_rk3588_aio-3588q_defconfig
7. firefly_rk3588_aio-3588sg_ubuntu_defconfig
8. firefly_rk3588_aio-3588sjd4_defconfig
9. firefly_rk3588_itx-3588j_ubuntu_defconfig
10. firefly_rk3588_lga-3588l-mini-duo_rk182x_debian_defconfig
11. firefly_rk3588_lga-3588l-mini-duo_rk182x_ubuntu_defconfig
12. firefly_rk3588_roc-rk3588-rt_defconfig
13. firefly_rk3588_roc-rk3588s-pc_defconfig
14. rockchip_rk3588_evb10_v10_defconfig
15. rockchip_rk3588_evb1_lp4_v10_amp_defconfig
16. rockchip_rk3588_evb1_lp4_v10_defconfig
17. rockchip_rk3588_evb1_lp4_v10_mcu_defconfig
18. rockchip_rk3588_evb7_v11_defconfig
19. rockchip_rk3588_ipc_evb1_v10_defconfig
20. rockchip_rk3588_ipc_evb7_lp4_v11_defconfig
21. rockchip_rk3588_multi_ipc_evb1_v10_defconfig
22. rockchip_rk3588_thunderboot_evb7_v11_defconfig
23. rockchip_rk3588s_evb1_lp4x_v10_defconfig
Which would you like? [1]:

Compilation

Full Compilation

Run

./build.sh all

The output firmware will be output/update/update.img

Partial Compilation

After a full compilation, if you modified kernel or uboot, you can do partial compilation to save time.

  • Only build u-boot, will generate u-boot/uboot.img
./build.sh uboot
  • Only build kernel, will generate kernel/extboot.img.
./build.sh extboot
  • Pack all parts to update.img
./build.sh updateimg

Build Debian Firmware

Preparations

Run these two commands to install necessary tools

sudo apt update
sudo apt install repo git ssh make gcc libssl-dev liblz4-tool \
expect g++ patchelf chrpath gawk texinfo chrpath diffstat binfmt-support \
qemu-user-static live-build bison flex fakeroot cmake gcc-multilib g++-multilib \
unzip device-tree-compiler ncurses-dev p7zip-full

Download rootfs here Debian Rootfs, please use rootfs under kernel-6.12 folder.

After download, decompress and move the rootfs image to SDK/prebuilt_rootfs/, then create a symbolic link.

# Decompress
7z x debian13_xxxx_rootfs_xxxx.7z
# Move the decompressed rootfs image to sdk and then create a symbolic link.
mkdir ./SDK/prebuilt_rootfs/
mv debian13_xxxx_rootfs_xxxx.img ./SDK/prebuilt_rootfs/
cd ./SDK/prebuilt_rootfs/
ln -sf debian13_xxxx_rtoofs_xxxx.img rk3588_debian_rootfs.img
cd ..

Configurations

Run ./build.sh lunch to list all available configs, enter a number to select. Please choose one with "debian" keyword:

./build.sh lunch
\n############### Rockchip Linux SDK ###############\n
Manifest: common_linux6.12_next.xml
GIT commit: "c5b718df fix: oem add 1828 sodimm deb and set default"
Log colors: message notice warning error fatal
Log saved at /home4/lhj/arm64/rockchip/rk3588_6.12.69_sdk/output/sessions/2026-11-17_17-48-59
Pick a defconfig:\n
1. rockchip_defconfig
2. firefly_rk3588_aio-3588jd4_ubuntu_defconfig
3. firefly_rk3588_aio-3588l-qua_rk182x_debian_defconfig
4. firefly_rk3588_aio-3588l-qua_rk182x_ubuntu_defconfig
5. firefly_rk3588_aio-3588l_ubuntu_defconfig
6. firefly_rk3588_aio-3588q_defconfig
7. firefly_rk3588_aio-3588sg_ubuntu_defconfig
8. firefly_rk3588_aio-3588sjd4_defconfig
9. firefly_rk3588_itx-3588j_ubuntu_defconfig
10. firefly_rk3588_lga-3588l-mini-duo_rk182x_debian_defconfig
11. firefly_rk3588_lga-3588l-mini-duo_rk182x_ubuntu_defconfig
12. firefly_rk3588_roc-rk3588-rt_defconfig
13. firefly_rk3588_roc-rk3588s-pc_defconfig
14. rockchip_rk3588_evb10_v10_defconfig
15. rockchip_rk3588_evb1_lp4_v10_amp_defconfig
16. rockchip_rk3588_evb1_lp4_v10_defconfig
17. rockchip_rk3588_evb1_lp4_v10_mcu_defconfig
18. rockchip_rk3588_evb7_v11_defconfig
19. rockchip_rk3588_ipc_evb1_v10_defconfig
20. rockchip_rk3588_ipc_evb7_lp4_v11_defconfig
21. rockchip_rk3588_multi_ipc_evb1_v10_defconfig
22. rockchip_rk3588_thunderboot_evb7_v11_defconfig
23. rockchip_rk3588s_evb1_lp4x_v10_defconfig
Which would you like? [1]:

Compilation

Full Compilation

Run

./build.sh all

The output firmware will be output/update/update.img

Partial Compilation

After a full compilation, if you modified kernel or uboot, you can do partial compilation to save time.

  • Only build u-boot, will generate u-boot/uboot.img
./build.sh uboot
  • Only build kernel, will generate kernel/extboot.img
./build.sh extboot
  • Pack all parts to update.img
./build.sh updateimg

On this page