文章目录

在这里插入图片描述

每日一句正能量

承认并接纳作为一个人所拥有的全部光明和阴影，这才是真正的爱自己。
爱自己不是只爱那个优秀的、得体的、阳光的部分，而是连自己的嫉妒、懒惰、脆弱、阴暗面也一并接纳。不评判、不割裂、不假装完美。完整比完美更重要——当你敢于面对全部的自己，才真正与自己和解。

前言

在前一篇 HAL 架构设计的文章中，我们探讨了如何通过分层抽象实现驱动的可移植性。然而，可移植性不仅体现在代码结构上，更体现在配置管理上。同一套 HAL 代码如何在不同硬件平台、不同功能需求、不同资源约束之间灵活裁剪？如何在 STM32H7（480MHz，2MB Flash）和 nRF52840（64MHz，1MB Flash）之间无缝切换？如何在"全功能版"和"最小功耗版"之间快速构建？本文将系统阐述如何将 Linux 内核成熟的 Kconfig 配置系统移植到裸机/RTOS 嵌入式固件中，实现声明式、可视化的菜单配置管理，彻底解决条件编译与依赖管理的工程难题。

一、为什么嵌入式固件需要 Kconfig

1.1 传统条件编译的痛点

在缺乏配置管理系统的小型嵌入式项目中，条件编译通常这样实现：

// 散落在各处的宏定义
#define USE_UART        1
#define USE_SPI         1
#define USE_I2C         0
#define UART_BAUDRATE   115200
#define SENSOR_TYPE     BMP280
// ... 数十个宏定义散布在十几个头文件中

这种方式的问题：

  • 配置分散：宏定义散落在各个头文件中，难以统一管理
  • 依赖混乱：USE_LORA 依赖 USE_SPI 和 USE_FREERTOS，但没有机制强制这种依赖
  • 无验证机制：可以编译出 USE_LORA=1 但 USE_SPI=0 的无效配置
  • 不可视化：新成员无法直观了解有哪些配置选项及其关系
  • 版本管理困难：.h 文件的修改历史混杂了配置变更与代码变更

1.2 Kconfig 的核心价值

Kconfig 是 Linux 内核的配置描述语言，配合 menuconfig/guiconfig 等前端工具，提供了：

  1. 声明式配置：用结构化语法描述配置项、类型、默认值、依赖关系
  2. 可视化交互：菜单树形界面，支持搜索、跳转、帮助查看
  3. 依赖自动求解：depends on / select / imply 自动处理选项间的逻辑关系
  4. 多配置管理：defconfig 机制支持多板型、多场景的快速配置切换
  5. 构建系统集成：自动生成 autoconf.h 和 config.mk，无缝接入 Makefile 条件编译

Kconfig 的工作本质上是通过条件编译和宏定义来实现系统的裁剪配置，采用树形结构组织，分散在各级源代码目录中，根目录下的顶层 Kconfig 文件通过 source 语句显式地包含其他子目录的 Kconfig 文件，从而聚合所有配置项 。

二、Kconfig 配置系统工作流程

2.1 完整工作链路

Kconfig 配置系统的工作流程可以概括为五个阶段 ：

在这里插入图片描述

阶段 1：配置输入（Kconfig 文件）
Kconfig 文件采用树形结构组织，分散在系统的各级源代码目录中。顶层 Kconfig 通过 source 语句显式包含子目录的 Kconfig 文件，使得配置项可以就近管理 。

阶段 2：图形化配置（menuconfig）
执行 menuconfig 命令后，系统递归解析所有 Kconfig 文件，启动基于 ncurses 的图形化配置界面。用户通过菜单选择需要的功能，并设置相关参数。

阶段 3：生成 .config
配置完成后保存，在工程根目录下生成 .config 文件，以键值对形式记录所有选择（例如 CONFIG_DRV_UART=y）。

阶段 4：生成 autoconf.h
构建系统调用 syncconfig 工具，将 .config 自动转换为 autoconf.h 头文件，包含所有对应的宏定义（例如 #define CONFIG_DRV_UART 1）。

