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

Linux 开发

获取 SDK

根据主核心模组,联系销售 (sales@t-firefly.com) 获取 RK35XX Kernel6.1 SDK下载链接, 并且阅读下载链接的 readme 文档。

注意:
1. SDK 采用交叉编译,所以要在 X86_64 电脑上使用 SDK,不要将 SDK 下载到板子上
2. 编译环境请使用 Ubuntu20.04(真机或 docker 容器),如果使用其他版本可能导致编译出错
3. 不要在虚拟机共享文件夹以及非英文目录存放、解压SDK
4. 获取、编译 SDK 请全程使用普通用户,不允许也不需要使用 root 权限(除非需要 apt 安装软件)
5. SDK 请至少更新到 rk35XX/linux6.1_release_v1.3.0e

SDK 配置介绍

目录介绍

$ tree -L 1
.
├── app
├── buildroot                                               # buildroot
├── build.sh -> device/rockchip/common/scripts/build.sh     # 编译脚本
├── device                                                  # 编译系统,内含编译配置文件
├── docs                                                    # 开发文档
├── external                                                # 一些组件
├── kernel -> kernel-6.1
├── kernel-6.1                                              # 内核
├── Makefile -> device/rockchip/common/Makefile
├── prebuilt_rootfs                                         # 用于存放预编译好的文件系统
├── prebuilts                                               # 用于存放交叉编译工具链
├── rkbin
├── rkflash.sh -> device/rockchip/common/scripts/rkflash.sh
├── tools                                                   # 工具,包含烧录工具等
└── u-boot                                                  # uboot

配置文件介绍

在 device/rockchip/<chip>/(如 rk3588、rk3576)目录下,有不同板型的配置文件(xxxx_defconfig),用于管理 SDK 每个环节的编译配置。

配置文件命名规则:

<vendor>_<chip>_<model>-<extra>_<OS>_defconfig

vendor: 产品供应商
chip: 产品所用的芯片
model: 产品型号,表示这个配置文件是用于该型号的产品
extra: 额外属性,可以为空
OS: 产品将会运行的操作系统

配置文件内容介绍,比如 firefly_rk3588_itx-3588j_debian_defconfig :

RK_KERNEL_DTS_NAME="rk3588-firefly-itx-3588j"                    # 指定编译内核所使用的设备树
RK_KERNEL_CFG_FRAGMENTS="firefly-linux.config"                   # 指定编译内核所使用的 config fragments
RK_UBOOT_CFG_FRAGMENTS="firefly-linux"                           # 指定编译 uboot 所使用的 config fragments
RK_USE_FIT_IMG=y
RK_BOOT_FIT_ITS_NAME="bootramdisk.its"
RK_PARAMETER="parameter-debian-fit.txt"                          # 指定固件分区表
RK_PRODUCT_MODEL="ITX-3588J"                                     # 产品名称/型号
PREBUILT_ROOTFS_IMG="prebuilt_rootfs/rk3588_debian_rootfs.img"   # 指定要使用的预编译文件系统
RK_MISC_RECOVERY=y
RK_RECOVERY_RAMDISK="rk3588-recovery-arm64.cpio.gz"
RK_RAMDISK_IMG="kernel/ramdisk.img"
USE_EXTBOOT=y                                                    # 使用 exlinux 风格的 boot.img
RK_EXTRA_PARTITION_NUM=1

分区说明

parameter 文件中包含了固件的分区信息,比如 device/rockchip/<chip>/parameter-xxxxxx-fit.txt

FIRMWARE_VER: 1.0
MACHINE_MODEL: RK3588
MACHINE_ID: 007
MANUFACTURER: RK3588
MAGIC: 0x5041524B
ATAG: 0x00200800
MACHINE: 0xffffffff
CHECK_MASK: 0x80
PWR_HLD: 0,0,A,0,1
TYPE: GPT
GROW_ALIGN: 0
CMDLINE: mtdparts=:0x00002000@0x00004000(uboot),0x00002000@0x00006000(misc),0x00040000@0x00008000(boot:bootable),0x00040000@0x00048000(recovery),0x00010000@0x00088000(backup),0x01c00000@0x00098000(rootfs),-@0x01c98000(userdata:grow)
uuid:rootfs=614e0000-0000-4b53-8000-1d28000054a9
uuid:boot=7A3F0000-0000-446A-8000-702F00006273

CMDLINE 属性是我们关注的地方,以 uboot 为例, 0x00002000@0x00004000(uboot) 中 0x00004000 为 uboot 分区的起始位置,0x00002000 为分区的大小,以此类推。分区的起始位置 + 分区大小 = 下一个分区的起始位置。

parameter 中数字的单位是 “块”,每块 512 字节。所以 uboot 分区大小为 0x00002000,即 8192 块,共 8192 x 512 / 1024 / 1024 = 4 MiB

请先获取 SDK。

准备工作

执行下面两条命令来安装需要的工具

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

rootfs

# 解压
7z x debian12_xxxx_rootfs_xxxx.7z

# 将解压后的 rootfs 镜像移动到 sdk 并创建一个符号链接
mkdir ./SDK/prebuilt_rootfs/
mv debian12_xxxx_rootfs_xxxx.img ./SDK/prebuilt_rootfs/
cd ./SDK/prebuilt_rootfs/
ln -sf debian12_xxxx_rtoofs_xxxx.img rk35XX_debian_rootfs.img
cd ..

配置

Core-3588JD4

./build.sh firefly_rk3588_aibox-pro-3588jd4_rk182x_debian_defconfig

Core-3576JD4

./build.sh firefly_rk3576_aibox-pro-3576jd4-rk182x-m2_debian_defconfig

编译

./build.sh all

生成的固件在 output/update/ 目录下,比如 AIBOX-PRO-35XXJD4_Debian.XXX.img

请先获取 SDK。

准备工作

执行下面两条命令来安装需要的工具

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

rootfs

# 解压
7z x Ubuntu22.04-xxxx.7z

mkdir ./SDK/prebuilt_rootfs/
mv Ubuntu22.04-xxxx.img ./SDK/prebuilt_rootfs/
cd ./SDK/prebuilt_rootfs/
ln -sf Ubuntu22.04-xxxx.img rk35XX_ubuntu_rootfs.img
cd ..

配置

RK3588

./build.sh firefly_rk3588_aibox-pro-3588jd4_rk182x_ubuntu_defconfig

RK3576

./build.sh firefly_rk3576_aibox-pro-3576jd4-rk182x-m2_ubuntu_defconfig

编译

./build.sh all

生成的固件在 output/update/ 目录下,比如 AIBOX-PRO-35XXJD4_Ubuntu.XXX.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

本页目录