编译 Linux 固件

获取 SDK

请联系销售(sales@t-firefly.com)获取 SDK 下载链接, 并且阅读下载链接的
readme 文档。

注意：

1. SDK 采用交叉编译，所以要在 X86_64 电脑上使用 SDK，不要将 SDK 下载到
板子上

2. 编译环境请使用 Ubuntu20.04（真机或 docker 容器），如果使用其他版本
可能导致编译出错

3. 不要在虚拟机共享文件夹以及非英文目录存放、解压SDK

4. 获取、编译 SDK 请全程使用普通用户，不允许也不需要使用 root 权限（除
非需要 apt 安装软件）


SDK 配置介绍

目录介绍

   $ 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

配置文件介绍

在 "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

分区说明

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

编译 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 根文件系统

，一般选择日期最新的文件系统。

下载后将文件系统解压到 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 ..

编译前配置

执行 "./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]:

编译

完整编译

执行如下命令即可

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