学习 / TSENGCHEN BLOG

Rockchip-SDK-Config-System--01-Rockchip-SDK-Config-System-Tutorial

01_Learning · 第 22 / 23 篇

Rockchip SDK 配置系统教程(RK3506 实例)

本文以 RK3506 SDK 为例,系统讲解 Rockchip 多 SoC SDK 中一块板子的固件版本由哪几层配置组成。每层按”作用 → 文件与内容 → 语法分析 → 工作机制”四部分展开。适合初学者建立 SDK 配置体系的整体认知。

适用范围

  • 基于 Buildroot 的 Rockchip SDK(本文实例为 RK3506,工作区目录名为 RK3588,目录名不代表目标 SoC)。
  • 文中所有文件路径、配置内容均取自实际 SDK,可直接对照阅读。

总体机制

SDK 的所有配置由 Kconfig 体系驱动。./build.sh 选定一个板级 defconfig 后,其中的 RK_* 变量作为总控参数,决定 U-Boot、内核、Buildroot、设备树、分区表各自使用哪份配置。

Kconfig(内核配置系统)是 Linux 生态通用的配置框架:每个配置项在 Config.in / Kconfig 文件中声明类型、默认值和依赖关系,最终生成 defconfig(精简的默认配置清单)和 .config(展开依赖后的完整配置)。

第 1~4 层(板级 defconfig、Buildroot、内核、U-Boot)使用统一的 Kconfig 输出格式,基本语法规则如下:

KEY=value          # 赋值:数字、布尔(y)或字符串
KEY="string"       # 字符串值必须加双引号
# KEY is not set   # 显式关闭(不是普通注释,是"禁用"语义)
# 普通注释          # 以 # 开头且不符合上一行格式的才是注释

第 5~7 层(设备树、分区表、FIT 镜像)使用各自的专用格式,下文分别分析。

第 1 层:板级 defconfig(组装层)

作用:一块板子一个文件,声明该版本的所有 RK_* 变量,是整个构建的入口。

文件:device/rockchip/rk3506/rockchip_rk3506_g_evb2_64m_minimal_defconfig

关键变量说明:

变量含义
RK_BUILDROOT_BASE_CFG指定 rootfs 基础配置名
RK_KERNEL_CFG / RK_KERNEL_CFG_FRAGMENTS内核 defconfig 及叠加的配置片段
RK_KERNEL_DTS_NAME设备树名称
RK_UBOOT_CFG_FRAGMENTS / RK_UBOOT_SPLU-Boot 配置片段 / 是否生成 SPL
RK_PARAMETER / RK_FLASH_SIZE分区表文件 / 闪存容量(KB)
RK_BOOT_FIT_ITS_NAME启动镜像打包模板
RK_ROOTFS_UBI / RK_WIFIBT_CHIProotfs 格式 / WiFi 芯片型号

语法分析:该文件使用上文统一的 Kconfig 输出格式。字符串值加引号(如 RK_WIFIBT_CHIP="AP6256"),布尔值用 =y,关闭用 # ... is not set(如 # RK_ROOTFS_LOG_GUARDIAN is not set)。

工作机制:这些变量定义在 device/rockchip/common/configs/Config.in.* 中,使用标准 Kconfig 声明语法:

config RK_BUILDROOT_BASE_CFG
	string "buildroot base cfg (rockchip_<cfg>_defconfig)"
	default "px30_64" if RK_CHIP_FAMILY = "px30"
	default RK_CHIP_FAMILY

其中 config 声明选项名,string 声明类型,default ... if ... 按芯片家族给默认值。因此板级 defconfig 中未写的变量会自动取家族默认值。

第 2 层:Buildroot 配置(rootfs 与用户态)

作用:决定 rootfs 中包含哪些软件包、文件系统格式(本例为 SquashFS + UBI)。

文件:buildroot/configs/rockchip_rk3506g_evb2_64m_minimal_defconfig(共 20 行),开头通过 #include 引入公共片段:

#include "base/base.config"
#include "chips/rk3506_arm.config"
#include "fs/vfat.config"
#include "ota/update_engine.config"
BR2_ARM_INSTRUCTIONS_THUMB2=y
# BR2_PACKAGE_DROPBEAR is not set
BR2_TARGET_ROOTFS_SQUASHFS4_ZSTD=y
BR2_TARGET_ROOTFS_UBI=y
BR2_TARGET_ROOTFS_UBI_SUBSIZE=2048

语法分析:

  1. 配置符号统一以 BR2_ 开头(Buildroot 2 前缀),按功能分类:

    前缀含义示例
    BR2_<arch>目标架构BR2_arm=y
    BR2_PACKAGE_<名字>是否编译某个软件包BR2_PACKAGE_MTD=y
    BR2_TARGET_ROOTFS_<格式>rootfs 文件系统格式与参数BR2_TARGET_ROOTFS_UBI=y
    BR2_TARGET_GENERIC_*系统通用行为BR2_TARGET_GENERIC_REMOUNT_ROOTFS_RW
    BR2_ROOTFS_OVERLAY追加 rootfs 覆盖目录BR2_ROOTFS_OVERLAY+="board/rockchip/common/base"
  2. 取值形式与统一规则相同:=y 启用、="str" 字符串、=数字、# ... is not set 关闭。

  3. #include "路径" 是片段包含指令,此处不是注释,构建时会被展开(见下)。

工作机制(已在 buildroot/scripts/parse_defconfig.sh 中核实):

  1. make rockchip_rk3506g_evb2_64m_minimal_defconfig 时,Makefile 调用 parse_defconfig.sh。
  2. 脚本递归解析 #include,路径先按 configs/<路径> 查找,找不到再按 configs/rockchip/<路径> 查找(因此 "base/base.config" 实际指向 configs/rockchip/base/base.config)。
  3. 用 merge_config.sh -m 按”先片段、后 defconfig”的顺序合并,后写的覆盖先写的,输出到 output/<板型>/.config,再交给 kconfig 展开依赖。

片段分层关系(自底向上,后者覆盖前者):

base/common.config                          通用基础(eudev、mount 工具等)
 └ base.config                              Rockchip 公共配置
    └ chips/rk3506.config → rk3506_arm.config   芯片与架构(如 BR2_arm=y)
       └ fs/vfat.config、ota/update_engine.config   功能片段
          └ 板级 defconfig                  最终覆盖(如关闭 dropbear、选择 ZSTD 压缩)

第 3 层:内核配置

作用:决定内核编译进哪些驱动和子系统。

文件:

  • 基础 defconfig:kernel/arch/arm/configs/rk3506_defconfig(约 358 行)
  • 板级片段:kernel/arch/arm/configs/rk3506-64m-minimal.config(约 31 行)

基础 defconfig 示例:

CONFIG_KERNEL_LZ4=y
CONFIG_PREEMPT=y
CONFIG_CC_OPTIMIZE_FOR_SIZE=y
# CONFIG_BUG is not set
CONFIG_ARCH_ROCKCHIP=y

片段示例(带注释说明每组开关对应的硬件):

# Display: DRM, VOP, MIPI-DSI, panel and backlight.
# CONFIG_DRM is not set
# CONFIG_ROCKCHIP_VOP is not set
# Audio framework and all dependent Rockchip codecs/interfaces.
# CONFIG_SOUND is not set

语法分析:

  1. 符号统一以 CONFIG_ 开头,取值形式:
    • CONFIG_X=y:编译进内核内置;
    • CONFIG_X=m:编译为可加载模块;
    • CONFIG_X="str" 或 CONFIG_X=0x10:字符串/数值参数;
    • # CONFIG_X is not set:显式关闭。
  2. defconfig 是精简清单,只记录与默认值不同的选项;构建时展开依赖后生成完整的 .config。
  3. 片段(fragment)与 defconfig 语法完全相同,只写差异项,文件内可用普通注释说明用途。

