Home - shaarkys/com.xiaomi-miio GitHub Wiki

Introduction

Use Homey to control WiFi devices which connect trough the Xiaomi Mi Home app. You can also use this app to control Xiaomi / Aqara Zigbee devices which are connected to a Xiaomi gateway. There are no restrictions to the number of connected Zigbee devices, since you can have multiple Mi Gateway devices and distribute all Zigbee devices between them. If you want to control ZigBee devices directly from Homey please use the Xiaomi Zigbee app available in the Homey app store.

Important

Xiaomi does not officially support controlling devices from outside the Mi Home app. Additional steps are required for pairing these devices with Homey that require some technical knowledge. It also means not all available devices are supported. Also be aware that Xiaomi can make changes to it's eco system at any time resulting in Homey not being able to control these devices anymore.

Adding miIO devices

For Homey to be able to communicate with devices over the miIO protocol a unique device token needs to be obtained. In some cases technical knowledge is needed for retrieving these tokens. See the instructions here on retrieving device tokens.

(Un)supported devices

As mentioned not all available devices are supported. Here is a list of identified devices that should work. If you want support for a specific device please read this.

Donations

I enjoy creating apps for Homey and try to support them as best as I can. If you enjoy using my apps a donation in return for the time I put into this is much appreciated.