Atom EchoS3R 语音助手

1. 环境安装

参考 Home Assistant 官网文档安装 Home Assistant。
在 Setting -> Add-ons -> Add-ons STORE 中安装 ESPHome Builder 插件。
ESPHome Builder 插件安装成功后，在其管理页面选中 Show in sidebar 将其添加至左侧导航栏。
本教程参考自 HA 官方使用文档，如有需要可自行访问。
参考以下教程完成语音识别相关插件安装和配置
- Home Assistant Cloud
- Assist Pipeline

本教程在 ESPHome 2025.9.0 下编译（推荐版本），如果在编译过程中出现问题，考虑将 ESPHome 切换至此版本

2. 添加设备

打开 ESPHome 插件页面，右下角点击 NEW DEVICE，创建一个新设备。

出现 New device 提示界面，点击 CONTINUE 按钮。

点击New Device Setup

为配置取一个合适的名称：

首先取消勾选Use recommended settings, 接着设备选择ESP32S3：

弹窗会提示选择合适的设备，这里我们选用Espressif ESP32-S3-Box，继续下一步设置 Home Assistant API Key 和 YAML 配置文件

复制 API Key 备用，之后点击Skip，

在生成的配置文件下点击Edit继续修改生成的 YAML 文件

YAML 配置文件示例如下，添加packages选项至末尾：

yaml 
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:
  m5stack.atom-echos3r-voice-assistant: github://m5stack/esphome-yaml/common/atom-echos3r-satellite-base.yaml@main