工作机制(已在 device/rockchip/common/scripts/mk-kernel.sh 中核实):

  1. SDK 执行 make rk3506_defconfig rk3506-64m-minimal.config,内核 Makefile 支持在 defconfig 目标后追加多个片段,内部用 scripts/kconfig/merge_config.sh 按顺序合并,后列片段覆盖前者。
  2. 若 RK_KERNEL_CFG_FRAGMENTS_BASIC=y,SDK 还会自动查找并叠加芯片基础片段(如 rk3506.config、rk3506_linux.config)。
  3. 合并后运行 olddefconfig 解决 Kconfig 依赖(如关闭 CONFIG_SOUND 会自动连带关闭所有音频驱动)。

这就是”一份内核、多份片段、多种板型”的实现方式:同一份 rk3506_defconfig 配不同片段即可得到标准版、64M 精简版、spinor 版等。

第 4 层:U-Boot 配置

作用:bootloader 功能选择,如启动介质、SPL、FIT 支持等。

文件:

  • 基础 defconfig:u-boot/configs/rk3506_defconfig
  • 板级片段:u-boot/configs/rk3506_tb.config(thunderboot 快速启动)

片段示例:

CONFIG_DEFAULT_DEVICE_TREE="rk3506-evb-tb"
CONFIG_OF_LIST="rk3506-evb-tb"
CONFIG_SPL_ADC_SUPPORT=y
CONFIG_SPL_ADC_KEY=y
# CONFIG_TPL is not set
# CONFIG_SPL_AB is not set

语法分析:与内核完全相同的 Kconfig 体系,但配置项按 U-Boot 的阶段和功能分类:

前缀/配置项含义
CONFIG_SPL_*SPL(二级引导器)阶段的功能,如 CONFIG_SPL_LOAD_FIT
CONFIG_TPL_*TPL(更早期的三级引导)阶段功能
CONFIG_TARGET_*板级目标选择,如 CONFIG_TARGET_EVB_RK3506
CONFIG_DEFAULT_DEVICE_TREEU-Boot 自身使用的设备树名
CONFIG_OF_LIST可打包进 FIT 的设备树列表
CONFIG_BOOTDELAY开机等待进入命令行的秒数

工作机制:U-Boot 同样用 merge_config.sh 合并 defconfig 与片段。RK_UBOOT_SPL=y 表示生成两级引导链:BootROM 加载 SPL,SPL 再加载完整 U-Boot。本例片段把 U-Boot 的设备树换成 rk3506-evb-tb、开启 SPL ADC 按键检测、关闭 TPL,实现快速启动。

第 5 层:设备树 DTS(硬件描述层)

作用:描述板子上有哪些外设、引脚、时钟、电源;内核依靠 compatible 字符串匹配驱动。同一个内核二进制更换 DTB 即可运行在不同板子上。

文件:板级入口 kernel/arch/arm/boot/dts/rk3506g-evb2-v10.dts:

/dts-v1/;

#include "rk3506.dtsi"
#include "rk3506-evb2-v10.dtsi"
#include "rk3506-rk816.dtsi"

/ {
	model = "Rockchip RK3506G(QFN128) EVB2 V10 Board";
	compatible = "rockchip,rk3506g-evb2-v10", "rockchip,rk3506";
};

语法分析:

  1. 文件结构:/dts-v1/; 声明格式版本;/ { ... }; 是根节点;编译前经过 C 预处理器,支持 #include 和 /* */、// 注释。

  2. 节点:[标签:] 名字[@单元地址] { ... };。标签供引用,单元地址须与 reg 属性的第一个地址一致。例如:

    uart0: serial@ff0a0000 {
        compatible = "rockchip,rk3506-uart", "snps,dw-apb-uart";
        reg = <0xff0a0000 0x100>;
        interrupts = <GIC_SPI 34 IRQ_TYPE_LEVEL_HIGH>;
        clocks = <&cru SCLK_UART0>, <&cru PCLK_UART0>;
    };
  3. 属性取值类型:

    类型语法示例
    字符串"..."model = "...";
    字符串列表逗号分隔compatible = "a", "b";
    cell 数组(32 位单元)<...>reg = <0xff0a0000 0x100>;
    phandle 引用<&标签 [参数...]>clocks = <&cru SCLK_UART0>;
    布尔属性只有名字wakeup-source;
    多段列表逗号分隔多个 <...>dmas = <&dmac0 4 ...>, <&dmac0 5 ...>;
  4. #address-cells 与 #size-cells:父节点用这两个属性声明子节点 reg 中”地址占几个 cell、长度占几个 cell”。RK3506 根节点为 #address-cells = <1>; #size-cells = <1>;,所以 reg = <0xff0a0000 0x100> 读作”地址 0xff0a0000,长度 0x100”。

  5. &标签 { } 覆盖语法:在任意位置用 &uart0 { status = "okay"; }; 修改已有节点,这是板级文件开关外设的主要手段。status 取 "okay"(启用)或 "disabled"(禁用)。

  6. 特殊节点:chosen 存放 bootargs(内核命令行);aliases 定义设备别名(如 ethernet0 = &gmac0)。

  7. compatible 匹配规则:字符串列表从具体到通用排列,内核驱动的 of_match_table 按顺序匹配第一个命中项。例如 uart0 先匹配 rockchip,rk3506-uart,失败再试通用的 snps,dw-apb-uart。

工作机制(分层包含):

rk3502.dtsi        SoC 级:所有 IP 寄存器定义(uart、i2c、gic、cru…)
 └ rk3506.dtsi     芯片级:display-subsystem、aliases 等
    └ rk3506-evb2-v10.dtsi   板级公共:chosen/bootargs、按键、背光、LED
       └ rk3506g-evb2-v10.dts   具体型号:只写 model/compatible 差异

注意:chosen 中的 bootargs 也是设备树的一部分,本例指定了 ubi.mtd=5 与 squashfs 根文件系统。

第 6 层:分区表 parameter(存储布局层)

作用:定义闪存分区与 loader 元信息,刷机工具和 U-Boot 都读取该文件。

文件:device/rockchip/rk3506/parameter-128M.txt:

FIRMWARE_VER:8.1
MACHINE_MODEL:RK3506
MACHINE_ID:007
MANUFACTURER: RK3506
MAGIC: 0x5041524B
ATAG: 0x00200800
MACHINE: 3506
CHECK_MASK: 0x80
PWR_HLD: 0,0,A,0,1
TYPE: GPT
GROW_ALIGN: 0
CMDLINE:mtdparts=:0x00003000@0x00002000(uboot),0x00000800@0x00005000(misc),0x00000200@0x00005800(vnvm),0x00007000@0x00005a00(recovery),0x00005000@0x0000ca00(boot),0x00020000@0x00011a00(rootfs),0x00008000@0x00031a00(oem),-@0x00039a00(userdata:grow)
uuid:rootfs=00000000-0000-0000-0000-000000000000

语法分析:

  1. 头部元信息:每行 键: 值,供 BootROM/loader 识别。MAGIC: 0x5041524B(即 ASCII “RKAP”)用于校验文件有效性;TYPE: GPT 指定分区表类型;MACHINE 是机器编号。

  2. CMDLINE 分区定义:格式为 mtdparts=<设备>:<分区>,<分区>,...,每个分区为:

    大小@起始偏移(分区名[:标志])
    • 大小与偏移是十六进制,单位是 512 字节扇区;
    • 大小写 - 表示占满剩余空间,常与 :grow 标志联用;
    • :ro 表示只读分区。
  3. 本例分区换算(128MB 闪存):

    分区扇区数实际大小起始偏移
    uboot0x30006 MiB2 MiB 处
    misc0x8001 MiB10 MiB 处
    vnvm0x200256 KiB11 MiB 处
    recovery0x700014 MiB11.25 MiB 处
    boot0x500010 MiB25.25 MiB 处
    rootfs0x2000064 MiB35.25 MiB 处
    oem0x800016 MiB99.25 MiB 处
    userdata剩余(grow)约 12.75 MiB115.25 MiB 处

