Voice Pyramid Home Assistant Integration

This tutorial explains how to integrate the Voice Pyramid voice base into Home Assistant.

Preparation

• Home Assistant host.
• Install and enable ESPHome Builder in Home Assistant.
• Main controller AtomS3R

Note

• This tutorial uses ESPHome version 2026.1.2 for firmware compilation and flashing. If you encounter problems during the compilation/flashing process, it is recommended to switch ESPHome to this version and try again.

Create Device

1. Click the green button in the bottom right corner to create a new device.

2. Click CONTINUE.

3. Click New Device Setup.

4. Enter the device name, then click NEXT.

5. Select ESP32-S3.

6. Click SKIP.

7. Click EDIT to customize device functions via the YAML file.

Modify Configuration

Below are the core parts of the configuration. Reference links and descriptions are provided later.

PSRAM Configuration

Add PSRAM component:

psram:
  mode: octal
  speed: 80MHz

External Components

Add External components:

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

I2C Bus Configuration

Add I2C component:

i2c:
  - id: bsp_bus
    sda: GPIO45
    scl: GPIO0
    scan: true
  - id: ext_bus # For Atomic Voice Base
    sda: GPIO38
    scl: GPIO39

I2S Audio Configuration

Add I2S Audio component:

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

Audio DAC Configuration

Add 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 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 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 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

Download and Flash Firmware

1. After modifying the configuration, click SAVE and INSTALL in the upper right corner, then select Manual Download from the pop-up window.

2. Once the firmware compilation is complete, click download and select Factory format(Previously Modern).

3. Connect the device to the host using a USB Type-C cable. Open ESPHome Web, and click CONNECT to connect to the device.

4. Locate the corresponding serial port number.

5. Click INSTALL.

6. Select the compiled firmware to upload.

7. After flashing is complete, restart the device.

Learn

1. In Home Assistant, click Settings -> Device & services to check the device.

2. The corresponding device can be found in the Discover section.

3. After adding the device, you will see that the relevant data is displayed correctly.

Finally, users can configure various controllable hardware on the Voice Pyramid through the control panel and use the custom wake word (Echo-Pyramid Wake Word) to activate the device, enabling intelligent voice interaction functions such as querying weather, time, and date.

Video