嵌入式Linux内核Kconfig配置与编译优化工程 - 第2节

2. Kconfig语法入门

Kconfig 是 Linux 内核配置系统的描述语言，用于定义内核功能的开关选项、依赖关系和默认值。每个 Kconfig 文件由一系列配置条目组成，每个条目以 config 关键字开头，后跟选项名称和属性定义。理解 Kconfig 语法是进行内核裁剪和定制的基础。

2.2 config 关键字：定义配置选项

config 是 Kconfig 中最核心的关键字，用于声明一个配置选项。其基本语法结构如下：

config <选项名称>
    <属性1> <值1>
    <属性2> <值2>
    ...

选项名称通常使用大写字母和下划线，例如 CONFIG_USB_SUPPORT。当该选项被选中后，在内核编译时会在 autoconf.h 中生成对应的宏定义。

config MY_FEATURE
    bool "Enable My Feature"
    default y
    help
      This option enables a custom feature for demonstration.

配置选项可以嵌套依赖，通过 depends on 关键字控制可见性。只有依赖条件满足时，该选项才会出现在配置菜单中。

2.3 类型详解：bool / tristate / string / hex / int

Kconfig 支持五种基本数据类型，每种类型决定了配置选项的取值方式和用户交互界面。下表列出了各类型的核心差异：

2.3.1 bool 类型

bool 是最简单的类型，只有两种状态：y（选中）或 n（未选中）。在配置界面中显示为复选框。适用于纯粹的开关功能，例如是否启用某个调试特性。

config DEBUG_PRINT
    bool "Enable debug print messages"
    default n
    help
      Say Y here to enable verbose debug output.

2.3.2 tristate 类型

tristate 是内核模块化机制的核心类型，支持三种状态：

• y：编译进内核（built-in）
• m：编译为可加载模块（module）
• n：不编译（disabled）

驱动开发者通常使用 tristate，让用户灵活选择驱动是内置还是模块化加载。

config USB_STORAGE
    tristate "USB Mass Storage support"
    depends on USB
    default m
    help
      Say Y here to build USB storage driver into kernel,
      or M to build it as a module.

2.3.3 string 类型

string 用于接收用户输入的任意文本，常用于配置设备路径、固件名称、命令行参数等。

config ROOT_DEVICE
    string "Root filesystem device"
    default "/dev/mmcblk0p2"
    help
      Specify the block device for root filesystem.

2.3.4 hex 类型

hex 用于输入十六进制数值，用户输入时不需要手动加 0x 前缀，Kconfig 会自动处理。常用于配置基地址、中断号、掩码等硬件参数。

config UART_BASE_ADDR
    hex "UART base address"
    default 0x10000000
    range 0x10000000 0x1FFFFFFF
    help
      Memory-mapped base address of the UART controller.

2.3.5 int 类型

int 用于输入十进制整数，可以配合 range 关键字限定取值范围。

config MAX_USERS
    int "Maximum number of concurrent users"
    default 10
    range 1 1000
    help
      Set the upper limit for user sessions.

2.4 default 默认值设置

default 关键字用于指定配置选项的默认值。当用户未手动修改配置时，系统使用该默认值。默认值可以是一个常量，也可以是表达式，甚至可以引用其他配置选项的值。

2.4.1 基本默认值

config LOG_LEVEL
    int "Kernel log level"
    default 7
    range 0 15

2.4.2 条件默认值

通过 default 配合 if 条件，可以根据其他选项的状态设置不同的默认值：

config BUFFER_SIZE
    int "Buffer size (KB)"
    default 64 if LOW_MEMORY
    default 256 if HIGH_PERFORMANCE
    default 128

条件默认值的匹配规则：从上到下依次检查，第一个满足条件的 default 生效；如果所有条件都不满足，则使用无条件的 default。

2.4.3 默认值引用其他选项

默认值可以引用另一个配置选项的值，实现联动：

config CACHE_SIZE
    int "Cache size"
    default 512

config CACHE_LINE
    int "Cache line size"
    default CACHE_SIZE / 8

2.5 综合示例：一个完整的 Kconfig 片段

下面展示一个包含多种类型和默认值设置的完整 Kconfig 示例，模拟嵌入式设备中音频子系统的配置：

menu "Audio Subsystem"

config AUDIO_SUPPORT
    bool "Audio support"
    default y
    help
      Enable audio subsystem for the embedded device.

if AUDIO_SUPPORT

config AUDIO_DRIVER
    tristate "Audio driver"
    default m
    help
      Audio driver for I2S codec.

config AUDIO_BUFFER_SIZE
    int "Audio buffer size (samples)"
    default 1024
    range 256 4096

config AUDIO_SAMPLE_RATE
    hex "Sample rate register value"
    default 0xBB80
    help
      Hex value for 48000 Hz sample rate.

config AUDIO_DEVICE_NAME
    string "Audio device name"
    default "snd-soc-audio"

endif # AUDIO_SUPPORT

endmenu

该示例展示了：

• 使用 menu 和 endmenu 组织配置菜单层次
• if 条件块控制子选项的可见性
• 五种类型各出现一次，覆盖完整场景
• 每个选项都设置了合理的默认值

2.6 常见错误与避坑指南