diff --git a/atom.xml b/atom.xml index 26edc0cca0..71ce2cedd8 100644 --- a/atom.xml +++ b/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Home Assistant]]> - 2017-08-26T11:12:26+00:00 + 2017-08-26T11:44:42+00:00 https://home-assistant.io/ diff --git a/blog/categories/announcements/atom.xml b/blog/categories/announcements/atom.xml index 01b86844ed..a419933c76 100644 --- a/blog/categories/announcements/atom.xml +++ b/blog/categories/announcements/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Announcements | Home Assistant]]> - 2017-08-26T11:12:26+00:00 + 2017-08-26T11:44:42+00:00 https://home-assistant.io/ diff --git a/blog/categories/community/atom.xml b/blog/categories/community/atom.xml index 69198c3d9f..0475e791c6 100644 --- a/blog/categories/community/atom.xml +++ b/blog/categories/community/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Community | Home Assistant]]> - 2017-08-26T11:12:26+00:00 + 2017-08-26T11:44:42+00:00 https://home-assistant.io/ diff --git a/blog/categories/device-tracking/atom.xml b/blog/categories/device-tracking/atom.xml index 28962b6836..27dfc64cde 100644 --- a/blog/categories/device-tracking/atom.xml +++ b/blog/categories/device-tracking/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Device-Tracking | Home Assistant]]> - 2017-08-26T11:12:26+00:00 + 2017-08-26T11:44:42+00:00 https://home-assistant.io/ diff --git a/blog/categories/esp8266/atom.xml b/blog/categories/esp8266/atom.xml index c26cfe8f0e..cd2459ef81 100644 --- a/blog/categories/esp8266/atom.xml +++ b/blog/categories/esp8266/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: ESP8266 | Home Assistant]]> - 2017-08-26T11:12:26+00:00 + 2017-08-26T11:44:42+00:00 https://home-assistant.io/ diff --git a/blog/categories/how-to/atom.xml b/blog/categories/how-to/atom.xml index 675737ba19..e8f04ab457 100644 --- a/blog/categories/how-to/atom.xml +++ b/blog/categories/how-to/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: How-To | Home Assistant]]> - 2017-08-26T11:12:26+00:00 + 2017-08-26T11:44:42+00:00 https://home-assistant.io/ diff --git a/blog/categories/ibeacons/atom.xml b/blog/categories/ibeacons/atom.xml index e63a134177..b2fdb8b1c7 100644 --- a/blog/categories/ibeacons/atom.xml +++ b/blog/categories/ibeacons/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: iBeacons | Home Assistant]]> - 2017-08-26T11:12:26+00:00 + 2017-08-26T11:44:42+00:00 https://home-assistant.io/ diff --git a/blog/categories/internet-of-things/atom.xml b/blog/categories/internet-of-things/atom.xml index 4dc973d2e7..ab099ac1f6 100644 --- a/blog/categories/internet-of-things/atom.xml +++ b/blog/categories/internet-of-things/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Internet-of-Things | Home Assistant]]> - 2017-08-26T11:12:26+00:00 + 2017-08-26T11:44:42+00:00 https://home-assistant.io/ diff --git a/blog/categories/iot-data/atom.xml b/blog/categories/iot-data/atom.xml index e0d6010675..d76080a84f 100644 --- a/blog/categories/iot-data/atom.xml +++ b/blog/categories/iot-data/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: IoT-Data | Home Assistant]]> - 2017-08-26T11:12:26+00:00 + 2017-08-26T11:44:42+00:00 https://home-assistant.io/ diff --git a/blog/categories/media/atom.xml b/blog/categories/media/atom.xml index c96f0f6c0b..b0fe3fbaa4 100644 --- a/blog/categories/media/atom.xml +++ b/blog/categories/media/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Media | Home Assistant]]> - 2017-08-26T11:12:26+00:00 + 2017-08-26T11:44:42+00:00 https://home-assistant.io/ diff --git a/blog/categories/merchandise/atom.xml b/blog/categories/merchandise/atom.xml index 9bd6e154b2..59eaa5a0e3 100644 --- a/blog/categories/merchandise/atom.xml +++ b/blog/categories/merchandise/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Merchandise | Home Assistant]]> - 2017-08-26T11:12:26+00:00 + 2017-08-26T11:44:42+00:00 https://home-assistant.io/ diff --git a/blog/categories/micropython/atom.xml b/blog/categories/micropython/atom.xml index 6aed23bf1c..87ff8ec1d8 100644 --- a/blog/categories/micropython/atom.xml +++ b/blog/categories/micropython/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Micropython | Home Assistant]]> - 2017-08-26T11:12:26+00:00 + 2017-08-26T11:44:42+00:00 https://home-assistant.io/ diff --git a/blog/categories/mqtt/atom.xml b/blog/categories/mqtt/atom.xml index 6748a3d326..f09733aa0c 100644 --- a/blog/categories/mqtt/atom.xml +++ b/blog/categories/mqtt/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: MQTT | Home Assistant]]> - 2017-08-26T11:12:26+00:00 + 2017-08-26T11:44:42+00:00 https://home-assistant.io/ diff --git a/blog/categories/organisation/atom.xml b/blog/categories/organisation/atom.xml index 9a9f7b8c66..ce4ff16c8f 100644 --- a/blog/categories/organisation/atom.xml +++ b/blog/categories/organisation/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Organisation | Home Assistant]]> - 2017-08-26T11:12:26+00:00 + 2017-08-26T11:44:42+00:00 https://home-assistant.io/ diff --git a/blog/categories/owntracks/atom.xml b/blog/categories/owntracks/atom.xml index 16d7b5cad8..d6e3eab9be 100644 --- a/blog/categories/owntracks/atom.xml +++ b/blog/categories/owntracks/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: OwnTracks | Home Assistant]]> - 2017-08-26T11:12:26+00:00 + 2017-08-26T11:44:42+00:00 https://home-assistant.io/ diff --git a/blog/categories/presence-detection/atom.xml b/blog/categories/presence-detection/atom.xml index af51621f55..1e3b405494 100644 --- a/blog/categories/presence-detection/atom.xml +++ b/blog/categories/presence-detection/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Presence-Detection | Home Assistant]]> - 2017-08-26T11:12:26+00:00 + 2017-08-26T11:44:42+00:00 https://home-assistant.io/ diff --git a/blog/categories/public-service-announcement/atom.xml b/blog/categories/public-service-announcement/atom.xml index df6c8c7568..990e79e3a8 100644 --- a/blog/categories/public-service-announcement/atom.xml +++ b/blog/categories/public-service-announcement/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Public-Service-Announcement | Home Assistant]]> - 2017-08-26T11:12:26+00:00 + 2017-08-26T11:44:42+00:00 https://home-assistant.io/ diff --git a/blog/categories/release-notes/atom.xml b/blog/categories/release-notes/atom.xml index bfd7c0973a..a2a60193b0 100644 --- a/blog/categories/release-notes/atom.xml +++ b/blog/categories/release-notes/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Release-Notes | Home Assistant]]> - 2017-08-26T11:12:26+00:00 + 2017-08-26T11:44:42+00:00 https://home-assistant.io/ diff --git a/blog/categories/survey/atom.xml b/blog/categories/survey/atom.xml index cf30e14724..5dedf0209b 100644 --- a/blog/categories/survey/atom.xml +++ b/blog/categories/survey/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Survey | Home Assistant]]> - 2017-08-26T11:12:26+00:00 + 2017-08-26T11:44:42+00:00 https://home-assistant.io/ diff --git a/blog/categories/talks/atom.xml b/blog/categories/talks/atom.xml index 75f85397c6..7ac955ec22 100644 --- a/blog/categories/talks/atom.xml +++ b/blog/categories/talks/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Talks | Home Assistant]]> - 2017-08-26T11:12:26+00:00 + 2017-08-26T11:44:42+00:00 https://home-assistant.io/ diff --git a/blog/categories/technology/atom.xml b/blog/categories/technology/atom.xml index 9dc285fe8e..1445a9dfde 100644 --- a/blog/categories/technology/atom.xml +++ b/blog/categories/technology/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Technology | Home Assistant]]> - 2017-08-26T11:12:26+00:00 + 2017-08-26T11:44:42+00:00 https://home-assistant.io/ diff --git a/blog/categories/user-stories/atom.xml b/blog/categories/user-stories/atom.xml index 929f5a76ac..069db7fa08 100644 --- a/blog/categories/user-stories/atom.xml +++ b/blog/categories/user-stories/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: User-Stories | Home Assistant]]> - 2017-08-26T11:12:26+00:00 + 2017-08-26T11:44:42+00:00 https://home-assistant.io/ diff --git a/blog/categories/video/atom.xml b/blog/categories/video/atom.xml index 435d3d6aa5..7f51f0c316 100644 --- a/blog/categories/video/atom.xml +++ b/blog/categories/video/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Video | Home Assistant]]> - 2017-08-26T11:12:26+00:00 + 2017-08-26T11:44:42+00:00 https://home-assistant.io/ diff --git a/blog/categories/website/atom.xml b/blog/categories/website/atom.xml index d32a599dcf..3589a9a5ba 100644 --- a/blog/categories/website/atom.xml +++ b/blog/categories/website/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Website | Home Assistant]]> - 2017-08-26T11:12:26+00:00 + 2017-08-26T11:44:42+00:00 https://home-assistant.io/ diff --git a/components/vacuum.xiaomi/index.html b/components/vacuum.xiaomi/index.html index ce03cd6cb1..f0cb150b73 100644 --- a/components/vacuum.xiaomi/index.html +++ b/components/vacuum.xiaomi/index.html @@ -76,79 +76,19 @@

