ESPHome components for MIoT devices
These ESPHome components are designed for MIoT devices which adhere to the Xiaomi MIoT Serial Communication protocol.
Such devices contain two microcontrollers, one actually controls the hardware (MCU), and the other acts as a LAN/cloud gateway.
These components allow you to replace the firmware on the latter, hence liberating your devices from the vendor cloud.
Since this uses ESPHome, adding your liberated devices to Home Assistant becomes a breeze with the official integration:
Supported devices
There are probably many more devices that could be supported, currently there are ESPHome configs for the following:
Some of the devices have more than one model (like Mi Air Purifier 3C). If their MIoT specifications are compatible, the ESPHome config will be usable with all of them.
Unsupported devices
-
Devices without a dedicated MCU, using only the ESP chip to directly control the hardware.
As these components are designed around the communication protocol between the two microcontrollers they’re of no use for such devices.
-
Devices using a proprietary Xiaomi WiFi microcontroller.
That hardware is currently unsupported by PlatformIO and hence ESPHome.
-
Devices that use the legacy miio protocol.
Such devices may have an ESP chip and a separate microcontroller, but the communication protocol is unsupported by these components.
If the device has the miio2miot tag on the Xiaomi MIoT Spec site, or if you see messages like props power "on" on the serial bus, this is the case.
Known unsupported devices:
| Device |
Model Version |
Reason |
Link |
MIoT Specification |
| Mi Air Purifier 2S |
zhimi.airpurifier.mc1 |
Proprietary chip MHCW02P |
link |
link |
| Mi Air Purifier 2H |
zhimi.airpurifier.mc2 |
Proprietary chip MHCW02P |
link |
link |
| Xiaomi Air Purifier 4 Lite (CN Model) |
zhimi.airp.rma3 |
No dedicated MCU |
link |
link |
| Xiaomi Smart Air Purifier 4 Compact |
zhimi.airp.cpa4 |
No dedicated MCU |
link |
link |
| Smartmi Evaporative Humidifier |
zhimi.humidifier.cb1 |
Proprietary chip MHCWB2P |
link |
link |
| Smartmi Evaporative Humidifier 3 |
zhimi.humidifier.ca6 |
No dedicated MCU |
link |
link |
| Xiaomi Smart Tower Fan |
dmaker.fan.p39 |
Proprietary chip MHCWB4P-B |
link |
link |
| Xiaomi Smart Tower Fan 2 |
xiaomi.fan.p45 |
Proprietary chip MHCWB5G-B |
link |
link |
| Xiaomi Smart Pet Food Feeder 2 |
xiaomi.feeder.iv2001 |
Proprietary chip MHCW05P-B |
link |
link |
| Xiaomi Smart Graphene Heater |
xiaomi.heater.ma8 |
No dedicated MCU |
link |
link |
| Xiaomi Smart Evaporative Humidifier |
xiaomi.humidifier.3lite |
Proprietary chip MHCWB5G-B |
link |
link |
Building a firmware
Either download an ESPHome config or create your own (see below) and feed it to ESPHome to build the firmware.
There’s no need to clone this repo, unless you plan to contribute - which would be very welcome!
Adding devices
First, look up the desired device on the Xiaomi MIoT Spec site.
Each device defines its service (SIID) and property (PIID) IDs. You just have to add all the desired properties with their according IDs to your ESPHome yaml config.
Alternatively, you can use the online
miot2esphome utility to
try to automatically generate a starter configuration for you, based on the
published device specs. You can then edit this to make sure everything works.
For examples, see the supported devices table above and compare a config against its specification.
Once your newly added device is working, please open a PR to add its config here!
Feedback
Please feel free to open issues and/or pull requests here.
Alternatively, there’s a thread on the official ESPHome forums.
Inspired by
https://github.com/jaromeyer/mipurifier-esphome
评论