New device support
Added information about Xiaomi Mijia Temperature and Humidity Sensor
This commit is contained in:
Oleksandr Kurbatov
GitHub
parent
4c41adf740
commit
abc43a3c13
33
README.md
33
README.md
|
|
@ -1,6 +1,6 @@
|
|||
# Xiaomi Mi Flora Plant Sensor MQTT Client/Daemon
|
||||
|
||||
A simple Linux python script to query arbitrary Mi Flora plant sensor devices and send the data to an **MQTT** broker,
|
||||
A simple Linux python script to query arbitrary Mi Bluetooth sensor devices and send the data to an **MQTT** broker,
|
||||
e.g., the famous [Eclipse Mosquitto](https://projects.eclipse.org/projects/technology.mosquitto).
|
||||
After data made the hop to the MQTT broker it can be used by home automation software, like [openHAB](https://openhab.org) or Home Assistant.
|
||||
|
||||
|
|
@ -9,15 +9,26 @@ After data made the hop to the MQTT broker it can be used by home automation sof
|
|||
The program can be executed in **daemon mode** to run continuously in the background, e.g., as a systemd service.
|
||||
|
||||
## About Mi Flora
|
||||
* [Xiaomi Mi Flora sensors](https://xiaomi-mi.com/sockets-and-sensors/xiaomi-huahuacaocao-flower-care-smart-monitor) ([e.g. 12-17€](https://www.aliexpress.com/wholesale?SearchText=xiaomi+mi+flora+plant+sensor)) are meant to keep your plants alive by monitoring soil moisture, soil conductivity and light conditions
|
||||
* [Xiaomi Mi Flora sensors](https://www.huahuacaocao.com) ([e.g. 12-17€](https://www.aliexpress.com/wholesale?SearchText=xiaomi+mi+flora+plant+sensor)) are meant to keep your plants alive by monitoring soil moisture, soil conductivity and light conditions
|
||||
* The sensor uses Bluetooth Low Energy (BLE) and has a rather limited range
|
||||
* A coin cell battery is used as power source, which should last between 1.5 to 2 years under normal conditions
|
||||
* Food for thought: The sensor can also be used for other things than plants, like in the [fridge](https://community.openhab.org/t/refrigerator-temperature-sensors/40076) or as [door and blind sensor](https://community.openhab.org/t/miflora-cheap-window-and-door-sensor-water-sensor-blind-sensor-etc/38232)
|
||||
|
||||
## About Xiaomi Mijia Temperature and Humidity Sensor
|
||||
* ''Xiaomi Mijia Temperature and Humidity Sensor'' ([e.g. $13](https://www.aliexpress.com/wholesale?SearchText=Mijia+Bluetooth+Temperature+Humidity+Sensor)) are for monitoring indoor air temperature and humidity
|
||||
* The sensor uses Bluetooth Low Energy (BLE) and has a rather limited range
|
||||
* Weight: 43 g
|
||||
* Screen size: 1.78 inch
|
||||
* Temperature range: -9.9-60
|
||||
* Humidity range: 0 ~ 99.9%
|
||||
* Rated power: 0.18 mW
|
||||
* Powered By : Batteries (AAA)
|
||||
|
||||
## Features
|
||||
|
||||
* Tested with Mi Flora firmware v2.6.2, v2.6.4, v2.6.6, v3.1.4, others anticipated
|
||||
* Build on top of [open-homeautomation/miflora](https://github.com/open-homeautomation/miflora)
|
||||
* Tested with Xiaomi Mijia Temperature and Humidity Sensor (MJ_HT_V1) firmware v00.00.66
|
||||
* Build on top of [open-homeautomation/miflora](https://github.com/open-homeautomation/miflora) and [mitemp_bt](https://github.com/flavio20002/mitemp_bt)
|
||||
* Highly configurable
|
||||
* Data publication via MQTT
|
||||
* Configurable topic and payload:
|
||||
|
|
@ -36,9 +47,9 @@ The program can be executed in **daemon mode** to run continuously in the backgr
|
|||
* Automatic generation of openHAB items and rules
|
||||
* Reliable and intuitive
|
||||
* Tested on Raspberry Pi 3 and Raspberry Pi 0W
|
||||
* Wiren Board 5 (Debian Stretch)
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
### Readings
|
||||
|
||||
|
|
@ -52,6 +63,14 @@ The Mi Flora sensor offers the following plant and soil readings:
|
|||
| `conductivity` | [Soil fertility](https://www.plantcaretools.com/measure-fertilization-with-ec-meters-for-plants-faq), in [µS/cm] |
|
||||
| `battery` | Sensor battery level, in [%] |
|
||||
|
||||
The Xiaomi Mijia Temperature and Humidity Sensor offers the following plant and soil readings:
|
||||
|
||||
| Name | Description |
|
||||
|-----------------|-------------|
|
||||
| `temperature` | Air temperature, in [°C] (0.1°C resolution) |
|
||||
| `humidity` | Air humidity in [%] |
|
||||
| `battery` | Sensor battery level, in [%] |
|
||||
|
||||
## Prerequisites
|
||||
|
||||
An MQTT broker is needed as the counterpart for this daemon.
|
||||
|
|
@ -91,13 +110,13 @@ vim /opt/miflora-mqtt-daemon/config.ini
|
|||
|
||||
**Attention:**
|
||||
You need to add at least one sensor to the configuration.
|
||||
Scan for available Mi Flora sensors in your proximity with the command:
|
||||
Scan for available Mi Bluetooth sensors in your proximity with the command:
|
||||
|
||||
```shell
|
||||
sudo hcitool lescan
|
||||
```
|
||||
|
||||
Interfacing your Mi Flora sensor with this program is harmless.
|
||||
Interfacing your Mi Bluetooth sensor with this program is harmless.
|
||||
The device will not be modified and will still work with the official Xiaomi app.
|
||||
|
||||
## Execution
|
||||
|
|
|
|||
Loading…
Reference in New Issue