嵌入式 Linux 与 RTOS / 系统课时

读懂 Kconfig 与 Kbuild

读懂 Kconfig 与 Kbuild

自定义驱动能否被用户选中、最终又以 built-in 还是模块形式进入内核,分别由 Kconfig 和 Kbuild 决定。本课沿一条驱动的配置符号、依赖关系和对象规则向下追踪,并完成一个最小可维护入口。

学习目标

  • 能从 Kconfig 读出配置符号的类型、依赖和可见条件。
  • 能解释 obj-y、obj-m 与 obj-$(CONFIG_...) 如何决定编译结果。
  • 能为一个新驱动补齐 Kconfig、Makefile 入口并验证配置与构建路径。

Kconfig 决定“能不能选”

Kconfig 描述的是配置模型,不负责真正编译。一个 config 块定义配置符号,常见类型有 bool、tristate、string、int 和 hex。驱动通常使用 tristate,这样符号可以取 y、m 或 n。

下面是片段示例,假设驱动文件位于 drivers/misc/demo_sensor.c,并且驱动依赖 I2C 子系统:

text
config DEMO_SENSOR
    tristate "Demo I2C sensor"
    depends on I2C
    help
      Enable support for the Demo I2C sensor.

depends on I2C 会把 I2C 作为必要条件;当依赖不满足时,该选项通常不会进入可选状态。select 则是反向强制打开另一个符号,容易绕过被选中符号自身的依赖,因此驱动入口应优先使用 depends on 表达真实前提。

Kbuild 决定“编进哪里”

同目录的 Makefile 由 Kbuild 读取。最常见规则是把配置符号直接映射到目标对象:

makefile
obj-$(CONFIG_DEMO_SENSOR) += demo_sensor.o

当 .config 中是 CONFIG_DEMO_SENSOR=y 时,上式展开成 obj-y += demo_sensor.o,目标进入内核内建对象;当值为 m 时展开成 obj-m += demo_sensor.o,最终生成可加载模块。若直接写 obj-y += demo_sensor.o,则不再受该配置符号控制。

复杂驱动可先把多个源文件聚合成一个复合目标。例如下面是片段示例,依赖同目录存在 demo_core.c 与 demo_bus.c:

makefile
obj-$(CONFIG_DEMO_SENSOR) += demo_sensor.o
demo_sensor-y := demo_core.o demo_bus.o

这里的 demo_sensor.o 是逻辑聚合目标,不要求存在同名源文件。Kbuild 会把两个子对象链接后,再按 y 或 m 放入对应产物。

一条驱动进入构建系统的路径

Kconfig 与 Kbuild 通过同一个 CONFIG_DEMO_SENSOR 串起来:上层 Kconfig 负责 source 到驱动目录,用户选择后写入 .config,Kbuild 再读取配置值并展开 obj-* 规则。

Kconfig 到 Kbuild 的驱动构建链路

如果新增的是一个目录,还要检查父目录的两处入口是否同时存在。例如父级 Kconfig 需要 source "drivers/misc/Kconfig",父级 Kbuild 需要通过对应 obj-* 规则进入该目录;缺任意一处,都可能出现“能配置但不编译”或“目录永远不可达”。

补齐并验证最小入口

把上面的 config DEMO_SENSOR 加入合适的 Kconfig,再把 obj-$(CONFIG_DEMO_SENSOR) 加入同目录 Makefile 后,可以用内核自带脚本非交互地打开依赖与驱动选项。以下命令需在 Linux 内核源码根目录执行:

bash
scripts/config --enable I2C
scripts/config --enable DEMO_SENSOR
make olddefconfig
grep -E 'CONFIG_(I2C|DEMO_SENSOR)=' .config

预期输出:

text
CONFIG_I2C=y
CONFIG_DEMO_SENSOR=y

如果第二行变回 n 或消失,说明依赖、符号定义或 Kconfig 引用路径仍有问题。配置正确后再执行目标架构的实际构建;交叉编译器前缀、架构与输出目录应按项目设置,不能只凭 menuconfig 中能看到选项就认为驱动已经进入产物。

常见断点怎么定位

遇到驱动未进入镜像或模块时,按“配置定义 → .config → Kbuild 展开 → 目标文件”顺序检查最省时间。先确认 grep CONFIG_DEMO_SENSOR .config 的结果,再检查 Makefile 是否拼写一致,最后观察对应 .o 或 .ko 是否生成。

尤其要避免配置符号重名、Kconfig 已定义但未被上级 source、Makefile 使用了不同符号名,以及把应当可选的驱动直接写死到 obj-y。Kconfig 与 Kbuild 的关键不是记语法,而是保证同一个配置符号从可见条件一直贯通到最终对象规则。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

读懂 Kconfig 与 Kbuild

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通