Der eBUS Adapter Shield C6 Stick ist eine kompakte Bridge im USB-Stick-Format (42×16 mm), die eBUS-Heizungsbussysteme mit IP-Netzwerken verbindet. Basierend auf dem ESP32-C6 läuft die integrierte micro-ebusd-Firmware, die das eBUS-Protokoll dekodiert und Daten über MQTT veröffentlicht. Das TapHome-Template überwacht den Adapter selbst — Signalqualität, Daemon-Verbindung, interne Temperatur und Uptime — nicht die Heizungsdaten, die durch ihn fließen.
Der Adapter unterstützt WiFi (eingebaute Antenne), USB-C und optionales Ethernet (USR-ES1 W5500 Modul). Der Stromverbrauch beträgt weniger als 120 mA bei 5 V, und er bezieht keinen Strom von der eBUS-Leitung (Class 0, vollständige galvanische Trennung).
Konfiguration
MQTT-Prefix
Das TapHome-Template verwendet einen festen Topic-Prefix stick-c6/. Der Adapter veröffentlicht Zustandsdaten unter diesem Prefix, wenn micro-ebusd mit aktiviertem MQTT läuft. Falls Ihr Adapter einen anderen MQTT-Prefix verwendet, aktualisieren Sie die Topic-Strings in den TapHome-Listener-Skripten entsprechend.
Template-Einrichtung
Nach dem Import des Templates in TapHome:
- Öffnen Sie das Modul eBUS Adapter Shield C6 Stick
- Setzen Sie die MQTT-Broker-IP und den Port (Standard
1883) - Überprüfen Sie, ob der Topic-Prefix in den Listener-Skripten mit der MQTT-Konfiguration Ihres Adapters übereinstimmt
Das Modul abonniert die vier stick-c6/-Topics und ordnet sie Überwachungsgeräten in TapHome zu.
Adapter-Einrichtung
Bevor das TapHome-Template Daten empfangen kann, muss der Adapter konfiguriert werden:
- Firmware flashen — verwenden Sie den Web-Flasher auf adapter.ebusd.eu
- WiFi verbinden — beim ersten Start erstellt der Adapter einen AP mit der SSID „EBUS" (ohne Passwort); verbinden Sie sich und konfigurieren Sie unter
http://192.168.4.1 - micro-ebusd aktivieren — erwerben Sie ein Token über den Configuration-Tab des Adapters und wählen Sie dann die micro-ebusd-Protokolloption
- MQTT konfigurieren — setzen Sie den MQTT-Broker-Host und -Port in den Adaptereinstellungen
- eBUS anschließen — verbinden Sie das 2-Draht-eBUS-Kabel mit dem 3,5-mm-Steckklemme (polaritätsunabhängig)
Der Adapter unterstützt den WPS-Push-Button-Modus für die WiFi-Einrichtung. Drücken Sie die Taste einmal, wenn die rote LED dauerhaft leuchtet, um die Verbindung automatisch herzustellen.
Gerätefunktionen
eBUS Signal
Das Gerät eBUS Signal ist ein Reed Contact, der meldet, ob der Adapter ein gültiges eBUS-Signal auf dem Bus erkennt:
"true"→ OK (Signal vorhanden)"false"→ Alarm (Signal verloren)
Dies ist der primäre Indikator für die physische eBUS-Konnektivität. Ein verlorenes Signal bedeutet, dass der Adapter keine Daten vom Heizungssystem empfängt.
ebusd Daemon
Das Gerät ebusd Daemon ist ein Reed Contact, der überwacht, ob der micro-ebusd-Daemon (oder eine externe ebusd-Instanz) läuft und verbunden ist:
"true"→ OK (Daemon verbunden)"false"→ Alarm (Daemon getrennt)
Wenn hier ein Alarm angezeigt wird, während das eBUS-Signal OK ist, liegt das Problem bei der ebusd-Software, nicht bei der physischen Verbindung.
Temperatursensor
Der integrierte Temperatursensor misst die Chip-Temperatur des ESP32-C6. Dies ist die interne Temperatur des Adapters, keine Temperaturmessung des Heizungssystems. Er kann zur Überwachung einer Überhitzung des Adapters in geschlossenen Installationen verwendet werden.
Der Wert wird als numerischer String auf stick-c6/temp veröffentlicht und im TapHome-Listener-Skript in einen Double-Wert konvertiert.
Uptime (h)
Das Gerät Uptime erfasst, wie lange der Adapter seit dem letzten Neustart läuft. Die rohen MQTT-Daten sind in Sekunden angegeben; das TapHome-Listener-Skript konvertiert sie zur besseren Lesbarkeit in Stunden.
Ein plötzlicher Uptime-Reset auf Null zeigt an, dass der Adapter neu gestartet wurde — nützlich zur Diagnose zeitweiliger Konnektivitätsprobleme.
Weitere Funktionen
Der Adapter veröffentlicht zusätzliche MQTT-Topics, die von diesem Template nicht abgedeckt werden:
- Fehlermeldungen (
{prefix}/error) — JSON-Payload mit Fehlerquelle und -beschreibung - Scan-Status (
{prefix}/scan) — meldet „OK", „running" oder „finished" während des eBUS-Gerätescans - Heizungssystemdaten (
{prefix}/circuit/name) — die tatsächlichen dekodierten eBUS-Werte (Temperaturen, Drücke, Betriebsmodi) der angeschlossenen Heizungsanlage. Die Integration dieser Daten in TapHome würde separate, auf das jeweilige Heizungssystem zugeschnittene Templates erfordern.
Fehlerbehebung
Keine Daten in TapHome
- Überprüfen Sie, ob der Adapter mit dem WiFi verbunden ist — kontrollieren Sie die RGB-LED und die grüne eBUS-LED auf Aktivität
- Bestätigen Sie, dass micro-ebusd aktiviert und MQTT in der Konfigurationsseite des Adapters aktiviert ist
- Prüfen Sie, ob MQTT-Broker-Adresse und -Port in den Adaptereinstellungen und der TapHome-Modulkonfiguration übereinstimmen
- Verwenden Sie einen MQTT-Client (z. B. MQTT Explorer), um
stick-c6/#zu abonnieren, und überprüfen Sie, ob der Adapter Nachrichten veröffentlicht
eBUS-Signal-Alarm
- Prüfen Sie die physische eBUS-Kabelverbindung am 3,5-mm-Anschluss des Adapters und am Heizungssystem
- Kontrollieren Sie die grüne eBUS-LED — wenn sie aus ist, wird keine eBUS-Spannung erkannt; wenn sie blinkt, empfängt der Adapter Daten
- Stellen Sie sicher, dass die eBUS-Leitung nicht überlastet ist — der Adapter ist Class 0 (kein Stromverbrauch), aber andere eBUS-Geräte können die Buskapazität überschreiten
ebusd-Daemon-Alarm bei OK-Signal
- Falls Sie micro-ebusd verwenden, prüfen Sie, ob das Token gültig und die Protokolloption korrekt ausgewählt ist
- Falls Sie ein externes ebusd verwenden, überprüfen Sie, ob der Device-String das Enhanced-Mode-Prefix
ens:verwendet (z. B.ens:192.168.0.50:9999) - Prüfen Sie die ebusd-Logs auf Verbindungsfehler
Dieses Template überwacht nur den Zustand des eBUS-Adapter-Sticks. Um tatsächliche Heizungssystemdaten zu lesen (Temperaturen, Betriebsmodi, Drücke), benötigen Sie ebusd mit den entsprechenden CSV-Nachrichtendefinitionen für Ihr Heizungssystem sowie zusätzliche TapHome-Templates zum Abonnieren dieser Topics.
