Inbetriebnahme des Adapters

Erste Schritte

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

  1. Adapter flashen
  2. Adapter konfigurieren
  3. Entscheidung ebusd oder micro-ebusd
  4. bei ebusd:
    1. ebusd installieren
    2. ebusd konfigurieren
  5. bei micro-ebusd
    1. Token erwerben
    2. micro-ebusd konfigurieren
  6. eBUS anschließen
  7. eBUS Nachrichten empfangen/versenden

Auslieferung

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

Adapter flashen

Der Adapter wird bereits mit geflashter Firmware geliefert, da diese für den Test vor Auslieferung nötig ist. Die Version kann aber bereits veraltet sein und es empfiehlt sich, diese auf den aktuellen Stand zu bringen.

Neuere Firmware Versionen lassen sich einfach via OTA direkt über die Adapter Webseite aktualisieren.

Die Firmware kann immer 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 eine noch unkonfigurierte Firmware einen WIFI Access Point mit SSID “EBUS” ohne Passwort. Wenn man sich damit verbindet, lassen sich auf der Webseite http://192.168.4.1 bequem die wichtigsten Einstellungen vornehmen. Solange der Adapter noch nicht konfiguriert wurde, wird auch WPS mit push button Modus (PBC) aktiviert nachdem der Button ein Mal gedrückt wurde, so dass die rote LED permanent an ist.

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 später nach Drücken+Halten des Buttons während des Bootens), 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.

Entscheidung ebusd oder micro-ebusd

Eine der beiden ebusd Versionen wird benötigt, um die Daten auf dem eBUS zu interpretieren:

Beide Versionen haben Ihre Vorteile:

Nutzung von ebusd

ebusd installieren

Sofern die Kommunikation via ebusd ablaufen soll, muss dieser irgendwo laufen.

Das geht entweder

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 Details 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):

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

Nutzung von micro-ebusd

Token erwerben

Ein Token für micro-ebusd lässt sich direkt aus der Adapter Webseite heraus erwerben. Dazu einfach in den Reiter “Configuration” gehen, die eBUS Sektion aufklappen und beim Protokoll auf das Schlüssel-Symbol neben der “micro-ebusd” Option klicken.

micro-ebusd konfigurieren

Das geht hier ganz einfach direkt über die Adapter Webseite im Reiter “Configuration” in der eBUS Sektion nach Auswahl der “micro-ebusd” Protokoll Option. Dort lassen sich dann Adresse, Message-Level, Poll-Intervall, und optional Home Assistant Discovery Filter Optionen einstellen.
Für Experten (ab Message-Level “installer”) gibt es noch weitere Optionen.

eBUS anschließen

Jetzt kann die eBUS Leitung mit der Buchse des Adapters verbunden werden.

Hinweis: Auf die Polung braucht dabei nicht geachtet zu werden.

Im Logging von ebusd sollten jetzt auch Nachrichten von anderen Teilnehmern am eBUS erscheinen, bspw. so:

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

Im Adapter Logging mit micro-ebusd sieht es ähnlich aus:

ebusd: received unknown 1050b505072b000100000000 / 00
...
ebusd: decoded ehp/Status {"temp":18.942500,"press":1.540000,"press_1":2.34000,"hcmode":"off","hex":"00"}

eBUS Nachrichten empfangen/versenden

Bei ebusd

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 -c hwc Mode aktiv auslesen, was bspw. folgendes Ergebnis liefert:

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

Bei micro-ebusd

Bei micro-ebusd kann man direkt im “Log” Reiter sehen, welche Nachrichten auf dem eBUS vorbeikommen.

Alle vom Scan gefunden Nachrichten-Definitionen lassen sich direkt im “Messages” Reiter inspizieren und dort auch vom eBUS abrufen. Schreibbare Nachrichten lassen sich hier auch direkt versenden.

Die Integration mit Home Assistant über MQTT Discovery ist hier ganz einfach (sofern das Token diese Option beinhaltet). Dazu wird einfach in der Adapter im Reiter “Configuration” unter “MQTT” die Home Assistant Option aktiviert und noch optional der MQTT Präfix eingetragen.

Welche eBUS Messages an Home Assistant weitergereicht werden, lässt sich im Reiter “Configuration” unter “eBUS” beim Filter einstellen. Hier hat man die Wahl: