2025.3.4
首页 ▸ Voice control ▸

ESP32-S3-BOX 语音助手

本教程将指导您将 ESP32-S3-BOX、ESP32-S3-BOX-3(B) 或 ESP32-S3-BOX-Lite 转变为 Home Assistant 语音助手。请注意，ESP32-S3-BOX 术语可用于指代这三种产品变体中的任何一种。

前提条件

  • 安装了 Home Assistant 操作系统的 Home Assistant 2023.12 或更高版本。如果您尚未安装 Home Assistant，请参阅 安装页面 获取说明。
  • Home Assistant Cloud 或手动配置的 Assist 流水线
  • 您的 2.4 GHz Wi-Fi 网络密码
  • 桌面上的 Chrome 或 Edge 浏览器（而不是 Android/iOS）
  • Espressif ESP32-S3-BOX 变体之一：
    • ESP32-S3-BOX-3B
    • ESP32-S3-BOX-3、ESP32-S3-BOX 或 ESP32-S3-BOX-Lite（目前未上市）
  • 用于连接 ESP32-S3-BOX 的 USB-C 数据线
  • 本程序假设这是您第一次在设备上安装 ESPHome 固件。如果您之前完成过本教程并希望安装最新的软件版本，请按照 [更新 S3-BOX 上的软件] 的步骤进行操作(#updating-the-software-on-the-s3-box)。

在 ESP32-S3-BOX 上安装软件

在您可以将此设备与 Home Assistant 一起使用之前，需要在其上安装一些软件。

  1. 此步骤适用于 ESP32-S3-BOX-3 和 ESP32-S3-BOX-3B。确保该页面在 桌面 上的基于 Chromium 的浏览器中打开。软件安装在平板电脑或手机上无法使用。

    • 选择下面的 连接 按钮以显示可用 USB 设备的列表。请勿立即连接 ESP32-S3-BOX-3。我们希望先查看可用 USB 设备的列表，以便后续更容易识别 ESP 设备。

    • 如果您的浏览器不支持 Web 串行，您会看到一个警告消息，表示此情况，而不是按钮。

    • 对于高级用户：配置文件可以在 GitHub 上找到：

  2. 将 ESP32-S3-BOX-3 连接到您的计算机，按照以下步骤操作：

    • 在弹出窗口中查看可用端口。
    • 将 USB-C 数据线直接插入盒中，而不是插入底座（不是插入蓝色部分），并将其连接到您的计算机。
    • 故障排除：如果您的 ESP32-S3-BOX-3 未出现在浏览器提供的设备列表中，您需要手动调用 “闪存模式”：
      • 按住 “引导” 按钮（左侧上按钮），同时按下 “重置” 按钮（左侧下按钮）。
      • 几秒钟后，ESP32-S3-BOX-3 应该出现在浏览器提供的 USB 设备列表中。
      • 按照步骤一直到第 3 步。在选择 下一步 按钮后，再次按下 ESP32-S3-BOX-3 上的 “重置” 按钮。
      • 然后，再次选择蓝色 连接按钮，选择 USB 设备并按照提示配置 Wi-Fi。
      • 在弹出窗口中，现在应出现一个新条目。选择此 USB 串口并选择 连接。

  3. 选择 安装语音助手，然后 安装。

    • 安装完成后，选择 下一步。
    • 将 ESP32-S3-BOX-3 添加到您的 Wi-Fi：
      • 当提示时，从列表中选择您的网络并输入您的 2.4 GHz Wi-Fi 网络凭据。
      • 选择 连接。
      • ESP32-S3-BOX-3 现在已连接到您的网络。选择 添加到 Home Assistant。

  4. 这将打开 Home Assistant 的 我的 链接。

    • 如果您之前未使用过我的 Home Assistant，则需要进行配置。如果您的 Home Assistant URL 在 http://homeassistant.local:8123 上不可访问，请用您 Home Assistant 实例的 URL 替换它。
    • 打开链接。 打开我的链接

  5. 选择 确认。

    设置 ESPHome

  6. 要添加新发现的设备，从列表中选择 ESP32-S3-BOX-3。

    • 将您的 ESP32-S3-BOX-3 添加到一个房间，并选择 完成。

  7. 现在您应该看到 ESPHome 集成。 发现新 ESPHome 设备

  8. 选择 ESPHome 集成。在 设备 下，您应该看到列出的 ESP32-S3-BOX。 发现 ESP32-S3-BOX-3

    • 您的 ESP32-S3-BOX 已通过 Wi-Fi 连接到 Home Assistant。现在您可以将其移动到家庭中任何有 USB 电源的地方。

  1. 确保该页面在 桌面 上的基于 Chromium 的浏览器中打开。软件安装在平板电脑或手机上无法使用。

    • 如果您的浏览器不支持 Web 串行，您会看到一个警告消息，表示此情况，而不是按钮。

    • 对于高级用户：配置文件可以在 GitHub 上找到：

  2. 将 ESP32-S3-BOX 连接到您的计算机，按照以下步骤操作：

    • 在弹出窗口中查看可用端口。
    • 将 USB-C 数据线插入 ESP32-S3-BOX，并将其连接到计算机。

  3. 选择 安装语音助手，然后 安装。

    • 一旦安装完成，选择 下一步。
    • 将 ESP32-S3-BOX 添加到您的 Wi-Fi：
      • 当提示时，从列表中选择您的网络并输入您的 2.4 GHz Wi-Fi 网络凭据。
      • 选择 连接。
      • ESP32-S3-BOX 现在已连接到您的网络。选择 添加到 Home Assistant。

  4. 这将打开 Home Assistant 的 我的 链接。

    • 如果您之前未使用过我的 Home Assistant，则需要进行配置。如果您的 Home Assistant URL 在 http://homeassistant.local:8123 上不可访问，请用您 Home Assistant 实例的 URL 替换它。
    • 打开链接。 打开我的链接

  5. 选择 确认。 设置 ESPHome

  6. 要添加新发现的设备，从列表中选择 ESP32-S3-BOX。

    • 将您的 ESP32-S3-BOX 添加到一个房间，并选择 完成。

  7. 现在您应该看到 ESPHome 集成。 发现新 ESPHome 设备

  8. 选择 ESPHome 集成。在 设备 下，您应该看到列出的 ESP32-S3-BOX。 发现 ESP32-S3-BOX-3

    • 您的 ESP32-S3-BOX 已通过 Wi-Fi 连接到 Home Assistant。现在您可以将其移动到家庭中任何有 USB 电源的地方。

  1. 确保该页面在 桌面 上的基于 Chromium 的浏览器中打开。软件安装在平板电脑或手机上无法使用。

    • 如果您的浏览器不支持 Web 串行，您会看到一个警告消息，表示此情况，而不是按钮。

    • 对于高级用户：配置文件可以在 GitHub 上找到：

  2. 将 ESP32-S3-BOX-Lite 连接到您的计算机，按照以下步骤操作：

    • 在弹出窗口中查看可用端口。
    • 将 USB-C 数据线插入 ESP32-S3-BOX-Lite，并将其连接到计算机。

  3. 选择 安装语音助手，然后 安装。

    • 一旦安装完成，选择 下一步。
    • 将 ESP32-S3-BOX-Lite 添加到您的 Wi-Fi：
      • 当提示时，从列表中选择您的网络并输入您的 2.4 GHz Wi-Fi 网络凭据。
      • 选择 连接。
      • ESP32-S3-BOX-Lite 现在已连接到您的网络。选择 添加到 Home Assistant。

  4. 这将打开 Home Assistant 的 我的 链接。

    • 如果您之前未使用过我的 Home Assistant，则需要进行配置。如果您的 Home Assistant URL 在 http://homeassistant.local:8123 上不可访问，请用您 Home Assistant 实例的 URL 替换它。
    • 打开链接。 打开我的链接

  5. 选择 确认。 设置 ESPHome

  6. 要添加新发现的设备，从列表中选择 ESP32-S3-BOX-Lite。

    • 将您的 ESP32-S3-BOX-Lite 添加到一个房间，并选择 完成。

  7. 现在您应该看到 ESPHome 集成。 发现新 ESPHome 设备

  8. 选择 ESPHome 集成。在 设备 下，您应该看到列出的 ESP32-S3-BOX-Lite。 发现 ESP32-S3-BOX-3

    • 您的 ESP32-S3-BOX-Lite 已通过 Wi-Fi 连接到 Home Assistant。现在您可以将其移动到家庭中任何有 USB 电源的地方。

检查唤醒词设置

  1. 确保您的助手已 启用唤醒词，使用 “好的 Nabu”。

  2. 在 设备 下，在 ESP32-S3-BOX* 条目上，选择 设备 以打开设备页面。

  3. 检查设备设置：

    • 如果您希望，可以在 ESP32-S3 设备上处理唤醒词，而不是在您的 Home Assistant 服务器上。（服务器是安装了 Home Assistant 的设备，例如在 Home Assistant Green 上）：

    • 在 唤醒词引擎位置 下，选择 设备上处理，如果您希望唤醒词在设备上而不是在 Home Assistant 中处理。

      • 本地处理更快。
      • 唤醒词现在是 好的 Nabu。

      ESP32-S3-BOX-3 设备唤醒词处理

  4. 如果您选择了设备上的唤醒词，但不想使用 好的 Nabu，您可以更改设备上的唤醒词。

  5. 恭喜！您现在可以通过带显示的 ESP32 设备语音控制 Home Assistant。现在发出一些命令。

控制 Home Assistant

  1. 说出您的唤醒词。对于本教程，请使用 “好的 Nabu”。
  2. 说出一个 支持的语音命令。例如，打开灯。
    • 一旦意图被处理，LED 将亮起绿色，Home Assistant 确认该操作。
      • 确保您使用的区域名称与您在 Home Assistant 中定义的完全一致。
      • 您还可以问一个问题，例如
        • 前门锁了吗？
        • 客厅里哪些灯是开着的？
  3. 您的命令不受支持？使用 句子触发器 添加您自己的命令。

关闭麦克风或屏幕

  1. 如果您不希望助手听到您的声音一段时间，您可以关闭麦克风。

    • 转到 设置 > 设备与服务 并选择 ESPHome 集成。

      • 在 ESP32-S3-BOX-3 下，选择 1 个设备。
      • 启用 静音。
      • ESP32-S3-BOX-3 的屏幕也将关闭。

      切换以启用/禁用静音

  2. 如果您只想使用唤醒词，但不想使用屏幕，可以将其关闭。

    • 转到 设置 > 设备与服务 并选择 ESPHome 集成。

      • 在 ESP32-S3-BOX-3 下，选择 1 个设备。
      • 禁用 屏幕。

      切换以启用/禁用唤醒词

更新 S3-BOX 上的软件

要更新 S3-BOX 上的软件，请按照以下步骤操作，具体取决于您的设置。

  • 选项 1：您拥有 Home Assistant 2024.7 或更高版本，并且没有手动更改 S3-BOX 的 ESPHome 配置：
    • 一旦有更新可用，您将收到更新通知，像其他更新一样。
    • 要直接在您的盒子上安装预编译的新固件，请确保 S3-BOX 连接到您的网络，然后在 ESP32 S3 BOX…固件 下，选择 安装。
  • 选项 2：您拥有 Home Assistant 2024.6 或更早版本，并且没有手动更改 S3-BOX 的 ESPHome 配置：
    • 按照 [在 S3-BOX 上安装软件] 的步骤 1-3 进行操作(#installing-the-software-onto-the-esp32-s3-box)。
      • 这将安装您 S3-BOX 的最新预编译固件。
  • 选项 3：您手动更改了 S3-BOX 的配置文件：
    • 您需要自己编译固件。为此，您可以：
      • 在 Home Assistant 中使用 ESPHome 控制面板插件。虽然这是最简单的选项，但它通常是最慢的，并且可能失败，特别是在旧系统或内存/ CPU 资源有限的系统上。
      • 按照 ESPHome 文档 中的步骤操作，并使用桌面级系统编译和安装固件。初始设置更复杂，但该过程显著更快且更可靠。

相关主题

相关链接