diff --git a/source/_integrations/roomba.markdown b/source/_integrations/roomba.markdown index 819ef1da823..2ea89784ad9 100644 --- a/source/_integrations/roomba.markdown +++ b/source/_integrations/roomba.markdown @@ -63,3 +63,18 @@ docker exec -it CONTAINER_NAME_OR_ID python -c 'import roombapy.entry_points; ro The command to retrieve the credentials does not need any additional software to be installed because it uses the built-in [roombapy](https://github.com/pschmitt/roombapy) package and [password](https://github.com/pschmitt/roombapy/blob/1.6.1/roomba/entry_points.py#L20) function deployed with Home Assistant. + +#### Retrieving credentials from the cloud with dorita980 + +The underlying Python library is currently unable to retrieve the credentials from some newer models (e.g. J7). See [this issue](https://github.com/pschmitt/roombapy/issues/97) for details. Luckily, the password can be retrieved from the cloud using a tool provided by the [dorita980](https://github.com/koalazak/dorita980) library. Follow [these instructions](https://github.com/koalazak/dorita980#how-to-get-your-usernameblid-and-password) to do this, you should receive output of the form: + +```shell +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 `=>` and `<=`, not including leading and trailing whitespace) into the Home Assistant password dialog.