drndos / mikettle

Xiaomi Mi Kettle Bluetooth Library
MIT License
54 stars 23 forks source link

mikettle - Library for Xiaomi Mi Kettle with Bleutooth LE

This library properly authenticates with Xiaomi Mi Kettle and allows to read status and control the kettle via Bluetooth.

Based on https://github.com/ratcashdev/mitemp that is based on https://github.com/open-homeautomation/miflora .

This library uses authentication that was reverse engineered by aprosvetova (https://github.com/aprosvetova/xiaomi-kettle) and then customized and verified by me

I am still not sure about ProductId and how many different ProductIds there are. This needs to be investigated further.

Demo

European ProductId (mine) is 275

Place your kettle near your Bluetooth device (for example RaspberryPi)

Run:

hcitool lescan

You can see the Mac address near MiKettle

Run demo by providing MAC address of your kettle and your ProductID (275 for EU).

pip3 install bluepy
python3 setup.py install
python3 demo.py connect AB:CD:EF:12:34:56 275

Functionality

Supports reading of these values:

Supports controlling of these values:

To use this library you will need a Bluetooth Low Energy dongle attached to your computer or Raspberry PI. You will also need a Xiaomi Mi Kettle.

To use with home-assistant please refer to documentation over at home assitant custom component https://github.com/drndos/mikettle-ha

Backend

Backend is using bluepy library. Please refer to installation instructions - https://github.com/IanHarvey/bluepy

Conttributing

please have a look at CONTRIBUTING.md


Projects Depending on mikettle

(TBD) https://github.com/home-assistant/home-assistant