Ersteinrichtung WLAN

Inhaltsverzeichnis

WICHTIGER HINWEIS

Beim ESP8266 haben wir mit Release 3.3.0 den WiFiManager wieder entfernt, da dieser für einen Absturz bei der Ersteinrichtung geführt hat. Tragt eure WLAN-Zugangsdaten bitte in der userConfig.h ein:

#define WIFI_SSID "yourSSID"       // SSID of your WiFi network
#define WIFI_PASS "yourWiFiPass"   // WPA key to your WiFi network

Beim ESP32 tritt dieses Problem nicht auf, benutzt vorerst das Release 3.2.0 inklusive WiFiManager und folgt dann weiter dieser Anleitung.

Kurzfassung

Für die Ersteinrichtung wird der WiFiManager benutzt. Beim ersten Start des Mikrocontrollers wird ein Access Point geöffnet, der mit den Werten aus eurer userConfig.h (Abschnitt “Connectivity”) konfiguriert ist: HOSTNAME (default: silvia) und Passwort PASS (default: CleverCoffee).

Verbindet euch mit dem Access Point, wählt euer WLAN aus und gebt das Passwort des Netzwerks ein, dann wird dieses gespeichert und beim nächsten Start automatisch verwendet. Der ESP wird immer für zehn Sekunden versuchen, das eingerichtete WLAN zu erreichen, falls dies nicht möglich ist, wird für 60 Sekunden das Konfigurationsportal wieder gestartet. Falls kein Zugriff auf das Portal passiert, startet die Maschine im Offline-Modus.

Schritt für Schritt

Wenn ihr den Code hochladet, ist im Log (Monitor-Befehl) etwa folgendes zu sehen:

*wm:[1] AutoConnect
*wm:[1] No Credentials are Saved, skipping connect
*wm:[2] Starting Config Portal
*wm:[2] AccessPoint set password is VALID
*wm:[2] Disabling STA
*wm:[2] Enabling AP
*wm:[1] StartAP with SSID:  silvia
*wm:[1] AP IP address: 192.168.4.1
*wm:[1] Starting Web Portal
*wm:[2] HTTP server started
*wm:[2] Config Portal Running, blocking, waiting for clients...

Diese IP-Adresse solltet ihr euch notieren, um später die Webseite für die Ersteinrichtung aufzurufen (falls diese nicht automatisch geöffnet wird). Wenn ihr nun per Mobile/Tablet/Desktop nach einem WLAN sucht werdet ihr das Netzwerk “silvia” sehen.

Sobald ihr euch mit dem Netzwerk verbunden habt, öffnet sich automatisch die Seite des WiFiManagers. Geht die Portalseite nicht automatisch auf, gebt in eurem Browser die IP-Adresse 192.168.4.1 ein.

Mit dem Klick auf Configure WiFi könnt ihr eurer WLAN auf dem ESP einrichten.

Wählt euer lokales WLAN-Netzwerk oben aus der Liste aus oder gebt eure SSID manuell ein, zusätzlich eurer Passwort vom WLAN. Nach dem Save sollte der ESP neu starten und ist für euer WLAN eingerichtet.

Remote Monitoring

Achtung: Der ESP8266 hat mit Version 3.3.0 keine remote monitoring Funktion. Dieser Abschnitt gilt nur für ESP32 mit Version 3.2.0

Zusätzlich zur Website, auf der ihr Einstellungen vornehmen oder die aktuelle Temperatur beobachten könnt, könnt ihr auch über PlatformIO / VS Code über WLAN auf den Serial Monitor zugreifen. Das ist vor allem nützlich, um mögliche Probleme im laufenden Betrieb zu debuggen. Wir raten dringend davon ab, einen in der Maschine verkabelten Mikrokontroller über USB an einen Rechner anzuschließen! Wählt stattdessen in PlatformIO esp32_ota -> Monitor aus.

Solltet ihr den Hostname oder das OTA-Passwort in der userConfig.h angepasst haben, müsst ihr für eine erfolgreiche Verbindung auch die platformio.ini in der Section env:esp32_ota anpassen.

Wichtig, falls ihr Remote Monitoring schon während der Ersteinrichtung testen wollt: Ihr könnt das Monitoring nicht gleichzeitig via Kabel und OTA starten.

Per CLI

Habt ihr das ESP per CLI bespielt, könnt ihr den pio-Befehl auch verwenden, um das Remote Monitoring zu starten:

pio run -e esp32_ota -t monitor