Welcome to Firefly
中文
Firefly文档中心
最近更新: 2026-11-19 22:11:26

编译 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]: 

编译

完整编译

执行如下命令即可

./build.sh all

编译完成后会生成完整固件 output/update/update.img

部分编译

一般来说自定义开发只涉及 kernel 和 uboot。因此,在进行过一次完整编译后,如果后续又修改了 kernel 或 uboot,可以部分编译来加快速度。

  • 单独编译 u-boot,生成 u-boot/uboot.img
./build.sh uboot
  • 单独编译 kernel,生成 kernel/extboot.img.
./build.sh extboot
  • 将各部件打包成 update.img
./build.sh updateimg

编译 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]: 

编译

完整编译

执行如下命令即可

./build.sh all

编译完成后会生成完整固件 output/update/update.img

部分编译

一般来说自定义开发只涉及 kernel 和 uboot。因此,在进行过一次完整编译后,如果后续又修改了 kernel 或 uboot,可以部分编译来加快速度。

  • 单独编译 u-boot,生成 u-boot/uboot.img
./build.sh uboot
  • 单独编译 kernel,生成 kernel/extboot.img
./build.sh extboot
  • 将各部件打包成 update.img
./build.sh updateimg

本页目录