如何通过Kconfig配置Zephyr设备树文件的包含逻辑？

你的核心问题是设备树的预处理流程和C代码不共享同一个宏展开阶段，直接在.dts里用#ifdef CONFIG_xxx不会被设备树编译器（dtc）处理，导致节点未生成，C代码引用设备树宏时出错。针对你这种硬件可配置的场景，完全可以用Kconfig作为中心配置，配合设备树Overlay实现硬件和固件的统一配置，以下是具体实现步骤：

1. 用Kconfig定义端口模式选项 #

先在项目的Kconfig文件中添加每个端口的模式配置，让图形化Kconfig Editor可以可视化选择：

config IO_BOARD_PORT1_MODE
    string "Port 1 Operating Mode"
    default "gpio_input"
    help
        Set Port 1 to work as I2C bus or GPIO input.
        Available options: "i2c", "gpio_input"

config IO_BOARD_PORT2_MODE
    string "Port 2 Operating Mode"
    default "gpio_input"
    help
        Set Port 2 to work as I2C bus or GPIO input.

config IO_BOARD_PORT3_MODE
    string "Port 3 Operating Mode"
    default "gpio_input"
    help
        Set Port 3 to work as I2C bus or GPIO input.

2. 编写对应模式的设备树Overlay #

为每种端口模式单独写Overlay文件，避免直接修改主设备树：

示例：Port1作为I2C的Overlay（port1_i2c.overlay） #

/ {
    aliases {
        i2c_port1 = &port1_i2c;
    };

    port1_i2c: i2c@0 {
        compatible = "vendor,i2c-controller";
        sda-gpios = <&gpio 10 GPIO_ACTIVE_HIGH>;
        scl-gpios = <&gpio 11 GPIO_ACTIVE_HIGH>;
        status = "okay";
    };
};

&gpio {
    port1_gpio_input: port1-input {
        status = "disabled";
    };
};

示例：Port1作为GPIO输入的Overlay（port1_gpio_input.overlay） #

/ {
    aliases {
        lock0 = &port1_gpio_input;
    };

    port1_gpio_input: gpio-input@0 {
        compatible = "gpio-input";
        gpios = <&gpio 10 GPIO_INPUT>;
        status = "okay";
    };
};

&i2c {
    port1_i2c: i2c@0 {
        status = "disabled";
    };
};

3. 用构建系统关联Kconfig与Overlay #

在CMakeLists.txt（或Makefile）中根据Kconfig选择的模式，自动加载对应的Overlay：

# 处理Port1模式
if(CONFIG_IO_BOARD_PORT1_MODE STREQUAL "i2c")
    zephyr_include_dts_overlay(port1_i2c.overlay)
elseif(CONFIG_IO_BOARD_PORT1_MODE STREQUAL "gpio_input")
    zephyr_include_dts_overlay(port1_gpio_input.overlay)
endif()

# 同理处理Port2和Port3
if(CONFIG_IO_BOARD_PORT2_MODE STREQUAL "i2c")
    zephyr_include_dts_overlay(port2_i2c.overlay)
elseif(CONFIG_IO_BOARD_PORT2_MODE STREQUAL "gpio_input")
    zephyr_include_dts_overlay(port2_gpio_input.overlay)
endif()

if(CONFIG_IO_BOARD_PORT3_MODE STREQUAL "i2c")
    zephyr_include_dts_overlay(port3_i2c.overlay)
elseif(CONFIG_IO_BOARD_PORT3_MODE STREQUAL "gpio_input")
    zephyr_include_dts_overlay(port3_gpio_input.overlay)
endif()

4. 在固件中根据Kconfig适配逻辑 #

在main.c中直接用Kconfig宏做分支处理，和设备树配置保持一致：

#include <zephyr/drivers/i2c.h>
#include <zephyr/drivers/gpio.h>

void main(void) {
    #if CONFIG_IO_BOARD_PORT1_MODE == "i2c"
        const struct i2c_dt_spec i2c_dev = I2C_DT_SPEC_GET(DT_ALIAS(i2c_port1));
        if (!device_is_ready(i2c_dev.bus)) {
            // 处理设备未就绪逻辑
        }
        // 初始化I2C操作
    #elif CONFIG_IO_BOARD_PORT1_MODE == "gpio_input"
        const struct gpio_dt_spec gpio_dev = GPIO_DT_SPEC_GET(DT_ALIAS(lock0));
        if (!device_is_ready(gpio_dev.port)) {
            // 处理设备未就绪逻辑
        }
        gpio_pin_configure_dt(&gpio_dev, GPIO_INPUT);
    #endif

    // 同理处理Port2和Port3
}

关键说明 #

• Kconfig适合你的场景：虽然官方不建议用Kconfig配置固定硬件，但你的板卡属于可扩展的硬件变体，通过Kconfig选择不同的扩展模式完全合理，属于部署阶段的配置选择，而非硬编码固定硬件。
• 避免直接在dts中用#ifdef：设备树编译器不会处理C预处理宏，必须通过Overlay或dtc的-D选项传递宏，但Overlay的方式更清晰、可维护。

内容的提问来源于stack exchange，提问作者Freygeist