待补充
humbertogontijo/homeassistant-roborock
智能家居
3/5
🧩 软硬件结合
已发布
项目简介
Roborock integration for Home Assistant. This integration uses your devices from the Roborock App
这个开源项目「humbertogontijo/homeassistant-roborock」是一个专为Home Assistant智能家居平台开发的Roborock（石头）扫地机器人自定义集成组件。它的核心价值在于解决了官方Roborock App与Home Assistant无法同时使用、以及旧版Xiaomi集成存在地图请求次数限制的问题，让用户可以在Home Assistant中无缝控制Roborock设备，同时保留官方App的使用体验。
标签
项目特点
**双控无忧**：支持Home Assistant与官方Roborock App同时使用，互不干扰。
**无地图请求限制**：彻底解决旧版Xiaomi集成对地图请求次数的限制问题。
**完整设备控制**：支持启动、暂停、回充、定点清扫、选区清扫等全功能控制。
**实时状态与地图**：可获取设备实时状态、清洁记录、耗材寿命，并支持在Home Assistant中显示实时地图。
**多设备支持**：兼容Roborock S4、S5、S6、S7、S8、Q7、Q5等主流型号。
**配置简单**：通过Home Assistant的“配置”->“集成”界面即可添加，无需手动编辑配置文件。
技术规格
| 平台 | Home Assistant（HACS） |
|---|---|
| 设备协议 | 基于Roborock本地API（通过局域网通信） |
| 支持设备 | Roborock S4 / S5 / S5 Max / S6 / S6 MaxV / S7 / S7 MaxV / S8 / Q7 / Q5 等 |
| 通信方式 | 局域网（需设备与Home Assistant在同一网段） |
| 依赖组件 | `python-roborock` 库 |
| 最低Home Assistant版本 | 2023.1.0 |
| 集成类型 | 自定义集成（通过HACS安装） |
| 地图显示 | 支持（需配合 `lovelace-roborock-card` 或 `roborock-vacuum-card`） |
项目资源
搜索资源
物料清单 (BOM)
| 物料名称 | 数量 | 参考价格 | 备注 |
|---|---|---|---|
| Home Assistant服务器（树莓派/NAS/PC等） | 1 | — | 运行Home Assistant的主机 |
| Roborock扫地机器人 | 1 | — | 支持S4/S5/S6/S7/S8/Q7/Q5等型号 |
| 路由器/交换机 | 1 | — | 确保设备在同一局域网 |
| Home Assistant（已安装） | 1 | — | 版本≥2023.1.0 |
| HACS（Home Assistant Community Store） | 1 | — | 用于安装自定义集成 |
| python-roborock库 | 1 | — | 自动作为依赖安装 |
| lovelace-roborock-card 或 roborock-vacuum-card | 1 | — | 用于在仪表盘显示地图 |
能力画像
**记忆与知识检索**：2/5 — 项目本身不涉及知识检索，但需要用户了解Home Assistant基本操作和Roborock设备信息。
**动手与操作**：3/5 — 需要动手安装HACS、添加集成、配置设备，步骤简单但涉及多个环节。
**编程与算法**：1/5 — 无需编程，但若需自定义卡片或调试，可能涉及少量YAML配置。
**设计与建模**：1/5 — 不涉及设计或建模，但可自定义Lovelace仪表盘卡片布局。
**实验与调试**：2/5 — 若遇到设备连接问题，需进行基本的网络排查和日志查看。
**协作与分享**：2/5 — 可通过GitHub提交Issue或PR，但项目规模较小，协作需求不高。
**学习与研究**：3/5 — 适合学习Home Assistant自定义集成的工作原理、局域网API通信机制。
**系统集成**：4/5 — 核心能力在于将Roborock设备无缝集成到Home Assistant生态中，实现跨平台联动。
项目图库
所需技能
熟悉Home Assistant基本操作（安装、配置、添加集成）
了解HACS的安装与使用
基本的网络知识（确保设备在同一局域网）
能够阅读简单的YAML配置文件（可选）
会使用浏览器访问Home Assistant Web界面
适用场景
已部署Home Assistant并希望将Roborock扫地机器人纳入智能家居控制体系的用户
希望同时使用官方Roborock App和Home Assistant，不想二选一的用户
受限于旧版Xiaomi集成地图请求次数限制，需要更稳定方案的玩家
希望在Home Assistant中实现自动化场景（如离家自动清扫、与传感器联动）的智能家居爱好者
拥有多台Roborock设备，需要统一管理的家庭用户