Atom EchoS3R Voice Assistant

This chapter describes how to configure the Atom EchoS3R as a Home Assistant voice assistant.

Preparation

• Refer to the Home Assistant Official Documentation to install Home Assistant.
• Install the ESPHome Builder add-on in Setting -> Add-ons -> Add-ons STORE.
• Once the ESPHome Builder add-on is installed, select Show in sidebar on its management page to add it to the left navigation bar.
• This tutorial refers to the ESPHome Official Documentation; you can visit it if needed.
• Refer to the following tutorials to complete the installation and configuration of voice recognition related add-ons.
  • Home Assistant Cloud.
  • Assist Pipeline.

Note

Create Device

1. Open the ESPHome add-on page and click NEW DEVICE in the bottom right corner to create a new device.

2. When the New device prompt appears, click the CONTINUE button.

3. Click New Device Setup.

4. Give the configuration a suitable name.

5. First, uncheck Use recommended settings, then select ESP32S3 as the device.

6. A pop-up will prompt you to select the appropriate device. Here we choose Espressif ESP32-S3-Box, then continue to the next step to set the Home Assistant API Key and YAML configuration file.

7. Copy the API Key for later use, then click Skip.

8. Under the generated configuration file, click Edit to continue modifying the generated YAML file.

Modify Configuration

1. The YAML configuration file example is as follows. Add the packages option to the end.

esphome:
  name: atom-echos3r-voice-assistant
  friendly_name: Atom Echo S3R Voice Assistant

esp32:
  board: esp32s3box
  framework:
    type: esp-idf

# Enable logging
logger:

# Enable Home Assistant API
api:
  encryption:
    key: "***********************"

ota:
  - platform: esphome
    password: "************************"

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

  # Enable fallback hotspot (captive portal) in case wifi connection fails
  ap:
    ssid: "Atom-EchoS3R-Voice-Assistant"
    password: ""

captive_portal:

# Add the external package here
packages:
  remote_package_files:
    url: https://github.com/m5stack/esphome-yaml
    files: [common/atom-echos3r-satellite-base.yaml]
    ref: main
    refresh: 0s

2. Click Save, then Install to perform the installation.

3. Choose your installation method according to the actual situation. Generally, if the device is already connected to the Home Assistant host and has entered download mode, you can select Plug into the computer running ESPHome Device Builder, then select the serial device to compile and upload.

Here we use Manual download as a demonstration:

Download and Burn Firmware

1. Once the compilation is complete, click Open ESPHome Web. Meanwhile, select Factory format to download the firmware.

2. On the ESPHome Web page, click CONNECT to connect your device.

3. Select the correct serial port.

4. Click INSTALL to upload the firmware.

5. Wait for the burning to complete, then RESET the device.

Learn

1. After the device powers on, it will automatically connect to WiFi. Home Assistant devices on the same local network will prompt that a new device has been discovered. You can find the device in Notifications and click Check it out to configure it.
2. If there is no notification reminder, you can go to Settings -> Devices & Services to find the device and configure it.

3. Click Add to add the integration.

4. After setting the correct Pipeline, try using the wake word Okay Nabu to wake up the device.

Video