Skip to content

Commit b599fc0

Browse files
balloobbotballoobbot
committed
Site updated at 2017-09-12 12:48:08 UTC
1 parent fc32e06 commit b599fc0

File tree

28 files changed

+125
-131
lines changed

28 files changed

+125
-131
lines changed

‎atom.xml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@
44
<title><![CDATA[Home Assistant]]></title>
55
<link href="https://home-assistant.io/atom.xml" rel="self"/>
66
<link href="https://home-assistant.io/"/>
7-
<updated>2017-09-12T08:31:50+00:00</updated>
7+
<updated>2017-09-12T12:41:34+00:00</updated>
88
<id>https://home-assistant.io/</id>
99
<author>
1010
<name><![CDATA[Home Assistant]]></name>

‎blog/categories/announcements/atom.xml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@
44
<title><![CDATA[Category: Announcements | Home Assistant]]></title>
55
<link href="https://home-assistant.io/blog/categories/announcements/atom.xml" rel="self"/>
66
<link href="https://home-assistant.io/"/>
7-
<updated>2017-09-12T08:31:50+00:00</updated>
7+
<updated>2017-09-12T12:41:34+00:00</updated>
88
<id>https://home-assistant.io/</id>
99
<author>
1010
<name><![CDATA[Home Assistant]]></name>

‎blog/categories/community/atom.xml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@
44
<title><![CDATA[Category: Community | Home Assistant]]></title>
55
<link href="https://home-assistant.io/blog/categories/community/atom.xml" rel="self"/>
66
<link href="https://home-assistant.io/"/>
7-
<updated>2017-09-12T08:31:50+00:00</updated>
7+
<updated>2017-09-12T12:41:34+00:00</updated>
88
<id>https://home-assistant.io/</id>
99
<author>
1010
<name><![CDATA[Home Assistant]]></name>

‎blog/categories/device-tracking/atom.xml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@
44
<title><![CDATA[Category: Device-Tracking | Home Assistant]]></title>
55
<link href="https://home-assistant.io/blog/categories/device-tracking/atom.xml" rel="self"/>
66
<link href="https://home-assistant.io/"/>
7-
<updated>2017-09-12T08:31:50+00:00</updated>
7+
<updated>2017-09-12T12:41:34+00:00</updated>
88
<id>https://home-assistant.io/</id>
99
<author>
1010
<name><![CDATA[Home Assistant]]></name>

‎blog/categories/esp8266/atom.xml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@
44
<title><![CDATA[Category: ESP8266 | Home Assistant]]></title>
55
<link href="https://home-assistant.io/blog/categories/esp8266/atom.xml" rel="self"/>
66
<link href="https://home-assistant.io/"/>
7-
<updated>2017-09-12T08:31:50+00:00</updated>
7+
<updated>2017-09-12T12:41:34+00:00</updated>
88
<id>https://home-assistant.io/</id>
99
<author>
1010
<name><![CDATA[Home Assistant]]></name>

‎blog/categories/how-to/atom.xml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@
44
<title><![CDATA[Category: How-To | Home Assistant]]></title>
55
<link href="https://home-assistant.io/blog/categories/how-to/atom.xml" rel="self"/>
66
<link href="https://home-assistant.io/"/>
7-
<updated>2017-09-12T08:31:50+00:00</updated>
7+
<updated>2017-09-12T12:41:34+00:00</updated>
88
<id>https://home-assistant.io/</id>
99
<author>
1010
<name><![CDATA[Home Assistant]]></name>

‎blog/categories/ibeacons/atom.xml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@
44
<title><![CDATA[Category: iBeacons | Home Assistant]]></title>
55
<link href="https://home-assistant.io/blog/categories/ibeacons/atom.xml" rel="self"/>
66
<link href="https://home-assistant.io/"/>
7-
<updated>2017-09-12T08:31:50+00:00</updated>
7+
<updated>2017-09-12T12:41:34+00:00</updated>
88
<id>https://home-assistant.io/</id>
99
<author>
1010
<name><![CDATA[Home Assistant]]></name>

