2. Kconfig 数据类型：bool / tristate / string / hex / int 定义与使用场景

Kconfig 是 Linux 内核配置系统的核心语言，用于定义配置选项的数据类型、依赖关系和默认值。理解每种数据类型的语义与适用场景，是编写正确 Kconfig 文件、避免嵌入式配置故障的基础。

2.1 数据类型总览

Kconfig 支持五种基本数据类型，其核心差异在于可选值范围和编译行为：

2.2 数据类型定义语法与默认值设置

每种数据类型通过 default 关键字指定默认值。默认值可以是常量、另一个配置选项的引用，或条件表达式。

2.2.1 bool 类型

config FEATURE_FASTBOOT
    bool "Enable fast boot optimization"
    default y
    help
      Say Y here to enable fast boot sequence for embedded devices.
      This reduces kernel init time by skipping non-critical probes.

• 默认值： y 或 n。不写 default 时默认为 n。
• 使用场景： 功能级开关，如是否启用某种优化、是否包含某个调试接口。

2.2.2 tristate 类型

config DRIVER_I2C_GPIO
    tristate "GPIO-based I2C driver"
    default m
    depends on GPIOLIB
    help
      This driver supports I2C bus over GPIO pins.
      Can be built as module (m) or built-in (y).

• 默认值： y / m / n。不写 default 时默认为 n。
• 使用场景： 驱动或子系统同时支持静态编译和模块加载的场景。
• 依赖约束： 如果父选项是 bool，子选项的 tristate 会被强制降级为 bool。

2.2.3 string 类型

config DTB_PATH
    string "Device Tree Blob path"
    default "/boot/dtb/kernel.dtb"
    help
      Specify the full path to the device tree blob file
      used by the bootloader.

• 默认值： 双引号包裹的字符串，如 "default_value"。
• 使用场景： 文件路径、设备名称、IP 地址、日志前缀等可变文本。

2.2.4 hex 类型

config UART_BASE_ADDR
    hex "UART controller base address"
    default 0x10000000
    range 0x10000000 0x1FFFFFFF
    help
      Base address of the UART controller in the memory map.
      Must be within the peripheral address range.

• 默认值： 十六进制数，不加 0x 前缀（Kconfig 自动按十六进制解析）。
• range 约束： 使用 range 关键字限定合法区间，防止配置越界。
• 使用场景： 硬件寄存器地址、DMA 通道掩码、内存映射基址。

2.2.5 int 类型

config RX_RING_SIZE
    int "RX ring buffer size (entries)"
    default 256
    range 64 4096
    help
      Number of entries in the receive ring buffer.
      Must be a power of 2 for optimal performance.

• 默认值： 十进制整数。
• range 约束： 同样支持 range 限定范围。
• 使用场景： 缓冲区大小、超时秒数、最大连接数、采样率等数值参数。

2.3 数据类型选择决策流程

以下 SVG 流程图帮助开发者在编写 Kconfig 时快速确定数据类型：

2.4 默认值的高级用法

default 支持条件表达式，使配置选项的默认值随平台或依赖选项动态变化：

config CACHE_LINE_SIZE
    int "Cache line size (bytes)"
    default 64 if ARM64
    default 32 if ARM
    default 64
    range 16 256
    help
      Default cache line size varies by architecture.

• 条件默认值： 使用 if 后缀，Kconfig 按顺序匹配第一个条件为真的默认值。
• 回退默认值： 最后一个不带条件的 default 作为全局回退。
• 覆盖规则： 用户显式配置的值始终优先于任何默认值。

2.5 数据类型与依赖关系

数据类型影响依赖传播行为。以下表格总结了关键规则：

2.6 数据类型与 menuconfig 界面呈现

不同数据类型在 menuconfig / nconfig 界面中的交互方式不同：

• bool： 显示为 [ ] 复选框，按空格切换 y/n。
• tristate： 显示为 < > 三态选择，按空格循环 y → m → n。
• string： 显示为 ( ) 输入框，直接键入字符串。
• hex： 显示为 [ ] 输入框，输入十六进制数（可带 0x 前缀）。
• int： 显示为 [ ] 输入框，输入十进制整数。

理解这些交互细节，有助于在嵌入式调试时快速通过 make menuconfig 定位配置项。

2.7 本章小结