编译 Linux 固件 编译环境搭建 本章介绍 Linux SDK的编译流程 注意：（1）推荐在 Ubuntu 18.04 系统环境下进行开发，若使用其它系统版本 ，可能需要对编译环境做相应调整。 （2）使用普通用户进行编译，不要使用 root 用户权限进行编译。 安装依赖包 sudo apt-get 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 python-pip ncurses-dev python-pyelftools 下载 Firefly_Linux_SDK 分卷压缩包 方法一（推荐） 由于 Firefly_Linux_SDK 源码包比较大，部分用户电脑不支持4G以上文件或单 个文件网络传输较慢, 所以我们采用分卷压缩的方法来打包 SDK。用户可以通过 如下方式获取 Firefly_Linux_SDK 源码包： Firefly_Linux_SDK源码包 下载完成后先验证一下 MD5 码： $ md5sum rk3308_linux_release_v1.5.0a_20221212_split_dir/*firefly_split* a97f218aed44be1b9a423a2868e09335 rk3308_linux_release_v1.5.0a_20221212_split_dir/rk3308_linux_release_v1.5.0a_20221212_firefly_split.file0 3f3936a72635b75613b89a4bf8d9de39 rk3308_linux_release_v1.5.0a_20221212_split_dir/rk3308_linux_release_v1.5.0a_20221212_firefly_split.file1 794ea504543a797d972c2112dfef2f3f rk3308_linux_release_v1.5.0a_20221212_split_dir/rk3308_linux_release_v1.5.0a_20221212_firefly_split.file2 0de1858d73e2841790006e487ff70a19 rk3308_linux_release_v1.5.0a_20221212_split_dir/rk3308_linux_release_v1.5.0a_20221212_firefly_split.file3 确认无误后，就可以解压： 注意：不要在共享文件夹、挂载文件夹以及非英文目录解压SDK，避免产生不必 要的错误 # 解压 mkdir ~/proj/ cd ~/proj/ cat path/to/rk3308_linux_release_v1.5.0a_20221212_split_dir/*firefly_split* | tar -xzv # 导出数据 .repo/repo/repo sync -l 方法二 通过 repo 拉取代码，此方法对网络要求较高，有条件可以使用 可选择获取完整 SDK 或者 BSP： mkdir ~/proj/rk3308_linux_release_v1.5.0a_20221212/ cd ~/proj/rk3308_linux_release_v1.5.0a_20221212/ ## 完整 SDK repo init --no-clone-bundle --repo-url https://gitlab.com/firefly-linux/git-repo.git -u https://gitlab.com/firefly-linux/manifests.git -b master -m rk3308_linux_release.xml ## BSP （ 只包含基础仓库和编译工具 ） ## BSP 包括 device/rockchip 、docs 、 kernel 、 u-boot 、 rkbin 、 tools 和交叉编译链 repo init --no-clone-bundle --repo-url https://gitlab.com/firefly-linux/git-repo.git -u https://gitlab.com/firefly-linux/manifests.git -b master -m rk3308_linux_bsp_release.xml 同步代码 执行如下命令同步代码： # 进入 SDK 根目录 cd ~/proj/rk3308_linux_release_v1.5.0a_20221212/ # 同步 .repo/repo/repo sync -c --no-tags .repo/repo/repo start firefly --all 后续可以使用以下命令更新 SDK： .repo/repo/repo sync -c --no-tags 因为网络环境等原因，".repo/repo/repo sync -c --no-tags" 命令更新代码可 能会失败，可多次反复执行。 编译 Ubuntu 固件 本章介绍 Ubuntu 固件的编译流程，推荐在 Ubuntu 18.04 系统环境下进行开发 ，若使用其它系统版本，可能需要对编译环境做相应调整。 Ubuntu 固件简单介绍 什么是 Ubuntu Minimal固件？ 编译 SDK 编译前配置 不同板型的配置文件存放在"device/rockchip/rk3308/"目录下 回到 SDK 根目录执行"build.sh"选择配置文件： ./build.sh roc-rk3308b-cc-plus-ubuntu.mk 配置文件会链接到 "device/rockchip/.BoardConfig.mk"，检查该文件可以验证 是否配置成功。 相关配置介绍： # Target arch export RK_ARCH=arm64 # 64位 ARM 架构 # Uboot defconfig export RK_UBOOT_DEFCONFIG=firefly-rk3308-debug-uart4 # u-boot 配置文件 # Kernel defconfig export RK_KERNEL_DEFCONFIG=firefly-rk3308b_linux_defconfig # kernel 配置文件 # Kernel dts export RK_KERNEL_DTS=rk3308b-roc-cc-plus-amic_emmc # dts 文件 # parameter for GPT table export RK_PARAMETER=parameter-64bit-ubuntu.txt # 分区表 # rootfs image path export RK_ROOTFS_IMG=ubuntu_rootfs/rk3308-ubuntu_rootfs.img # 根文件系统路径 下载 Ubuntu 根文件系统 下载根文件系统：Ubuntu 根文件系统(64位)，放到 SDK 路径下 将根文件系统放到SDK的 ubuntu_rootfs/ 目录下 mkdir ubuntu_rootfs mv ubuntu-aarch64-rootfs.img ubuntu_rootfs/rk3308-ubuntu_rootfs.img 全自动编译 全自动编译会执行所有编译、打包操作，直接生成 RK 固件。 ./build.sh 部分编译 编译 u-boot ./build.sh uboot 编译 kernel ./build.sh kernel 编译 recovery ./build.sh recovery 更新链接 更新各部分镜像链接到 "rockdev/" 目录： ./mkfirmware.sh 打包固件 打包固件，生成的完整固件会保存到 "rockdev/pack/" 目录。 # 打包 RK 固件 ./build.sh updateimg 分区说明 parameter 分区表 parameter.txt 文件中包含了固件的分区信息，以 parameter-ubuntu-fit.txt 为例： 路径："device/rockchip/rk3308/parameter-64bit-ubuntu.txt" FIRMWARE_VER:8.1 MACHINE_MODEL:RK3308 MACHINE_ID:007 MANUFACTURER: RK3308 MAGIC: 0x5041524B ATAG: 0x00200800 MACHINE: 3308 CHECK_MASK: 0x80 PWR_HLD: 0,0,A,0,1 TYPE: GPT CMDLINE: mtdparts=rk29xxnand:0x00001000@0x00002000(uboot),0x00001000@0x00003000(trust),0x00000800@0x00004000(misc),0x0000A000@0x00004800(recovery),0x0000A000@0x0000E800(boot),0x00100000@0x00018800(rootfs),-@0x118800(userdata:grow) uuid:rootfs=614e0000-0000-4b53-8000-1d28000054a9 CMDLINE 属性是我们关注的地方，以 uboot 为例， 0x00001000@0x00002000(uboot) 中 0x00001000 为uboot 分区的起始位置， 0x00002000 为分区的大小，以此类推。 package-file package-file 文件用于打包固件时确定需要的分区镜像和镜像路径，同时它需 要与 parameter.txt 文件保持一致。 路径："tools/linux/Linux_Pack_Firmware/rockdev/rk3308-package-file- ubuntu" # NAME Relative path # #HWDEF HWDEF package-file package-file bootloader Image/MiniLoaderAll.bin parameter Image/parameter.txt trust Image/trust.img uboot Image/uboot.img boot Image/boot.img rootfs Image/rootfs.img recovery Image/recovery.img #oem Image/oem.img userdata:grow RESERVED misc Image/misc.img backup RESERVED #update-script update-script #recover-script recover-script 更多内容 《Firefly Ubuntu使用手册》 编译 Buildroot 固件 本章介绍 Buildroot 固件的编译流程，推荐在 Ubuntu 18.04 系统环境下进行 开发，若使用其它系统版本，可能需要对编译环境做相应调整。 编译 SDK 编译前配置 不同板型的配置文件存放在"device/rockchip/rk3308/"目录下 回到 SDK 根目录执行"build.sh"选择配置文件： ./build.sh roc-rk3308b-cc-plus-buildroot.mk 配置文件会链接到 "device/rockchip/.BoardConfig.mk"，检查该文件可以验证 是否配置成功。 相关配置介绍： # Target arch export RK_ARCH=arm64 # 64位 ARM 架构 # Uboot defconfig export RK_UBOOT_DEFCONFIG=firefly-rk3308-debug-uart4 # u-boot 配置文件 # Kernel defconfig export RK_KERNEL_DEFCONFIG=firefly-rk3308b_linux_defconfig # kernel 配置文件 # Kernel dts export RK_KERNEL_DTS=rk3308b-roc-cc-plus-amic_emmc # dts 文件 # Buildroot config export RK_CFG_BUILDROOT=firefly_rk3308_release # Buildroot 配置 # Recovery config export RK_CFG_RECOVERY=firefly_rk3308_recovery # recovery 配置 # parameter for GPT table export RK_PARAMETER=parameter-64bit-emmc.txt # 分区表 # rootfs image path export RK_ROOTFS_IMG=rockdev/rootfs.${RK_ROOTFS_TYPE} # 根文件系统路径 全自动编译 全自动编译会执行所有编译、打包操作，生成完整固件。 ./build.sh 部分编译 编译 u-boot ./build.sh uboot 编译 kernel ./build.sh kernel 编译 recovery ./build.sh recovery 编译 Buildroot 根文件系统 编译 Buildroot 根文件系统，将会在 "buildroot/output" 生成编译输出目录 ： ./build.sh buildroot # 注：确保作为普通用户编译 Buildroot 根文件系统，避免不必要的错误。 打包固件 更新各部分镜像链接到 "rockdev/" 目录： ./mkfirmware.sh 打包固件，生成的完整固件会保存到 "rockdev/pack/" 目录。 ./build.sh updateimg 分区说明 parameter 分区表 parameter.txt 文件中包含了固件的分区信息，以 "parameter-buildroot- fit.txt" 为例： 路径："device/rockchip/rk356x/parameter-buildroot-fit.txt" FIRMWARE_VER:8.1 MACHINE_MODEL:RK3308 MACHINE_ID:007 MANUFACTURER: RK3308 MAGIC: 0x5041524B ATAG: 0x00200800 MACHINE: 3308 CHECK_MASK: 0x80 PWR_HLD: 0,0,A,0,1 TYPE: GPT CMDLINE: mtdparts=rk29xxnand:0x00001000@0x00002000(uboot),0x00001000@0x00003000(trust),0x00000800@0x00004000(misc),0x0000A000@0x00004800(recovery),0x0000A000@0x0000E800(boot),0x00080000@0x00018800(rootfs),0x00020000@0x00098800(oem),-@0x00B8800(userdata:grow) uuid:rootfs=614e0000-0000-4b53-8000-1d28000054a9 CMDLINE 属性是我们关注的地方，以 uboot 为例， 0x00001000@0x00004000(uboot) 中 0x00001000 为uboot 分区的起始位置， 0x00002000 为分区的大小，以此类推。 package-file package-file 文件用于打包固件时确定需要的分区镜像和镜像路径，同时它需 要与 parameter.txt 文件保持一致。 路径："tools/linux/Linux_Pack_Firmware/rockdev/rk3308-package-file" # NAME Relative path # #HWDEF HWDEF package-file package-file bootloader Image/MiniLoaderAll.bin parameter Image/parameter.txt trust Image/trust.img uboot Image/uboot.img boot Image/boot.img rootfs Image/rootfs.img recovery Image/recovery.img oem Image/oem.img userdata:grow Image/userdata.img misc Image/misc.img backup RESERVED #update-script update-script #recover-script recover-script 更多内容 《Firefly Buildroot 使用手册》