jeans/home-assistant.io
jeans/home-assistant.io
1
0
Fork 0
mirror of https://github.com/home-assistant/home-assistant.io.git synced 2025-08-03 06:28:02 +00:00
Code Issues Packages Projects Releases Wiki Activity

Minor changes to format

Browse Source
This commit is contained in:
Fabian Affolter 2017-08-26 12:43:03 +02:00
parent cc44067d07
commit 2385b618a2
No known key found for this signature in database
GPG Key ID: DDF3D6F44AAB1336
1 changed files with 22 additions and 19 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

35
source/_components/vacuum.xiaomi.markdown
View File

@ -24,11 +24,10 @@ Follow the pairing process using your phone and Mi-Home app. From here you will
Before you begin you need to install `libffi-dev` by running the command below. This is needed for `python-mirobi` to be installed correctly. Before you begin you need to install `libffi-dev` by running the command below. This is needed for `python-mirobi` to be installed correctly.
```bash ```bash
apt-get install libffi-dev $ sudo apt-get install libffi-dev
``` ```
<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.
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 ```bash
$ sudo su -s /bin/bash homeassistant $ sudo su -s /bin/bash homeassistant
@ -37,45 +36,47 @@ $ source /srv/homeassistant/bin/activate
To fetch the token follow these instructions depending on your mobile phone platform. To fetch the token follow these instructions depending on your mobile phone platform.
### Windows and Android ### {% linkable_title Windows and Android %}
1. Configure the robot with the Mi-Home app. 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. 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 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: 4. Create a backup of the application com.xiaomi.smarthome:
```bash ```bash
.\adb backup -noapk com.xiaomi.smarthome -f backup.ab $ 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: 5. If you have this message: "More than one device or emulator", use this command to list all devices:
```bash ```bash
.\adb devices $ adb devices
``` ```
and execute this command: and execute this command:
```bash ```bash
.\adb -s DEVICEID backup -noapk com.xiaomi.smarthome -f backup.ab # (with DEVICEID the device id from the previous 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. 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/ 7. Get ADB Backup Extractor: https://sourceforge.net/projects/adbextractor/
8. Extract All files from the backup: 8. Extract All files from the backup:
```bash ```bash
java.exe -jar ../android-backup-extractor/abe.jar unpack backup.ab backup.tar "" $ java.exe -jar ../android-backup-extractor/abe.jar unpack backup.ab backup.tar ""
``` ```
9. Unzip the ".tar" file. 9. Unzip the ".tar" file.
10. Open the SQLite DB miio2.db with a tool like SQLite Manager extension for FireFox. 10. Open the SQLite DB `miio2.db` with a tool like SQLite Manager extension for FireFox.
11. Get the token from "devicerecord" table. 11. Get the token from "devicerecord" table.
### Linux and Android (rooted!) ### {% linkable_title Linux and Android (rooted!) %}
1. Configure the light with the Mi-Home app. 1. Configure the light with the Mi-Home app.
2. Enable developer mode, USB debugging and root permission only for ADB on the Android phone and plug it into the computer. 2. Enable developer mode, USB debugging and root permission only for ADB on the Android phone and plug it into the computer.
3. Get ADB f.e. `apt-get install android-tools-adb` 3. Get ADB f.e. `apt-get install android-tools-adb`
4. `adb devices` should list your device 4. `adb devices` should list your device
5. `adb root` (does work for development builds only: ones with ro.debuggable=1) 5. `adb root` (does work for development builds only: ones with `ro.debuggable=1`)
6. `adb shell` 6. `adb shell`
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. 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.
### macOS and iOS ### {% linkable_title macOS and iOS %}
1. Setup iOS device with the Mi-Home app. 1. Setup iOS device with the Mi-Home app.
2. Create an unencrypted backup of the device using iTunes. 2. Create an unencrypted backup of the device using iTunes.
3. Install iBackup Viewer from here: http://www.imactools.com/iphonebackupviewer/ 3. Install iBackup Viewer from here: http://www.imactools.com/iphonebackupviewer/
@ -84,19 +85,21 @@ java.exe -jar ../android-backup-extractor/abe.jar unpack backup.ab backup.tar ""
## {% linkable_title Configuration %} ## {% linkable_title Configuration %}
To add a vacuum to your installation, add the following to your `configuration.yaml` file:
```yaml ```yaml
# Example configuration.yaml entry # Example configuration.yaml entry
vacuum: vacuum:
- platform: xiaomi - platform: xiaomi
name: 'name of the robot'
host: 192.168.1.2 host: 192.168.1.2
token: your-token-here token: your-token-here
``` ```
Configuration variables: Configuration variables:
- **name** (*Optional*): The name of your robot
- **host** (*Required*): The IP of your robot - **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 token of your robot. Go to Getting started section to read more about how to get it.
- **name** (*Optional*): The name of your robot.
### {% linkable_title Platform services %} ### {% linkable_title Platform services %}