The xiaomi vacuum platform allows you to control the state of your Xiaomi Mi Robot Vacuum.

Current supported features are turn_on, pause, stop, return_to_home, turn_off (stops goes to dock), locate, clean_spot, set_fanspeed and even remote control your robot.

-

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.

-

Before you begin you need to install libffi-dev by running the command below. This is needed for python-mirobi to be installed correctly.

-
$ sudo apt-get install libffi-dev
-
-
-

If your Home Assistant installation is running in a Virtualenv, make sure you activate it by running the commands below.

-
$ sudo su -s /bin/bash homeassistant
-$ source /srv/homeassistant/bin/activate
-
-
-

To fetch the token follow these instructions depending on your mobile phone platform.

-

Windows and Android

-
    -
  1. Configure the robot with the Mi-Home app.
    2. -
  2. Enable developer mode and USB debugging on the Android phone and plug it into the computer.
    3. -
  3. Get ADB tool for Windows: https://developer.android.com/studio/releases/platform-tools.html
    4. -
  4. Create a backup of the application com.xiaomi.smarthome: - 
    $ adb backup -noapk com.xiaomi.smarthome -f backup.ab
-
    -
    -
    5. -
  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. -
  6. On the phone, you must confirm the backup. DO NOT enter any password and press button to make the backup.
    7. -
  7. Get ADB Backup Extractor: https://sourceforge.net/projects/adbextractor/
    8. -
  8. Extract All files from the backup: - 
    $ java.exe -jar ../android-backup-extractor/abe.jar unpack backup.ab backup.tar ""
