WORK IN PROGRESS
-
Install it via PyPI:
pip install lywsd02
Note: use
pip3
instead ofpip
on Raspbian and other systems that default to Python 2. -
Or directly from the source code:
git clone https://github.com/h4/lywsd02.git python lywsd02/setup.py install
Note: use
python3
if your system defaults to Python 2.
Instantiate client with Lywsd02 mac address
from lywsd02 import Lywsd02Client
mac = '3F:59:C8:80:70:BE'
client = Lywsd02Client(mac)
Read data (each property will be fetched using new connection)
print(client.temperature)
print(client.humidity)
Read temperature as humidity from a single notification
data = client.data
print(data.temperature)
print(data.humidity)
Read data (all data will be retrieved with a single connection)
with client.connect():
data = client.data
print(data.temperature)
print(data.humidity)
print(client.battery)
Read the 10 most recent entries only
with client.connect():
total_records, current_records = client.num_stored_entries
client.history_index = total_records - 10 1
data = client.history_data
This library also installs a simple command-line utility called lywsd02
.
It allows to synchronize time and read data from devices:
lywsd02 sync 3F:59:C8:80:70:BE
lywsd02 read 3F:59:C8:80:70:BE 3F:59:C8:80:70:BF
Consult lywsd02 -h
to get information on all possible actions.
Note that you may need to replace lywsd02
with ~/.local/bin/lywsd02
or some other path, depending on your installation settings.
client.temperature
– Sensor's temperature data in Celsius degrees. Updates with timeout (See below)client.humidity
– Sensor's humidity data in percent. Updates with timeoutclient.units
– Current temperature units displayed on screen. Returns'C'
for Celsius and'F'
for Fahrenheitclient.time
– Current time and timezone offset. Returns as tuple ofdatetime.datetime
andint
client.battery
– Sensor's battery level in percent (0 to 100).client.history_data
– Ordered Dictionary of hourly minimum and maximum including timestamp for temperature and humidityclient.num_stored_entries
- A tuple describing thehistory_data
property. It holds the number of total records saved and currently stored recordsclient.history_index
- Index where thehistory_data
collection should be read from
client.units = 'C'
– Changes temperature units displayed on screenclient.time = datetime.datetime.now()
- Changes time using local timezone or tz_offset (if set)client.tz_offset = 1
- Sets timezone offset in hours that will be used when setting timeclient.history_index = total_records - 9
- Sets an index so thathistory_data
will be updated with the ten most recent entries
Client may be initialized with additional kwargs.
notification_timeout
– timeout to wait fortemperature
andhumidity
requests. If sensor responds slower then timeout data would not updated. Default value is 5 second.
from lywsd02 import Lywsd02Client
mac = '3F:59:C8:80:70:BE'
client = Lywsd02Client(mac, notification_timeout=1.0, data_request_timeout=30.0)
Error:
ERROR: Command errored out with exit status 1: /usr/bin/python3 -u -c 'import sys, setuptools, tokenize; sys.argv[0] = '"'"'/tmp/pip-install-m1_xzdf5/bluepy/setup.py'"'"'; __file__='"'"'/tmp/pip-install-m1_xzdf5/bluepy/setup.py'"'"';f=getattr(tokenize, '"'"'open'"'"', open)(__file__);code=f.read().replace('"'"'\r\n'"'"', '"'"'\n'"'"');f.close();exec(compile(code, __file__, '"'"'exec'"'"'))' install --record /tmp/pip-record-00nadffm/install-record.txt --single-version-externally-managed --compile Check the logs for full command output.
Fix: Install glib2 library
# On RedHat/CentOS/Fedora:
dnf install glib2-devel
# On Ubuntu/Debian:
apt install libglib2.0-dev
# On Alpine:
apk add glib-dev