This library lets you read sensor data from a Xiaomi Aqara temperature and humidity sensor.
the mithermometer library is based on the miflora library. Thanks for this great lib.
It supports reading the different measurements from the sensor
To use this library you will need a Bluetooth Low Energy dongle attached to your computer. You will also need a Xiaomi Aqara thermometer.
As there is unfortunately no universally working Bluetooth Low Energy library for Python, the project currently offers support for two Bluetooth implementations:
To use the bluepy library you have to install it on your machine, in most cases this can be done via:
pip3 install bluepy
Example to use the bluepy backend:
from mithermometer.mithermometer_poller import MiThermometerPoller
from btlewrap.bluepy import BluepyBackend
poller = MiThermometerPoller('some mac address', BluepyBackend)
This is the backend library to be used.
To use the bluez wrapper, you need to install the bluez tools on your machine. No additional python libraries are required. Some distrubutions moved the gatttool binary to a separate package. Make sure you have this binaray available on your machine.
Example to use the bluez/gatttool wrapper:
from mithermometer.mithermometer_poller import MiThermometerPoller
from btlewrap.gatttool import GatttoolBackend
poller = MiThermometerPoller('some mac address', GatttoolBackend)
This backend should only be used, if your platform is not supported by bluepy. Note: gatttool is depracated in many Linux distributions.
If you have a Blue Giga based device that is supported by pygatt, you have to
install the bluepy library on your machine. In most cases this can be done via:
pip3 install pygatt
Example to use the pygatt backend:
from mithermometer.mithermometer_poller import MiThermometerPoller
from btlewrap.pygatt import PygattBackend
poller = MiThermometerPoller('some mac address', PygattBackend)
mithermometer depends on the btlewrap library. If you install mithermometer via PIP btlewrap will automatically be installed. If not, you will have to install btlewrap manually:
pip3 install btlewrap
please have a look at CONTRIBUTING.md
mithermometerThe following shows a selected list of projects using this library:
FAQs
Library to read data from Xiaomi Aqara thermometer
We found that mithermometer demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
Research
An advanced npm supply chain attack is leveraging Ethereum smart contracts for decentralized, persistent malware control, evading traditional defenses.
Security News
Research
Attackers are impersonating Sindre Sorhus on npm with a fake 'chalk-node' package containing a malicious backdoor to compromise developers' projects.
Security News
The npm package for the LottieFiles Player web component was hit with a supply chain attack after a software engineer's npmjs credentials were compromised.