iot-backend/software/firmware/plant-monitor/README.md

# Plant Monitor

## Existing project

We use our existing plant monitor for this project.

It can be found in this Git instance: [Plant sensor workshop](https://code.curious.bio/curious.bio/pflanzensensor-workshop)

## Tasmota

[Tasmota](https://tasmota.github.io/docs/) is an alternative Firmware for ESP8266. It's easy to use with it's graphical user interface.

You can flash Tasmota right from the browser using the [Tasmota Web Installer](https://tasmota.github.io/).

![Flash it](./docs/images/01-flash-1.png)

You have to connect your device through USB and select the right port. Exisisting firmware will be delete.

![Erase everything](./docs/images/02-flash-2.png)

After Tasmota has been flashed to your ESP, you can already set up your wifi.

![Set up Wifi](./docs/images/03-wifi.png)

After your device is connected to Wifi, you can switch over to the web UI of your device. Yes, your device now runs an embedded web server. There you can configure your device.

![Embedded web server](./docs/images/04-web-ui.png)

### Configure

Using this Web UI you can setup up your device: `Configure -> Configure Module`

Our Wemos D1 mini clone is a `generic device with 18 ports`. We have a DHT11 connected to D1 and an analogue measurement on A0.

![Basic configuration](./docs/images/05-configuration.png)


After configuring it this way, we can see you data in the web UI.

![Flash it](./docs/images/06-overview.png)

### MQTT

Tasmota's main protocol is MQTT. You can setup MQTT under `Configuration -> MQTT`.

 ![MQTT](./docs/images/07-setup-mqtt.png)

To send data more frequent (nice for debugging) you have to change the telemetry period to a lower leven (than 300 s / 5 min).

 ![Telemetry interval](./docs/images/08-configure-telemetry-interval.png)
 
 Then our device will send data like this:
 
 ```
 {
  "Time": "2023-02-26T17:19:55",
  "ANALOG": {
    "A0": 6
  },
  "DHT11": {
    "Temperature": 19,
    "Humidity": 44,
    "DewPoint": 6.4
  },
  "TempUnit": "C"
}

 ```
You can subscribe to this MQTT event in Node-RED.

![Node-RED](./docs/images/08-node-red-overview.png)

There is a small converter function, so we only store the interesting values in InfluxDB.

```
return {
    payload: {
        temperature: Number(msg.payload.DHT11.Temperature),
        humidity: Number(msg.payload.DHT11.Humidity)
    }
};
```
We can query this data in InfluxDB.

![InfluxDB](./docs/images/09-influx.png)

This is our query.

```
from(bucket: "plant")
  |> range(start: v.timeRangeStart, stop: v.timeRangeStop)
  |> filter(fn: (r) => r["_measurement"] == "msg")
  |> filter(fn: (r) => r["_field"] == "temperature" or r["_field"] == "humidity")
  |> aggregateWindow(every: v.windowPeriod, fn: mean, createEmpty: false)
  |> yield(name: "mean")
```

We can use this query to create a dashboard in Grafana.
![InfluxDB](./docs/images/10-grafana.png)