工作机制:构建时按该文件生成 GPT 分区表并打包各分区镜像;刷机工具(Rockchip 量产工具/rkflash.sh)与 U-Boot 都解析同一份 CMDLINE,保证主机侧与板侧分区视图一致。

第 7 层:FIT 镜像 .its(打包层)

作用:把 kernel、DTB(可选 ramdisk)打包成带哈希或签名的 FIT(Flattened Image Tree)镜像,供 SPL/U-Boot 校验并加载。

文件:device/rockchip/rk3506/thunderboot.its(节选):

/dts-v1/;
/ {
    description = "U-Boot FIT source file for arm";

    images {
        fdt {
            data = /incbin/("@KERNEL_DTB@");
            type = "flat_dt";
            arch = "arm";
            compression = "none";
            load = <0x00063000>;
            hash { algo = "sha256"; };
        };
        kernel {
            data = /incbin/("@KERNEL_IMG@");
            type = "kernel";
            os = "linux";
            entry = <0x01100000>;
            load = <0x01100000>;
            hash { algo = "sha256"; };
        };
    };

    configurations {
        default = "conf";
        conf {
            fdt = "fdt";
            kernel = "kernel";
            signature {
                algo = "sha256,rsa2048";
                sign-images = "fdt", "kernel", "multi";
            };
        };
    };
};

语法分析:

  1. .its(FIT Image Tree Source)本身使用 DTS 语法,但语义不同:固定由 images 与 configurations 两个顶层节点组成。
  2. images 子节点:每个子节点是一个组件,常用属性:
    • data = /incbin/("文件"):DTS 预处理器指令,把二进制文件原样嵌入;
    • type:组件类型(kernel、flat_dt、ramdisk);
    • os:操作系统(仅 kernel 需要,取 "linux");
    • compression:压缩方式("none"、"gzip" 等);
    • load / entry:加载地址 / 入口地址,cell 数组;
    • hash { algo = "..."; }:完整性校验算法。
  3. configurations 子节点:定义”哪些组件组合成一套可启动镜像”,default 指定默认组合;signature 节点定义签名算法(如 sha256,rsa2048)与参与签名的组件(sign-images)。
  4. 占位符:@KERNEL_DTB@、@KERNEL_IMG@ 不是 FIT 语法,是 Rockchip 构建脚本的替换标记,打包前被替换为实际产物路径。

工作机制:构建脚本替换占位符后,用 U-Boot 自带的 mkimage -f xxx.its xxx.itb 编译生成 FIT 镜像;SPL/U-Boot 加载时先验证哈希/签名,再按 load、entry 地址摆放并启动内核。

构建串联流程

./build.sh lunch rockchip_rk3506_g_evb2_64m_minimal_defconfig
   → 复制到 output/defconfig,解析 RK_* 变量
   → U-Boot: rk3506_defconfig + rk3506_tb.config → idbLoader/uboot.img
   → Kernel: rk3506_defconfig + 64m-minimal 片段 → zImage + DTB
   → 按 thunderboot.its 打包 boot.img
   → Buildroot: rockchip_rk3506g_evb2_64m_minimal_defconfig → rootfs.ubi
   → 按 parameter-128M.txt 生成各分区镜像与 update.img → rockdev/

验证与注意事项

  • 确认当前构建目标的正确方式:读取 device/rockchip/.chip 软链接、output/defconfig 与 output/final.env,不要依据 SDK 根目录名推断 SoC。
  • 内核实际版本须读取内核顶层 Makefile,不要依据 kernel-6.1 等目录名推断。
  • 已发现的命名不一致:板级 defconfig 中 RK_KERNEL_DTS_NAME="rk3506g-evb2-v10-64m",但内核 arch/arm/boot/dts/Makefile 中只有 rk3506g-evb2-v10.dtb 与 rk3506g-evb1-v10-64m.dtb,不存在 rk3506g-evb2-v10-64m。修改或构建该配置前需先核对此项。
01_Learning · 文档目录
上一篇Register下一篇UART-Driver-Learning--01-UART-Driver-Error-Logs-and-Debug