home-assistant.io/source/_integrations/roomba.markdown

title, description, ha_category, ha_iot_class, ha_release, ha_conflig_flow, ha_codeowners, ha_domain, ha_config_flow, ha_dhcp, ha_platforms

title	description	ha_category	ha_iot_class	ha_release	ha_conflig_flow	ha_codeowners	ha_domain	ha_config_flow	ha_dhcp	ha_platforms
iRobot Roomba and Braava	Instructions on how to integrate your Wi-Fi enabled Roomba and Braava within Home Assistant.	Vacuum	Local Push	0.51	true	@pschmitt @cyr-ius @shenxn	roomba	true	true	binary_sensor sensor vacuum

The roomba integration allows you to control your iRobot Roomba vacuum or iRobot Braava m-series mop.

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.

{% include integrations/config_flow.md %}

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

Integration Entities

The Roomba Integration will add the following sensors.

Sensors:

• roomba_battery_level : The status of your battery
• roomba_bin_full (if Roomba has the capacity to do) : Bin Full status

Manually retrieving your credentials

Please refer to here or here to retrieve both the BLID (username) and the password.

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 command to retrieve the credentials does not need any additional software to be installed because it uses the built-in roombapy package and password function deployed with Home Assistant.