Atom VoiceS3R 语音助手

本章节介绍如何将 Atom VoiceS3R 配置为 Home Assistant 语音助手。

1. 准备工作

环境准备

参考 Home Assistant 官方文档安装 Home Assistant。
参考 ESPHome 官方文档完成 ESPHome Device Builder 插件安装。（注意：本教程基于 ESPHome 2025.1.2 版本编写，如遇编译错误，建议先切换至该版本进行验证。）
完成语音识别相关插件的安装和配置：

Home Assistant Cloud。
Assist Pipeline。

硬件产品

Atom EchoS3R

2. 在线烧录

点击下方在线烧录按钮，按提示完成固件烧录和 Wi-Fi 配置，即可快速体验 Atom VoiceS3R 接入 Home Assistant。

烧录及配置的详细操作可参考在线 ESPHome 固件烧录与配置说明。

使用在线烧录功能完成后，无需执行“固件编译 & 烧录”步骤，直接跳转至4. 开始使用章节继续后面的操作。

3. 固件编译 & 烧录

本小节将说明如何基于 yaml 配置文件重新编译项目，便于二次开发、功能修改或新增功能。

编译时长

通过 HA 进行固件编译较为耗费资源，首次编译可能会需要较长时间进行资源下载，跟实际部署 HA 服务的设备以及网络质量相关。

创建设备

打开 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选项至末尾。

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 