[mi-home] App Store Production: https://homey.app/a/com.xiaomi-miio App Store Test: https://homey.app/a/com.xiaomi-miio/test About the app Use Homey to control supported Wi-Fi devices that are normally managed through the Xiaomi Mi Home app. The app can also control supported Xiaomi and Aqara Zigbee devices connected through a compatible Xiaomi Mi Home Gateway. You can use multiple gateways and distribute your Zigbee devices between them; the app itself does not impose a fixed limit on the number of connected Zigbee devices. If you want to connect Zigbee devices directly to Homey without using a Xiaomi gateway, use the separate Xiaomi Zigbee app available in the Homey App Store. A list of devices currently supported by this app is available here: [image] Supported Devices Homey app to control Mi Home devices that implement the miIO protocol and Xiaomi gateway child devices - shaarkys/com.xiaomi-miio Important information Xiaomi does not officially support controlling these devices outside the Mi Home ecosystem. Pairing therefore requires additional steps and, in some cases, a certain level of technical knowledge. If device support LAN/Local MioT, it must be on the same VLAN as Homey Please also keep in mind that: Not every Xiaomi ecosystem device is supported. Devices that look identical may use different model IDs or protocols. Regional variants, such as EU and CN models, may behave differently. Xiaomi may change its devices, firmware, cloud services or ecosystem at any time. Such changes may temporarily or permanently prevent Homey from communicating with a device. Is an existing device no longer working? For general help and troubleshooting, first post your question in this Homey Community topic. Please describe the issue in English and include as much relevant information as possible: Confirmation the device is on the same VLAN and subnet, as Homey The exact product name The device model ID, for example zhimi.airpurifier.mc1 The product variant or region, such as EU or CN The installed app version The Homey model and Homey firmware version Whether the device previously worked Any relevant error message The steps needed to reproduce the problem Please also send a diagnostic report from within the Xiaomi Mi Home app on Homey and include the diagnostic report ID in your post. If the problem has been identified as an app bug and can be reproduced, you may create a GitHub issue here: [image] Issues · shaarkys/com.xiaomi-miio Homey app to control Mi Home devices that implement the miIO protocol and Xiaomi gateway child devices - Issues · shaarkys/com.xiaomi-miio Before opening a new issue, please check whether the same problem has already been reported. Pairing miIO devices For Homey to communicate with a device through the miIO protocol, the device’s unique token is usually required. Retrieving this token may require additional tools and technical knowledge. Token retrieval instructions: [image] Obtain token Homey app to control Mi Home devices that implement the miIO protocol and Xiaomi gateway child devices - shaarkys/com.xiaomi-miio Video instructions: [In 1 EASY WAY extract Xiaomi Token & Get Control in HomeKit] To determine which Homey driver should be used for your device, consult the supported-device list: [image] Supported Devices Homey app to control Mi Home devices that implement the miIO protocol and Xiaomi gateway child devices - shaarkys/com.xiaomi-miio Whenever possible, give the Xiaomi device a fixed IP address or DHCP reservation. This helps prevent communication problems if its IP address changes. Requesting support for a new device Not every Xiaomi ecosystem device can be supported automatically. Before requesting support, check whether the device is already listed: [image] Supported Devices Homey app to control Mi Home devices that implement the miIO protocol and Xiaomi gateway child devices - shaarkys/com.xiaomi-miio Support for a new device normally requires at least one of the following: An existing open-source implementation or library that documents the device’s miIO methods and properties. Technical information supplied by a user who owns the device, including its exact model ID and the methods, properties and values used by the device. This information can often be obtained by inspecting or capturing communication between the device and the Mi Home app. Further information is available in the python-miio contribution guide. Physical access to the device for development and testing. This generally means that a user would need to provide or send the device to the developer. Without access to the protocol information or the physical device, adding support is usually not possible. Requests for new-device support can be submitted here: [image] Issues · shaarkys/com.xiaomi-miio Homey app to control Mi Home devices that implement the miIO protocol and Xiaomi gateway child devices - Issues · shaarkys/com.xiaomi-miio When submitting a request, always include: The exact product name A link to the exact product variant The complete model ID, for example roborock.vacuum.a15 The region or variant, such as EU or CN Any known miIO methods and properties Links to an existing implementation in another open-source project, if available Please do not submit only a marketing name or product photograph. Xiaomi frequently sells visually similar products with different model IDs and protocols. Support the development :heart: Community apps and appreciation These Homey Community apps are developed and maintained in my spare time. Did you know? In my experience maintaining community Homey apps, only a very small proportion of users choose to support their development financially—even when a new device integration or specific feature has been implemented at their request. Contributions are never required, but they are a meaningful way to recognise the time invested in development, testing, compatibility updates and ongoing user support. If one of my apps has been useful to you, you can optionally show your appreciation here: :heart: Send an optional thank-you via PayPal A contribution does not unlock additional features or affect the support you receive. It is simply a way to say thank you. My Homey apps [Smart Presence | 72x72] Smart Presence Wi-Fi presence detection [Xiaomi Mi Home | 72x72] Xiaomi Mi Home Xiaomi Mi Home devices [Broadlink | 72x72] Broadlink IR, RF and smart devices [TP-Link KASA LAN | 72x72] TP-Link KASA LAN Local Kasa control [Yeelights LAN | 72x72] Yeelights LAN Local Yeelight control [Xiaomi Miija | 72x72] Xiaomi Miija Temperature and humidity sensors [Octoprint | 72x72] Octoprint Monitor your 3D printer [Virtual Radar | 72x72] Virtual Radar ADS-B aircraft tracking [enigma2 | 72x72] enigma2 Control Enigma2 receivers View all my Homey apps →

