HomeAssistant连接米家设备时，出现“无法发现设备”或“连接超时”问题如何解决？

Question

**HomeAssistant连接米家设备“无法发现设备”或“连接超时”问题解决方法** 在使用HomeAssistant连接米家设备时，若出现“无法发现设备”或“连接超时”的情况，可能是网络配置、密钥设置或设备兼容性问题导致。首先，确保米家设备与HomeAssistant运行在同一局域网内，并检查设备是否已正确接入Wi-Fi。其次，确认在HomeAssistant的Miio组件中正确填写了设备的IP地址和令牌（Token）。如果令牌未知，可通过重置设备或使用工具如`miot`获取。 此外，尝试更新HomeAssistant至最新版本，以支持更多设备类型和修复潜在bug。对于特定设备（如小米空调伴侣），可能需要手动指定协议版本（如`miot`或` legacy`）。最后，关闭防火墙或调整路由器设置，允许必要的端口通信，以避免网络阻塞引发连接超时。通过以上步骤，通常可以有效解决连接问题。

Answer 1

1. 初步检查与网络配置

在解决HomeAssistant连接米家设备“无法发现设备”或“连接超时”的问题时，首先需要确认基本的网络配置是否正确。以下是关键步骤：

• 确保米家设备和运行HomeAssistant的主机在同一局域网内。
• 检查米家设备是否已成功接入Wi-Fi，可以通过米家App查看其状态。
• 确认路由器未启用访客网络或隔离模式，这些设置可能会阻止设备间通信。

如果网络配置无误，但问题仍然存在，请继续检查以下内容。

2. 配置Miio组件与令牌获取

HomeAssistant通过Miio组件与米家设备通信，因此正确的配置至关重要：

1. 在HomeAssistant的配置文件中，为米家设备指定IP地址和令牌（Token）。
2. 如果令牌未知，可以通过重置设备或使用工具如`miot`来获取。

# 示例配置
miio:
  - host: 192.168.1.100
    token: 00000000000000000000000000000000
    

注意：令牌是一个32位的十六进制字符串，错误的令牌会导致连接失败。

3. 更新HomeAssistant与协议调整

HomeAssistant的版本更新通常会修复已知问题并支持更多设备类型。以下是建议步骤：

步骤	描述
1	将HomeAssistant更新至最新稳定版本。
2	对于特定设备（如小米空调伴侣），尝试手动指定协议版本（如`miot`或`legacy`）。

某些设备可能需要特定的协议支持，这在旧版本中可能不可用。

4. 网络环境优化

防火墙、路由器设置或端口限制可能导致连接超时。以下是优化建议：

使用Mermaid流程图展示排查步骤：

graph TD;
            A[检查防火墙] --> B{防火墙是否开启};
            B --是--> C[关闭防火墙];
            B --否--> D[检查路由器设置];
            D --> E{是否允许必要端口};
            E --否--> F[调整路由器设置];
            E --是--> G[测试连接];

确保路由器允许HomeAssistant与米家设备之间的通信，避免因端口阻塞导致的问题。

5. 进阶调试与日志分析

如果上述方法均无效，可以启用HomeAssistant的日志功能进行深入分析：

logger:
  default: warning
  logs:
    homeassistant.components.miio: debug
    

通过日志输出，可以定位具体的错误原因，例如网络延迟、协议不匹配或设备兼容性问题。