‎blog/categories/internet-of-things/atom.xml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@
44
<title><![CDATA[Category: Internet-of-Things | Home Assistant]]></title>
55
<link href="https://home-assistant.io/blog/categories/internet-of-things/atom.xml" rel="self"/>
66
<link href="https://home-assistant.io/"/>
7-
<updated>2017-09-12T08:31:50+00:00</updated>
7+
<updated>2017-09-12T12:41:34+00:00</updated>
88
<id>https://home-assistant.io/</id>
99
<author>
1010
<name><![CDATA[Home Assistant]]></name>

‎blog/categories/iot-data/atom.xml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@
44
<title><![CDATA[Category: IoT-Data | Home Assistant]]></title>
55
<link href="https://home-assistant.io/blog/categories/iot-data/atom.xml" rel="self"/>
66
<link href="https://home-assistant.io/"/>
7-
<updated>2017-09-12T08:31:50+00:00</updated>
7+
<updated>2017-09-12T12:41:34+00:00</updated>
88
<id>https://home-assistant.io/</id>
99
<author>
1010
<name><![CDATA[Home Assistant]]></name>

‎blog/categories/media/atom.xml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@
44
<title><![CDATA[Category: Media | Home Assistant]]></title>
55
<link href="https://home-assistant.io/blog/categories/media/atom.xml" rel="self"/>
66
<link href="https://home-assistant.io/"/>
7-
<updated>2017-09-12T08:31:50+00:00</updated>
7+
<updated>2017-09-12T12:41:34+00:00</updated>
88
<id>https://home-assistant.io/</id>
99
<author>
1010
<name><![CDATA[Home Assistant]]></name>

‎blog/categories/merchandise/atom.xml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@
44
<title><![CDATA[Category: Merchandise | Home Assistant]]></title>
55
<link href="https://home-assistant.io/blog/categories/merchandise/atom.xml" rel="self"/>
66
<link href="https://home-assistant.io/"/>
7-
<updated>2017-09-12T08:31:50+00:00</updated>
7+
<updated>2017-09-12T12:41:34+00:00</updated>
88
<id>https://home-assistant.io/</id>
99
<author>
1010
<name><![CDATA[Home Assistant]]></name>

‎blog/categories/micropython/atom.xml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@
44
<title><![CDATA[Category: Micropython | Home Assistant]]></title>
55
<link href="https://home-assistant.io/blog/categories/micropython/atom.xml" rel="self"/>
66
<link href="https://home-assistant.io/"/>
7-
<updated>2017-09-12T08:31:50+00:00</updated>
7+
<updated>2017-09-12T12:41:34+00:00</updated>
88
<id>https://home-assistant.io/</id>
99
<author>
1010
<name><![CDATA[Home Assistant]]></name>

‎blog/categories/mqtt/atom.xml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@
44
<title><![CDATA[Category: MQTT | Home Assistant]]></title>
55
<link href="https://home-assistant.io/blog/categories/mqtt/atom.xml" rel="self"/>
66
<link href="https://home-assistant.io/"/>
7-
<updated>2017-09-12T08:31:50+00:00</updated>
7+
<updated>2017-09-12T12:41:34+00:00</updated>
88
<id>https://home-assistant.io/</id>
99
<author>
1010
<name><![CDATA[Home Assistant]]></name>

‎blog/categories/organisation/atom.xml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@
44
<title><![CDATA[Category: Organisation | Home Assistant]]></title>
55
<link href="https://home-assistant.io/blog/categories/organisation/atom.xml" rel="self"/>
66
<link href="https://home-assistant.io/"/>
7-
<updated>2017-09-12T08:31:50+00:00</updated>
7+
<updated>2017-09-12T12:41:34+00:00</updated>
88
<id>https://home-assistant.io/</id>
99
<author>
1010
<name><![CDATA[Home Assistant]]></name>

‎blog/categories/owntracks/atom.xml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@
44
<title><![CDATA[Category: OwnTracks | Home Assistant]]></title>
55
<link href="https://home-assistant.io/blog/categories/owntracks/atom.xml" rel="self"/>
66
<link href="https://home-assistant.io/"/>
7-
<updated>2017-09-12T08:31:50+00:00</updated>
7+
<updated>2017-09-12T12:41:34+00:00</updated>
88
<id>https://home-assistant.io/</id>
99
<author>
1010
<name><![CDATA[Home Assistant]]></name>

‎blog/categories/presence-detection/atom.xml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@
44
<title><![CDATA[Category: Presence-Detection | Home Assistant]]></title>
55
<link href="https://home-assistant.io/blog/categories/presence-detection/atom.xml" rel="self"/>
66
<link href="https://home-assistant.io/"/>
7-
<updated>2017-09-12T08:31:50+00:00</updated>
7+
<updated>2017-09-12T12:41:34+00:00</updated>
88
<id>https://home-assistant.io/</id>
99
<author>
1010
<name><![CDATA[Home Assistant]]></name>

‎blog/categories/public-service-announcement/atom.xml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@
44
<title><![CDATA[Category: Public-Service-Announcement | Home Assistant]]></title>
55
<link href="https://home-assistant.io/blog/categories/public-service-announcement/atom.xml" rel="self"/>
66
<link href="https://home-assistant.io/"/>
7-
<updated>2017-09-12T08:31:50+00:00</updated>
7+
<updated>2017-09-12T12:41:34+00:00</updated>
88
<id>https://home-assistant.io/</id>
99
<author>
1010
<name><![CDATA[Home Assistant]]></name>

‎blog/categories/release-notes/atom.xml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@
44
<title><![CDATA[Category: Release-Notes | Home Assistant]]></title>
55
<link href="https://home-assistant.io/blog/categories/release-notes/atom.xml" rel="self"/>
66
<link href="https://home-assistant.io/"/>
7-
<updated>2017-09-12T08:31:50+00:00</updated>
7+
<updated>2017-09-12T12:41:34+00:00</updated>
88
<id>https://home-assistant.io/</id>
99
<author>
1010
<name><![CDATA[Home Assistant]]></name>

‎blog/categories/survey/atom.xml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@
44
<title><![CDATA[Category: Survey | Home Assistant]]></title>
55
<link href="https://home-assistant.io/blog/categories/survey/atom.xml" rel="self"/>
66
<link href="https://home-assistant.io/"/>
7-
<updated>2017-09-12T08:31:50+00:00</updated>
7+
<updated>2017-09-12T12:41:34+00:00</updated>
88
<id>https://home-assistant.io/</id>
99
<author>
1010
<name><![CDATA[Home Assistant]]></name>

‎blog/categories/talks/atom.xml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@
44
<title><![CDATA[Category: Talks | Home Assistant]]></title>
55
<link href="https://home-assistant.io/blog/categories/talks/atom.xml" rel="self"/>
66
<link href="https://home-assistant.io/"/>
7-
<updated>2017-09-12T08:31:50+00:00</updated>
7+
<updated>2017-09-12T12:41:34+00:00</updated>
88
<id>https://home-assistant.io/</id>
99
<author>
1010
<name><![CDATA[Home Assistant]]></name>

‎blog/categories/technology/atom.xml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@
44
<title><![CDATA[Category: Technology | Home Assistant]]></title>
55
<link href="https://home-assistant.io/blog/categories/technology/atom.xml" rel="self"/>
66
<link href="https://home-assistant.io/"/>
7-
<updated>2017-09-12T08:31:50+00:00</updated>
7+
<updated>2017-09-12T12:41:34+00:00</updated>
88
<id>https://home-assistant.io/</id>
99
<author>
1010
<name><![CDATA[Home Assistant]]></name>

‎blog/categories/user-stories/atom.xml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@
44
<title><![CDATA[Category: User-Stories | Home Assistant]]></title>
55
<link href="https://home-assistant.io/blog/categories/user-stories/atom.xml" rel="self"/>
66
<link href="https://home-assistant.io/"/>
7-
<updated>2017-09-12T08:31:50+00:00</updated>
7+
<updated>2017-09-12T12:41:34+00:00</updated>
88
<id>https://home-assistant.io/</id>
99
<author>
1010
<name><![CDATA[Home Assistant]]></name>

‎blog/categories/video/atom.xml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@
44
<title><![CDATA[Category: Video | Home Assistant]]></title>
55
<link href="https://home-assistant.io/blog/categories/video/atom.xml" rel="self"/>
66
<link href="https://home-assistant.io/"/>
7-
<updated>2017-09-12T08:31:50+00:00</updated>
7+
<updated>2017-09-12T12:41:34+00:00</updated>
88
<id>https://home-assistant.io/</id>
99
<author>
1010
<name><![CDATA[Home Assistant]]></name>

