Echo Pyramid Home Assistant 集成

介绍

Echo Pyramid 是一款面向 Atom / Atom-Lite / AtomS3 / AtomS3R 的专业语音开发底座。只需插入 ATOM 控制器，开发者就可以快速搭建智能语音设备。ATOM 模组 负责音频处理、无线连接和 IoT 控制；独立的 STM32 微控制器负责触摸按键和 RGB 灯效，实现灵敏的交互反馈和丰富的视觉效果。借助高性能音频编解码器、单麦克风 和 内置功放扬声器，Echo Pyramid 能够实现清晰的远场语音采集和播放，非常适合作为语音助手、智能音箱以及 IoT 语音控制终端。

准备工作

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

Tip

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

步骤 1. 创建新设备
— 点击右下角的绿色按钮来创建一个新设备。

步骤 2. 创建设备名称
— 点击 CONTINUE。

— 点击 New Device Setup。

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

步骤 3. 选择设备类型

— 选择 ESP32-S3。

— 点击 SKIP 跳过。

步骤 4. 开始编辑 YAML 文件
— 点击 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

 