Skip to content

Xiaomi BLE Thermo- & Hygrometer implementation for Domoticz

License

Notifications You must be signed in to change notification settings

fr31b3u73r/miThermoHygro

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

4 Commits
 
 
 
 
 
 

Repository files navigation

miThermoHygro

Python Donate

Important information: This library was developed for working with FW version 00.00.66. Xiaomi might change interface in future FW updates!

This python script allows you interfacing Xiaomi BLE temperature and humidity sensors with Domoticz. To be able to use it your device needs a bluetooth hardware that supports BLE, Python (2) as well as external libraries as defined in imports. Tested on Raspberry Pi 3.

Setup

First you need to know the MAC addresses of your sensor devices (can be easily found using hcitool on PC/Mac or smarthone BLE scan apps). Next create a new hardware device in Domoticz using type "dummy" and add the according amount of your sensors as devices of type "Temp + Humidity" to it. Afterwards open the script and edit the Domoticz configuration to match your setup. Next add your sensors (with the MAC addresses you got above) and assign them to the according device Idx of domoticz. You can add as many sensors as you want (of course also only one is possible).

That´s it! Now whenever you run the Python script the sensor data in Domoticz gets updated. For continuous polling just create a cronjob for example on your device calling the Python script.

Supported values

  • temperature
  • humidity
  • battery level

Thanks

A big thanks to Dirk (distel) of the FHEM forum for reverse engineering the sensor!

About

Xiaomi BLE Thermo- & Hygrometer implementation for Domoticz

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages