Echo Pyramid Home Assistant Integration

Description

Echo Pyramid is a professional voice development base designed for the Atom / AtomS3 / AtomS3R series controllers. Simply insert an Atom controller, and developers can quickly build intelligent voice devices. The Atom controller handles audio processing, wireless connectivity, and IoT control, while an independent STM32 microcontroller manages touch buttons and RGB lighting effects, delivering responsive interactive feedback and rich visual effects. With a high-performance audio codec, single microphone, and built-in amplified speaker, Echo Pyramid enables clear far-field voice capture and playback, making it ideal for use as a voice assistant, smart speaker, and IoT voice control terminal.

Preparation

• Home Assistant host
• Install and enable ESPHome Builder in Home Assistant
• Master Controller AtomS3R

Step 1. Create New Device — Click the green button in the lower right corner to create a device.

Step 2. Create Device Name — Click CONTINUE.

— Click New Device Setup.

— Enter the name of the device and Click NEXT.

Step 3. Choose Device Type

— Click ESP32-S3.

— Click SKIP.

Step 4. Start Edit YAML File — Click EDIT. We can customize device functionality through YAML files.

Device Setup

The following is the core part of the code. Relevant references and explanations are provided below.

PSRAM Configuration

• Add the PSRAM component

psram:
  mode: octal
  speed: 80MHz

External Components

• Add the External components

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

I2C Bus Configuration

• Add the I2C component

i2c:
  - id: bsp_bus
    sda: GPIO45
    scl: GPIO0
    scan: true
  - id: ext_bus # used on atomic echo base
    sda: GPIO38
    scl: GPIO39

I2S Audio Configuration

• Add the I2S Audio component

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

Audio DAC Configuration

• Add the Audio DAC component

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

Audio ADC Configuration

• Add the Audio ADC component

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

Microphone Configuration

• Add the Microphone component

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

Speaker Configuration

• Add the Speaker component

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

Firmware Build

— Click INSTALL again to flash and wait for it to complete.

— After making changes, click SAVE and INSTALL in the top-right corner, then choose Manual Download in the popup.

— After the firmware compilation is complete, click Download and select Factory format(Previously Modern)

Firmware Upload

— Connect the device to your host via a USB Type‑C cable. Open ESPHome Web and click CONNECT to connect to the device.

— Locate the corresponding serial port number

— Click INSTALL

— Select the previously compiled firmware to upload.

Home Assistant Integration

— Click Settings -> Device & services to check the device.

— We can find the corresponding device in the Discover section.

— After adding the device, the data will be displayed correctly.

— Ultimately, users can configure the various controllable hardware components of the Echo Pyramid through the control panel and activate the device using a custom voice wake word (Echo-Pyramid Wake Word) to perform smart voice interactions such as checking the weather or obtaining the time and date.