1. 编译 Linux 固件¶
1.1. 获取 SDK¶
请联系销售(sales@t-firefly.com)获取 SDK 下载链接, 并且阅读下载链接的 readme 文档。
注意：
1. SDK 采用交叉编译，所以要在 X86_64 电脑上使用 SDK，不要将 SDK 下载到板子上
2. 编译环境请使用 Ubuntu20.04（真机或 docker 容器），如果使用其他版本可能导致编译出错
3. 不要在虚拟机共享文件夹以及非英文目录存放、解压SDK
4. 获取、编译 SDK 请全程使用普通用户，不允许也不需要使用 root 权限（除非需要 apt 安装软件）
1.2. SDK 配置介绍¶
1.2.1. 目录介绍¶
$ tree -L 1
.
├── app
├── buildroot # buildroot
├── build.sh -> device/rockchip/common/scripts/build.sh # 编译脚本
├── device # 编译系统，内含编译配置文件
├── docs # 开发文档
├── external # 一些组件
├── kernel # 内核
├── Makefile -> device/rockchip/common/Makefile
├── prebuilt_rootfs # 用于存放预编译好的文件系统
├── prebuilts # 用于存放交叉编译工具链
├── rkbin
├── rkflash.sh -> device/rockchip/common/scripts/rkflash.sh
├── tools # 工具，包含烧录工具等
└── u-boot # uboot
1.2.2. 配置文件介绍¶
在 device/rockchip/rk3576/ 目录下，有不同板型的配置文件(xxxx_defconfig)，用于管理 SDK 每个环节的编译配置。
配置文件命名规则：
<vendor>_<chip>_<model>-<extra>_<OS>_defconfig
vendor: 产品供应商
chip: 产品所用的芯片
model: 产品型号，表示这个配置文件是用于该型号的产品
extra: 额外属性，可以为空
OS: 产品将会运行的操作系统
配置文件内容介绍，比如 firefly_rk3576_aio-3576jd4_debian_defconfig :
#include "firefly.config" # 引用 firefly.config
PREBUILT_ROOTFS_IMG="prebuilt_rootfs/rk3576_debian_rootfs.img" # 指定要使用的预编译文件系统
RK_PARAMETER="parameter-ubuntu-fit.txt" # 指定固件分区表
RK_KERNEL_DTS_NAME="rk3576-firefly-aio-3576jd4" # 指定编译内核所使用的设备树
RK_PRODUCT_MODEL="AIO-3576JD4" # 产品名称/型号
UBOOT_DEBUG_BAUDRATE="115200" # 设置 debug 串口波特率为 115200
firefly.config 中的主要内容为：
RK_KERNEL_CFG_FRAGMENTS="firefly-linux.config firefly-docker.config" # 指定编译内核所使用的 config fragments
RK_UBOOT_CFG_FRAGMENTS="firefly-linux" # 指定编译 uboot 所使用的 config fragments
USE_EXTBOOT=y # 使用 exlinux 风格的 boot.img
1.2.3. 分区说明¶
parameter 文件中包含了固件的分区信息，比如 device/rockchip/rk3576/parameter-xxxxxx-fit.txt
FIRMWARE_VER: 1.0
MACHINE_MODEL: RK357
MACHINE_ID: 007
MANUFACTURER: RK3576
MAGIC: 0x5041524B
ATAG: 0x00200800
MACHINE: 0xffffffff
CHECK_MASK: 0x80
PWR_HLD: 0,0,A,0,1
TYPE: GPT
GROW_ALIGN: 0
CMDLINE: mtdparts=:0x00004000@0x00004000(uboot),0x00002000@0x00008000(misc),0x00040000@0x0000a000(boot:bootable),0x00040000@0x0004a000(recovery),0x00010000@0x0008a000(backup),0x00c00000@0x0009a000(rootfs),-@0x00c9a000(userdata:grow)
uuid:rootfs=614e0000-0000-4b53-8000-1d28000054a9
uuid:boot=7A3F0000-0000-446A-8000-702F000062736
CMDLINE 属性是我们关注的地方，以 boot 为例， 0x00040000@0x0000a000(boot:bootable) 中 0x0000a000 为 boot 分区的起始位置，0x00040000 为分区的大小，以此类推。分区的起始位置 + 分区大小 = 下一个分区的起始位置。
parameter 中数字的单位是 “块”，每块 512 字节。所以 boot 分区大小为 0x00040000，即 262144 块，共 262144 x 512 / 1024 / 1024 = 128 MiB
1.3. 编译 Ubuntu 固件¶
1.3.1. 准备工作¶
执行下面两条命令来安装需要的工具
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 根文件系统，一般选择日期最新的文件系统。
下载后将文件系统解压到 SDK/prebuilt_rootfs/ 下，并创建链接
# 解压
7z x Ubuntu22.04-xxxx.7z
mv Ubuntu22.04-xxxx.img ./rk3576_sdk/prebuilt_rootfs/
cd ./rk3576_sdk/prebuilt_rootfs/
ln -sf Ubuntu22.04-xxxx.img rk3576_ubuntu_rootfs.img
cd ..
1.3.2. 编译前配置¶
执行 ./build.sh lunch 列出所有可用的配置文件，输入编号选择对应的配置文件，注意要选择带有 ubuntu 字样的配置文件：
./build.sh lunch
############### Rockchip Linux SDK ###############
Manifest: rk3576_linux_release_20250520_v1.0.1f.xml
Log colors: message notice warning error fatal
Log saved at /home2/liuth/project/linux/rk3576/output/sessions/2025-08-06_15-27-20
Pick a defconfig:
1. rockchip_defconfig
2. firefly_rk3576_aio-3576c_buildroot_defconfig
3. firefly_rk3576_aio-3576c_debian_defconfig
4. firefly_rk3576_aio-3576c_ubuntu_defconfig
5. firefly_rk3576_aio-3576jd4_buildroot_defconfig
6. firefly_rk3576_aio-3576jd4_debian_defconfig
7. firefly_rk3576_aio-3576jd4_ubuntu_defconfig
......
......
24. firefly_rk3576_roc-rk3576-pc_buildroot_defconfig
25. firefly_rk3576_roc-rk3576-pc_debian_defconfig
26. firefly_rk3576_roc-rk3576-pc_ubuntu_defconfig
27. rockchip_rk3576_evb1_v10_defconfig
28. rockchip_rk3576_industry_evb_v10_defconfig
29. rockchip_rk3576_iotest_v10_defconfig
30. rockchip_rk3576_ipc_evb1_v10_defconfig
31. rockchip_rk3576_multi_ipc_evb1_v10_defconfig
32. rockchip_rk3576_test1_v10_defconfig
33. rockchip_rk3576_test2_v10_defconfig
34. rockchip_rk3576_vehicle_evb_v10_defconfig
35. rockchip_rk3576_vehicle_evb_v20_mos_defconfig
Which would you like? [1]: