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-fullDownload 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 allThe 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 updateimgBuild 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-fullDownload 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 allThe 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
