3个步骤让石头扫地机器人无缝接入HomeAssistant智能家居
还在为频繁切换Roborock官方APP和HomeAssistant而烦恼吗？这个专为石头扫地机器人设计的集成插件，能够让你的清洁设备真正融入智能家居生态，实现自动化联动控制。
为什么选择这个集成方案？
传统的Xiaomi集成存在地图请求次数限制，而这个定制化方案完美解决了这个问题。通过本地网络通信，你可以同时使用官方APP和HomeAssistant，无需在两者之间做出妥协。
核心优势：
- 🚫 无地图请求限制
- 📱 可与官方APP并行使用
- 🗺️ 内置实时地图显示
- 🔧 丰富的自定义服务
第一步：快速安装集成插件
通过HACS安装（推荐）
- 打开HomeAssistant的HACS集成
- 添加自定义仓库：https://gitcode.com/gh_mirrors/ho/homeassistant-roborock
- 搜索"Roborock"并下载安装
- 重启HomeAssistant服务
重要提示： 确保你的HomeAssistant实例能够在58866端口接收设备广播，并能在58867端口与设备通信。
配置网络环境
为了让集成正常工作，你需要确保以下网络配置：
- 开放UDP端口58866用于设备发现
- 允许TCP端口58867用于设备控制
- 确保HomeAssistant与扫地机器人在同一局域网内
第二步：完成设备认证与连接
安装完成后，按照以下步骤完成设备配置：
- 进入"设置"→"设备与服务"
- 点击"添加集成"
- 搜索"Roborock"
- 输入你在Roborock APP中使用的用户名
- 提交后，你将收到包含验证码的邮件
- 输入验证码完成认证
小贴士： 如果遇到连接问题，尝试刷新浏览器页面或重启HomeAssistant服务。
第三步：充分利用丰富功能
基础清洁控制
- 启动/停止清扫：一键控制扫地机器人工作状态
- 暂停功能：临时中断当前清扫任务
- 回充指令：让设备自动返回充电座
- 风速调节：根据清洁需求调整吸力强度
- 定点清洁：针对特定区域进行重点清扫
高级控制服务
通过自定义服务，你可以实现更精细的控制：
远程遥控模式：
- 启动远程控制：
vacuum_remote_control_start - 移动控制：
vacuum_remote_control_move - 停止远程控制：
vacuum_remote_control_stop
区域清洁功能：
- 指定区域清洁：
vacuum_clean_zone - 分段清洁：
vacuum_clean_segment - 精确导航：
vacuum_goto
实时状态监测
集成提供了全面的传感器数据，让你随时掌握设备状态：
- 清洁统计：当前清洁时长、清洁面积、累计数据
- 设备健康：主刷、边刷、滤网剩余寿命
- 电池信息：实时电量监测
- 工作状态：勿扰模式、错误提示
地图可视化
内置的地图功能能够显示扫地机器人最近的清扫路径和当前位置，让你直观了解清洁覆盖情况。
配件状态检测
- 拖布模块是否安装
- 水箱是否连接
- 缺水预警提示
实用场景与自动化建议
场景一：定时清洁联动
设置自动化规则，让扫地机器人在你离家后自动开始工作，回家前完成清洁。
场景二：区域重点清洁
当检测到特定区域（如厨房）需要清洁时，触发区域清洁服务。
场景三：设备维护提醒
基于传感器数据，设置滤网更换、刷头维护的自动化提醒。
常见问题解答
Q：集成安装后设备无法连接怎么办？ A：首先检查网络端口配置，确保HomeAssistant能够与设备通信。同时验证用户名和验证码是否正确。
Q：可以同时使用官方APP吗？ A：完全可以！这正是这个集成的优势所在，两者可以并行使用。
Q：支持哪些型号的石头扫地机器人？ A：项目主要针对Roborock S7 Maxv开发，但通常兼容其他型号。
通过这个三步配置流程，你的石头扫地机器人将真正成为智能家居生态系统的一部分，实现更加智能、便捷的清洁体验。立即开始配置，享受自动化带来的便利吧！