阶段 5：条件编译
源码中广泛使用 #ifdef、#ifndef 等预处理指令判断 autoconf.h 中的宏定义。只有被启用的模块才会编译到最终固件中，实现系统的精确裁剪 。

2.2 配置工具链

Linux 内核提供了多种配置前端工具 ：

工具 命令 依赖 适用场景
mconf make menuconfig ncurses 最常用，终端菜单界面
nconf make nconfig ncurses 新版界面，快捷键丰富
qconf make xconfig Qt5 图形窗口，鼠标操作
gconf make gconfig GTK+ GTK图形界面
conf make config 无 命令行逐条问答（不推荐）
oldconfig make oldconfig 无 基于现有配置更新
defconfig make defconfig 无 加载默认配置
savedefconfig make savedefconfig 无 导出最小化配置

三、Kconfig 核心语法与依赖管理

3.1 基础配置语法

Kconfig 支持多种配置类型，每种类型对应不同的用户交互方式和输出格式 ：

# === 布尔选项 ===
config USE_UART
    bool "Enable UART driver"
    default y
    help
      Enable the UART peripheral driver for console output.

# === 数值选项 ===
config UART_BAUDRATE
    int "UART baudrate"
    default 115200
    range 9600 921600
    depends on USE_UART

# === 字符串选项 ===
config UART_PORT_NAME
    string "UART device name"
    default "uart0"
    depends on USE_UART

# === 三态选项 (y/m/n) ===
config DRV_SPI
    tristate "SPI driver support"
    default y
    help
      y=builtin, m=module, n=disabled
      For bare-metal firmware, m is equivalent to n.

# === 多选一 ===
choice
    prompt "RTOS selection"
    default USE_FREERTOS
    config USE_FREERTOS
        bool "FreeRTOS"
    config USE_RTTHREAD
        bool "RT-Thread"
    config USE_BAREMETAL
        bool "Bare metal (no RTOS)"
endchoice

3.2 依赖管理机制

Kconfig 提供了四种依赖控制机制 ：

机制 语法 作用 使用建议
正向依赖 depends on 子选项依赖父选项，父关闭时子隐藏 首选方式，逻辑清晰
自动选中 select 选中A时自动选中B 慎用，注意依赖传递
弱建议 imply 默认选中但允许用户关闭 推荐替代select
条件块 if/endif 一组选项共享依赖 减少重复depends

depends on vs select 的最佳实践：

# ✅ 推荐：使用 depends on
config USE_LORA
    bool "Enable LoRaWAN communication"
    depends on USE_SPI
    depends on USE_FREERTOS
    help
      LoRaWAN requires SPI for SX1262 and FreeRTOS for stack.

# ⚠️ 慎用：select 可能导致依赖传递问题
config USE_LORA
    bool "Enable LoRaWAN communication"
    select USE_SPI
    select USE_FREERTOS

select 的陷阱在于：如果 USE_SPI 后续增加了新的依赖（如 depends on HAS_DMA），那么 USE_LORA 也需要同步更新依赖，否则可能生成无效配置 。因此，官方推荐优先使用 depends on，仅在辅助符号（无提示符的隐藏选项）上使用 select。

在这里插入图片描述

四、嵌入式固件 Kconfig 实战：工业传感器节点

4.1 完整 Kconfig 配置示例

以下是一个工业传感器节点固件的完整 Kconfig 配置，展示了从硬件平台到应用功能的完整配置树：

# firmware/Kconfig
mainmenu "Industrial Sensor Node Configuration"

menu "Hardware Platform"
    choice
        prompt "Target MCU"
        default MCU_STM32H7
        config MCU_STM32H7
            bool "STM32H743 (480MHz, 2MB Flash)"
        config MCU_NRF52840
            bool "nRF52840 (64MHz, 1MB Flash)"
    endchoice

    config HSE_VALUE
        int "External crystal frequency (kHz)"
        default 25000 if MCU_STM32H7
        default 32000 if MCU_NRF52840
        range 4000 50000
        help
          External high-speed crystal frequency in kHz.
endmenu

