编译 Linux 固件
获取 SDK
首先准备一个空文件夹用于存放 SDK,建议在 home 目录下,本文以~/proj为例
编译说明
注意:
1. SDK 采用交叉编译,所以要在 X86_64 电脑上使用 SDK,不要将 SDK 下载到板子上
2. 编译环境请使用 Ubuntu22.04(真机或 docker 容器),如果使用其他版本可能导致编译出错
3. 不要在虚拟机共享文件夹以及非英文目录存放、解压SDK
4. 获取、编译 SDK 请全程使用普通用户,不允许也不需要使用 root 权限(除非需要 apt 安装软件)
SDK 配置介绍
编译固件
编译 Ubuntu 固件
准备工作
执行下面两条命令来安装需要的工具
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下载根文件系统:Ubuntu 根文件系统(64位) Kernel6.12,请使用网盘中 Kernel-6.12 目录下的文件系统。
下载后将文件系统解压到 SDK/prebuilt_rootfs/ 下,并创建链接
# 解压
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 ..编译前配置
执行 ./build.sh lunch 列出所有可用的配置文件,输入编号选择对应的配置文件,注意要选择带有 ubuntu 字样的配置文件:
./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]: 编译 Debian 固件
准备工作
执行下面两条命令来安装需要的工具
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下载根文件系统:Debian 根文件系统(64位),请使用网盘中 Kernel-6.12 目录下的文件系统。
下载后将文件系统解压到 SDK/prebuilt_rootfs/ 下,并创建链接
# 解压
7z x debian13_xxxx_rootfs_xxxx.7z
# 将解压后的 rootfs 镜像移动到 sdk 并创建一个符号链接
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 ..编译前配置
执行 ./build.sh lunch 列出所有可用的配置文件,输入编号选择对应的配置文件,注意要选择带有 debian 字样的配置文件:
./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]: 
