Firmware

Der wichtigste Teil des Adapters (neben der physischen eBUS Isolation) ist die Firmware für den ESP32-C3.

Der einfachste Weg zum Flashen der Firmware ist über einen Webbrowser mit Unterstützung von Web Serial.

Alternativ kann auch esptool und dergleichen verwendet werden, aber das ist deutlich umständlicher und wird nicht näher erläutert.

Flashen über Webbrowser

Folgende Schritte müssen zum Flashen der Firmware über einen Webbrowser mit Unterstützung von Web Serial durchlaufen werden:

  1. den Adapter via USB anschließen und währenddessen den Button gedrückt halten (Bootloader Modus forcieren)
  2. die gewünschte Version auswählen und dann auf "CONNECT" klicken:
    Bitte erst eine der Optionen oben auswählen!
    Installer powered by ESP Web Tools.
  3. den seriellen Port "USB/JTAG serial debug unit (COM...)" auswählen und auf "Verbinden" klicken (z.B. unter Windows)
  4. "INSTALL ..." klicken und den weiteren Anweisungen folgen

Sofern der Adapter zum ersten Mal geflasht wurde, muss die Stromversorgung (USB) kurz getrennt werden, um den Bootloader Modus wieder zu verlassen. Möchte man darüber gleich die WIFI Einstellungen vornehmen, muss auch die Verbindung des Flash-Tools erneuert werden, sprich der Dialog komplett verlassen und über “CONNECT” die Verbindung wieder aufgebaut werden.

Sollte der Dialog nach dem Flashen keine Optionen zum Konfigurieren anbieten (“CONNECT TO NETWORK” o.ä.), kann es notwendig sein, etwa 10 Sekunden zu warten, auf “LOGS & CONSOLE” zu klicken und darin wieder auf “BACK”, um die Kommunikation herzustellen.

Über den Dialog kann die Verbindung zum eigenen WIFI oder Ethernet hergestellt werden über “CONNECT TO NETWORK”. Dabei werden verfügbare Netze gescannt und zur Auswahl angeboten, inkl. Ethernet bei eingestecktem USR-ES1 oder W5500 Modul (erscheint als “#ETHERNET (via USR/W5500)” in der Liste). Klappt die Verbindung nach optionaler Eingabe des Passworts, werden die Zugangsdaten auch gleich gespeichert.

Anschließend gelangt man über “VISIT DEVICE” zur Webseite des Adapters. Alternativ steht unter “LOGS & CONSOLE” das easi> Interface zur Konfiguration zur Verfügung.

Nach dem initialen Flashen und auch durch Drücken des Buttons beim Booten startet die Firmware einen WIFI Access Point mit SSID “EBUS” ohne Passwort. Wenn man sich damit verbindet, lassen sich auf der Seite http://192.168.4.1 bequem die wichtigsten Einstellungen vornehmen.

Konfiguration

Am einfachsten lassen sich die Einstellungen über Netzwerk vornehmen, z.B. über den WIFI Access Point mit SSID “EBUS” (ohne Passwort), der von der Firmware nach dem ersten Flashen gestartet wird oder nach Drücken+Halten des Buttons während des Bootens (solange die LEDs faden).

Alternativ lässt sich das easi> Interface auch über eine serielle Verbindung bedienen. Das geht bspw. mit der Firmware-Seite wie oben erläutert oder mit Putty, minicom oder einem anderen Terminalprogramm, um damit den seriellen USB Port zu öffnen (Parameter sind egal). Dann erscheint das easi> Interface des Adapters, das über zig Befehle zur Konfiguration und zum Testen verfügt. Mit “help” werden diese samt Parametern aufgelistet.

Für die Ethernet Option empfiehlt es sich, dennoch den oben beschriebenen Weg zur Erstkonfiguration zu verwenden, da die Ethernet Schnittstelle erst konfiguriert werden muss.

MQTT

Sofern MQTT konfiguriert ist, sendet der Adapter Status Infos via MQTT unter dem eingestellten Topic: