Skip to content

Vacuum Setup


I have a Roborock S5 Max vacuum robot. It's paired with Home Assistant using built-in Xiaomi Miio integration.

In order to get this device working with Home Assistant, you must obtain an access token, which is a bit tricky. Fortunately, there's a guide on how to get this token.

I used a vacuum-card I built myself for controlling my vacuum and lovelace-xiaomi-vacuum-map-card for displaying a live map.

You can find the latest state of my vacuum setup here:

Automations Scripts

Asking to start cleaning

I have a relatively complex set of automation for my vacuum.

At first, I just used to start my robot every couple of days. It's not a good approach, because it always starts vacuuming right in the middle of a working call.

Over time, I've changed logic to more complex and elegant.

Now my vacuum sends an actionable notification asking to start cleaning, based on multiple conditions:

  • Robot is docked.
  • It's a working day.
  • It's a time during working hours.
  • Do Not Disturb mode is off.
  • It's time to clean, meaning: the previous cleaning was too short to clean the whole home, or there was no cleaning in a reasonable period.

When I think it's a good time to start cleaning, I press a button in the notification, and the robot starts cleaning.

Additionally, the robot starts cleaning every time we leave our home, and it's time to clean.

Asking to clean itself

I solved this issue by automatically sending it to the trash bin after every 5th cleaning.

The tricky part here is to tell the robot where to go. There is an article that helped me solve this issue: How I set up room-cleaning automation with Google Home, Home-Assistant and Xiaomi vacuum cleaner

Using the method described in the article, I've found the location of my trash bin. In my case, it's:

[24500, 24500];

Now I can send the vacuum to this spot in my home, like this:

  alias: Vacuum Maintenance
  icon: mdi:screwdriver
    - service: vacuum.send_command
      entity_id: vacuum.roborock
        command: app_goto_target
        params: [24500, 24500] # Coordinates near the trash bin

Cleaning the specific room

I made shortcuts for cleaning rooms separately. Here's a guide how to retrieve valid room number: Retrieving room numbers.

Here are mine:

  [16, '350001002902'], // Living Room
  [17, '350001004993'], // Bedroom
  [18, '350001010484'], // Corridor
  [19, '350001010483'], // Bathroom
  [20, '350001010672'], // Kitchen

Using the first number in these tuples, I can send a vacuum to clean a specific room like this:

# Single Room
  alias: Vacuum Clean Kitchen
  icon: mdi:silverware-fork-knife
    - service: vacuum.send_command
        entity_id: vacuum.roborock
        command: app_segment_clean
        params: [20]

# Multiple rooms
  alias: Vacuum Clean Living Room
  icon: mdi:sofa
    - service: vacuum.send_command
        entity_id: vacuum.roborock
        command: app_segment_clean
        params: [16, 20]