Skip to end of metadata
Go to start of metadata
Autor
Logo

Status

STABLE

Version1.0.1
Min. LB Version

LB 1.0LB 2.0

Downloadhttps://github.com/michaelmiklis/loxberry-plugin-miflora/archive/2.0.2.zip
ZweckLoxberry plugin for querying Xiaomi MiFlora Flower Sensors
LanguagesEN, DE
Diskussionhttps://www.loxforum.com/forum/projektforen/loxberry/plugins/156917-plugin-xiaomi-miflora-flower-monitor
 Version History...
  • 2020-01-05 Release 2.0.2 - Fixed issue with btlewrap __init__
  • 2019-12-31 Release 2.0.1 - Support for Loxberry 2.0.0.4 and above
  • 2018-06-18 Release 1.0.1 - Fixed typo in postroot.sh install script
  • 2018-06-04 Release 1.0.0 - Initial release of version 1.0.0


Inhalt


This Plugin queries the Xiaomi MiFlora Flower Sensors via bluetooth low energy (btle) and sends the data via UDP to the Loxone Miniserver.

Xiaomi MiFlora Plugin

The Xiaomi MiFlora Plugin supports multiple flower sensors. During each execution a bluetooth scan for Xiaomi MiFlora devices is performed and each found device will be queried. Each received value will be send as an individual UDP packet. The UDP packets will have the following format:

[Device-MAC].[Sensor-Name]=[Value]

Sample:

C47C8D66275B.Moisture=4 C47C8D66275B.Light=136

Sample

The UDP packages will be sent as follows:

UDP-Monitor

With the following command recognition the values can be assigend to a "UDP-Command" / virtual input:

UDP-Befehl

Sensor data

Sensor NameDescriptionSample value
NameName of the sensorFlower care
PollTimeDate/Time in Loxone format297370058
PollTimeStringDate/Time string03.06.2018 18:47:38
FirmwareFirmware version2.7.0
TemperatureTemperature in Celcius27.1
MoistureMoisture (unknown unit)4
LightLight (unknown unit)136
ConductivityConductivity (unknown unit)0
BatteryBattery level in percent86

Troubleshooting and feedback

If you have any issues you can run the plugin manually from the Loxberry command line (SSH) using the following command:

/usr/bin/python3 /opt/loxberry/bin/plugins/xiaomi-miflora/miflora.py

If the above command does NOT find you Xiaomi Flower Sensors proceed with the following steps to find the cause:


Step 1: Are the sensors are discoverable by the OS?

Test if the bluetooth stack from Raspbian can find the devices:

hcitool lescan (must be executed as root)

If your device is not found - it seems to be a low-level problem either with the bluetooth device, your raspbian drivers, bluetooth chip, e.g. Please understand that I cannot provide support for these kind of problems as they are not related to the plugin.

Step 2: Are the sesnors are discoverable by the Python btle-wrapper?

Start the btle-wrapper (called bluepy-helper). This module makes the bluetooth stack available in python3.

./usr/local/lib/python3.7/dist-packages/bluepy/bluepy-helper

Enter scan and check the output if your devices are listed here (rsp=$scanaddr=b{YOUR DEVICE ID}type)

If your device is not found or any module-errors are shown it seems to be a problem with the bluepy python3 moduel. Check the version and try to manually reinstall the module:

pip3 show bluepy apt-get install --no-install-recommends --reinstall python3-pip

Please understand that I cannot provide support for these kind of problems as they are not related to the plugin.

Step 3: Discover using pyhton3 script blescan

To start a discovery of the BLE devices using blescan.py execute the following command:

python3 /usr/local/bin/blescan

If your device is not found - it seems to be a problem with the bluepy python3 module. Check the developers page https://github.com/IanHarvey/bluepy for further assistance.

Step 4: All of the above worked correctly, but the plugin still fails

Post an issue on my GitHub Page or in the Loxberry Forum.https://www.loxforum.com/forum/projektforen/loxberry/plugins/156917-plugin-xiaomi-miflora-flower-monitor

Feedback & Discussion

This plugin will be improved over time and feedback is appreciated. Therefore I created a thread in the LoxForum:

https://www.loxforum.com/forum/projektforen/loxberry/plugins/156917-plugin-xiaomi-miflora-flower-monitor

Where to buy

Amazon: https://www.amazon.de/Flower-Care-Pflanzenmonitor-Bodenfruchtbarkeit-feuchtigkeitsgrad-White/dp/B01MUDQD8I/

AliExpress: https://de.aliexpress.com/item/Original-Xiaomi-Mi-Plants-Monitor-Flower-Plants-Tester-Xiaomi-Flora-Sensor-with-Bluetooth-for-Aquarium-Garden/32739947607.html

AliExpress: https://de.aliexpress.com/item/Xiaomi-MIJIA-Flora-Monitor-Digital-Flower-Grass-Plants-Care-Garden-Soil-Water-Smart-Tester-Sensor-International/32864987731.html

Otherwise search for "Flora" on AliExpress, Zapals or any other shopping site.


Tested Devices

The following devices have been tested with this plugin:

Device DescriptionResult
Xiaomi MiFlora International Version(successful)
Raspberry Pi 3 internal Bluetooth Module (Buster)(successful)
LogiLink® Bluetooth 4.0 Adapter
(successful)