Roborock S7 is one of the best robot vacuum cleaners available on the market and for sure the best one that I’ve ever seen so far, but I will not talk about its features and capabilities (if you want to see them check the description in Amazon or AliExpress). Instead of that I will just integrate the Roborock S7 with Home Assistant.

Two ways of Home Assistant Roborock S7 integration

I’m going to show you two ways for the Home Assistant Roborock S7 integration:

  • The first is plain, vanilla way where you just have to execute few easy steps and you will be ready in no time.
  • The second method is for the advanced users where we will extract the Cloud Token, we will configure the Roborock S7 in Home Assistant manually, we will extract the room map and we will add it in Home Assistant Lovelace as a custom card that shows and can control everything.

Do not worry here if you follow the steps you will see that the advanced method is not so complicated and it is very rewarding.

Home Assistant Roborock S7 integration – Prerequisites

First let’s talk about some prerequisites: 

  • The first one is obviously a Roborock S7 vacuum cleaner. You have to have such device, but the same procedure should apply for Roborock S6 & Roborock S5 models. 
Home Assistant Roborock S7 Integration (HOW-TO) 1
  • The second prerequisite is to pair your Roborock with Xiaomi Mi Home App and not with Roborock app. So if you are currently using Roborock mobile App you have to reset your WiFi settings, to download Xiaomi Mi Home App and to add your Roborock vacuum cleaner inside. The app will guide you through the pairing process, so it is not big of a deal.
    • Mi Home App for iOS 👉 LINK
    • Mi Home App for Android 👉 LINK

Quick Tip: Your Roborock S7 and Home Assistant should be in the same network. If they are in different VLANS for example there is a big chance that Home Assistant Roborock integration will not work for you.

  • The third prerequisite is to use Home Assistant OS or Home Assistant Supervised installation, as they have Supervisor & Add-on store. This is only needed if you are willing to use the advanced Home Assistant Roborock integration method. On the other hand, if you are up for the simple method then Home Assistant Container or Home Assistant Core installations will be enough.

Home Assistant Installation Types – Webinar

I’m really sorry If I’m confusing you with all these different Home Assistant installation types and names, but for good or for bad these are the official names of the different official installation methods.

If you want to know more about them I’m officially inviting you to join my free Home Assistant Webinar which is exactly on this topic. You will understand everything there, plus all of the pros & cons of every method. That way you can make an informed decision what is best for you.

4 Official + 1 Secret way to install Home Assistant Webinar 👉 https://automatelike.pro/webinar

Roborock S7 in Home Assistant – Simple Method

In this section, I will demo the first Home Assistant Roborock S7 method. This is the standard, easy & plain method, but without the goodies like, room maps extracted in Home Assistant Lovelace.

  • In Home Assistant, go to Configuration > Devices & Services > Add Integration > and search for Xiaomi. Alternatively, click on the my Home Assistant Link below.
Open your Home Assistant instance and start setting up a new integration.
Home Assistant Roborock S7 standard integration
Home Assistant Roborock S7 standard integration
  • When you are ready click the Submit and then Finish buttons.

If everything is fine you will see the Roborock current status and lot of Diagnostic data and sensors.

Added Roborock S7 in Home Assistant using the standard method
Added Roborock S7 in Home Assistant using the standard method

That was the standard Home Assistant Roborock S7 integration. You can now add the Roborock to your Home Assistant dashboard, you can start, pause and return to dock the vacuum cleaner, you can see most of the sensors and diagnostic data and of course, you can create Home Assistant Automations and scripts.

Roborock S7 in Home Assistant – Advanced Method

If you are eager to squeeze a bit more from your Home Assistant Roborock S7 integration, buckle your belt as we are starting with the second and more advanced method. 

Roborock S7 Token Extraction

The first thing that is needed is to extract the Xiaomi Cloud token, thanks to Piotr Machowski and his Xiaomi Cloud Tokens Extractor GitHub project this is very easy. Not only that, this great guy from Poland is also the author of the Xiaomi Cloud Map Extractor & Xiaomi Vacuum Map card that we are going to use later. So all of the credits for this second method of Home Assistant Roborock S7 integration goes to him. If you want to buy him a coffee or PayPal him – find the links of his GitHub page. Guys like him definitely deserves some support.

Now back to action with the Xiaomi Cloud Tokens Extractor.

  • Otherwise, download and install the SSH & Web Terminal add-on, which is available in Home Assistant > Configuration > Add-ons, Backups & Supervisor > Add-on store under Community section.

TIP: If you are not seeing the SSH & Web Terminal add-on – enable Advanced mode from your Home Assistant username profile.

  • Don’t forget to set a password from the Configuration tab and to disable the Protection mode in the Info tab.
SSH web terminal add-on with disabled protection mode
SSH & Web Terminal add-on with disabled protection mode
  • Start the add-on, wait few seconds and then click on the Open Web UI button.
  • Inside the opened Terminal, execute the following command:
