Echo Pyramid Home Assistant 集成

本教程介绍如何将 Echo Pyramid 语音底座集成至 Home Assistant。

准备工作

Home Assistant 主机。
在 Home Assistant 中安装并启用 ESPHome Builder。
主控控制器 AtomS3R

注意事项

本教程使用 ESPHome 2026.1.2 版本进行固件编译和烧录。如果你在编译 / 烧录过程中遇到问题，建议将 ESPHome 切换到该版本后重试。

创建设备

点击右下角的绿色按钮来创建一个新设备。

点击 CONTINUE。

点击 New Device Setup。

输入设备名称，然后点击 NEXT。

选择 ESP32-S3。

点击 SKIP 跳过。

点击 EDIT，通过 YAML 文件来自定义设备功能。

修改配置

下面是配置中的核心部分，后文会给出相关参考链接和说明。

PSRAM 配置

添加 PSRAM 组件：

psram:
  mode: octal
  speed: 80MHz 

外部组件

添加 External 外部组件：

external_components:
  - source: github://m5stack/esphome-yaml/components
    components: [aw87559, si5351, lp5562, pyramidrgb, pyramidtouch]
    refresh: 0s 

I2C 总线配置

添加 I2C 组件：

i2c:
  - id: bsp_bus
    sda: GPIO45
    scl: GPIO0
    scan: true
  - id: ext_bus # 用于 Atomic Echo 底座
    sda: GPIO38
    scl: GPIO39 

I2S 音频配置

添加 I2S Audio 组件：

i2s_audio:
  - id: i2s_audio_bus
    i2s_lrclk_pin: GPIO8
    i2s_bclk_pin: GPIO6 

音频 DAC 配置

添加 Audio DAC 组件：

audio_dac:
  - platform: es8311
    id: es8311_dac
    i2c_id: ext_bus
    bits_per_sample: 16bit
    sample_rate: 16000 

音频 ADC 配置

添加 Audio ADC 组件：

audio_adc:
  - platform: es7210
    id: es7210_adc
    i2c_id: ext_bus
    address: 0x40
    bits_per_sample: 16bit
    sample_rate: 16000 

麦克风配置

添加 Microphone 组件：

microphone:
  - platform: i2s_audio
    id: i2s_mic
    sample_rate: 16000
    i2s_din_pin: GPIO5
    bits_per_sample: 16bit
    adc_type: external
    channel: stereo 

扬声器配置

添加 Speaker 组件：

speaker:
  - platform: i2s_audio
    id: i2s_speaker
    i2s_dout_pin: GPIO7
    dac_type: external
    bits_per_sample: 16bit
    sample_rate: 16000
    channel: mono
    audio_dac: es8311_dac 