HomeAssistant Roborock集成配置与使用指南-优快云博客

项目概述

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

HomeAssistant Roborock集成是一个专门为Roborock（石头）扫地机器人设计的自定义组件，能够将您的扫地机器人无缝集成到HomeAssistant智能家居系统中。该项目使用Roborock App中的设备信息，为HomeAssistant用户提供丰富的设备控制和管理功能。

项目结构解析

homeassistant-roborock/
├── custom_components/roborock/          # 核心组件目录
│   ├── __init__.py                         # 组件初始化入口
│   ├── config_flow.py                      # 配置向导流程
│   ├── const.py                            # 常量定义文件
│   ├── manifest.json                       # 组件清单文件
│   ├── vacuum.py                           # 扫地机器人控制逻辑
│   ├── sensor.py                           # 传感器数据处理
│   ├── binary_sensor.py                    # 二进制传感器
│   ├── camera.py                           # 摄像头功能
│   ├── common/                             # 公共模块
│   │   ├── image_handler.py               # 图像处理
│   │   ├── map_data.py                     # 地图数据处理
│   │   ├── map_data_parser.py             # 地图数据解析
│   │   └── types.py                        # 类型定义
│   └── translations/                       # 多语言翻译文件
├── tests/                                   # 测试文件目录
├── README.md                                # 项目说明文档
└── requirements.txt                         # 依赖包列表

核心功能特性

扫地机器人控制

启动和停止扫地机器人
暂停清扫任务
返回充电座
调节吸力强度
查看电池状态
定位机器人位置
定点清扫功能

传感器数据监控

免打扰模式开始时间
免打扰模式结束时间
上次清扫开始时间
上次清扫结束时间
上次清扫时长
上次清扫面积
当前错误状态
当前清扫时长
当前清扫面积
总清扫时长
总清扫面积
总清扫次数
总集尘次数
主刷剩余寿命
边刷剩余寿命
滤网剩余寿命
传感器清洁剩余时间

二进制传感器状态

拖布是否安装
水箱是否安装
是否缺水状态

地图功能

集成内置地图功能，显示扫地机器人最近/当前运行的清扫路径和地图信息。

安装配置步骤

通过HACS安装

打开HomeAssistant实例
进入HACS -> 集成
添加自定义仓库
搜索并下载Roborock集成
重启HomeAssistant服务

网络配置要求

确保您的HomeAssistant实例能够：

在端口58866上接收设备广播
在端口58867上与设备通信

集成设置流程

点击"添加集成"按钮
搜索"Roborock"
输入您在Roborock App中使用的用户名并提交
您将收到包含验证码的电子邮件
输入验证码并提交
配置完成

高级功能配置

摄像头集成

如果您的扫地机器人内置摄像头，可以使用go2rtc项目来实现摄像头功能。

服务功能支持

通过服务支持以下高级功能：

远程控制
区域清扫
前往指定位置
分区清扫
设置拖地模式
设置拖地强度
重置耗材

配置选项详解

地图变换配置

缩放比例设置
旋转角度调整（支持0°、90°、180°、270°）
裁剪设置（左、右、上、下边界）
包含忽略的障碍物
包含禁行区域

设备网络配置

支持手动配置设备网络信息：

设备主机地址
设备唯一标识符

多语言支持

项目提供完善的多语言翻译，包括：

中文、英文、德语、法语
意大利语、西班牙语、葡萄牙语
俄语、日语、韩语等

自动化场景示例

日常清扫自动化

automation:
  - alias: "Morning Cleaning"
    trigger:
      platform: time
      at: "08:00:00"
    action:
      - service: vacuum.start
        target:
          entity_id: vacuum.living_room

地理围栏触发

automation:
  - alias: "Away Mode Cleaning"
    trigger:
      platform: state
      entity_id: person.family_member
      to: "not_home"
    action:
      - service: vacuum.start
        target:
          entity_id: vacuum.living_room

故障排除指南

常见问题解决

设备连接失败：检查网络配置和端口设置
认证失败：验证用户名和验证码是否正确
地图显示异常：检查地图变换配置参数

日志调试

集成提供详细的日志记录功能，可通过查看日志来诊断问题：

logger:
  logs:
    custom_components.roborock: debug

项目依赖要求

项目运行需要以下Python包：

python-roborock==0.39.2
ical==7.0.3
dacite==1.8.0

版本信息

当前集成版本：1.0.13 支持HomeAssistant版本：最新稳定版

通过本指南，您可以充分利用HomeAssistant Roborock集成的各项功能，打造智能化的家居清洁体验。

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考