bash <(curl -L https://github.com/PiotrMachowski/Xiaomi-cloud-tokens-extractor/raw/master/run_docker.sh)

This command will start a simple script, that will download a Docker image for you with all the prerequisites and will start the Piotr’s Xiaomi Cloud Token Extractor. So give it some time, depending of your Internet connection speed and device performance it can take several minutes before you will be asked for your Xiaomi app username and password.

  • Type your credentials, enter your Xiaomi region if you know it. Otherwise, leave this field empty and the Xiaomi Cloud Token Extractor will check all regions available.
  • After the program finish its execution you will see the Token. Copy the Token somewhere safe as we are going to use it in a moment.
Cloud Token Extractor in Progress
Cloud Token Extractor in Progress

Home Assistant Roborock S7 – manual config

Now when I have the Xiaomi Cloud Token I can try to add the Xiaomi Roborock S7 in Home Assistant manually. The procedure start exactly the same as with the simple method described above.

  • In Home Assistant, go to Configuration > Devices & Services > Add Integration > and search for Xiaomi. Alternatively, click on the My Home Assistant Link below.
Open your Home Assistant instance and start setting up a new integration.
Home Assistant Roborock S7 Manual Configuration
Home Assistant Roborock S7 Manual Configuration
  • On the next dialog, enter your Roborock S7 IP (You can get that either from Xiaomi Cloud Token Extractor tool, or from your router).
  • Paste the Token into the API Token field and click Submit and then Finish buttons.
Enter the Roborock S7 Cloud Token in Home Assistant
Enter the Roborock S7 Cloud Token in Home Assistant

It is good idea to enable some entities that are disabled by default. For example:  Total Clean Area, Total Clean Count, Total Duration and whatever else you wish.

Enable Some Roborock S7 entities
Enable Some Roborock S7 entities

Home Assistant Roborock S7 cloud map extractor

Time to extract the room map from the Xiaomi app. This map is not available until the first run of the vacuum, so if needed start one full clean first and then proceed. Then I recommend to install Home Assistant Community Store or HACS for short. I have a dedicated video & article with all the details and I will link it right here 👇

If you still don’t have HACS go see the above link and install HACS as I’m showing there. Then come back right here. When you are ready, do the following:

  • Open HACS, click on Integrations > Explore & Download Repositories, and search and install Xiaomi Cloud Map Extractor.
  • Restart Home Assistant from Configuration > Settings > Server Controls.
  • After restart, open your Home Assistant configuration.yaml file (with File Editor add-on for example) and paste the following lines inside:
# configuration.yaml entry
camera:
  - platform: xiaomi_cloud_map_extractor
    host: !secret xiaomi_vacuum_host
    token: !secret xiaomi_vacuum_token
    username: !secret xiaomi_cloud_username
    password: !secret xiaomi_cloud_password
    draw: ['all']
    attributes:
      - calibration_points
  • Save the changes and open your secrets.yaml file and paste the following lines:
# secrets.yaml entry 
xiaomi_vacuum_host: YOUR_ROBOROCK_IP
xiaomi_vacuum_token: YOUR_ROBOROCK_TOKEN
xiaomi_cloud_username: YOUR_XIAOMI_USER
xiaomi_cloud_password: YOUR_XIAOMI_PASS
  • Change all of the YOUR_… text with your real credentials and data, save the changes and restart Home Assistant once again.
  • After Home Assistant has started, check if everything is Okay, by pressing the ‘e‘ key when you are inside Home Assistant. This will open the Entity search bar. Start typing camera.xiaomi... and you should see a new entity called – camera.xiaomi_cloud_map_extractor.
Xiaomi cloud map extractor entity

Xiaomi cloud map extractor entity

Home Assistant Roborock S7 Xiaomi vacuum map card

Time for the final step which is to add Xiaomi Vacuum Map card inside Home Assistant. We are going to use HACS again as it is much easier that way.

  • Go to HACS > Frontend > Explore & Download Repositories > Search for Xiaomi Vacuum Map Card > Download this Repository with HACS > Download.
  • Go to Home Assistant Configuration > Dashboards > Resources and paste the following line as URL.
url: /hacsfiles/lovelace-xiaomi-vacuum-map-card/xiaomi-vacuum-map-card.js

Hit Create button and refresh/reload your browser.

Adding Resource in Home Assistant
Adding Resource in Home Assistant

From now on you can add the Xiaomi custom card in Home Assistant the standard way.

  • Go to Home Assistant Overview section, click on three dots menu in the upper right corner and select Edit Dashboard > Add Card.
  • Search for Xiaomi card, select it and click Save button.
Home Assistant Roborock S7 custom map in action.
Home Assistant Roborock S7 custom map in action.

This card contains UI configuration editor, but it is limited to only basic set of features. Its full potential can be achieved by manual yaml adjustments.If you want to do that you can always refer to the Piotr’s GitHub page.

As end result you will be able to see your Roborock S7 map and sensors in one place, you can do a zone cleaning as well as Pin & Go right from your Home Assistant. Of course, you can crate automations and scripts if you want.

Hope this article was useful for you! Subscribe for my newsletter and you will receive notifications when I release new articles.

I’m Kiril Peyanski and I’m done writing. Bye!


1 Comment

Jeffrey Goh · 20/05/2022 at 7:43 pm

Did you ever get Zone Cleanup or Pin & Go to work on the S7? So far the map extractor works great and I can just press start (next to locate vacuum and fan speed – pillbox bottom center of map) but neither ZC or P&G works for me.

Leave a Reply

Avatar placeholder

Your email address will not be published.

This site uses Akismet to reduce spam. Learn how your comment data is processed.