gfduszynski / esphome-miot Goto Github PK

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, 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:

There are probably many more devices that could be supported, currently there are ESPHome configs for the following:

Xiaomi Smart Air Purifier 4 Lite

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!

First, look up the desired device on the MIoT specs 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.

For an example, see the spec for the Xiaomi Smart Air Purifier 4 Lite and its ESPHome config file.

Once your newly added device is working, please open a PR to add its config here!

https://github.com/jaromeyer/mipurifier-esphome