‎blog/categories/website/atom.xml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@
44
<title><![CDATA[Category: Website | Home Assistant]]></title>
55
<link href="https://home-assistant.io/blog/categories/website/atom.xml" rel="self"/>
66
<link href="https://home-assistant.io/"/>
7-
<updated>2017-09-12T08:31:50+00:00</updated>
7+
<updated>2017-09-12T12:41:34+00:00</updated>
88
<id>https://home-assistant.io/</id>
99
<author>
1010
<name><![CDATA[Home Assistant]]></name>

‎components/light.xiaomi_philipslight/index.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -76,7 +76,7 @@ <h1 class="title indent">
7676
<hr class="divider">
7777
<p>The <code class="highlighter-rouge">xiaomi_philipslight</code> platform allows you to control the state of your Xiaomi Philips LED Ball Lamp and Xiaomi Philips LED Ceiling Lamp.</p>
7878
<p>Currently, the supported features are <code class="highlighter-rouge">on</code>, <code class="highlighter-rouge">off</code>, <code class="highlighter-rouge">set_cct</code> (colortemp) , <code class="highlighter-rouge">set_bright</code> (brightness).</p>
79-
<p>Please follow the instructions on <a href="/components/xiaomi/#retrieving-the-access-token">Retrieving the Access Token</a> to get the API token to use in the <code class="highlighter-rouge">configuration.yaml</code> file.</p>
79+
<p>Please follow the instructions on <a href="/components/vacuum.xiaomi/#retrieving-the-access-token">Retrieving the Access Token</a> to get the API token to use in the <code class="highlighter-rouge">configuration.yaml</code> file.</p>
8080
<p>To add a Xiaomi Philips Light to your installation, add the following to your configuration.yaml file:</p>
8181
<div class="language-yaml highlighter-rouge"><pre class="highlight"><code><span class="c1"># Example configuration.yaml entries</span>
8282
<span class="s">light</span><span class="pi">:</span>

‎components/vacuum.xiaomi/index.html

