HomeAssistant 接入石头扫地机器人配置实战
很多用户在构建智能家居时，常遇到官方 Xiaomi 集成存在地图请求限制的问题，且难以同时使用官方 APP。针对石头扫地机器人（Roborock），采用本地网络通信的定制集成方案是更优解，它能实现真正的自动化联动。
集成安装
推荐使用 HACS 进行安装。在 HACS 界面添加自定义仓库，搜索 "Roborock" 并下载。安装完成后重启 HomeAssistant 服务。
网络环境要求：
- UDP 端口 58866：用于设备发现
- TCP 端口 58867：用于设备控制
- 确保 HomeAssistant 与扫地机器人在同一局域网内
设备连接
进入'设置'→'设备与服务'，点击'添加集成'并搜索 "Roborock"。输入 Roborock APP 中的用户名，系统将发送验证码至邮箱，填入即可完成认证。若遇连接问题，可尝试刷新页面或重启服务。
功能拓展
基础控制
支持一键启停清扫、暂停任务、自动回充、吸力调节及定点清洁。
高级服务
通过自定义服务可实现精细操作：
- 远程遥控：
vacuum_remote_control_start,vacuum_remote_control_move - 区域清洁：
vacuum_clean_zone,vacuum_clean_segment - 精确导航：
vacuum_goto
状态监测
集成提供清洁统计、配件寿命（主刷、滤网）、电池信息及错误提示。内置地图功能可直观展示清扫路径与当前位置。
自动化建议
- 定时联动：离家后自动启动，回家前完成清洁。
- 场景触发：检测到特定区域（如厨房）脏污时触发清洁。
- 维护提醒：基于传感器数据设置滤网更换提醒。
常见问题
- 无法连接？ 检查端口配置及账号验证信息。
- 能否共用官方 APP？ 可以，两者互不冲突。
- 型号兼容性？ 主要针对 S7 Maxv，通常兼容其他主流型号。
通过以上配置，石头扫地机器人将成为智能家居生态的一部分，带来更智能便捷的清洁体验。
