CoreS3 HA 语音助手

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

1. 准备工作

环境准备

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

• Home Assistant Cloud。
• Assist Pipeline。

硬件产品

• CoreS3

2. 在线烧录

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

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

在线烧录

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

3. 固件编译 & 烧录

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

创建设备

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

2. 弹窗点击CONTINUE。

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

4. 填写配置文件名称。

5. 选择设备类型，首先取消勾选Use recommended settings，然后点击ESP32-S3，选择M5Stack CoreS3。

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

修改配置

1. 点击设备左下角EDIT，修改 WiFi 连接配置。(Wi-Fi 配置默认为当前 HA 服务器的 Wi-Fi 配置，也支持直接修改为明文的方式:ssid:"xxxx")。

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

packages:
  remote_package_files:
    url: https://github.com/m5stack/esphome-yaml
    files: [common/cores3-satellite-base.yaml]
    ref: main
    refresh: 0s

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

烧录固件

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

2. 点击Open ESPHome Web使用 web 烧录工具烧录，或是通过 esptool 等其他工具进行烧录，固件烧录起始地址为 0x00。

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

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

5. 点击 INSTALL，选择先前步骤完成编译的*.bin文件。

6. 再次点击INSTALL 按钮进行烧录。

7. 等待烧录完成。

4. 开始使用

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

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

• 测试唤醒词。
  

• 选择区域。
  

• 选择 Pipeline。
  

• 完成设置。
  

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

5. 相关视频