ESP32-H2-DevKitM-1 板级支持详解RIOT 中灵活的 GPIO 复用与外围设备配置【免费下载链接】RIOTRIOT - The friendly OS for IoT项目地址: https://gitcode.com/GitHub_Trending/riot/RIOT本文围绕 RIOT 仓库中 boards/esp32h2-devkit/doc.md 展开系统讲解 ESP32-H2-DevKitM-1 开发板在 RIOT 中的板级定义、GPIO 灵活复用机制、外围设备默认配置与烧录方法。读完本文你将掌握如何在 RIOT 中为 ESP32-H2 系列板卡完成板级适配、按应用需求覆盖默认引脚分配并快速完成固件烧录与调试。一、板卡概述Espressif 官方推出的ESP32-H2-DevKitM-1开发板基于ESP32-H2-MINI-1x 模组是一块面向 IEEE 802.15.4Thread / Zigbee与 BLE 5 无线应用的低功耗评估板。在 RIOT 中该板卡被命名为esp32h2-devkit属于boards_esp32h2板卡族核心特性由 ESP32-H2 SoC 提供详见 CPU 层 cpu/esp32 的 ESP32 SoC 系列说明。由于 ESP32-H2 可用的 GPIO 数量及其复用能力相当有限RIOT 官方在设计这块板卡的默认配置时采用了**“通用化”策略**ESP32-H2-DevKitM-1 的默认板级定义同样适用于大多数其他 ESP32-H2 板卡。若特定应用需要不同的引脚分配可以通过应用级板卡配置application-specific board configuration覆盖默认定义。二、板载硬件2.1 MCU 与模组板卡绝大多数功能由 ESP32-H2 SoC 提供。ESP32-H2-MINI-1x 模组内封装了 flash对应 GPIO15 至 GPIO21这些引脚未引出并提供 IEEE 802.15.4 与 BLE 5 无线能力。2.2 板载器件除了必要的最小系统电路外ESP32-H2-DevKitM-1 板卡上唯一的特殊器件是一颗 WS2812 兼容的 RGB LEDSK68XXMINI-HS其余 GPIO 全部以排针形式引出为灵活复用提供了最大自由度。RGB LED 数据引脚接在GPIO8上可通过 RIOT 的ws281x驱动模块进行控制。从 boards/esp32h2-devkit/include/board.h 的源码可以看到 LED 参数的默认定义#ifndef WS281X_PARAM_PIN # define WS281X_PARAM_PIN (GPIO8) /** GPIO pin connected to the data pin */ #endif #ifndef WS281X_PARAM_NUMOF # define WS281X_PARAM_NUMOF (1U) /** Number of LEDs chained */ #endif即板载 LED 数量为 1数据引脚为 GPIO8可通过ws281x模块驱动。2.3 按键BOOT 按键板上的 BOOT 按键连接到 GPIO9在正常运行期间可作为用户按键使用。由于该按键将 GPIO9 接地信号为低电平有效按下输出低电平。且板上没有外部上拉电阻因此 board.h 中将按键引脚模式配置为内部上拉输入#define BTN0_PIN GPIO9 #define BTN0_MODE GPIO_IN_PU #define BTN0_INT_FLANK GPIO_FALLING在 SAUL 层该按键被注册为名为BOOT、带SAUL_GPIO_INVERTED标志的 GPIO 设备见 boards/esp32h2-devkit/include/gpio_params.h且当应用使用saul_default模块时Makefile.dep 会自动引入saul_gpio方便通过 SAUL 统一访问。三、GPIO 复用机制按需分配的外设引脚由于所有 GPIO 都被引出同一组引脚可以在不同应用中承担不同角色。RIOT 的 ESP32 板级定义允许GPIO 同时出现在多个外设配置中但在任一时刻只能被一个外设使用。引脚是否真正绑定到某个外设取决于以下触发条件满足其一即占用对应的外设模块被使用例如启用了periph_spi对应的初始化函数被调用例如adc_init对应的初始化函数被调用例如pwm_init。也就是说GPIO 的实际用途由“最先被使用的模块或函数”决定。典型例子GPIO1、GPIO3、GPIO4、GPIO5 既被声明为 ADC 通道也出现在 SPI_DEV(0)GPIO1、GPIO4、GPIO5和 PWM_DEV(1)GPIO1、GPIO3、GPIO5的配置中。只要应用不启用periph_spi模块这些引脚便可自由用作 ADC 或 PWM 通道。该设计意图在 boards/esp32h2-devkit/include/periph_conf.h 的注释中有明确说明且每个配置块都以#ifndef包裹允许通过应用级配置覆盖。四、默认外设配置详解4.1 默认配置总表以下为 doc.md 给出的默认板级配置按 GPIO 功能归类可由应用级配置覆盖功能GPIO说明配置参考BUTTON0GPIO9BOOT 按键低有效—ADCGPIO1、GPIO2、GPIO3、GPIO4、GPIO5最多 5 个 ADC 通道ADC ChannelsPWM_DEV(0)GPIO2、GPIO12、GPIO223 通道PWM ChannelsPWM_DEV(1)GPIO1、GPIO3、GPIO53 通道PWM ChannelsI2C_DEV(0):SCLGPIO10—I2C InterfacesI2C_DEV(0):SDAGPIO11—I2C InterfacesRGB-LEDGPIO8由ws281x驱动模块支持—SPI_DEV(0):SCKGPIO4使用 SPI2_HOST (FSPI)SPI InterfacesSPI_DEV(0):MISOGPIO5使用 SPI2_HOST (FSPI)SPI InterfacesSPI_DEV(0):MOSIGPIO0使用 SPI2_HOST (FSPI)SPI InterfacesSPI_DEV(0):CS0GPIO1使用 SPI2_HOST (FSPI)SPI InterfacesUART_DEV(0):TxDGPIO24控制台配置固定UART interfacesUART_DEV(0):RxDGPIO23控制台配置固定UART interfacesUSB D- / DGPIO26——注意事项ADC 通道配置包含了所有可被用作 ADC 通道的 ESP32-H2 GPIOGPIO6 与 GPIO7 未引出GPIO15 至 GPIO21 被模组内封装 flash 占用未引出。4.2 ADC 通道最多 5 路periph_conf.h 中将所有引出的可做 ADC 的引脚声明为通道#ifndef ADC_GPIOS # define ADC_GPIOS { GPIO1, GPIO2, GPIO3, GPIO4, GPIO5 } #endif注释明确只要未通过adc_init初始化这些引脚为 ADC 通道它们仍可用于其他用途。4.3 I2C 接口1 路快速模式默认仅定义一个 I2C 接口 I2C_DEV(0)总线速度I2C_SPEED_FAST400 kbit/s 量级具体值取决于 ESP32-H2 时钟配置#ifndef I2C0_SPEED # define I2C0_SPEED I2C_SPEED_FAST #endif #ifndef I2C0_SCL # define I2C0_SCL GPIO10 #endif #ifndef I2C0_SDA # define I2C0_SDA GPIO11 #endif同样这些引脚仅在启用periph_i2c模块时才被初始化为 I2C 信号否则可另作他用。4.4 PWM 输出2 个设备 × 3 通道板卡提供两个 PWM 设备#ifndef PWM0_GPIOS # define PWM0_GPIOS { GPIO2, GPIO12, GPIO22 } /* PWM_DEV(0) */ #endif #ifndef PWM1_GPIOS # define PWM1_GPIOS { GPIO1, GPIO3, GPIO5 } /* PWM_DEV(1) */ #endifPWM_DEV(0)只包含未被 I2C、SPI、UART 占用的引脚PWM_DEV(1)与 SPI_DEV(0) 的 SCK/MISO/CS0 以及 ADC 通道存在重叠但只要未调用pwm_init这些引脚便可另作他用。4.5 SPI 接口1 路FSPI默认 SPI_DEV(0) 使用 ESP32-H2 的 SPI2_HOST即 FSPI 控制器#ifndef SPI0_CTRL # define SPI0_CTRL FSPI #endif #ifndef SPI0_SCK # define SPI0_SCK GPIO4 /* FSPICLK */ #endif #ifndef SPI0_MISO # define SPI0_MISO GPIO5 /* FSPIQ */ #endif #ifndef SPI0_MOSI # define SPI0_MOSI GPIO0 /* FSPID */ #endif #ifndef SPI0_CS0 # define SPI0_CS0 GPIO1 /* FSPICS0 */ #endif注意SPI 引脚只有在首次调用spi_init_cs或spi_acquire时才会被初始化为 SPI 信号因此在此之前它们保持空闲、可复用。4.6 UART / 控制台固定配置ESP32-H2 提供 2 个 UART 接口本板仅使用 UART_DEV(0) 作为控制台且该配置是固定的、不可更改#define UART0_TXD GPIO24 #define UART0_RXD GPIO23对比非固定的 TxD/RxD 引脚定义此处不采用#ifndef包裹表明不允许覆盖。UART_DEV(1) 默认不启用。4.7 功能特性声明boards/esp32h2-devkit/Makefile.features 声明了板卡提供的功能特性CPU_MODEL esp32h2_mini_1x_h4s # common board and CPU features include $(RIOTBOARD)/common/esp32h2/Makefile.features # additional features provided by the board FEATURES_PROVIDED periph_adc FEATURES_PROVIDED periph_i2c FEATURES_PROVIDED periph_pwm FEATURES_PROVIDED periph_spi # unique features provided by the board FEATURES_PROVIDED esp_jtag FEATURES_PROVIDED arduino_analog FEATURES_PROVIDED arduino_i2c FEATURES_PROVIDED arduino_pins FEATURES_PROVIDED arduino_pwm FEATURES_PROVIDED arduino_spi FEATURES_PROVIDED arduino_uart可见除基础外设外该板还提供esp_jtag片上 JTAG 调试与完整的 Arduino 兼容特性analog/i2c/pins/pwm/spi/uart可直接用于 RIOT 的 Arduino API 兼容层。Kconfig 配置见 boards/esp32h2-devkit/Kconfig其选择BOARD_COMMON_ESP32H2并指定 CPU 型号esp32h2_mini_1x_h4s。五、应用级配置覆盖方法当默认引脚分配不满足应用需求时无需修改板级定义只需在应用工程中覆盖相关宏即可。由于 periph_conf.h 中 ADC、I2C、PWM、SPI 相关定义均以#ifndef包裹应用可通过以下方式覆盖在应用Makefile中通过 CFLAGS 传入宏定义例如覆盖 SPI 引脚CFLAGS -DSPI0_SCKGPIO6 -DSPI0_MOSIGPIO7 -DSPI0_MISOGPIO2或在应用的periph_conf.h若使用 Kconfig 方式配置外设中重新定义。同理board.h中的WS281X_PARAM_PIN、WS281X_PARAM_NUMOF以及BTN0_INT_FLANK均支持覆盖。需要特别注意的是UART_DEV(0) 的 TxD/RxD 固定为 GPIO24/GPIO23 且不可更改覆盖时不要触碰这两项。六、烧录与调试6.1 快速烧录板卡自带 Micro-USB 连接器并集成复位/启动/烧录逻辑通过 CP2102N USB-UART 桥接芯片因此烧录 RIOT 固件非常简单将板卡连接到主机使用编程串口在应用目录执行BOARDesp32h2-devkit make flash ...首次烧录时建议先指定串口设备如PORT/dev/ttyUSB0boards/esp32h2-devkit/Makefile.include 中定义了自动选口过滤规则使用MOST_RECENT_PORT1时仅匹配 Silicon Labs CP2102N USB 转 UART 桥接设备TTY_BOARD_FILTER : --driver cp210x --vendor Silicon Labs --model CP2102N USB to UART Bridge Controller6.2 调试由于板卡提供了esp_jtag特性可通过 ESP32-H2 的片上 JTAG 接口进行调试配合 USB-CDC 串口可同时观察控制台输出。关于 ESP32-H2 在 RIOT 中的编译、配置与烧录细节参见 cpu/esp32 的 ESP32 相关文档esp32_riot章节。七、总结RIOT 对 ESP32-H2-DevKitM-1 的板级支持体现了“最小硬件、最大灵活性”的设计思路板载硬件精简到极致仅一颗 WS2812 RGB LED 与 BOOT 按键GPIO 全部引出通过“按需分配”机制同一 GPIO 可同时出现在多个外设配置中由先被启用的模块或初始化函数决定实际用途所有非固定配置均以#ifndef包裹支持应用级配置无缝覆盖兼顾了不同 ESP32-H2 板卡的兼容性唯一例外是控制台 UART 的 GPIO24/GPIO23 为固定引脚。从 boards/esp32h2-devkit/include/periph_conf.h 与 boards/esp32h2-devkit/include/board.h 的源码注释中可以确认这一整套默认配置被设计为“大多数其他 ESP32-H2 板卡的通用模板”因此本文的配置表与覆盖方法同样适用于基于 ESP32-H2-MINI-1x 模组的其他板卡。【免费下载链接】RIOTRIOT - The friendly OS for IoT项目地址: https://gitcode.com/GitHub_Trending/riot/RIOT创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
ESP32-H2-DevKitM-1 板级支持详解RIOT 中灵活的 GPIO 复用与外围设备配置【免费下载链接】RIOTRIOT - The friendly OS for IoT项目地址: https://gitcode.com/GitHub_Trending/riot/RIOT本文围绕 RIOT 仓库中 boards/esp32h2-devkit/doc.md 展开系统讲解 ESP32-H2-DevKitM-1 开发板在 RIOT 中的板级定义、GPIO 灵活复用机制、外围设备默认配置与烧录方法。读完本文你将掌握如何在 RIOT 中为 ESP32-H2 系列板卡完成板级适配、按应用需求覆盖默认引脚分配并快速完成固件烧录与调试。一、板卡概述Espressif 官方推出的ESP32-H2-DevKitM-1开发板基于ESP32-H2-MINI-1x 模组是一块面向 IEEE 802.15.4Thread / Zigbee与 BLE 5 无线应用的低功耗评估板。在 RIOT 中该板卡被命名为esp32h2-devkit属于boards_esp32h2板卡族核心特性由 ESP32-H2 SoC 提供详见 CPU 层 cpu/esp32 的 ESP32 SoC 系列说明。由于 ESP32-H2 可用的 GPIO 数量及其复用能力相当有限RIOT 官方在设计这块板卡的默认配置时采用了**“通用化”策略**ESP32-H2-DevKitM-1 的默认板级定义同样适用于大多数其他 ESP32-H2 板卡。若特定应用需要不同的引脚分配可以通过应用级板卡配置application-specific board configuration覆盖默认定义。二、板载硬件2.1 MCU 与模组板卡绝大多数功能由 ESP32-H2 SoC 提供。ESP32-H2-MINI-1x 模组内封装了 flash对应 GPIO15 至 GPIO21这些引脚未引出并提供 IEEE 802.15.4 与 BLE 5 无线能力。2.2 板载器件除了必要的最小系统电路外ESP32-H2-DevKitM-1 板卡上唯一的特殊器件是一颗 WS2812 兼容的 RGB LEDSK68XXMINI-HS其余 GPIO 全部以排针形式引出为灵活复用提供了最大自由度。RGB LED 数据引脚接在GPIO8上可通过 RIOT 的ws281x驱动模块进行控制。从 boards/esp32h2-devkit/include/board.h 的源码可以看到 LED 参数的默认定义#ifndef WS281X_PARAM_PIN # define WS281X_PARAM_PIN (GPIO8) /** GPIO pin connected to the data pin */ #endif #ifndef WS281X_PARAM_NUMOF # define WS281X_PARAM_NUMOF (1U) /** Number of LEDs chained */ #endif即板载 LED 数量为 1数据引脚为 GPIO8可通过ws281x模块驱动。2.3 按键BOOT 按键板上的 BOOT 按键连接到 GPIO9在正常运行期间可作为用户按键使用。由于该按键将 GPIO9 接地信号为低电平有效按下输出低电平。且板上没有外部上拉电阻因此 board.h 中将按键引脚模式配置为内部上拉输入#define BTN0_PIN GPIO9 #define BTN0_MODE GPIO_IN_PU #define BTN0_INT_FLANK GPIO_FALLING在 SAUL 层该按键被注册为名为BOOT、带SAUL_GPIO_INVERTED标志的 GPIO 设备见 boards/esp32h2-devkit/include/gpio_params.h且当应用使用saul_default模块时Makefile.dep 会自动引入saul_gpio方便通过 SAUL 统一访问。三、GPIO 复用机制按需分配的外设引脚由于所有 GPIO 都被引出同一组引脚可以在不同应用中承担不同角色。RIOT 的 ESP32 板级定义允许GPIO 同时出现在多个外设配置中但在任一时刻只能被一个外设使用。引脚是否真正绑定到某个外设取决于以下触发条件满足其一即占用对应的外设模块被使用例如启用了periph_spi对应的初始化函数被调用例如adc_init对应的初始化函数被调用例如pwm_init。也就是说GPIO 的实际用途由“最先被使用的模块或函数”决定。典型例子GPIO1、GPIO3、GPIO4、GPIO5 既被声明为 ADC 通道也出现在 SPI_DEV(0)GPIO1、GPIO4、GPIO5和 PWM_DEV(1)GPIO1、GPIO3、GPIO5的配置中。只要应用不启用periph_spi模块这些引脚便可自由用作 ADC 或 PWM 通道。该设计意图在 boards/esp32h2-devkit/include/periph_conf.h 的注释中有明确说明且每个配置块都以#ifndef包裹允许通过应用级配置覆盖。四、默认外设配置详解4.1 默认配置总表以下为 doc.md 给出的默认板级配置按 GPIO 功能归类可由应用级配置覆盖功能GPIO说明配置参考BUTTON0GPIO9BOOT 按键低有效—ADCGPIO1、GPIO2、GPIO3、GPIO4、GPIO5最多 5 个 ADC 通道ADC ChannelsPWM_DEV(0)GPIO2、GPIO12、GPIO223 通道PWM ChannelsPWM_DEV(1)GPIO1、GPIO3、GPIO53 通道PWM ChannelsI2C_DEV(0):SCLGPIO10—I2C InterfacesI2C_DEV(0):SDAGPIO11—I2C InterfacesRGB-LEDGPIO8由ws281x驱动模块支持—SPI_DEV(0):SCKGPIO4使用 SPI2_HOST (FSPI)SPI InterfacesSPI_DEV(0):MISOGPIO5使用 SPI2_HOST (FSPI)SPI InterfacesSPI_DEV(0):MOSIGPIO0使用 SPI2_HOST (FSPI)SPI InterfacesSPI_DEV(0):CS0GPIO1使用 SPI2_HOST (FSPI)SPI InterfacesUART_DEV(0):TxDGPIO24控制台配置固定UART interfacesUART_DEV(0):RxDGPIO23控制台配置固定UART interfacesUSB D- / DGPIO26——注意事项ADC 通道配置包含了所有可被用作 ADC 通道的 ESP32-H2 GPIOGPIO6 与 GPIO7 未引出GPIO15 至 GPIO21 被模组内封装 flash 占用未引出。4.2 ADC 通道最多 5 路periph_conf.h 中将所有引出的可做 ADC 的引脚声明为通道#ifndef ADC_GPIOS # define ADC_GPIOS { GPIO1, GPIO2, GPIO3, GPIO4, GPIO5 } #endif注释明确只要未通过adc_init初始化这些引脚为 ADC 通道它们仍可用于其他用途。4.3 I2C 接口1 路快速模式默认仅定义一个 I2C 接口 I2C_DEV(0)总线速度I2C_SPEED_FAST400 kbit/s 量级具体值取决于 ESP32-H2 时钟配置#ifndef I2C0_SPEED # define I2C0_SPEED I2C_SPEED_FAST #endif #ifndef I2C0_SCL # define I2C0_SCL GPIO10 #endif #ifndef I2C0_SDA # define I2C0_SDA GPIO11 #endif同样这些引脚仅在启用periph_i2c模块时才被初始化为 I2C 信号否则可另作他用。4.4 PWM 输出2 个设备 × 3 通道板卡提供两个 PWM 设备#ifndef PWM0_GPIOS # define PWM0_GPIOS { GPIO2, GPIO12, GPIO22 } /* PWM_DEV(0) */ #endif #ifndef PWM1_GPIOS # define PWM1_GPIOS { GPIO1, GPIO3, GPIO5 } /* PWM_DEV(1) */ #endifPWM_DEV(0)只包含未被 I2C、SPI、UART 占用的引脚PWM_DEV(1)与 SPI_DEV(0) 的 SCK/MISO/CS0 以及 ADC 通道存在重叠但只要未调用pwm_init这些引脚便可另作他用。4.5 SPI 接口1 路FSPI默认 SPI_DEV(0) 使用 ESP32-H2 的 SPI2_HOST即 FSPI 控制器#ifndef SPI0_CTRL # define SPI0_CTRL FSPI #endif #ifndef SPI0_SCK # define SPI0_SCK GPIO4 /* FSPICLK */ #endif #ifndef SPI0_MISO # define SPI0_MISO GPIO5 /* FSPIQ */ #endif #ifndef SPI0_MOSI # define SPI0_MOSI GPIO0 /* FSPID */ #endif #ifndef SPI0_CS0 # define SPI0_CS0 GPIO1 /* FSPICS0 */ #endif注意SPI 引脚只有在首次调用spi_init_cs或spi_acquire时才会被初始化为 SPI 信号因此在此之前它们保持空闲、可复用。4.6 UART / 控制台固定配置ESP32-H2 提供 2 个 UART 接口本板仅使用 UART_DEV(0) 作为控制台且该配置是固定的、不可更改#define UART0_TXD GPIO24 #define UART0_RXD GPIO23对比非固定的 TxD/RxD 引脚定义此处不采用#ifndef包裹表明不允许覆盖。UART_DEV(1) 默认不启用。4.7 功能特性声明boards/esp32h2-devkit/Makefile.features 声明了板卡提供的功能特性CPU_MODEL esp32h2_mini_1x_h4s # common board and CPU features include $(RIOTBOARD)/common/esp32h2/Makefile.features # additional features provided by the board FEATURES_PROVIDED periph_adc FEATURES_PROVIDED periph_i2c FEATURES_PROVIDED periph_pwm FEATURES_PROVIDED periph_spi # unique features provided by the board FEATURES_PROVIDED esp_jtag FEATURES_PROVIDED arduino_analog FEATURES_PROVIDED arduino_i2c FEATURES_PROVIDED arduino_pins FEATURES_PROVIDED arduino_pwm FEATURES_PROVIDED arduino_spi FEATURES_PROVIDED arduino_uart可见除基础外设外该板还提供esp_jtag片上 JTAG 调试与完整的 Arduino 兼容特性analog/i2c/pins/pwm/spi/uart可直接用于 RIOT 的 Arduino API 兼容层。Kconfig 配置见 boards/esp32h2-devkit/Kconfig其选择BOARD_COMMON_ESP32H2并指定 CPU 型号esp32h2_mini_1x_h4s。五、应用级配置覆盖方法当默认引脚分配不满足应用需求时无需修改板级定义只需在应用工程中覆盖相关宏即可。由于 periph_conf.h 中 ADC、I2C、PWM、SPI 相关定义均以#ifndef包裹应用可通过以下方式覆盖在应用Makefile中通过 CFLAGS 传入宏定义例如覆盖 SPI 引脚CFLAGS -DSPI0_SCKGPIO6 -DSPI0_MOSIGPIO7 -DSPI0_MISOGPIO2或在应用的periph_conf.h若使用 Kconfig 方式配置外设中重新定义。同理board.h中的WS281X_PARAM_PIN、WS281X_PARAM_NUMOF以及BTN0_INT_FLANK均支持覆盖。需要特别注意的是UART_DEV(0) 的 TxD/RxD 固定为 GPIO24/GPIO23 且不可更改覆盖时不要触碰这两项。六、烧录与调试6.1 快速烧录板卡自带 Micro-USB 连接器并集成复位/启动/烧录逻辑通过 CP2102N USB-UART 桥接芯片因此烧录 RIOT 固件非常简单将板卡连接到主机使用编程串口在应用目录执行BOARDesp32h2-devkit make flash ...首次烧录时建议先指定串口设备如PORT/dev/ttyUSB0boards/esp32h2-devkit/Makefile.include 中定义了自动选口过滤规则使用MOST_RECENT_PORT1时仅匹配 Silicon Labs CP2102N USB 转 UART 桥接设备TTY_BOARD_FILTER : --driver cp210x --vendor Silicon Labs --model CP2102N USB to UART Bridge Controller6.2 调试由于板卡提供了esp_jtag特性可通过 ESP32-H2 的片上 JTAG 接口进行调试配合 USB-CDC 串口可同时观察控制台输出。关于 ESP32-H2 在 RIOT 中的编译、配置与烧录细节参见 cpu/esp32 的 ESP32 相关文档esp32_riot章节。七、总结RIOT 对 ESP32-H2-DevKitM-1 的板级支持体现了“最小硬件、最大灵活性”的设计思路板载硬件精简到极致仅一颗 WS2812 RGB LED 与 BOOT 按键GPIO 全部引出通过“按需分配”机制同一 GPIO 可同时出现在多个外设配置中由先被启用的模块或初始化函数决定实际用途所有非固定配置均以#ifndef包裹支持应用级配置无缝覆盖兼顾了不同 ESP32-H2 板卡的兼容性唯一例外是控制台 UART 的 GPIO24/GPIO23 为固定引脚。从 boards/esp32h2-devkit/include/periph_conf.h 与 boards/esp32h2-devkit/include/board.h 的源码注释中可以确认这一整套默认配置被设计为“大多数其他 ESP32-H2 板卡的通用模板”因此本文的配置表与覆盖方法同样适用于基于 ESP32-H2-MINI-1x 模组的其他板卡。【免费下载链接】RIOTRIOT - The friendly OS for IoT项目地址: https://gitcode.com/GitHub_Trending/riot/RIOT创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