menu "Sensor Subsystem"
    config USE_SENSOR
        bool "Enable sensor subsystem"
        default y
        select DRV_I2C
        select DRV_GPIO
        help
          Enable temperature/humidity/pressure sensor reading.

    if USE_SENSOR
        choice
            prompt "Primary sensor"
            config SENSOR_BMP280
                bool "BMP280 (Temperature/Pressure)"
            config SENSOR_SHT30
                bool "SHT30 (Temperature/Humidity)"
        endchoice

        config SENSOR_POLL_INTERVAL_MS
            int "Sensor polling interval (ms)"
            default 1000
            range 100 60000
            help
              How often to read sensor data.
    endif
endmenu

menu "Communication"
    config USE_LORA
        bool "Enable LoRaWAN communication"
        select DRV_SPI
        select USE_FREERTOS
        help
          Long-range wireless communication via LoRaWAN.

    config LORA_FREQ
        int "LoRa frequency (MHz)"
        default 470
        range 400 960
        depends on USE_LORA
        help
          Regional frequency: CN470=470, EU868=868, US915=915.
endmenu

4.2 生成的 autoconf.h

运行 make menuconfig 并保存后，生成的 autoconf.h 如下：

/* Auto-generated by Kconfig - DO NOT EDIT */
#ifndef __AUTOCONF_H__
#define __AUTOCONF_H__

/* Hardware Platform */
#define CONFIG_MCU_STM32H7 1
#define CONFIG_HSE_VALUE 25000

/* Sensor Subsystem */
#define CONFIG_USE_SENSOR 1
#define CONFIG_SENSOR_BMP280 1
#define CONFIG_SENSOR_POLL_INTERVAL_MS 1000

/* Communication */
#define CONFIG_USE_LORA 1
#define CONFIG_LORA_FREQ 470

/* Auto-selected dependencies */
#define CONFIG_DRV_I2C 1
#define CONFIG_DRV_GPIO 1
#define CONFIG_DRV_SPI 1
#define CONFIG_USE_FREERTOS 1

/* Unselected options are absent */
/* #undef CONFIG_MCU_NRF52840 */
/* #undef CONFIG_SENSOR_SHT30 */

#endif /* __AUTOCONF_H__ */

4.3 源码中的条件编译应用

#include "autoconf.h"
#include "hal_i2c.h"

#ifdef CONFIG_USE_SENSOR
    #ifdef CONFIG_SENSOR_BMP280
        #include "drivers/bmp280.h"
        static bmp280_dev_t g_sensor;
    #elif defined(CONFIG_SENSOR_SHT30)
        #include "drivers/sht30.h"
        static sht30_dev_t g_sensor;
    #endif

    void sensor_init(void) {
        #ifdef CONFIG_SENSOR_BMP280
            bmp280_init(&g_sensor, BMP280_I2C_ADDR);
        #elif defined(CONFIG_SENSOR_SHT30)
            sht30_init(&g_sensor, SHT30_I2C_ADDR);
        #endif
    }

    void sensor_poll(void) {
        static uint32_t last_tick = 0;
        if (hal_get_tick() - last_tick >= CONFIG_SENSOR_POLL_INTERVAL_MS) {
            last_tick = hal_get_tick();
            #ifdef CONFIG_SENSOR_BMP280
                bmp280_read(&g_sensor);
            #elif defined(CONFIG_SENSOR_SHT30)
                sht30_read(&g_sensor);
            #endif
        }
    }
#endif /* CONFIG_USE_SENSOR */

#ifdef CONFIG_USE_LORA
    #include "lora/sx1262.h"
    static sx1262_dev_t g_lora;

    void lora_init(void) {
        sx1262_init(&g_lora, CONFIG_LORA_FREQ);
    }
#endif

在这里插入图片描述

五、Kconfig 与 Makefile/Kbuild 集成

5.1 顶层 Makefile 设计

Kconfig 必须与构建系统深度集成，才能实现"配置即编译"的效果 。

# 顶层 Makefile
KCONFIG_CONFIG ?= .config

# 1. 生成 autoconf.h
autoconf.h: $(KCONFIG_CONFIG)
	@echo "Generating autoconf.h..."
	$(Q)scripts/kconfig/syncconfig $(KCONFIG_CONFIG)

# 2. 包含生成的配置
-include .config
include scripts/config.mk

