layout: page

title: "Xiaomi Mi Robot Vacuum"

description: "Instructions how to integrate your Xiaomi Mi Robot Vacuum within Home Assistant."

date: 2017-05-05 18:11

sidebar: true

comments: false

sharing: true

footer: true

logo: xiaomi_vacuum.png

ha_category: Switch

ha_release: 0.48

The `xiaomi_vacuum`switch platform allows you to control the state of your [Xiaomi Mi Robot Vacuum](http://www.mi.com/roomrobot/).

Current supported features are `start` and `stop` (goes to dock).

{% linkable_title Getting started %}

Follow the pairing process using your phone and Mi-Home app. From here you will be able to retrieve the token from a SQLite file inside your phone.

<p class='note warning'>

If your Home Assistant installation is running in a [Virtualenv](/docs/installation/virtualenv/#upgrading-home-assistant), make sure you activate it by running the commands below.</p>

```bash

$ sudo su -s /bin/bash homeassistant

$ source /srv/homeassistant/bin/activate

In order to fetch the token follow these instructions depending on your mobile phone platform.

1. Configure the robot with the Mi-Home app.

2. Enable developer mode and USB debugging on the Android phone and plug it into the computer.

3. Get ADB tool for Windows : https://developer.android.com/studio/releases/platform-tools.html

4. Create a backup of the application com.xiaomi.smarthome:

.\adb backup -noapk com.xiaomi.smarthome -f backup.ab

5. If you have this message : "More than one device or emulator", use this command to list all devices:

.\adb devices

```

and execute this command:

.\adb -s DEVICEID backup -noapk com.xiaomi.smarthome -f backup.ab # (with DEVICEID the device id from the previous command)

6. On the phone, you must confirm the backup. DO NOT enter any password and press button to make the backup.

7. Get ADB Backup Extractor : https://sourceforge.net/projects/adbextractor/

8. Extract All files from the backup:

java.exe -jar ../android-backup-extractor/abe.jar unpack backup.ab backup.tar ""

9. Unzip the ".tar" file.

10. Open the sqlite DB miio2.db with a tool like SQLite Manager extension for FireFox.

11. Get token from "devicerecord" table.

1. Setup iOS device with the Mi-Home app.

2. Create an unencrypted backup of the device using iTunes.

3. Install iBackup Viewer from here: http://www.imactools.com/iphonebackupviewer/

4. Extract this file /raw data/com.xiami.mihome/_mihome.sqlite to your computer

5. Open the file extracted using notepad. You will then see the list of all the device in your account with their token.

{% linkable_title Configuration %}

- platform: xiaomi_vacuum

name: 'name of the robot'

host: 192.168.1.2

token: your-token-here