STM32L496G-Disco开发板Zephyr下单GPIO引脚配置报错求助

问题背景 #

使用STM32L496G-Disco开发板，基于Zephyr OS和Devicetree开发，板上I/O仅引出Arduino扩展接口。计划单独配置单个引脚（如A0作为GPIO）而非完整Arduino扩展板，创建设备覆盖文件后编译报错。

错误的DTS覆盖文件 #

/{
    leds {
        compatible = "gpio-keys";
        led0: led_0 {
            gpios = <&gpioc 4 GPIO_ACTIVE_HIGH>;
        };
    };
};

测试代码 #

#include <zephyr/device.h>
#include <zephyr/kernel.h>
#include <zephyr/drivers/gpio.h>

#define LED0_NODE DT_NODELABEL(led0)
#define LED_GPIO DT_GPIO_LABEL(LED0_NODE, gpios)
#define LED_PIN DT_GPIO_PIN(LED0_NODE, gpios)
#define LED_FLAGS DT_GPIO_FLAGS(LED0_NODE, gpios)


void main(void) {
  // 获取GPIO设备
  const struct device * dev = device_get_binding(LED_GPIO);

  // 配置LED引脚为输出
  gpio_pin_configure(dev, LED_PIN, GPIO_OUTPUT | LED_FLAGS);

  // 无限循环
  while (1) {
    gpio_pin_toggle(dev, LED_PIN);
    k_msleep(1000);
  }
}

错误信息 #

/Zephyr/zephyrproject/build/zephyr/include/generated/devicetree_generated.h:14695:83: error: 'DT_N_S_soc_S_pin_controller_48000000_S_gpio_48000800_P_label' undeclared (first use in this function); did you mean 'DT_N_S_soc_S_pin_controller_48000000_S_gpio_48000800_P_reg'?
14695 | #define DT_N_S_soc_S_pin_controller_48000000_S_gpio_keys_S_led_0_P_gpios_IDX_0_PH DT_N_S_soc_S_pin_controller_48000000_S_gpio_48000800

解决步骤 #

1. 修正DTS节点的compatible属性 #

你误用了gpio-keys（这是按键设备的兼容属性），GPIO输出设备应使用gpio-leds；如果是自定义GPIO用途，也可以省略compatible属性，但gpio-leds是Zephyr支持的标准兼容属性，能避免驱动匹配问题。

2. 补全节点的status属性 #

必须添加status = "okay";来启用该节点，否则Devicetree不会生成对应的节点信息。

3. 确认GPIO控制器节点的label属性 #

错误提示说明引用的GPIO控制器节点（如&gpioc）没有生成label相关宏，检查开发板基础DTS文件（stm32l496g_disco.dts），确认GPIOC节点是否包含label = "GPIOC";。如果没有，可在覆盖文件中补充：

&gpioc {
    label = "GPIOC";
    status = "okay";
};

修正后的完整DTS覆盖文件 #

/ {
    leds {
        compatible = "gpio-leds";
        status = "okay";
        led0: led_0 {
            gpios = <&gpioc 4 GPIO_ACTIVE_HIGH>;
        };
    };
};

&gpioc {
    status = "okay";
    label = "GPIOC";
};

代码层面优化（可选） #

获取GPIO设备后添加有效性检查，避免空指针操作：

if (dev == NULL) {
    printk("GPIO设备绑定失败\n");
    return;
}

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