Atom EchoS3R 语音助手

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

准备工作

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

注意事项

创建设备

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

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

3. 点击New Device Setup。

4. 为配置取一个合适的名称。

5. 首先取消勾选Use recommended settings，接着设备选择ESP32S3。

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

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

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

修改配置

1. 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

2. 点击Save，Install进行安装。

3. 根据实际情况，选择您的安装方式。一般情况下，如果设备已经连接至 Home Assistant 主机，并且进入了下载模式，可以选择Plug into the computer running ESPHome Device Builder，之后选择串口设备进行编译上传。

这里我们用Manual download做示范：

下载和烧录固件

1. 编译完成后，接着点击Open ESPHome Web，同时，选择Factory format下载固件。

2. 在 ESPHome Web 页面，点击CONNECT连接您的设备。

3. 选择正确的串行端口。

4. 点击INSTALL，上传固件。

5. 等待烧录完成，RESET 设备。

开始使用

1. 设备上电后会自动连接 WiFi，同一局域网内的 Home Assistant 设备会提示发现新设备。可以在 Notifications 中找到设备，点击Check it out进行配置。
2. 如果没有通知提醒，可以点击Settings -> Devices & Services下寻找设备并配置。

3. 点击Add添加集成。

4. 设置了正确的 Pipeline 之后，尝试使用Okay Nabu唤醒词唤醒设备。

相关视频