2025.3.4
首页 ▸ Integrations ▸

iRobot Roomba 和 Braava

Roomba integrations集成将 Home Assistant 与您的设备、服务等连接和集成。 [Learn more] 允许您控制您的 iRobot Roomba 吸尘器或 iRobot Braava m 系列拖把。

Note

此 integrations集成将 Home Assistant 与您的设备、服务等连接和集成。 [Learn more] 已经过测试，并确认可以与 iRobot Roomba s9+、Roomba 980、Roomba 960、Roomba 890 和 Braava jet m6 型号正常工作，但也应能与任何 Wi-Fi 连接的 Roomba 或 Braava 正常工作，例如 690。要进行自动发现，您需要重新启动 Roomba。例如，通过在 i7 或 980 上按住清洁按钮长达 20 秒。 有关如何重新启动机器人的更多信息。

配置

要将 iRobot Roomba 和 Braava integration 添加到您的 Home Assistant 实例中，请使用此 My 按钮：

iRobot Roomba 和 Braava 可以被 Home Assistant 自动发现。如果发现了实例， 它将显示为 已发现。您可以立即进行设置。

手动配置步骤

如果没有自动发现，请不要担心！您可以设置一个 手动集成条目：

  • 浏览到您的 Home Assistant 实例。

  • 转到 设置 > 设备与服务。

  • 在右下角，选择 Add Integration 按钮。

  • 从列表中选择 iRobot Roomba 和 Braava。

  • 按照屏幕上的说明完成设置。

Warning

Roomba 的 MQTT 服务器只允许单个连接。默认情况下启用连续模式，这将强制应用通过云连接到您的 Roomba。连续模式可以在添加后在集成的配置选项中禁用。有关更多信息，请参阅 Roomba 980 仓库。

集成实体

Roomba integrations集成将 Home Assistant 与您的设备、服务等连接和集成。 [Learn more] 将添加以下传感器。

传感器：

  • 电池: 您的电池状态
  • 垃圾箱已满（如果 Roomba 具备此功能）: 垃圾箱是否已满
  • 取消的任务: 总共取消的任务数量
  • 失败的任务: 总共失败的任务数量
  • 成功的任务: 总共成功的任务数量
  • 平均任务时间: 每个任务平均花费的时间
  • 总任务数: 所有任务的总数
  • 擦洗次数: 机器人执行“擦洗”操作的总次数
  • 总清洁时间: 机器人总共花费的清洁时间（小时）
  • 清洁总面积: 机器人清洁的总面积（平方米）

检索您的凭据

检查是否可以直接从设备中检索到凭据：

  1. 确保您所有设备上的 Roomba 应用都已关闭。
  2. 按照 Home Assistant 中的说明检索凭据。

如果自动检索无法正常工作，您可以手动检索凭据。要手动检索 BLID（用户名）和密码，请参考 Roomba 980 或 dorita 980 仓库中的说明。

对于 Home Assistant 容器，以下命令可以检索 BLID（用户名）和密码：

docker exec -it CONTAINER_NAME_OR_ID python -c 'import roombapy.entry_points; roombapy.entry_points.password()' ROOMBA_IP

Note

检索凭据的命令不需要安装任何额外的软件，因为它使用的是与 Home Assistant 一起部署的内置 roombapy 包和 password 函数。

使用 dorita980 从云中检索凭据

底层的 Python 库当前无法从某些较新型号（例如 J7）中检索凭据。有关详细信息，请参见 此问题。幸运的是，可以使用由 dorita980 库提供的工具从云中检索密码。按照 这些说明 操作，您应该会收到以下格式的输出：

Found 1 robot(s)!
Robot "RoombaJ7" (sku: j715800 SoftwareVer: sapphire+22.21.1+2022-06-02-570490a425b+Firmware-Production+70):
BLID=> XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
Password=> XXXXXXXXXXXXXXXXXXXXXXXXXXXXX <= 是的, 所有这个字符串。

在 dorita980 库中使用这些凭据 :)

将密码（在 => 和 <= 之间的内容，不包括首尾的空格）复制到 Home Assistant 密码对话框中。

故障排除

  • 集成向导在提交密码后显示“连接失败”: 在尝试恢复出厂设置（这可能是个繁琐的过程）之前，尝试在 Roomba 正在运行（即清洁）时在集成向导中提交密码。尽量避免打开应用程序以启动手动任务，而是直接按设备上的物理清洁按钮以启动手动任务。这似乎能在一些型号上解决此问题，因为它们只能在活跃运行时响应查询。

    如果这仍然无法解决问题，则恢复出厂设置该型号。