AtomS3R + Atomic Echo Base 语音助手

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

准备工作

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

注意事项

• 2026-02：解决新版 ESPHome API 变更导致的编译错误，新版本在 ESPHome 2025.1.2 下编译，如遇见问题可以考虑切换到此版本。

创建设备

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

2. 弹窗点击 CONTINUE。

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

4. 填写配置文件名称。

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

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

修改配置

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

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

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

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

下载和烧录固件

1. 完成固件编译后，点击 Download 按钮，选择 Factory Format (Previously Modern) 格式固件下载到本地。

2. 点击 Open ESPHome Web 使用 web 烧录工具烧录。

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

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

5. 点击 INSTALL。

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

等待烧录完成。

开始使用

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

2. 接下来可以继续设置 Voice Assistant，也可以跳过此步骤之后再设置。

   • 测试唤醒词。
     

   • 选择区域。
     

   • 选择 Pipeline。
     

   • 完成设置。
     

完成设备添加，以及在准备步骤环节 Home Assistant Cloud 和 Assist pipeline 插件的配置后。即可使用唤醒词 "Okay Nabu"，唤醒语音助手。

效果演示视频：

相关视频