Update

Tip

Es gibt zwei Wege die Firmware des Pflanzensensors zu aktualisieren: über den Webbrowser und WLAN und über USB Kabel mit Hilfe von platform.io und VSCode. Beide Wege sind hier beschrieben.

Update über Webinterface

Auf dieser Seite kannst du die Software deines Pflanzensensors upgraden. Hier ist beschrieben, wie das funktioniert.

Einstellungen sichern

Tip

Eigentlich sichert der Pflanzensensor alle Einstellungen und stellt sie nach dem Update von allein wieder her. Falls aber etwas unvorhergesehenes schief geht kann es sein, dass das nicht funktioniert. In diesem Fall ist ein Backup deiner Konfiguration nützlich, denn so vermeidest du das du alles neu einstellen musst sondern kannst, falls etwas schief ging, deine gesicherten Einstellungen wieder herstellen.

Sichere deine Einstellungen indem du auf den Konfiguration herunterladen Button klickst.
Dein Browser sollte eine config.json-Datei von deinem Sensor bekommen

Important

Falls beim Update oder dem automatischen Wiederherstellen der Konfigurationsdateien etwas schief geht wird dein Pflanzensensor nach dem Update nicht mehr in deinem WLAN sein sondern ein eigenes WLAN mit dem Namen Fabmobil Pflanzensensor aufmachen. Du musst dich dann zu diesem WLAN verbinden um die Einstellungen wieder herzustellen zu können. Du solltest den Download der Einstellungen also auf einem Gerät mit WLAN machen, sonst kannst du dich nach dem Update nicht mit deinem Pflanzensensor verbinden um deine Einstellungen wiederherzustellen. Die IP Adresse des Pflanzensensors, wenn er ein eigenes WLAN aufgemacht hat, ist dann immer 192.168.4.1.

Neue Version herunterladen

Tip

Die Updateseite deines Pflanzensensors zeigt dir die Version der Firmware an, die installiert ist. Vergleiche die Version deines Sensors mit der aktuellsten Version auf der Releases Seite hier auf Github.

Wenn du schon die aktuellste Version hast, brauchst du auch nichts zu aktualisieren.
Ansonsten lade dir von dort die neueste Pflanzensensor Firmware (firmware.bin) und das dazugehörige Dateisystem (littlefs.bin) herunter:

Firmware updaten

Warning

Die Reihenfolge des Überspielens der beiden Dateien ist wichtig. Stelle sicher, dass du immer zuerst die firmware.bin und erst danach die littlefs.bin überspielst!

Jetzt kannst du auf der Update Seite des Pflanzensensors auf den Durchsuchen ... Button klicken. Wähle dann firmware.bin aus. Das Update dauert etwa 1-2 Minuten.
Wenn dein Pflanzensensor neu gestartet hat musst du noch einmal auf die Updateseite deines Pflanzensensors gehen. Klicke noch einmal auf Durchsuchen ... und wähle diesmal littlefs.bin aus. Auch hier dauert das Update etwa 1-2 Minuten

🎉 Du hast die Software deines Pflanzensensors erfolgreich aktualisiert! 🎉

Einstellungen wiederherstellen im Fehlerfall

Warning

Das Wiederherstellen der Einstellungen nach dem Update geschieht eigentlich automatisch und du musst dich darum nicht kümmern. Diese Anleitung ist nur für den Notfall wenn etwas schief gegangen sein sollte.

Tip

Falls du vor dem Update deine Konfigurationsdateien nicht heruntergeladen hast wie oben beschrieben kannst du sie auch nicht wiederherstellen. In dem Fall musst du alle Einstellungen manuell wieder neu konfigurieren.

Wenn beim wiederherstellen der Einstellungen etwas schief ging wird dein Pflanzenssensor u.a. seine WLAN Einstellungen und seinen Namen vergessen haben.
Er wird dann ein eigenes WLAN aufmachen mit dem Namen Fabmobil Pflanzensensor. Verbinde dich zu diesem. Falls du eine Warnung bekommst, dass dieses WLAN keine Verbindung zum Internet hat, kannst du diese ignorieren.
Gehe auf die Geräteeinstellungen Seite deines Pflanzensensors. Sie sollte unter http://192.168.4.1/admin erreichbar sein.

Tip

Falls du dein Adminpasswort geändert hattest, hat der Pflanzensensor das auch vergessen. Falls du nach einem Login gefragt wirst ist der Benutzername admin (kleines "a" am Anfang!) und das Passwort Fabmobil (großes "F" am Anfang!).