@Phuturist @Sharkys My commitment is fulfilled. Just donated 15 euros through the PayPal app as @Phuturist committed himself to update the app. Great news!

I will do a donation this weekend as well! And can test some wifi devices such as purifier and humidier. And maybe the Xiaomi Vacuum STYJ02YM? It works via a workaround in the Roborock app but the developer is not active anymore. And in the current Xiaomi app i can’t connect it.

[image] Maurits: It works via a workaround in the Roborock app but the developer is not active anymore Maybe opportunity for @Phuturist fro another app ? :wink:

Thanx to all who donated, it’s much appreciated … :pray: I’ll be on holiday the upcoming week. The week after that I will release the first test version to the test channel. This release contains the following: Upgrade to SDK3 Merged with the Mi Homey app from the community store, all devices will now be available under one app (this requires re-pairing of those devices) Support for a couple of extra devices from pending pull requests from the Xiaomi Mi Home repo Couple of improvements to existing drivers Possibly tested on Homey Pro 2023 but I havent had time to set that up yet Since it’s a complete rewrite it could be some devices need to be re-paired or flows need to be fixed. There was a lot of duplicate and not optimized code in both apps which I cleaned out. Something that ment breaking currently functionality to make it more future proof. When all is stable I can consider added missing devices where the information of these devices is available somewhere on the internet.

Is there a possibility that “room”-cleaning can come to the app?

What do you mean by this, like vacuum robots ? [image] Phuturist: When all is stable I can consider added missing devices where the information of these devices is available somewhere on the internet. But also [image] [APP][Pro] Roborock Vacuum Cleaners Apps Then I’ll write a new app slight_smile

[image] Sharkys: What do you mean by this, like vacuum robots ? [image] Phuturist: When all is stable I can consider added missing devices where the information of these devices is available somewhere on the internet. For instance. The Xiaomi Mi Home or Mija eco system is huge and they keep bringing out new product variations that work slightely different all the time. Some products have been reversed engineered and integrated in other integrations. Sometimes this information can be used to add it to the Homey app as well. But as mentioned, I first want a stable base (SDK3 with merged functionality of Mi Homey). [image] Sharkys: But also I already looked at that if integrating those would be an opion, the code of this app is not shared on Github by the developer as far as I checked so no, I probably wont be integrating that 1-on-1.

2023-03-05 - v3.1.0 - TEST This release is a complete rewrite of the app including many breaking changes. The app has been fully rewritten with SDK3 to make it futureproof. This new version also merged the devices from the community app Mi Homey. Some previously paired devices might continu to work but please re-pair your devices and/or fix your flows before reporting any issue. If the issue persists after re-pair please report it on the community forum or Github. I have just published version 3.1.0 to the test channel of the app store and I’m looking for people to properly test this version as it will contain bugs. As the release also contains breaking changes the only way to properly test it if you encounter an issue is by re-pairing the device and/or fix your flows and test if the issues still persists. If so, please report it here or preferably on Github. If you want to go back to the live version you will have to re-pair and/or fix your flows again as both versions are not fully back- and forwards compatible. The test version can be installed through this link: Xiaomi Mi Home | Homey

[image] Phuturist: and/or fix your flows and test if the issues Thank you @Phuturist , going to test for my few devices. ALL - just might this script come handy : [HOW-TO][Pro][Cloud] - Tool to FIX (advanced) flows after removing and re-adding devices It’s fantastic life saver in such situations. My advice - mark down the old device IDs before doing any repairs. :wink:

So surprisingly Xiaomi Gateway v2 (lumi.gateway.v3) added flawlessly (previously added as 3 devices, now as one) - I see however JOIN button missing (eg. when adding devices to the GW itself). Surprisingly even lux sensor works after more then 2 years ! :wink: Not sure if light powered off via DIM or powered on via DIM shall results also in Button switched off/on- it’s currently independent on light itself but button itself turn lights on/off. I also got down-light “Philips” lights but after adding them (and also after automatic app update), I’m getting error when interacting with light - Could not get device by ID …sent also diag report f5c3c1ea-9865-4e90-8559-2c82d433ae62 (I hope that’s the right one from clipboard but if not, i guess you were notified)

[APP][Pro] Xiaomi Mi Home App

Apps

Sharkys March 1, 2023, 12:40pm 1007

What do you mean by this, like vacuum robots ?

But also

Topic		Replies	Views
Mi Homey Apps app	335	26252	May 24, 2023
[APP] Yeelights LAN Apps app , lights , yeelights	344	16769	October 19, 2026
[APP][Pro] Xiaomi Miija (Temperature and Humidity) Apps app	212	9028	October 27, 2026
Mi-Light SDK3 Apps	0	140	October 18, 2023
Yeelight not working Questions & Help	38	17287	March 12, 2022

[APP][Pro] Xiaomi Mi Home App

Related topics