为什么选择这个集成方案?
传统的 Xiaomi 集成存在地图请求次数限制,而这个定制化方案完美解决了这个问题。通过本地网络通信,你可以同时使用官方 APP 和 HomeAssistant,无需在两者之间做出妥协。
核心优势:
- 🚫 无地图请求限制
- 📱 可与官方 APP 并行使用
- 🗺️ 内置实时地图显示
- 🔧 丰富的自定义服务
第一步:快速安装集成插件
通过 HACS 安装(推荐)
- 打开 HomeAssistant 的 HACS 集成
- 添加自定义仓库
- 搜索"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
实时状态监测
集成提供了全面的传感器数据,让你随时掌握设备状态:
- 清洁统计:当前清洁时长、清洁面积、累计数据
- 设备健康:主刷、边刷、滤网剩余寿命
- 电池信息:实时电量监测
- 工作状态:勿扰模式、错误提示

