📚 课程目录第4章 Kconfig与Makefile

4. Kconfig与Makefile：配置系统原理、如何添加新板级支持、编译流程

U-Boot 的配置与编译系统是其高度可移植性的核心支柱。本章深入剖析 Kconfig 与 Makefile 的协作机制，讲解如何为一块新板卡添加板级支持，并梳理完整的编译流程。理解这些原理，是进行 DDR 初始化参数调整和设备树适配的前提。

4.1 配置系统架构：Kconfig 与 Makefile 的分工

U-Boot 采用类似 Linux 内核的配置系统，由 Kconfig 和 Makefile 两大组件协同工作：

Kconfig：定义配置选项的菜单结构、依赖关系和默认值。开发者通过 make menuconfig 等工具进行可视化配置，最终生成 .config 文件。
Makefile：读取 .config 中的变量，决定哪些源文件被编译、哪些功能被启用，并控制链接过程。

下图展示了从配置到编译的完整数据流：

关键理解：Kconfig 定义“有哪些选项”，defconfig 提供“某板卡的默认值”，menuconfig 提供“交互式修改界面”，.config 是“最终配置快照”，Makefile 则根据 .config 执行“条件编译”。

4.2 Kconfig 层级结构与配置项定义

U-Boot 的 Kconfig 文件分布在各个子目录中，形成树状层级。顶层 Kconfig 通过 source 语句引入子目录的 Kconfig：

# 顶层 Kconfig (arch/../Kconfig)
source "arch/Kconfig"
source "board/Kconfig"
source "drivers/Kconfig"
source "cmd/Kconfig"
# ...

一个典型的板级配置项定义如下：

# board/vendor/myboard/Kconfig
config TARGET_MYBOARD
    bool "Support myboard"
    select CPU_V7A
    select SYS_ARCH "arm"
    select SYS_SOC "my_soc"
    help
      This is a custom board for evaluation.

配置项常用属性：

属性	说明	示例
bool / tristate	布尔值或三态（y/n/m）	`bool "Enable feature X"`
select	选中本项时自动选中其他项	`select DM_SERIAL`
depends on	依赖某个配置项	`depends on ARM64`
default	默认值	`default y`
help	帮助文本	`help\n This option ...`

4.3 添加新板级支持的完整步骤

假设我们要为一块基于 ARM Cortex-A7、SoC 为 my_soc 的板卡 myboard 添加支持，需要创建以下文件结构：

创建板级目录：board/vendor/myboard/，存放板级初始化代码（如 myboard.c、lowlevel_init.S）。
创建 Kconfig 文件：board/vendor/myboard/Kconfig，定义 TARGET_MYBOARD 并关联 SoC 和架构。
创建 defconfig 文件：configs/myboard_defconfig，包含该板卡的默认配置。
创建 MAINTAINERS 条目：在 board/vendor/myboard/MAINTAINERS 中记录维护者信息。
创建设备树文件：arch/arm/dts/myboard.dts 及其 .dtsi 包含文件。
修改顶层 Kconfig：在 arch/arm/Kconfig 的 source 语句中添加 source "board/vendor/myboard/Kconfig"。
修改 Makefile：在 board/vendor/myboard/Makefile 中添加编译目标。

下图展示了新板卡文件之间的依赖关系：

4.4 defconfig 文件详解

defconfig 文件是板卡的配置“快照”，只记录与默认值不同的选项。一个典型的 defconfig 内容如下：

# configs/myboard_defconfig
CONFIG_ARM=y
CONFIG_TARGET_MYBOARD=y
CONFIG_SYS_TEXT_BASE=0x87800000
CONFIG_SYS_MALLOC_F_LEN=0x4000
CONFIG_NR_DRAM_BANKS=1
CONFIG_DM=y
CONFIG_DM_SERIAL=y
CONFIG_BAUDRATE=115200
CONFIG_BOOTDELAY=3
# CONFIG_DISPLAY_CPUINFO is not set

注意：defconfig 中 # CONFIG_XXX is not set 表示显式关闭该选项。不要遗漏关键选项如 CONFIG_TARGET_MYBOARD，否则 Kconfig 无法正确解析板级依赖。

4.5 Makefile 编译流程解析

U-Boot 的编译流程分为三个阶段：

阶段	命令	输出	说明
配置	`make myboard_defconfig`	.config	将 defconfig 复制为 .config，并调用 Kconfig 解析依赖
预处理	`make oldconfig` / `make menuconfig`	include/autoconf.mk	将 .config 转换为 Makefile 可用的宏定义
编译	`make`	u-boot.bin / u-boot.img	递归调用各子目录 Makefile，最终链接生成镜像

顶层 Makefile 的核心逻辑：

# 顶层 Makefile 简化逻辑
include include/autoconf.mk   # 包含配置宏

# 根据 CONFIG_TARGET_MYBOARD 决定是否编译板级目录
libs-y += board/vendor/myboard/

# 递归编译所有 libs-y 目录
$(BUILD_DIR)/u-boot: $(libs-y) $(head-y)
    $(LD) -T u-boot.lds -o $@ $^

板级目录内的 Makefile 示例：

# board/vendor/myboard/Makefile
obj-y += myboard.o
obj-y += lowlevel_init.o

4.6 编译流程的完整步骤图

以下 SVG 图展示了从执行 make 到生成最终镜像的完整流程：

4.7 常见问题与调试技巧

  问题1：执行 make myboard_defconfig 报错 "Can't find file"。

  解决：检查 configs/ 目录下文件名是否完全匹配，注意大小写。同时确认 arch/arm/Kconfig 中已添加 source 语句。

  问题2：编译时提示 undefined reference 到板级函数。

  解决：检查 board/vendor/myboard/Makefile 中 obj-y 是否包含了所有 .o 文件，以及函数名是否与 myboard.c 中定义的一致。

调试技巧：使用 make V=1 可以输出详细的编译命令，帮助定位文件未编译或链接顺序错误。使用 make savedefconfig 可以从当前 .config 生成最小化的 defconfig。

4.8 本章小结

Kconfig 与 Makefile 构成了 U-Boot 配置编译系统的骨架。添加新板级支持的核心在于：

在 Kconfig 中定义板级选项并建立依赖链。
在 defconfig 中提供板级默认配置。
在 Makefile 中确保板级代码被正确编译和链接。