1. Build Linux Firmware

1.1. Download SDK

Please contact sales@t-firefly.com to get SDK download link .

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

1.2. Decompress SDK

mkdir rk182x-developer-kit
cat rk182x-developer-kit.tgz.split* | tar -xzv -C rk182x-developer-kit/

1.3.

1.3.1. rk182x

cd rk182x-developer-kit/rk182x
.repo/repo/repo sync -l

1.3.2. rk3588

cd rk182x-developer-kit/rk3588
.repo/repo/repo sync -l

1.3.2.1. rootfs

  • Download rootfs, eg: Debian12-Xfce_rootfs_v1.2-55_20250825.7z

  • Decompress rootfs and create a symbolic link

cd rk182x-developer-kit/rk3588
mkdir prebuilt_rootfs
cd prebuilt_rootfs
7z x Debian12-Xfce_rootfs_v1.2-55_20250825.7z
ln -sf Debian12-Xfce_rootfs_v1.2-55_20250825.img rk3588_debian_rootfs.img

1.4. Build

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

1.4.2. RK3588

goto the dictionary of rk3588

1.4.2.1. Config

./build.sh firefly_rk3588_aio-gs1n2-3588jd4-rk182x_debian_defconfig

1.4.2.2. Build

./build.sh all

The generated firmware at output/update/ , eg: AIO-GS1N2-3588JD4-RK182X_Debian12-Xfce-r1255_debug_251126.img

1.4.3. RK182X

goto the dictionary of rk182x

1.4.3.1. Config

use ./build.sh config to config.

Select board type:
1) RK1820 EVB1
2) RK1820 SODIMM
3) RK1820 M2
4) Cancel
#?

Select 2

1.4.3.2. Build

./build.sh

The generated software installation package is located at output/firmware/rknn3_rk182x_sodimm_installer_arm64.tgz

  • The rootfs used by RK3588 have already installed the necessary software packages for rk182x

  • If you need to manually install the RK182X software package, follow the steps below:

    • Copy rknn3_rk182x_sodimm_installer_arm64.tgz to RK3588

    • Decompress: tar xzf rknn3_rk182x_sodimm_installer_arm64.tgz

    • Install: ./install.sh

      • After installation and rebooting, the RK3588 system will automatically download the RK182X firmware and start the background service program upon startup.