AtomS3R + Atomic Echo Base 语音助手

本教程介绍如何将 AtomS3R + Atomic Echo Base 结合，集成语音助手功能进入 Home Assistant。

1. 环境安装

1. 参考Home Assistant 官网文档安装 Home Assistant 2025.12.3及以上版本。
2. 参考以下教程完成语音识别相关插件安装和配置
- Home Assistant Cloud
- Assist Pipeline
3. 在 Setting -> Add-ons -> Add-ons STORE 中安装 ESPHome 插件，
4.ESPHome 插件成功，在 ESPHome 管理页面点亮Show in sidebar将其添加至左侧导航栏

提示

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

2. 添加设备

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

弹窗点击 CONTINUE

选择 New Device Setup ，创建新的配置文件

填写配置文件名称

选择设备类型，点击ESP32-S3 即可

复制Home Assistant API Encryption Key备用，点击 Skip

3. 配置设备

在新生成的配置处点击 EDIT，修改配置。 (Wi-Fi 配置默认为当前 HA 服务器的 Wi-Fi 配置，也可以根据实际情况配置 ssid, password 等选项)

添加下方资源包配置链接，为设备添加语音助手的功能组件。

packages:
  m5stack.atoms3r-with-echo-base: github://m5stack/esphome-yaml/common/atoms3r-with-echo-base.yaml@main 

之后点击右上角SAVE, INSTALL，弹出的安装方式中选择 Manual download

固件编译提示：

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

4. 固件烧录

固件保存

1. 完成固件编译后，点击 Download 按钮，选择 Factory Format (Previously Modern) 格式固件下载到本地。
2. 点击 Open ESPHome Web 使用 web 烧录工具烧录

提示

在下载选项界面可以点击 Open ESPHome Web

连接烧录

组装 AtomS3R 和 Atomic Echo Base，将 AtomS3R 设备通过 USB-C 数据线连接电脑，长按复位键直至绿灯亮起松开，使其进入下载模式。

在 Open ESPHome Web 中点击 CONNECT 连接设备，选择对应的设备端口

点击 INSTALL

选择先前步骤完成编译 *.bin 文件，再次点击 INSTALL 按钮进行烧录

等待烧录完成

5. 确认新设备配置

完成固件烧录后，设备开机将自动进行 Wi-Fi 连接。同一局域网内的 Home Assistant 服务将会提示新设备发现，在 Notifications 中选中新设备并 Check it out->CONFIGURE，按照弹框步骤将设备添加到指定的区域即可完成配置。若未收到新设备提示消息，点击 Settings->Device & services 可查看设备情况。