# 3. 条件编译源文件列表
obj-y += startup/
obj-y += hal/
obj-y += bsp/

# 条件编译：仅当配置选中时加入
obj-$(CONFIG_USE_SENSOR) += drivers/sensor/
obj-$(CONFIG_USE_LORA)   += drivers/lora/
obj-$(CONFIG_USE_FREERTOS) += middleware/freertos/
obj-$(CONFIG_USE_LWIP)   += middleware/lwip/

# 4. 子目录递归编译
subdir-y := $(patsubst %/,%,$(obj-y))

all: autoconf.h
	$(MAKE) -C $(subdir-y)

# 5. menuconfig目标
menuconfig:
	$(Q)scripts/kconfig/mconf Kconfig

# 6. 默认配置
defconfig:
	$(Q)scripts/kconfig/conf --defconfig=configs/stm32h7_defconfig Kconfig

5.2 子目录 Kbuild/Makefile

# drivers/sensor/Makefile

# 通用源文件（始终编译）
obj-y += sensor_core.c
obj-y += sensor_hal.c

# 条件编译：根据Kconfig选择传感器驱动
obj-$(CONFIG_SENSOR_BMP280) += bmp280.c
obj-$(CONFIG_SENSOR_SHT30) += sht30.c
obj-$(CONFIG_SENSOR_MPU6050) += mpu6050.c

# 条件编译：根据平台选择接口
ifeq ($(CONFIG_MCU_STM32H7),y)
    obj-y += bmp280_stm32.c
    ccflags-y += -DBMP280_USE_DMA
else ifeq ($(CONFIG_MCU_NRF52840),y)
    obj-y += bmp280_nrf.c
    ccflags-y += -DBMP280_USE_TWIM
endif

# 条件编译：调试支持
ifeq ($(CONFIG_DEBUG_SENSOR),y)
    ccflags-y += -DSENSOR_DEBUG_LEVEL=$(CONFIG_SENSOR_DEBUG_LEVEL)
    obj-y += sensor_debug.c
endif

关键机制解析：

  • obj-$(CONFIG_XXX)：当 CONFIG_XXX=y 时，展开为 obj-y，源文件被编译进固件；当 CONFIG_XXX=n 时，展开为空，源文件被排除
  • ccflags-y：条件编译时传递的 C 编译器标志，用于控制代码内部的 #ifdef 分支
  • syncconfig：Kconfig 提供的配置同步工具，将 .config 转换为 autoconf.h 和 config.mk

在这里插入图片描述

六、多板型配置管理与版本控制

6.1 配置目录结构设计

在支持多硬件平台的项目中，配置管理需要分层设计：

configs/
├── stm32h7_defconfig       # STM32H743默认配置
├── stm32h7_minimal.config  # 最小功能配置（低功耗场景）
├── stm32h7_full.config     # 全功能配置（评估板）
├── nrf52840_defconfig      # nRF52840默认配置
├── custom_v1.config        # 客户定制版本V1
├── custom_v2.config        # 客户定制版本V2
└── factory_test.config     # 工厂测试模式配置

boards/
├── nucleo_h743/
│   └── board.config        # Nucleo板级覆盖配置
├── custom_evboard/
│   └── board.config
└── ...

