Vacuum cleaners

Introduction

The Xiaomi Mi Home eco system supports a variety of vacuum cleaner models. This page contains specific information about some flow card for vacuum cleaners paired with Homey.

Using the Go To Target action card

This action card will send your vacuum cleaner to a specific target in the room, for instance in front of the dustbin so you can easily empty the container. The action card requires you to enter the X and Y coordinates of the location on the map where you want to send the robot. If you have not figured out the coordinates follow these instructions.

• The room map is a square of 51000 by 51000 millimeters
• The base location (typically the position of the dock when the map was created) is at [25500,25500] in the center of the map where these values are in the format [x-axis/horizontal, y-axis/vertical].
• Increasing the first value results in going to the top of the map, increasing the second value results in going to the right of the map (as displayed inside the app). The value seems to be in millimeters (so adding 1000 to a coordinate is adding 1 meter).
• Knowing this you can approximate the desired location and change it as follows. In our example we want to go one meter up and three meters to the right: [25500,25500] --> [26500,28500].
• Keep testing until you have the right coordinates.

Using the Clean Zone action card

With this action card you can command the vacuum cleaner to clean a specified zone or even multiple zones. This action card requires you to enter one or multiple zones for cleaning. A zone takes two coordinates, the first one is the bottom left corner, the other one the top right corner and at the end you can specify the number of times the zone needs to be cleaned. So a single zone would look something like this: [25200, 27500, 27250, 30250, 1]. You can specify multiple zones by separating them by a comma. So a zone cleanup with two zones would look like this: [25200, 27500, 27250, 30250, 1], [27000, 22250, 28200, 27000, 1].

Using the Clean Room action card

With this action card you can command the vacuum cleaner to clean specific rooms. This action card requires you to enter a comma separated list of the ID's of the rooms you want cleaned. Unfortunately there is no way to enter the room name so it requires some trail and error to figure out which ID corresponds to which room. The current list of saved room ID's can be found under the device settings. The order of this list is usually the order in which the rooms where created in the Xiaomi Home app. This setting with the rooms is updated every time changes are made to the room layout through the Xiaomi Home smartphone app. And if changed, you will need to edit your flow cards to match the correct room ID's again.

To find out which ID corresponds to which room trigger the flow with a specified ID and head back to the Xiaomi Home app. You will see that the map will be gray out and only the room(s) you have chosen will light up.

Using the Status Changed trigger card

The vacuum status changed trigger card will enable you to make advanced flows based on what the vacuum cleaner is doing. In the list below you will find a list of all the available statuses that can be used with the token of the trigger card. that the status card understands:

• charger-offline: Find out if the vacuum cleaner is unable to find the docking station.
• cleaning: The vacuum cleaner is busy cleaning.
• returning: The vacuum cleaner is busy returning to the dock.
• charging: The vacuum cleaner is charging. When the battery is fully charged, this status will change to docked.
• charging-error: The vacuum cleaner is not able to charge.
• paused: The vacuum cleaner is paused during work.
• spot-cleaning: The vacuum cleaner is busy doing a spot cleaning.
• error: The vacuum cleaner has an error, maybe something is jamming the brush.
• docked: The vacuums battery is fully charged and it’s at his dock.
• zone-cleaning: The vacuum is busy doing a zone cleanup