This integration has been tested and confirmed to be working with the iRobot Roomba s9+, Roomba 980, Roomba 960, Roomba 890, and Braava jet m6 models, but should also work fine with any Wi-Fi enabled Roomba or Braava like the 690. For auto-discovery, you will need to initiate a Roomba reboot. For example, by holding the clean button for up to 20 seconds on an i7 or 980. More information about rebooting your robot.
To add the iRobot Roomba and Braava integration to your Home Assistant instance, use this My button:
iRobot Roomba and Braava can be auto-discovered by Home Assistant. If an instance was found, it will be shown as Discovered. You can then set it up right away.
If it wasn’t discovered automatically, don’t worry! You can set up a manual integration entry:
The Roomba’s MQTT server only allows a single connection. Enabling continuous mode will force the App to connect via the cloud to your Roomba. More info here
The Roomba Integration will add the following sensors.
- roomba_battery_level : The status of your battery
- roomba_bin_full (if Roomba has the capacity to do) : Bin Full status
For Home Assistant Container, the following command retrieves the BLID (username) and password:
docker exec -it CONTAINER_NAME_OR_ID python -c 'import roombapy.entry_points; roombapy.entry_points.password()' ROOMBA_IP
The underlying Python library is currently unable to retrieve the credentials from some newer models (e.g. J7). See this issue for details. Luckily, the password can be retrieved from the cloud using a tool provided by the dorita980 library. Follow these instructions to do this, you should receive output of the form:
Found 1 robot(s)! Robot "RoombaJ7" (sku: j715800 SoftwareVer: sapphire+22.21.1+2022-06-02-570490a425b+Firmware-Production+70): BLID=> XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX Password=> XXXXXXXXXXXXXXXXXXXXXXXXXXXXX <= Yes, all this string. Use this credentials in dorita980 lib :)
Copy the password (everything between
<=, not including leading and trailing whitespace) into the Home Assistant password dialog.