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-702F00006273CMDLINE 属性是我们关注的地方,以 uboot 为例, 0x00002000@0x00004000(uboot) 中 0x00004000 为 uboot 分区的起始位置,0x00002000 为分区的大小,以此类推。分区的起始位置 + 分区大小 = 下一个分区的起始位置。
parameter 中数字的单位是 “块”,每块 512 字节。所以 uboot 分区大小为 0x00002000,即 8192 块,共 8192 x 512 / 1024 / 1024 = 4 MiB
准备工作
执行下面两条命令来安装需要的工具
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-fullrootfs
- 下载根文件系统:Debian 根文件系统(64位) Kernel6.1,请使用网盘中 kernel-6.1 目录下的文件系统。
- 解压 rootfs 并链接 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_defconfigCore-3576JD4
./build.sh firefly_rk3576_aibox-pro-3576jd4-rk182x-m2_debian_defconfig准备工作
执行下面两条命令来安装需要的工具
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-fullrootfs
- 下载根文件系统:Ubuntu 根文件系统(64位) Kernel6.1,请使用网盘中 kernel-6.1 目录下的文件系统。
- 解压 rootfs 并链接 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_defconfigRK3576
./build.sh firefly_rk3576_aibox-pro-3576jd4-rk182x-m2_ubuntu_defconfig部分编译
一般来说自定义开发只涉及 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