Auf der Geräteeinstellungsseite kannst du jetzt die heruntergeladene Konfigurationsdatei config.json wieder hochladen und so deine Einstellungen wiederherstellen:
Danach startet den Sensor neu und er sollte sich wieder unter altem Namen und mit alten Einstellungen mit deinem WLAN verbinden.

Update über USB Kabel und VSCode

Tip

Falls beim Update über das Webinterface etwas schief ging oder du technisch tiefer einsteigen möchtest kannst du deine Pflanzensensorsoftware auch per USB Kabel und VSCode überspielen. Das ist hier beschrieben.

Einstellungen sichern

Sichere deine Einstellungen über den Update Bereich des Webinterfaces deines Pflanzensensors:
klicke auf den Einstellungen herunterladen und dann auf den Sensordaten herunterladen Button.
Dein Browser sollte dann zwei Dateien von deinem Sensor bekommen: config.json und sensors.json.

Important

Falls du nicht wie unter Einstellungen anpassen beschrieben die Einstellungen in der Konfigurationsdatei vor dem Kompilieren änderst wird der Pflanzensensor nach dem Update nicht mehr in deinem WLAN sein sondern ein eigenes WLAN mit dem Namen Fabmobil Pflanzensensor aufmachen. Zu dem musst du dich dann verbinden, um die Einstellungen wieder herzustellen. Du solltest den Download der Einstellungen ggfs. auf einem Gerät mit WLAN machen, sonst kannst du dich nach dem Update nicht mit deinem Pflanzensensor verbinden um deine Einstellungen wiederherzustellen.

VSCode und platformio installieren

lade dir Visual Studio Code herunter und installiere es
finde in VSCode den Erweiterungsmarktplatz, suche dort nach der PlatformIO IDE und installiere sie

Pflanzensensor Quellcode herunterladen

Lade dir den aktuellen Quellcode der Pflanzensensorfirmware von der Github Releases Seite herunter und entpacke ihn
öffne den entpackten Ordner in VSCode

Tip

Wenn du die PlatformIO IDE Erweiterung installiert hast sollte diese die platformio.ini automatisch erkennen und die benötigten Bibliotheken und alles weitere für dich herunterladen. Beim ersten Mal kann das, je nach Geschwindigkeit deiner Internetverbindung, einige Minuten dauern.

Einstellungen anpassen

Finde die config_example.h Datei im Pflanzensensor/src/configs Unterverzeichnis
Nenne sie in config_pflanzensensor.h um
Öffne sie in VSCode. Du kannst hier allerlei Einstellungen anpassen und zB. den Namen, das Adminpasswort oder die gespeicherten WLAN Zugangsdaten anpassen. Die wichtigsten Einstellungen sind:
- DEVICE_NAME ist der Name deines Sensors (und auch des WLANs welches er anbietet, falls keine anderen WLANs eingespeichert sind oder diese nicht erreichbar sind)
- ADMIN_PASSWORD ist das Adminpasswort des Webinterfaces
- WIFI_SSID_[1,2,3] und WIFI_PASSWORD_[1,2,3] sind die drei unterschiedlichen WLANs zu denen sich der Pflanzensensor versucht zu verbinden
- MEASUREMENT_INTERVAL ist das Messintervall in Sekunden

Firmware kompilieren und überspielen

Schließe den Pflanzensensor per USB an deinen Computer an. Achtung: du musst zum Daten überspielen den MicroUSB Stecker am ESP8266 verwenden. Der USB-C Stecker an der Leiterplatte dient nur der Stromversorgung und kann keine Daten überspielen.
Finde den PlatformIO Reiter in VSCode und dort den default Ordner (mit kleinem D):

Führe nacheinander folgende zwei Schritte aus:
1. Upload: kompiliert den Code und überspielt ihn auf den Sensor. Das kann, wenn du es das erste Mal machst, ein paar Minuten dauern
2. Upload Filesystem Image: überspielt das Dateisystem. Dabei gehen alle deine Einstellungen verloren.
Starte deinen Pflanzensensor neu und überprüfe, ob alles noch funktioniert
Gegegebenenfalls kannst du die vorher heruntergeladene config.json und sensors.json auch wieder hochladen um deine (Sensor)Einstellungen wiederherzustellen. Wie das geht steht hier