.gitignore:
# 忽略自动生成的配置
.config
autoconf.h
config.mk
# 但保留defconfig
!configs/*_defconfig

6.2 defconfig 机制

defconfig 是 Kconfig 的"最小配置导出"功能，仅记录与默认值不同的配置项，极大简化了版本管理 ：

# 从当前配置导出最小化defconfig
make savedefconfig
# 生成 defconfig 文件，仅包含非默认配置

# 加载defconfig并生成完整配置
make defconfig DEFCONFIG=configs/stm32h7_defconfig

stm32h7_defconfig 示例：

# STM32H743 默认配置
# 最小可用配置，仅包含核心功能

CONFIG_MCU_STM32H7=y
CONFIG_HSE_VALUE=25000

# 驱动
CONFIG_DRV_UART=y
CONFIG_DRV_GPIO=y
CONFIG_DRV_I2C=y
# CONFIG_DRV_SPI is not set
# CONFIG_DRV_DMA is not set

# 传感器
CONFIG_USE_SENSOR=y
CONFIG_SENSOR_BMP280=y
# CONFIG_SENSOR_SHT30 is not set
CONFIG_SENSOR_POLL_INTERVAL_MS=1000

# 通信
# CONFIG_USE_LORA is not set
# CONFIG_USE_ETHERNET is not set

# RTOS
CONFIG_USE_FREERTOS=y
CONFIG_FREERTOS_HEAP_SIZE=32768

# 调试
CONFIG_DEBUG=y
CONFIG_LOG_LEVEL=2

6.3 配置合并策略

在实际项目中，常常需要"默认配置 + 板级覆盖 + 本地调试"三层合并：

#!/bin/bash
# scripts/merge_config.sh - 配置合并脚本

merge_config() {
    DEFCONFIG=$1      # 默认配置
    BOARD_CONFIG=$2   # 板级覆盖配置
    
    # 1. 加载默认配置
    make defconfig DEFCONFIG=$DEFCONFIG
    
    # 2. 合并板级覆盖
    if [ -f "$BOARD_CONFIG" ]; then
        scripts/kconfig/merge_config.sh .config "$BOARD_CONFIG"
    fi
    
    # 3. 合并本地覆盖（不提交git）
    if [ -f .config.local ]; then
        scripts/kconfig/merge_config.sh .config .config.local
    fi
    
    # 4. 验证配置一致性
    make oldconfig
}

# 使用示例：
merge_config \
    configs/stm32h7_defconfig \
    boards/nucleo_h743/board.config

版本控制最佳实践：

实践 说明
defconfig 纳入版本控制 仅保存最小差异配置，避免提交完整的 .config
使用 savedefconfig 导出 生成最小化 defconfig，仅包含非默认值
板级配置继承 boards/*/board.config 只包含与默认配置的差异
CI 验证 每次提交自动运行 make oldconfig，检测配置冲突
配置变更审查 通过 diff defconfig 审查配置变更，比 diff .config 更清晰

在这里插入图片描述

七、高级技巧：Kconfig 在嵌入式中的进阶应用

7.1 条件默认值

Kconfig 支持基于其他选项的条件默认值，这在多平台项目中非常有用：

config FREERTOS_HEAP_SIZE
    int "FreeRTOS heap size (bytes)"
    default 65536 if MCU_STM32H7
    default 32768 if MCU_NRF52840
    default 16384
    help
      Automatically adjusted based on target MCU RAM size.

7.2 可见性控制

使用 visible if 可以在不破坏依赖关系的前提下控制菜单可见性 ：

menu "Advanced Debug Features"
    visible if CONFIG_DEBUG

    config DEBUG_BACKTRACE
        bool "Enable stack backtrace"
        default n

    config DEBUG_MEMORY_TRACK
        bool "Enable memory allocation tracking"
        default n
endmenu

当 CONFIG_DEBUG=n 时，整个"Advanced Debug Features"菜单隐藏，但子选项的默认值仍然生效（如果其他选项依赖它们）。

7.3 可选菜单（choice optional）

对于必须多选一的配置，可以允许用户不选择任何选项：

choice
    prompt "Sensor calibration method"
    optional                    # 允许不选任何选项
    config CALIB_FACTORY
        bool "Factory calibration"
    config CALIB_AUTO
        bool "Auto-calibration at startup"
    config CALIB_MANUAL
        bool "Manual calibration via CLI"
endchoice

7.4 编译测试支持

Kconfig 支持 COMPILE_TEST 机制，允许在 CI 中编译测试所有驱动代码，即使目标硬件不可用 ：

config DRV_ADC
    bool "ADC driver support"
    depends on HAS_ADC || COMPILE_TEST
    help
      ADC driver for on-chip analog-to-digital converter.
      Can be compile-tested on any platform.

八、实战案例：从 200KB 到 80KB 的固件裁剪

8.1 项目背景

某工业传感器节点项目，初始固件大小 200KB，需要在资源受限的 nRF52840（1MB Flash，256KB RAM）上运行，同时保留 STM32H743 的全功能版本。

8.2 裁剪策略

通过 Kconfig 配置系统，定义三个配置 profile：

