Skip to content

dmitry-cherkas/mikettle

 
 

Repository files navigation

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:

  • Current action
  • Current Mode
  • Keep warm set temperature
  • Current temperature
  • Keep warm type
  • Keep warm time

Supports controlling of these values:

  • TBD

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

About

Xiaomi Mi Kettle Bluetooth Library

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Python 95.5%
  • Shell 4.5%