解决Home Assistant Roborock集成常见问题：端口设置与设备连接排查

【免费下载链接】homeassistant-roborockRoborock integration for Home Assistant. This integration uses your devices from the Roborock App项目地址: https://gitcode.com/gh_mirrors/ho/homeassistant-roborock

Home Assistant Roborock集成允许用户将Roborock设备与Home Assistant系统无缝连接，实现智能控制和自动化。但在实际使用中，用户可能会遇到端口设置错误或设备连接失败等问题。本文将详细介绍如何排查和解决这些常见问题，帮助你快速恢复设备连接。

常见连接问题及表现

当Roborock设备无法连接到Home Assistant时，通常会出现以下几种情况：

• 认证失败：在配置流程中提示"auth"错误，无法完成登录验证
• 设备未找到：提示"no_device"错误，系统无法发现Roborock设备
• 主机不可达：设备IP地址或端口设置不正确导致连接超时
• 配置错误：网络设置或集成选项配置不当

这些问题主要与网络连接、端口设置或认证信息有关，通过系统排查通常可以解决。

端口与网络设置排查步骤

确认设备网络连接状态

首先确保Roborock设备已正确连接到家庭网络：

1. 检查设备是否已成功连接到Wi-Fi，可通过Roborock官方App确认
2. 确保设备与Home Assistant服务器在同一局域网内
3. 尝试重启路由器和Roborock设备，刷新网络连接

手动配置设备IP与端口

如果自动发现功能失败，可以手动配置设备网络信息：

1. 在Home Assistant中进入Roborock集成配置页面
2. 选择"configure_device"选项
3. 输入设备的IP地址和设备ID（可从Roborock App中获取）

配置文件路径：custom_components/roborock/config_flow.py中的DEVICE_SCHEMA定义了设备配置所需的参数，包括主机地址(CONF_HOST)和设备ID(CONF_DEVICE_ID)。

检查防火墙与端口占用情况

确保Home Assistant服务器的防火墙允许相关端口通信：

1. 检查是否有防火墙规则阻止Home Assistant访问网络
2. 确认Roborock设备所需端口未被其他应用占用
3. 尝试关闭防火墙或添加例外规则测试连接

认证与登录问题解决

验证账号信息

Roborock集成支持两种认证方式：验证码登录和密码登录。如果遇到认证问题：

1. 确认输入的用户名/邮箱正确无误
2. 检查验证码是否及时输入（验证码通常有有效期）
3. 尝试使用密码登录方式替代验证码登录

相关代码实现可参考custom_components/roborock/config_flow.py中的async_step_code和async_step_password方法。

重新授权流程

当认证信息过期或变更时，需要进行重新授权：

1. 在Home Assistant集成页面找到Roborock集成
2. 选择"重新配置"或"重新授权"选项
3. 按照提示完成新的登录验证流程

高级排查技巧

查看系统日志

Home Assistant日志可以提供详细的错误信息：

1. 在Home Assistant中开启调试日志，添加以下配置到configuration.yaml：

   logger: default: info logs: custom_components.roborock: debug

2. 查看日志文件中与Roborock相关的错误信息
3. 根据日志提示定位具体问题

检查设备兼容性

确认你的Roborock设备型号是否在支持列表中：

支持的主要型号包括：

• ROCKROBO_S4 (roborock.vacuum.s4)
• ROCKROBO_S5 (roborock.vacuum.s5)
• ROCKROBO_S6 (roborock.vacuum.s6)
• ROCKROBO_S7 (roborock.vacuum.a15)
• ROCKROBO_G10 (roborock.vacuum.a29)
• ROCKROBO_Q5 (roborock.vacuum.a34)

完整支持列表可查看custom_components/roborock/const.py文件中的设备型号定义。

集成配置选项调整

根据实际需求调整集成选项：

1. 在集成配置页面选择"选项"
2. 可配置的主要选项包括：
   • 地图转换设置（旋转、缩放、裁剪）
   • 清洁区域和禁区设置
   • 包含共享设备选项
   • 云集成开关

这些配置项在custom_components/roborock/config_flow.py中的OPTION_SCHEMA有详细定义。

常见问题FAQ

Q: 为什么我的Roborock设备在Home Assistant中显示为离线？
A: 首先检查设备是否在线，网络连接是否正常。尝试重启设备和Home Assistant，重新加载集成。如果问题持续，检查IP地址是否正确或是否有防火墙阻止连接。

Q: 配置时提示"auth"错误怎么办？
A: 这通常是认证失败导致的。确认用户名/邮箱正确，尝试重新获取验证码或使用密码登录方式。如果使用两步验证，请确保已正确完成验证步骤。

Q: 如何手动指定设备IP地址？
A: 在集成配置页面选择"configure_device"，输入设备的IP地址和设备ID。建议在路由器中为Roborock设备设置静态IP，避免IP地址变化导致连接问题。

通过以上步骤，大多数Home Assistant Roborock集成的端口设置和设备连接问题都可以得到解决。如果问题仍然存在，建议查看项目的官方文档或提交issue获取进一步支持。

【免费下载链接】homeassistant-roborockRoborock integration for Home Assistant. This integration uses your devices from the Roborock App项目地址: https://gitcode.com/gh_mirrors/ho/homeassistant-roborock