Lines changed: 56 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -76,7 +76,7 @@ <h1 class="title indent">
7676
<hr class="divider">
7777
<p>The <code class="highlighter-rouge">xiaomi</code> vacuum platform allows you to control the state of your <a href="http://www.mi.com/roomrobot/">Xiaomi Mi Robot Vacuum</a>.</p>
7878
<p>Current supported features are <code class="highlighter-rouge">turn_on</code>, <code class="highlighter-rouge">pause</code>, <code class="highlighter-rouge">stop</code>, <code class="highlighter-rouge">return_to_home</code>, <code class="highlighter-rouge">turn_off</code> (stops goes to dock), <code class="highlighter-rouge">locate</code>, <code class="highlighter-rouge">clean_spot</code>, <code class="highlighter-rouge">set_fanspeed</code> and even remote control your robot.</p>
79-
<p>Please follow the instructions on <a href="/components/xiaomi/#retrieving-the-access-token">Retrieving the Access Token</a> to get the API token to use in the <code class="highlighter-rouge">configuration.yaml</code> file.</p>
79+
<p>Please follow the instructions on <a href="/components/vacuum.xiaomi/#retrieving-the-access-token">Retrieving the Access Token</a> to get the API token to use in the <code class="highlighter-rouge">configuration.yaml</code> file.</p>
8080
<p>To add a vacuum to your installation, add the following to your <code class="highlighter-rouge">configuration.yaml</code> file:</p>
8181
<div class="language-yaml highlighter-rouge"><pre class="highlight"><code><span class="c1"># Example configuration.yaml entry</span>
8282
<span class="s">vacuum</span><span class="pi">:</span>
@@ -196,6 +196,61 @@ <h4><a class="title-link" name="service-vacuumxiaomi_remote_control_move_step" h
196196
</tr>
197197
</tbody>
198198
</table>
199+
<h3><a class="title-link" name="retrieving-the-access-token" href="#retrieving-the-access-token"></a> Retrieving the Access Token</h3>
200+
<p class="note">
201+
This token (32 hexadecimal characters) is required for the Xiaomi Mi Robot Vacuum and Xiaomi Philips Light. The Xiaomi Gateway uses another security method and requires a <code class="highlighter-rouge">key</code> (16 alphanumeric chars) which can be obtained easily via a hidden menu item at the Mi-Home app.
202+
</p>
203+
<p>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.</p>
204+
<p>Before you begin you need to install <code class="highlighter-rouge">libffi-dev</code> and <code class="highlighter-rouge">libssl-dev</code> by running the command below. This is needed for <code class="highlighter-rouge">python-mirobo</code> to be installed correctly.</p>
205+
<div class="language-bash highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>sudo apt-get install libffi-dev libssl-dev
206+
</code></pre>
207+
</div>
208+
<p>If your Home Assistant installation is running in a <a href="/docs/installation/virtualenv/#upgrading-home-assistant">Virtualenv</a>, make sure you activate it by running the commands below.</p>
209+
<div class="language-bash highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>sudo su -s /bin/bash homeassistant
210+
<span class="gp">$ </span><span class="nb">source</span> /srv/homeassistant/bin/activate
211+
</code></pre>
212+
</div>
213+
<p>To fetch the token follow these instructions depending on your mobile phone platform.</p>
214+
<h4><a class="title-link" name="windows-and-android" href="#windows-and-android"></a> Windows and Android</h4>
215+
<ol>
216+
<li>Configure the robot with the Mi-Home app.</li>
217+
<li>Enable developer mode and USB debugging on the Android phone and plug it into the computer.</li>
218+
<li>Get and install the <a href="https://developer.android.com/studio/releases/platform-tools.html">ADB tool for Windows</a>.</li>
219+
<li>Create a backup of the application <code class="highlighter-rouge">com.xiaomi.smarthome</code>:
220+
<div class="language-bash highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>adb backup -noapk com.xiaomi.smarthome -f backup.ab
221+
</code></pre>
222+
</div>
223+
</li>
224+
<li>If you have this message: “More than one device or emulator”, use this command to list all devices:
225+
<div class="language-bash highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>adb devices
226+
</code></pre>
227+
</div>
228+
<p>and execute this command:</p>
229+
<div class="language-bash highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>adb -s DEVICEID backup -noapk com.xiaomi.smarthome -f backup.ab <span class="c"># (with DEVICEID the device id from the previous command)</span>
230+
</code></pre>
231+
</div>
232+
</li>
233+
<li>On the phone, you must confirm the backup. DO NOT enter any password and press button to make the backup.</li>
234+
<li>Get and install <a href="https://sourceforge.net/projects/adbextractor/">ADB Backup Extractor</a>.</li>
235+
<li>Extract All files from the backup:
236+
<div class="language-bash highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>java.exe -jar ../android-backup-extractor/abe.jar unpack backup.ab backup.tar <span class="s2">""</span>
237+
</code></pre>
238+
</div>
239+
</li>
240+
<li>Unzip the “.tar” file.</li>
241+
<li>Open the SQLite database <code class="highlighter-rouge">miio2.db</code> with a tool like SQLite Manager extension for FireFox.</li>
242+
<li>Get the token from “devicerecord” table.</li>
243+
</ol>
244+
<h4><a class="title-link" name="linux-and-android-rooted" href="#linux-and-android-rooted"></a> Linux and Android (rooted!)</h4>
245+
<ol>
246+
<li>Configure the light with the Mi-Home app.</li>
247+
<li>Enable developer mode, USB debugging and root permission only for ADB on the Android phone and plug it into the computer.</li>
248+
<li>Get ADB f.e. <code class="highlighter-rouge">apt-get install android-tools-adb</code></li>
249+
<li><code class="highlighter-rouge">adb devices</code> should list your device</li>
250+
<li><code class="highlighter-rouge">adb root</code> (does work for development builds only: ones with <code class="highlighter-rouge">ro.debuggable=1</code>)</li>
251+
<li><code class="highlighter-rouge">adb shell</code></li>
252+
<li><code class="highlighter-rouge">echo "select name,localIP,token from devicerecord;" | sqlite3 /data/data/com.xiaomi.smarthome/databases/miio2.db</code> returns a list of all registered devices including IP address and token.</li>
253+
</ol>
199254
</article>
200255
</div>
201256
<aside id="sidebar" class="grid__item one-third lap-one-whole palm-one-whole">

0 commit comments

Comments
 (0)