A Python library for working with Xiaomi Mijia LYWSD03MMC bluetooth temperature and humidity sensors.
Updating the firmware on the devices is not required.
This package is built on top of the lywsd02 package, which may include additional useful information.
This relies on bluepy installed via python pip, which itself needs libglib2 to install:
sudo apt-get install python3-pip libglib2.0-dev
The LYWSD03MMC package can then be installed from PyPi, using the following command:
pip3 install lywsd03mmc
Finding the MAC address of the devices
From the Xiaomi Home app:
- Go into the details of the device
- Click on the three dots to get into the settings
- Click "About" (near the top of the list)
- And make a note of the MAC address shown.
It is also possible to find the addresses of all devices by running
sudo hcitool lescan and looking for devices labelled "LYWSD03MMC"
Two helper commands are distributed here:
lywsd03mmc - Current data
This shows the current temperature, humidity and battery level of the device.
lywsd03mmc2csv - Export history
This exports the history to a CSV file, containing the maximum and minimum temperature and humidity for each hour there is data for.
This can be very slow, and may take up to about 10 minutes to download all the data from the device.
lywsd03mmc2csv A4:C1:38:12:34:56 --output data.csv
The library interface closely matches the LYWSD02 package, with the following changes:
- Setting the time has been removed
- Battery data is available from the main data export
- An extra option has been included to estimate the time the device was started
- History data times are calculated based on the start time of the device
Connecting and retrieving information
Here's an example of getting the basic information out of the device:
from lywsd03mmc import Lywsd03mmcClient client = Lywsd03mmcClient("A4:C1:38:12:34:56") data = client.data print('Temperature: ' + str(data.temperature)) print('Humidity: ' + str(data.humidity)) print('Battery: ' + str(data.battery)) print('Display units: ' + client.units)
Times given in the history output are for the end of the hour in which data was recorded.
Downloading the history data can take a significant amount of time (up to about 10 minutes).
A property is available on the client to output data from each record retrieved, to allow you to see the progress:
# Create the client from lywsd03mmc import Lywsd03mmcClient client = Lywsd03mmcClient("A4:C1:38:12:34:56") # Enable history output client.enable_history_progress = True # Retrieve the history data history = client.history_data
Failed to connect to peripheral
Check you are connecting to the correct MAC address, and are in range of the device.
If those are correct, this can normally be fixed by retrying the connection.