yunkong2.mihome/doc/en/Readme.md
2019-01-16 11:42:54 +08:00

115 lines
5.2 KiB
Markdown

![Logo](media/mihome.png)
# yunkong2 Mi Home Adapter
The Mi Home Adapter integrates a Mi Control Hub (Gateway) into an yunkong2 system
and enables the communication of various Xiaomi sensors, switches etc. with yunkong2.
Via yunkong2, e.g. the lighting and the speaker of the gateway are controlled.
## Requirements
* Mi Home App on Android or iOS device and free local network function
* Connected Mi Home Gateway
* Ready to use yunkong2 system
### Mi Home App installation and local network feature unlocking
#### Android
* Download, install and open [Android Mi Home App][Android App] on an Android device
* Choose `Mainland China` and set language `English`
* Setup an Account with `Sign in`
* After successfully logging in add a device via `+`
* Choose `MI Control Hub` under `Household security` and follow the instructions
* After successfully integration of the Gateway in Mi Home tip the 3 dots at the top
right of the screen and click `About`
* Tap the text `Plug*in version` number at the bottom of the screen 10 times
* There should be now 2 extra options listed until the developer mode is enabled.
[ if not try all steps again!]
* Choose the option `Wireless communication protocol`
* Then tap the first toggle switch to enable LAN functions. Note down the password.
> Password is required later in the yunkong2 installation.
* Make sure to hit the OK button to save changes.
* If you change here something, you lose your password!
Now further devices can be trained via the `+` sign.
#### iOS
* Download, install and open [iOS Mi Home App][ios App] on a iOS device
* Select the country setting `mainland China` via Profile/Settings/Country .
* Setup an Account with `Sign in`
* After successfully logging in add a device via `+`
* Choose `MI Control Hub` under `Household security` and follow the instructions
* After successfully integration of the Gateway in Mi Home tip the 3 dots at the top
right of the screen and click `About`*
* There should be now more extra options listed until the developer mode is enabled.
[ if not try all steps again!]
* Choose the option No. 4
* Then tap the first toggle switch to enable LAN functions. Note down the password.
> Password is required later in the yunkong2 installation.
* Make sure to hit the OK button to save changes.
* If you change here something, you lose your password!
Now further devices can be trained via the `+` sign.
## Router Setup
The Gateway IP address can be determined within the text after _localip_ under About/Hub
info. In the used router used, this IP should be assigned fix to the gateway.
If the operation of the learned devices via the App is no longer wanted, after learning
all devices the Internet access of the gateway can be switched off in the router.
### Supported devices
The following list does not claim to be complete:
* gateway * Xiaomi RGB Gateway
* sensor_ht * Xiaomi Temperature/Humidity
* weather.v1 * Xiaomi Temperature/Humidity/Pressure
* switch * Xiaomi Wireless Switch
* sensor_switch.aq2 * Xiaomi Aqara Wireless Switch Sensor
* sensor_switch.aq3 * Xiaomi Aqara Wireless Switch Sensor
* plug * Xiaomi Smart Plug
* 86plug * Xiaomi Smart Wall Plug
* 86sw2 * Xiaomi Wireless Dual Wall Switch
* 86sw1 * Xiaomi Wireless Single Wall Switch
* natgas * Xiaomi Mijia Honeywell Gas Alarm Detector
* smoke * Xiaomi Mijia Honeywell Fire Alarm Detector
* ctrl_ln1 * Xiaomi Aqara 86 Fire Wall Switch One Button
* ctrl_ln1.aq1 * Xiaomi Aqara Wall Switch LN
* ctrl_ln2 * Xiaomi 86 zero fire wall switch double key
* ctrl_ln2.aq1 * Xiaomi Aqara Wall Switch LN double key
* ctrl_neutral2 * Xiaomi Wired Dual Wall Switch
* ctrl_neutral1 * Xiaomi Wired Single Wall Switch
* cube * Xiaomi Cube
* sensor_cube.aqgl01 * Xiaomi Cube
* magnet * Xiaomi Door Sensor
* sensor_magnet.aq2 * Xiaomi Aqara Door Sensor
* curtain * Xiaomi Aqara Smart Curtain
* motion * Xiaomi Motion Sensor
* sensor_motion.aq2 * Xiaomi Aqara Motion Sensor
* sensor_wleak.aq1 * Xiaomi Aqara water sensor
* ctrl_ln2.aq1 * Xiaomi Aqara Wall Switch LN (Double)
* remote.b286acn01 * Xiaomi Aqara Wireless Remote Switch (Double Rocker)
* remote.b1acn01 * Xiaomi Aqara Wireless Remote Switch
* vibration * Xiaomi vibration Sensor
* wleak1 * Xiaomi Aqara Water Sensor
* lock_aq1 * Xiaomi Lock
## yunkong2 Mi Home Adapter installation
Further settings are only made via the yunkong2 Admin * interface.
Find the adapter in the `Adapter` area and install it using the `+` sign.
![Logo](media/Adapter.png)
The following configuration window then opens:
![Logo](media/Adapterconfig1.PNG)
Enter the password determined above under `Default Gateway Key` and close the window
with `save and close`.
The current adapter should then be displayed green under `Instances`:
![Logo](media/Instanz.PNG)
Under `Objects` now the gateway and its learned devices are displayed:
![Logo](media/Objekte.PNG)
The manual was created to the best of my knowledge and belief.
[Android App]:(https://play.google.com/store/apps/details?id=com.xiaomi.smarthome)
[iOS App]:(https://itunes.apple.com/de/app/mi*home*xiaomi*smarthome/id957323480?mt=8)