Profile 目标平台 功能 Flash RAM
full STM32H743 全功能（LoRa+传感器+以太网） ~200KB ~128KB
standard STM32H743/nRF52840 标准功能（LoRa+传感器） ~120KB ~64KB
minimal nRF52840 最小功能（仅传感器+BLE） ~80KB ~32KB

8.3 Kconfig 配置差异

# minimal_defconfig - 最小配置
CONFIG_MCU_NRF52840=y
CONFIG_HSE_VALUE=32000

# 仅保留必要驱动
CONFIG_DRV_UART=y
CONFIG_DRV_GPIO=y
CONFIG_DRV_I2C=y
# CONFIG_DRV_SPI is not set
# CONFIG_DRV_DMA is not set
# CONFIG_DRV_ADC is not set

# 仅保留传感器
CONFIG_USE_SENSOR=y
CONFIG_SENSOR_BMP280=y
# CONFIG_SENSOR_SHT30 is not set
CONFIG_SENSOR_POLL_INTERVAL_MS=5000   # 降低采样频率

# 禁用LoRa（使用BLE替代）
# CONFIG_USE_LORA is not set

# 禁用RTOS（使用裸机轮询）
# CONFIG_USE_FREERTOS is not set

# 禁用调试
# CONFIG_DEBUG is not set
CONFIG_LOG_LEVEL=0

8.4 构建命令

# 构建全功能版（STM32H743）
make defconfig DEFCONFIG=configs/stm32h7_full.config
make CROSS_COMPILE=arm-none-eabi-

# 构建最小版（nRF52840）
make defconfig DEFCONFIG=configs/nrf52840_minimal.config
make CROSS_COMPILE=arm-none-eabi-

通过 Kconfig 的条件编译，同一套源码无需任何修改即可生成差异巨大的固件镜像，实现了"一份代码，多种产品"的目标。

九、总结与最佳实践

9.1 Kconfig 在嵌入式固件中的核心价值

维度 传统方式 Kconfig方式
配置管理 分散在头文件中 集中式树形菜单
依赖验证 无，靠人工检查 自动求解，无效配置无法生成
可视化 无 menuconfig/guiconfig图形界面
多板型支持 手动修改头文件 defconfig快速切换
版本控制 完整.h文件，噪音大 最小defconfig，差异清晰
CI集成 困难 make oldconfig自动验证

9.2 设计原则清单

  1. 配置即文档：Kconfig 的 help 文本是活的文档，比单独的 README 更及时
  2. 依赖显式化：所有依赖关系用 depends on 声明，避免隐式耦合
  3. 默认值合理：每个选项都有 sensible default，新成员可以 make defconfig 直接编译
  4. 分层配置：顶层 Kconfig 只 source 子目录，不直接定义具体选项
  5. 最小配置导出：使用 savedefconfig 生成版本控制友好的 defconfig

9.3 推荐工具链

开发阶段 → make menuconfig（交互式配置）
    ↓
CI构建   → make defconfig + make oldconfig（自动化验证）
    ↓
发布阶段 → make savedefconfig（导出最小配置归档）
    ↓
版本管理 → git diff configs/*.defconfig（审查配置变更）

通过将 Linux 内核成熟的 Kconfig 配置系统引入嵌入式固件开发，我们不仅解决了条件编译与依赖管理的工程难题，更建立了一套声明式、可视化、可验证的配置管理基础设施。这是从"手工作坊"走向"工业级软件工程"的关键一步。

转载自：https://blog.csdn.net/u014727709/article/details/162603519
欢迎 👍点赞✍评论⭐收藏，欢迎指正

# dubbo
Logo
AI硬件创业社区

智能硬件社区聚焦AI智能硬件技术生态，汇聚嵌入式AI、物联网硬件开发者，打造交流分享平台，同步全国赛事资讯、开展 OPC 核心人才招募，助力技术落地与开发者成长。

更多推荐

cover

STM32 02 多路流水灯

avatar AI硬件创业社区
cover

STM32 01 LED点灯（第一天学习）

avatar AI硬件创业社区
cover

esp32开发与应用（题外话之无线手柄操控）

avatar AI硬件创业社区