跳转到内容
ESPHome - 让智能家居更简单2026.7.0

ESP32 Hosted

ESP32 Hosted（ESP-Hosted-MCU）是一种 允许你将 ESP32 模组用作通信协处理器的解决方案。该 解决方案为主机模组提供无线连接（Wi-Fi 和蓝牙）， 使其能够与其他设备通信。

支持两种传输模式：SDIO（默认）和 SPI。

SDIO 传输

Section titled “SDIO 传输”
# Example SDIO configuration (4-bit, default)
esp32_hosted:
  type: sdio
  variant: ESP32C6
  reset_pin: GPIOXX
  cmd_pin: GPIOXX
  clk_pin: GPIOXX
  d0_pin: GPIOXX
  d1_pin: GPIOXX
  d2_pin: GPIOXX
  d3_pin: GPIOXX
  active_high: true
  sdio_frequency: 10MHz


wifi:
  ssid: !secret wifi_ssid
  password: !secret wifi_password
# Example SDIO configuration (1-bit)
esp32_hosted:
  type: sdio
  variant: ESP32C6
  bus_width: 1
  reset_pin: GPIOXX
  cmd_pin: GPIOXX
  clk_pin: GPIOXX
  d0_pin: GPIOXX
  active_high: true


wifi:
  ssid: !secret wifi_ssid
  password: !secret wifi_password

SDIO 配置变量

Section titled “SDIO 配置变量”
  • type (Optional, string): 传输模式。对于 SDIO 传输，设置为 sdio。默认为 sdio。
  • variant (Required, string): 主机所使用 ESP32 协处理器的型号。可取 ESP32、ESP32S2、ESP32S3、ESP32C2、ESP32C3 和 ESP32C6 之一。
  • reset_pin (Required, Pin): 协处理器的复位引脚。
  • active_high (Required, boolean): 如果启用，则当复位信号为高电平时协处理器处于活动状态。如果禁用，则当复位信号为低电平时协处理器处于活动状态。
  • clk_pin (Required, Pin): SDIO 时钟引脚。
  • cmd_pin (Required, Pin): SDIO 命令引脚。
  • d0_pin (Required, Pin): SDIO D0 引脚。
  • d1_pin (Optional, Pin): SDIO D1 引脚。当 bus_width 为 4 时必需。
  • d2_pin (Optional, Pin): SDIO D2 引脚。当 bus_width 为 4 时必需。
  • d3_pin (Optional, Pin): SDIO D3 引脚。当 bus_width 为 4 时必需。
  • bus_width (Optional, int): SDIO 总线宽度。可为 1 或 4。默认为 4。
  • slot (Optional, int): SDIO 插槽编号。默认为 1。
  • sdio_frequency (Optional, frequency): 设置主机与协处理器之间的通信速度。如果遇到通信丢失或重启的问题，请尝试降低此值。 该值可以在 400kHz 到 50MHz 之间，默认值为 40MHz。
  • use_psram (Optional, boolean): 将 SDIO 传输缓冲区池放置在 PSRAM 中，而不是 内部 RAM 中。要求主机 MCU 已启用支持 DMA 的 PSRAM（ESP32-P4、ESP32-S3）。 当主机固件使用了大部分内部 RAM（例如，大型 LVGL UI）时建议启用； 否则启动可能会因 sdio_mempool_create 断言（assert）而失败。默认为 false。

SPI 传输

Section titled “SPI 传输”
# Example SPI configuration
esp32_hosted:
  type: spi
  variant: ESP32C6
  reset_pin: GPIOXX
  clk_pin: GPIOXX
  mosi_pin: GPIOXX
  miso_pin: GPIOXX
  cs_pin: GPIOXX
  handshake_pin: GPIOXX
  data_ready_pin: GPIOXX
  active_high: true


wifi:
  ssid: !secret wifi_ssid
  password: !secret wifi_password

SPI 配置变量

Section titled “SPI 配置变量”
  • type (Required, string): 传输模式。对于 SPI 传输，设置为 spi。
  • variant (Required, string): 主机所使用 ESP32 协处理器的型号。可取 ESP32、ESP32S2、ESP32S3、ESP32C2、ESP32C3 和 ESP32C6 之一。
  • reset_pin (Required, Pin): 协处理器的复位引脚。
  • active_high (Required, boolean): 如果启用，则当复位信号为高电平时协处理器处于活动状态。如果禁用，则当复位信号为低电平时协处理器处于活动状态。
  • clk_pin (Required, Pin): SPI 时钟引脚。
  • mosi_pin (Required, Pin): SPI MOSI 引脚。
  • miso_pin (Required, Pin): SPI MISO 引脚。
  • cs_pin (Required, Pin): SPI 片选引脚。
  • handshake_pin (Required, Pin): 协处理器用于发出就绪信号的握手引脚。
  • data_ready_pin (Required, Pin): 协处理器用于指示有可用数据的数据就绪引脚。
  • spi_mode (Optional, int): SPI 模式（0-3）。默认值取决于型号：ESP32 为模式 2，其他所有型号为模式 3。
  • frequency (Optional, frequency): SPI 时钟频率。最大值取决于型号：ESP32 为 10MHz，其他所有型号为 40MHz。默认为每个型号的最大值。
  • handshake_active_high (Optional, boolean): 握手信号的极性。默认为 true。
  • data_ready_active_high (Optional, boolean): 数据就绪信号的极性。默认为 true。
  • use_psram (Optional, boolean): 将 SPI 传输缓冲区池放置在 PSRAM 中，而不是 内部 RAM 中。要求主机 MCU 已启用支持 DMA 的 PSRAM（ESP32-P4、ESP32-S3）。 当主机固件使用了大部分内部 RAM（例如，大型 LVGL UI）时建议启用； 否则启动可能会因 spi_mempool_create 断言（assert）而失败。默认为 false。

更新协处理器固件

Section titled “更新协处理器固件”

你可以使用 Esp32 Hosted 平台更新你的 ESP32 协处理器上的固件。这允许你在不手动重新刷写协处理器的情况下向其部署固件更新。

另请参见

Section titled “另请参见”