故障排除 ESP32-S3-BOX-3

本节提供了 Espressif 的 ESP32-S3-BOX-3 的故障排除步骤。

错误：无法连接到 Wi-Fi

症状

ESP32-S3-BOX-3 显示无法连接到 Wi-Fi 的消息。

解决方法

1. 首先，检查您的网络是否准备就绪。

   1. 确保路由器已开启并在可达范围内。
   2. 确保您选择了支持 2.4 GHz 的 Wi-Fi 网络。ESP32-S3-BOX-3 不会在 5 GHz 网络中显示。

2. 下一步是确保您输入了正确的 Wi-Fi 密码。根据您是否安装了 ESPHome 插件，按照 选项 1 或 选项 2 的步骤进行。

   • 选项 1：您没有安装 ESPHome 插件，或者您安装了插件但没有采纳 ESP32-S3-BOX-3。如果设备显示为绿色，则未被采纳。
     1. 确保 USB 电缆已连接到 ESP32-S3-BOX-3。
     2. 前往 ESPHome 项目网站，选择 连接 按钮，然后 更改 Wi-Fi。
   • 选项 2：您已经在 ESPHome 仪表板上安装并采纳了 ESP32-S3-BOX-3。

     1. 确保 USB 电缆已连接到 ESP32-S3-BOX-3。

     2. 在 Home Assistant 中，前往 设置 > 附加组件 > ESPHome，并 打开 Web 界面。

     3. 在 ESP32-S3-BOX-3 插件上，选择编辑。

        • 结果：打开一个编辑器，显示配置文件。

     4. 在 wifi 部分，检查是否引用了 secrets 文件（包含 !secret）。 如果不包含 wifi 部分，请输入以下部分：

        wifi:
          ssid: !secret wifi_ssid
          password: !secret wifi_password
        

     5. 关闭编辑器，在概览中选择 Secrets。

     6. 输入您的 Wi-Fi 凭据。

安装后 Wi-Fi 对话框从未出现

症状

安装向导从未显示连接到 Wi-Fi 的对话框，而是直接返回到 安装语音助手 的屏幕。

解决方法

1. 断开连接 ESP32-S3-BOX-3 的 USB 电缆，然后重新连接它。
2. 如果这没有帮助，检查您是否正在使用仅供电且不传输数据的 USB 电缆。

错误：没有 Home Assistant

症状

ESP32-S3-BOX-3 显示没有 Home Assistant 的消息。

描述

该消息表明设备能够连接到 Wi-Fi，但无法与 Home Assistant 通信。

解决方法

1. 如果您在重启或更新时看到此消息，请等待重启或更新完成。

   • 在这种情况下，您无需执行任何操作。设备暂时停止通信是预期的。

2. 确保您的设备与 Home Assistant 在同一网络上。

   • 如果您有复杂的网络设置与 VLAN，请确保它在同一 VLAN 中。

3. 前往 设置 > 设备和服务。

   • 如果设备显示为 已发现，请选择 添加。
   • 如果未发现，请选择 添加集成 > ESPHome。

4. 如果您看到以下屏幕，但 ESP32-S3-BOX-3 未列出，请选择 设置另一个 ESPHome 实例。

   

   • 前往您的路由器，找到您设备的 IP 地址或主机名，并输入它。