Skip to content
Snippets Groups Projects
Commit b105a44b authored by Michael Schenkelberger's avatar Michael Schenkelberger
Browse files

Update README.md

parent b1769991
No related branches found
No related tags found
No related merge requests found
......@@ -3,9 +3,7 @@
# Pflanzenüberwachungssystem
</span>
Mit dieser Anleitung ist es Ihnen möglich, eine Grafische Übersicht über Ihr Pflanzen zu bekommen. Es werden swohl die Temperatur und Feuchtigkeitsdaten sowie die der Pflanze aktuell zur Verfügung stehende Lux Zahl angezeigt.
Optional:
Bei Pflanzen im Outdoor bereich, kann die aktuelle Regenwahrscheinlichkeit eingeblendet werden.
Mit dieser Anleitung ist es Ihnen möglich, eine grafische Übersicht über Ihre Pflanzen zu bekommen. Es werden sowohl die Temperatur und Feuchtigkeitsdaten, sowie die der Pflanze aktuell zur Verfügung stehende Lux Zahl angezeigt.
## 1. Hardware
......@@ -15,18 +13,18 @@ Bei Pflanzen im Outdoor bereich, kann die aktuelle Regenwahrscheinlichkeit einge
- Bluetooth Pflanzensensoren (je Pflanze 1 Sensor)<br>
von Diverse Herstellern verfügbar. <br>
z.B. ohne Wertiung: WANFEI, Royal Gardineer oder VegTrug<br>
am günstigsten Beschaffen kann man die Senosoren direkt aus Fernost.
Eine günstigere Beschaffungsquelle sind diverse Anbieter aus Fernost.
## 2. Installation des Pi
Damit der Rasberry Pi zum ersten mal starten kann, muss zunächst die Micro-SD Karte mit dem entsprechenden Betriebssysem installiert werden.
Damit der Rasberry Pi zum ersten Mal starten kann, muss zunächst die Micro-SD Karte mit dem entsprechenden Betriebssysem installiert werden.
Dazu wird die SD-Karte in einen PC eingesteckt und mit Hilfe der Software "Pi Installer" installiert.
1. Download Pi Installer von der Website https://www.raspberrypi.com
2. Pi Installer starten und unter **"Betriebssystem"** "Raspberry Pi OS Lite" auswählen.
3. SD-Karte am Computer einlegen Unter **"SD Karte"** die gewünschte SD Karte auswählen.
3. SD-Karte am Computer eingestecken. Unter **"SD Karte"** die gewünschte SD Karte auswählen.
4. Mit Strg + Shit + X bzw. Control + Shift + X den Advance Mode öffnen.
......@@ -36,15 +34,15 @@ Dazu wird die SD-Karte in einen PC eingesteckt und mit Hilfe der Software "Pi In
- ssh muss aktiviert werden. PW selst wählen.
- Wifi muss zumindest bei den Pi Zero Geärten eingerichtet werden.
- Wifi muss zumindest bei den Pi Zero Geräten eingerichtet werden.
(Achtung beim Pi Zero hat nur Wifi 4)
5. Durch Auswahl der Funkion "Schreiben" fortfahren. Meldung mit "Ja" bestätigen.
6. Einleigen der SD Karte in den Raspberry Pi, einstecken der Stromversorgung und erster Hochfahren des Gerätes
6. Einleigen der SD Karte in den Raspberry Pi, einstecken der Stromversorgung. Der Pi startet nach dem Einstecken der Stromversorung automatisch.
7. Verbidnung mit ssh aufbauen. <br>
Dazu Terminal öffnen und zum Verbidnungsaufbau folgenden fehl kopierne und anpassen.
Dazu Terminal öffnen und zum Verbidnungsaufbau folgenden Befehl kopieren und anpassen.
```shell
ssh pi@ip-adresse_des_Pi
......@@ -56,7 +54,7 @@ Dazu wird die SD-Karte in einen PC eingesteckt und mit Hilfe der Software "Pi In
## 3. Installation von Docker inkl. Docker Compose
1. Deinstallation aller ggf. Bereits vorhandenen Docker Daten. <br>
1. Deinstallation aller ggf. bereits vorhandenen Docker Daten. <br>
Wird auch bei Neuinstallation empfohlen.
```shell
......@@ -71,7 +69,7 @@ Dazu wird die SD-Karte in einen PC eingesteckt und mit Hilfe der Software "Pi In
```
3. Installation von Docker <br>
Hier wird zunächst die im Schritt zuvor erkannten Updates Installiert, danach werden die Docker Files Heruntergeladen und installiert.
Hier wird zunächst die im Schritt zuvor erkannten Updates Installiert, danach werden die Docker Files heruntergeladen und installiert.
```shell
sudo apt-get install \
......@@ -88,7 +86,7 @@ Dazu wird die SD-Karte in einen PC eingesteckt und mit Hilfe der Software "Pi In
```
Hinweis: Während der Installation ist eine Bestätigung notwendig, diese mit “Y“ bestätigen
4. Eirnichten des Docker Zugriffs ohne bei jedem Befehl sudo verwenden zu müssen
4. Einrichten der Zugriffsrechte von Docker, dadurch ist es möglich Docker ohne sudo im Befehl verwenden zu können.
```shell
sudo groupadd docker
......@@ -131,7 +129,7 @@ Ein ggf. angezeigter Hinweis zum Kernel kann ignoriert werden.
## 5. Installation der Bluetooth Komponenten und des flowercare-exporter
1. Installation der Bluetooth Komponenten
1. Installation der Bluetooth-Komponenten
Quelle: https://howchoo.com/pi/bluetooth-raspberry-pi
```shell
......@@ -141,7 +139,7 @@ Ein ggf. angezeigter Hinweis zum Kernel kann ignoriert werden.
```
Hinweis: Während der Installation ist eine Bestätigung notwendig, diese mit “Y“ bestätigen.
Restart + erneut einloggen erforderlich (Der erneute login kann etwas dauern)
Restart + erneutes Einloggen erforderlich (Der erneute Login kann etwas dauern)
2. Bluetooth Test
......@@ -155,7 +153,7 @@ Ein ggf. angezeigter Hinweis zum Kernel kann ignoriert werden.
3. Installation von flowercare-exporter
Quelle: https://github.com/xperimental/flowercare-exporter
Download der benötigten Installationsdatein sowie die Installation in ein neues Verzeichniss "flower-exporter"
Download der benötigten Installationsdatein, sowie die Installation in ein neues Verzeichniss "flower-exporter"
```shell
git clone https://github.com/xperimental/flowercare-exporter.git
......@@ -168,7 +166,7 @@ Ein ggf. angezeigter Hinweis zum Kernel kann ignoriert werden.
1. Eigenen Ordner für die Docker Images und Dokumente anlegen
Anlegen eines Ordners „sensor“ im Homeverzeichnis und wechsel in dieses Verzeichniss.
Anlegen eines Ordners „sensor“ im Homeverzeichnis und Wechsel in dieses Verzeichniss.
```shell
sudo mkdir sensor
......@@ -232,7 +230,7 @@ Ein ggf. angezeigter Hinweis zum Kernel kann ignoriert werden.
sudo nano prometheus/prometheus.yml
```
In die Datei Einfügen und in letzter Zeile die IP Adress des Pi eintragen:
In die Datei einfügen und in die letzte Zeile die IP Adress des Pi eintragen:
```shell
# my global config
global:
......@@ -260,7 +258,7 @@ Ein ggf. angezeigter Hinweis zum Kernel kann ignoriert werden.
- targets: ['192.168.15.2:9294']
```
4. Bluetooth Geräte scannen
4. Bluetooth-Geräte scannen
```shell
sudo hcitool lescan
......@@ -279,7 +277,7 @@ Ein ggf. angezeigter Hinweis zum Kernel kann ignoriert werden.
sudo nano /etc/systemd/system/flowercare.service
```
einfügen und unter Environment die Geräte gem. Beispiel anpassen:
Einfügen und unter Environment die Geräte gem. Beispiel anpassen:
```shell
Description=FlowerCareService
......@@ -307,7 +305,7 @@ Ein ggf. angezeigter Hinweis zum Kernel kann ignoriert werden.
WantedBy=multi-user.target
```
Nach erstellen und nach jeder Anderung der zuvor erstellten Service-Datei:
Nach erstellen und nach jeder Änderung der zuvor erstellten Service-Datei muss diese aktiviert werden:
```shell
sudo systemctl daemon-reload
sudo systemctl enable flowercare.service
......@@ -317,7 +315,7 @@ Ein ggf. angezeigter Hinweis zum Kernel kann ignoriert werden.
systemctl status flowercare
```
Der Service sollte nun Aktiv sein, ansonsten noch einmal die config prüfen und die Änderung wie beschrieben bestätigten.
Der Service sollte nun aktiv sein, ansonsten noch einmal die config prüfen und die Änderung wie zuvor beschrieben aktivieren.
Status kann mit Strg + c bzw. Crtl + c beendet werden.
......@@ -340,11 +338,11 @@ Ein ggf. angezeigter Hinweis zum Kernel kann ignoriert werden.
<img src="Screenshot/Screenshot_Targets.png" alt="Prometheus" height="300px">
Die IP Adresse sollte die von Ihnen angegeben Adresse sein und der Status sollte Grün sein.
Die IP Adresse sollte die von Ihnen angegeben Adresse sein und der Status sollte grün sein.
2. Grafana starten
Im Browser folgendes Eingeben
Im Browser folgendes eingeben
IP-Adresse_des_Pi:3000
......@@ -352,7 +350,7 @@ Ein ggf. angezeigter Hinweis zum Kernel kann ignoriert werden.
Name: admin <br>
Passwort: admin <br>
Nach dem ersten einloggen wird man gebeten das Passwort zu ändern.
Nach dem ersten Einloggen wird man gebeten das Passwort zu ändern.
Nun befindet man sich bereits in Grafana.
......@@ -361,47 +359,87 @@ Ein ggf. angezeigter Hinweis zum Kernel kann ignoriert werden.
Da Grafana viele Möglichkeiten zur Gestalltung des Dashboard anbietet und nicht jede einzeln aufgeführt werden kann hier 2 Beispiele zur Gestalltung:
Zunächst muss ein neues Dashboard angelegt werden. Dazu im Linken Menü das Plus Auswählen. Über ''Add an empty panel'' gelangt man in das Design Board von Grafana.
Variante A - Anzeige der akutellen Temperatur und Feuchtigkeit der einzelnen Pflanzen.
**Variante A** - Anzeige der akutellen Temperatur und Feuchtigkeit der einzelnen Pflanzen.
<img src="Screenshot/Screenshot_je_Pflanze.png" alt="Dashboard je Pflanze" height="300px"> <br>
Beispiel Variante A
Zunächst wechseln wir von Time series zu Gauge, dazu ein kurzer klick auf Time Series und dann Gauge wählen.
Unter MEtrics Browser wird dann die entsprechende Metric gewählt.
Zunächst wechseln wir von Time series zu Gauge, dazu ein kurzer Klick auf Time Series und dann Gauge wählen.
Unter Metrics Browser wird dann die entsprechende Metric gewählt.
Hier ein Beispiel für die Temperatur einer Pflanze:
```shell
flowercare_temperature_celsius{name="Wohnzimmer_Calathea"}
```
Generell können so über + Querry weitre Pflanzen hinzugefügt werden. Bei der Betrachtung der einzelnen Pflanzen gelten je Pflanze eventuewll andere Idealserte, vondaher ist eine erstellung eines Panels je Pflanze empfohlen.
Nach der Auswahl der Metric kann auf der Rechten Seite noch der Name der Pflanze sowie die Idealwerte einer Pflanze einstellt werden.
Generell können so über + Querry weitere Pflanzen hinzugefügt werden. Bei der Betrachtung der einzelnen Pflanzen gelten je Pflanze eventuell andere Idealwerte, von daher ist eine Erstellung eines Panels je Pflanze empfohlen.
Nach der Auswahl der Metric kann auf der Rechten Seite noch der Name der Pflanze, sowie die Idealwerte einer Pflanze einstellt werden.
Den Namen in das Feld Title eintragen.
Die Idealwerte Markiert man mit hilfe des Threesholds.<br>
Die Idealwerte Markiert man mit Hilfe des Threesholds.<br>
Dazu benötigt man 3 Bereiche, Base und der erste Wert sind bereits angelegt, den dritten erzeugt man über den Button +Add threeshold.<br>
Die Farbe bei Base wird auf orange gestellt. <br>
Der Wert oberhalb von Base wird auf den niedrigsten empfohlenen Tmeperaturwert der Pflanze eingestellt. Im Beispiel der Calathea 12 und die Farbe auf Grün. <br>
Den obersten Wert ersetzen wir ensprechend durch den EMpfohlenen Maximalwert, hier 32 und die stellen wir Farbe Rot.
Der Wert oberhalb von Base wird auf den niedrigsten empfohlenen Temperaturwert der Pflanze eingestellt. Im Beispiel der Calathea 12 und die Farbe auf Grün. <br>
Den obersten Wert ersetzen wir ensprechend durch den empfohlenen Maximalwert, hier 32 und die stellen wir Farbe rot.
Da der MAximalwert der Ansicht aus den Existierenden Werten der Metric Automatisch einstellt wird und nicht für alle Pflanzen gleiche Werte existren. Empfhielt es sich, die Maximal anzeigbaren Werte einheitlich manuell festzulegen. Dazu muss ,ebenfalls im rechten Menü, unter standard options der Wert bei Max festgelegt werden.
Da der Maximalwert der Ansicht aus den existierenden Werten der Metric automatisch einstellt wird und nicht für alle Pflanzen gleiche Werte existren. Empfielt es sich, die Maximal anzeigbaren Werte einheitlich manuell festzulegen. Dazu muss ,ebenfalls im rechten Menü, unter standard options der Wert bei Max festgelegt werden.
Mit einem Klick auf Apply kommt man in das Dashboard zurück.
Über den Button Add panel können immer weitere Panels aufgenommen werden.
Ein Klick auf den zuvor festgelegten Titel öffnet ein Menü, in dem unter More... - Duplicate das Panel dupliziert werden kann.
Zum Ändern eines Panels auf den Titel des Panels klicken und dann Edit wählen.
Diese kann dann durch Anpassung des Titels, der Metric und ggf. der Idealwerte angepasst werden. Über das Duplicat empfhielt es sich auch das erste Panel mit Feuchtigkeit anzulegen. Hier muss dann allerdings auch die Metric geändert werden.
Die einzelnen Panels können dann beliebig verschoben werden.
Ein Beispiel für die Feuchtigkeit einer Pflanze:
```shell
flowercare_moisture_percent{name="Wohnzimmer_Calathea"}
```
Über den Button Add panel können weitere beliebige Panels aufgenommen werden.
Die einzelnen Panels können auf dem Dashboard frei verschoben werden.
Über die Diskette, kann das aktuelle Dashboard gespeichert werden.
Über das Zahnrad, kann der Name des Dashboards angepasst werden.
Ein Beispiel für die Feutchtigkeit einer Pflanze:
```shell
flowercare_moisture_percent{name="Wohnzimmer_Calathea"}
```
Selbstverständlich kann im Anschluss der Einstellung ein weiteres Dashboard mit der Variante B erstellt werden.
Variante B - Anzeige von Temperatur, Feuchtigkeit und Helligerkeit über die letzten 24 Stunden.
**Variante B** - Anzeige von Temperatur, Feuchtigkeit und Helligerkeit über die letzten 24 Stunden.
<img src="Screenshot/Screenshot_je_Raum.png" alt="Dashboard je Raum" height="300px"> <br>
Beispiel Variante B
Zunächst wird ein Panel für die Temperatur eines Raumes angelegt. Unter Metrics Browser wird die entsprechende Metric gewählt.
Hier ein Beispiel für die Temperatur einer Pflanze:
```shell
flowercare_temperature_celsius{name="Wohnzimmer_Calathea"}
```
über den Button +Querry können weitere Pflanzen, nach dem Schema des Beispiels, zu diesem Raum hinzugefügt werden.
Im rechten Menü wird unter Panel-Options der Titel festgelegt.
Unter Standardoptions wird Degress (°) gewählt und der Maximalwert manuell festgelegt. Dies dient dazu, dass später alle Räume die selben Maximalwerte haben.
Über Apply wird das Panel dem Dashboard hinzugefügt.
Der Klick auf den zuvor festgelegten Titel öffnet ein Menü, in dem unter More... - Duplicate das Panel dupliziert werden kann.
Zum Ändern eines Panels auf den Titel des Panels klicken und dann Edit wählen.
Hier wird nun die Metric angepasst.
Aus flowercare_temperature_celsius{...} <br>
wird flowercare_moisture_percent{...}
Der Titel wird angepasst und aus Degrees wird Humidity (%H) und der Maximalwert wird auf 80 gesetzt.
Im Anschluss wieder mit Apply das Fenster schließen.
Optional kann noch der Lux Wert eingebunden werden. Dazu erneut ein Panel duplizieren.
Die Metric zu flowercare_brightness_lux{...} ändern. Da die Lux stark schwankt, kann man hier auch einen größeren Interval verwenden. den passt man unter der Metricquelle im Feld min Step an. Empfehlung 30m für 30 min. <br>
Auf der Rechten Seite wird erneut der Titel angepasst, unter Axis wird von Linar auf Logarithmic base 10 umgestellt. Der Min Wert auf 1 stellen und der Max Wert auf 10.000. Im Anschluss mit Apply bestätigten.
Das Dashboard kann durch verschieben, vergrößern und verkleinern der Panele, mit Hilfe des Mauszeigers, angepasst werden. Ein Beispeil dazu kann man im vorherigen Screenshot sehen.
Selbstverständlich kann im Anschluss der Einstellung ein weiteres Dashboard mit der Variante A erstellt werden.
Auch ein Dahboard für die einzelen Räume mit Kombination der Variante A und B kann im Alltag praktikabel sein.
0% Loading or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment