Erste Schritte zur Inbetriebnahme des Adapters

Nach Empfang des Adapters sind ein paar Schritte notwendig, um den Adapter in Betrieb zu nehmen:

  1. Adapter flashen
  2. Adapter konfigurieren
  3. ebusd installieren
  4. ebusd konfigurieren
  5. eBUS anschließen
  6. eBUS Nachrichten empfangen/versenden

Lieferung

Es gibt geringfügig unterschiedliche Versionen des Adapters, was sich in folgenden Aspekten zeigt:

All diese Aspekte haben keinerlei Einfluss auf den Betrieb des Adapters.

Adapter flashen

Der Adapter wird entweder ohne Firmware direkt von der Produktion oder mit einer evtl. schon veralteten Version ausgeliefert und es empfiehlt sich, diese auf den aktuellen Stand zu bringen.

Die Firmware kann durch Starten eines Webbrowsers mit Unterstützung von Web Serial geflasht und auch aktualisiert werden.

Dazu einfach den Schritten zum Flashen über Webbrowser auf der Firmware-Seite folgen.

Danach ist bereits direkt im Flasher über “LOGS & CONSOLE” das easi> Interface zur Konfiguration verfügbar.

Gleichzeitig 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.

Adapter konfigurieren

Am einfachsten lassen sich die Einstellungen über WIFI vornehmen. Das geht sowohl über den WIFI Access Point (SSID “EBUS” ohne Passwort), der von der Firmware nach dem ersten Flashen gestartet wird (und danach für eine Minute nach dem Booten), als auch nach Konfiguration der Zugangsdaten zum eigenen WIFI über den Flasher in der Firmware-Seite wie oben notiert.

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.

ebusd installieren

Sofern die Kommunikation via ebusd ablaufen soll, muss dieser installiert werden. Das geht entweder direkt vom Debian Package aus dem letzten Release, als Docker Container oder über das Kompilieren der Sourcen.

ebusd konfigurieren

Abhängig von der Verbindung des host mit dem Adapter muss der ebusd Device String gesetzt werden. Zudem ist bei einem frisch installierten ebusd im Device String noch nicht der enhanced mode eingestellt. Wie dieser Device String genau aussehen muss, findet sich wieder bei den Varianten der Host-Verbindung.

Beim Docker Container wird dieser im Compose File oder im docker run als Argument an ebusd übergeben und bei einer Installation unter /etc/default/ebusd eingetragen. Dort stehen standardmäßig folgende Einstellungen:

EBUSD_OPTS="--scanconfig"

Ohne weitere Angabe verwendet ebusd als Device /dev/ttyUSB0. Wegen des enhanced mode und auch wenn man den Adapter nicht via USB angeschlossen hat, muss der Device String angegeben werden. Für USB sähe das dann so aus:

EBUSD_OPTS="--scanconfig -d ens:/dev/ttyACM0"

Und für WIFI oder Ethernet könnte das z.B. so aussehen:

EBUSD_OPTS="--scanconfig -d ens:192.168.0.50:9999"

Wird nun ebusd gestartet, sollten im Logfile (/var/log/ebusd.log bzw. Docker Logging) die folgenden Zeilen auftauchen (Werte in spitzen Klammern hängen von der jeweiligen Konfiguration ab):

<DATE TIME> [main notice] ebusd <VERSION>> started with auto scan on enhanced device <DEVICE>
...
<DATE TIME> [bus notice] device status: resetting
...
<DATE TIME> [bus notice] device status: reset, supports info

eBUS anschließen

Jetzt kann die eBUS Leitung mit der Buchse des Adapters verbunden werden. Auf die Polung braucht dabei keine Rücksicht genommen zu werden. Im Logging sollten jetzt auch Nachrichten von anderen Teilnehmern am Bus erscheinen, bspw. so:

<DATE TIME> [update notice] received unknown MS cmd: 1050b505072b000100000000 / 00
...
<DATE TIME> [update notice] received read ehp Status QQ=10: 18.94;1.540;2.340;off;00

eBUS Nachrichten empfangen/versenden

Bevor man sich um weitere Integrationen kümmert, sollte zuerst die Kommunikation via ebusctl geprüft werden. Dazu am besten einfach mal schauen, welche Nachrichten durch den automatischen Scanvorgang zur Verfügung stehen mit ebusctl find.

Die ausgegebene Liste enthält die Nachrichten-ID (circuit gefolgt von name) und hinter dem Gleichheitszeichen die zuletzt (innerhalb der letzten 5 Minuten) empfangenen Daten. Ist in der Liste bspw. folgender Eintrag zu finden:

hwc Mode = no data stored

dann lässt sich dieser mit dem Kommando ebusctl read hwc Mode aktiv auslesen, was bspw. folgendes Ergebnis liefert:

hwc Mode = 53;auto;disabled;hwc;00;day