-
    -
    -
    9. -
  9. Unzip the “.tar” file.
    10. -
  10. Open the SQLite DB miio2.db with a tool like SQLite Manager extension for FireFox.
    11. -
  11. Get the token from “devicerecord” table.
    12. -
-

Linux and Android (rooted!)

-
    -
  1. Configure the light with the Mi-Home app.
    2. -
  2. Enable developer mode, USB debugging and root permission only for ADB on the Android phone and plug it into the computer.
    3. -
  3. Get ADB f.e. apt-get install android-tools-adb
    4. -
  4. adb devices should list your device
    5. -
  5. adb root (does work for development builds only: ones with ro.debuggable=1)
    6. -
  6. adb shell
    7. -
  7. echo "select name,localIP,token from devicerecord;" | sqlite3 /data/data/com.xiaomi.smarthome/databases/miio2.db returns a list of all registered devices including ip address and token.
    8. -
-

macOS and iOS

-
    -
  1. Setup iOS device with the Mi-Home app.
    2. -
  2. Create an unencrypted backup of the device using iTunes.
    3. -
  3. Install iBackup Viewer from here: http://www.imactools.com/iphonebackupviewer/
    4. -
  4. Extract this file: /raw data/com.xiami.mihome/1234567_mihome.sqlite to your computer, where 1234567 is any string of numbers.
    5. -
  5. Open the sqlite DB with a tool like SQLite Manager extension for FireFox, DB Browser, etc. You will then see the list of all the devices in your account with their token. The token you need is in the column ZToken and looks like 123a1234567b12345c1d123456789e12.
    6. -
-

Configuration

+

Please follow the instructions on Retrieving the Access Token to get the API token to use in the configuration.yaml file.

To add a vacuum to your installation, add the following to your configuration.yaml file:

# Example configuration.yaml entry
 vacuum:
   - platform: xiaomi
     host: 192.168.1.2
-    token: your-token-here
+    token: YOUR_TOKEN

Configuration variables:

  • host (Required): The IP of your robot.
    • -
  • token (Required): The token of your robot. Go to Getting started section to read more about how to get it.
    • +
  • token (Required): The API token of your robot.
  • name (Optional): The name of your robot.

Platform services

diff --git a/components/xiaomi/index.html b/components/xiaomi/index.html index 87f05ed1eb..5f6da59a68 100644 --- a/components/xiaomi/index.html +++ b/components/xiaomi/index.html @@ -106,6 +106,7 @@
  • Additional alarm events of the Gas and Smoke Detector: Analog alarm, battery fault alarm (smoke detector only), sensitivity fault alarm, I2C communication failure

    • Follow the setup process using your phone and Mi-Home app. From here you will be able to retrieve the key from within the app following this tutorial

    +

    Please check the instructions in this section to get the API token to use with your platforms.

    To enable Xiaomi gateway in your installation, add the following to your configuration.yaml file:

    One Gateway

    # You can leave mac empty if you only have one gateway.
@@ -177,7 +178,7 @@
       gw_mac: xxxxxxxxxxxx
    -

    Retrieving Access Token

    +

    Retrieving the Access Token

    Follow the pairing process using your phone and Mi-Home app. You will be able to retrieve the token from a SQLite file inside your phone. This token is needed for using various xiaomi platforms.

    Before you begin you need to install libffi-dev by running the command below. This is needed for python-mirobi to be installed correctly.

    $ sudo apt-get install libffi-dev
diff --git a/sitemap.xml b/sitemap.xml
index 08cb6524ab..c7c8451be6 100644
--- a/sitemap.xml
+++ b/sitemap.xml
@@ -3933,62 +3933,62 @@
 
 
 https://home-assistant.io/demo/frontend.html
-2017-08-26T11:10:56+00:00
+2017-08-26T11:43:19+00:00
 
 
 https://home-assistant.io/demo/index.html
-2017-08-26T11:10:56+00:00
+2017-08-26T11:43:19+00:00
 
 
 https://home-assistant.io/demo/panels/ha-panel-dev-event.html
-2017-08-26T11:10:56+00:00
+2017-08-26T11:43:19+00:00
 
 
 https://home-assistant.io/demo/panels/ha-panel-dev-info.html
-2017-08-26T11:10:56+00:00
+2017-08-26T11:43:19+00:00
 
 
 https://home-assistant.io/demo/panels/ha-panel-dev-service.html
-2017-08-26T11:10:56+00:00
+2017-08-26T11:43:19+00:00
 
 
 https://home-assistant.io/demo/panels/ha-panel-dev-state.html
-2017-08-26T11:10:56+00:00
+2017-08-26T11:43:19+00:00
 
 
 https://home-assistant.io/demo/panels/ha-panel-dev-template.html
-2017-08-26T11:10:56+00:00
+2017-08-26T11:43:19+00:00
 
 
 https://home-assistant.io/demo/panels/ha-panel-history.html
-2017-08-26T11:10:56+00:00
+2017-08-26T11:43:19+00:00
 
 
 https://home-assistant.io/demo/panels/ha-panel-iframe.html
-2017-08-26T11:10:56+00:00
+2017-08-26T11:43:19+00:00
 
 
 https://home-assistant.io/demo/panels/ha-panel-logbook.html
-2017-08-26T11:10:56+00:00
+2017-08-26T11:43:19+00:00
 
 
 https://home-assistant.io/demo/panels/ha-panel-map.html
-2017-08-26T11:10:56+00:00
+2017-08-26T11:43:19+00:00
 
 
 https://home-assistant.io/googlef4f3693c209fe788.html
-2017-08-26T11:10:56+00:00
+2017-08-26T11:43:19+00:00
 
 
 https://home-assistant.io/static/fonts/roboto/DESCRIPTION.en_us.html
-2017-08-26T11:10:56+00:00
+2017-08-26T11:43:20+00:00
 
 
 https://home-assistant.io/static/fonts/robotomono/DESCRIPTION.en_us.html
-2017-08-26T11:10:56+00:00
+2017-08-26T11:43:20+00:00
 
 
 https://home-assistant.io/static/mdi-demo.html
-2017-08-26T11:10:56+00:00
+2017-08-26T11:43:20+00:00