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.

Important

Während des Updates werden alle deine Einstellungen überschrieben: Sensorname, WLAN Zugangsdaten, Adminpasswort, Einstellungen für Sensoren usw. Lies dir diese Anleitung bis zum Ende durch damit du verstehst, wie du vermeiden kannst, alles neu einstellen zu müssen!

Einstellungen sichern

Sichere deine Einstellungen indem du erst auf den Einstellungen herunterladen und dann auf den Sensordaten herunterladen Button klickst. * Dein Browser sollte dann zwei Dateien von deinem Sensor bekommen: config.json und sensors.json.

Important

Der Pflanzensensor wird nach dem Update kurz 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 also auf einem Gerät mit WLAN machen, sonst kannst du dich nach dem Update nicht mit deinem Pflanzensensor verbinden um deine Einstellungen wiederherzustellen.

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

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

Einstellungen wiederherstellen

Durch das Update wurden deine Einstellungen überschrieben und dein Pflanzensensor hat u.a. seine WLAN Einstellungen und seinen Namen vergessen.
Er wird ein eigenes WLAN aufmachen mit dem Namen Fabmobil Pflanzensensor. Verbinde dich zu diesem. Falls du eine Warnung bekommst, dass das WLAN keine Verbindung zum Internet hast 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 und das Passwort Fabmobil.

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

🎉 Du hast die Software deines Pflanzensensors erfolgreich aktualisiert! 🎉

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 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 wieder herzustellen. Wie das geht steht hier