ebusd Smart-Home-Integration, kostenlos und Open Source
Heizkessel und Wärmepumpen von Vaillant, Saunier Duval, Wolf… am eBUS, über ebusd, lokal.
Veröffentlicht von William-De71
- Geräte
- Version 0.1.0
- Erfordert Gladys >=5.3.0
- ★ 0
Überblick
Diese Integration bringt Ihre eBUS-Heizung in Gladys: Vaillant, Saunier Duval, AWB, Bulex, Wolf, Kromschröder und die anderen Marken, deren Heizkessel, Wärmepumpen und Regler über den eBUS kommunizieren. Sie nutzt dafür ebusd, ein freies Programm, das mit einem eBUS-Adapter den Bus mithört und die Nachrichten jedes Geräts kennt.
Jedes eBUS-Gerät, das ebusd kennt, wird zu einem Gladys-Gerät: der Heizkessel, die Wärmepumpe, der Regler, die Heizkreise, dazu ebusd selbst mit dem eBUS-Signal. Werte, die sich auf dem Bus ändern, kommen live an; die übrigen werden alle paar Minuten gelesen. Alles bleibt in Ihrem lokalen Netzwerk.
Inoffizielle Integration, weder mit dem ebusd-Projekt noch mit den genannten Marken verbunden.
Voraussetzungen
- Gladys Assistant 5.3.0 oder neuer.
- ebusd läuft auf einem Raspberry Pi, einem NAS, dem Gladys-Rechner (Docker-Image
john30/ebusd) oder als Home-Assistant-Add-on, mit einem eBUS-Adapter (zum Beispiel dem eBUS Adapter Shield). - ebusd mit seinen Konfigurationsdateien (Standard) und mit von Gladys erreichbarem TCP-Port 8888: Starten Sie es nicht mit
--localhost. Prüfen Sie mitebusctl info, dass es Ihre Geräte sieht und für jedes eine geladene Konfiguration (loaded) anzeigt.
Konfiguration
ebusd
- Adresse von ebusd: die IP-Adresse oder der Name des Rechners, auf dem ebusd läuft.
localhostfunktioniert nicht: Gladys führt die Integration in einem eigenen Container aus. - TCP-Port: 8888, sofern Sie
--portnicht geändert haben. - Benutzer und Geheimnis: nur, wenn ebusd eine Zugriffsdatei (
--aclfile) verwendet. - Leseintervall: 1 bis 10 Minuten (standardmäßig 2). Der eBUS ist langsam und wird mit Ihrer Heizung geteilt; Werte, die sich ändern, kommen ohnehin live an.
- Angebotene Werte: die nützlichen (Temperaturen, Druck, Flamme, Modulation, Leistung, Energie, Stunden, Starts, Betriebsarten, Fehler) oder alle, die ebusd gesehen hat.
- Zusätzliche Nachrichten: Nachrichten, die immer angeboten und gelesen werden, so benannt wie bei ebusd (
ebusctl find), zum Beispielbai.PumpPower, 700.Z1NightTemp. - Sprache der Namen und Texte: die Sprache der Geräte- und Funktionsnamen und der Fehlermeldungen.
Drücken Sie ebusd testen und Geräte suchen: Die Antwort nennt die ebusd-Version, das eBUS-Signal und die gefundenen Geräte mit ihrer Anzahl an Werten.
Einstellungen ändern
Standardmäßig aus: Gladys liest nur. Aktivieren Sie Änderungen erlauben, damit Gladys ändern kann, was der Regler für jeden freigibt:
- Raum-Solltemperaturen (Tag, Nacht…): 5 bis 30 °C;
- Warmwasser-Soll: 35 bis 70 °C;
- Ein/Aus und Betriebsarten (Heizung, Warmwasser: aus, Automatik, Tag, Nacht…).
Nie die Installateur- oder Service-Einstellungen. Derselbe Wert wird nie zweimal geschrieben, dieselbe Nachricht höchstens einmal pro Minute, höchstens 100 Änderungen pro Tag; nach dem Schreiben wird der Wert zurückgelesen.
Verwendung
Geräte
Fügen Sie unter Integrationen → ebusd → Entdecken die gewünschten Geräte hinzu:
- ebusd: das eBUS-Signal (ein, wenn der Adapter den Bus hört);
- ein Gerät pro eBUS-Kreis, benannt nach Art und Modell, zum Beispiel Heizkessel bai (Vaillant BAI00) oder Regler 700 (Vaillant 70000).
Ihre Funktionen sind die nützlichen Werte: Vorlauf-, Rücklauf-, Außen-, Raum-, Warmwasser- und Speichertemperatur, Wasserdruck, Flamme, Modulation, Betriebsstunden und Starts, Betriebsarten Heizung und Warmwasser, aktueller Fehler… Ein neues Gerät erscheint einige Minuten, nachdem ebusd seine Konfiguration geladen hat: Drücken Sie dann erneut Scannen.
Widgets
- Heizung: die wichtigsten Temperaturen, Druck und Modulation live, dann Flamme, Betriebsarten, Warmwasser-Soll und aktueller Fehler.
- Heizungsverlauf: Außen-, Vorlauf-, Rücklauf- und Warmwassertemperatur über 24 Stunden, 3 oder 7 Tage.
- eBUS: ebusd, der Verkehr auf dem Bus und die gesehenen Geräte mit Modell und Software.
Szenen
Auslöser: Ein eBUS-Gerät meldet einen Fehler (mit dem Fehlercode), Ein eBUS-Fehler ist behoben, ebusd antwortet nicht mehr, ebusd antwortet wieder.
Aktionen: eBUS-Wert lesen (eine beliebige Nachricht über Kreis und Namen: Wert, Zahl, Einheit, alle Felder) und eBUS-Wert schreiben (eine für jeden offene Nachricht, wenn Änderungen erlaubt sind).
Beispiele:
- Wenn der Heizkessel einen Fehler meldet, eine Nachricht mit dem Fehlercode senden.
- Wenn ebusd nicht mehr antwortet, benachrichtigen: Das Haus wird womöglich nicht mehr geheizt.
- Jeden Morgen
bai WaterPressurelesen; unter 1 bar daran erinnern, Wasser in der Heizung nachzufüllen.
Fehlerbehebung
- ebusd antwortet nicht: Prüfen Sie Adresse und Port, dass ebusd im Netzwerk lauscht (nicht
--localhost) und dass keine Firewall Port 8888 blockiert. - Kein eBUS-Signal: ebusd läuft, aber der Adapter hört nichts; prüfen Sie den Adapter, seine Verkabelung und
ebusctl state. - Ein Gerät oder ein Wert fehlt: Warten Sie, bis ebusd die Konfiguration des Geräts geladen hat (
ebusctl info), und suchen Sie dann erneut; wählen Sie „Alle, die ebusd gesehen hat“ oder tragen Sie die Nachricht unter „Zusätzliche Nachrichten“ ein. - Eine Änderung wird abgelehnt: Aktivieren Sie Änderungen erlauben; dieselbe Nachricht lässt sich einmal pro Minute ändern; Installateur-Einstellungen werden nie geschrieben.
- Logs: der Tab Logs der Integrationsseite.
Konfigurationseinstellungen
Diese Einstellungen fragt ebusd in seinem Konfigurationsbildschirm in Gladys ab.
| Einstellung | Typ | Pflichtfeld | Beschreibung |
|---|---|---|---|
| Ihr ebusd | section | Nein | ebusd ist ein freies Programm, das über einen eBUS-Adapter (zum Beispiel das eBUS Adapter Shield) mit dem eBUS Ihrer Heizung spricht (Vaillant, Saunier Duval, AWB, Bulex, Wolf, Kromschröder…). Betreiben Sie es auf einem Raspberry Pi, einem NAS oder dem Gladys-Rechner, mit seinen Konfigurationsdateien (Standard) und mit für das Netzwerk geöffnetem TCP-Port 8888 (kein --localhost). Gladys liest es im lokalen Netzwerk: nichts verlässt Ihr Zuhause. Nicht mit dem ebusd-Projekt oder den genannten Marken verbunden. |
| Adresse von ebusd | string | Nein | Die IP-Adresse oder der Name des Rechners, auf dem ebusd läuft („localhost“ funktioniert nicht: Gladys führt die Integration in einem eigenen Container aus). |
| TCP-Port | number | Nein | Die Option --port von ebusd, 8888, sofern nicht geändert. |
| Benutzer (optional) | string | Nein | Nur wenn ebusd eine Zugriffsdatei (--aclfile) verwendet: der Benutzer, mit dem sich Gladys anmeldet. |
| Geheimnis (optional) | secret | Nein | Das Geheimnis dieses Benutzers in der Zugriffsdatei. |
| Was Gladys liest | section | Nein | Gladys verfolgt jeden Wert, der sich auf dem Bus ändert, sofort, und liest die übrigen im unten gewählten Intervall, aus dem Speicher von ebusd, wenn er aktuell genug ist. Jedes eBUS-Gerät (Heizkessel, Regler, Wärmepumpe, Heizkreis…) wird ein Gladys-Gerät; seine Funktionen sind die nützlichen Werte, die ebusd bereits gesehen hat (Temperaturen, Druck, Flamme, Betriebsarten, Stunden, Starts, Fehler), plus die bekannten Werte von Vaillant-Anlagen. |
| Leseintervall | select | Nein | Der eBUS ist langsam und wird mit Ihrer Heizung geteilt: einige Minuten genügen. |
| Angebotene Werte | select | Nein | |
| Zusätzliche Nachrichten (optional) | string | Nein | Kreis- und Nachrichtennamen, wie ebusd sie anzeigt (ebusctl find), durch Kommas getrennt: Gladys liest sie, auch wenn ebusd sie noch nicht gesehen hat. |
| Einstellungen ändern | section | Nein | Standardmäßig aus: Gladys liest nur. Wenn erlaubt, kann Gladys ändern, was der Regler jedem erlaubt: Raum-Solltemperaturen (5 bis 30 °C), Warmwasser-Soll (35 bis 70 °C), Betriebsarten, Ein/Aus. Nie die Installateur- oder Service-Einstellungen. Dieselbe Nachricht höchstens einmal pro Minute, höchstens 100 Änderungen pro Tag. |
| Änderungen erlauben | boolean | Nein | Nur aktivieren, wenn Sie diese Einstellungen kennen: eine falsche kann das Haus kalt lassen. Siehe Anleitung Ihres Reglers. |
| Sprache der Namen und Texte | select | Nein | Gladys teilt Integrationen die Sprache der Benutzer nicht mit: Wählen Sie die der Geräte- und Funktionsnamen und der Fehlermeldungen. |
So installierst du ebusd in Gladys
- Öffne in Gladys Integrationen: ebusd erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
- Klicke auf Installieren. Gladys lädt das Docker-Image (
ghcr.io/william-de71/gladys-ebusd:0.1.0) herunter, startet es in einer vom Kern isolierten Sandbox und erzeugt die Oberfläche der Integration (Geräte, Erkennung und Konfiguration). - Öffne den Bildschirm Konfiguration der Integration, fülle die Einstellungen aus und speichere.
- Du kannst sie auch direkt über die URL ihres Repositorys installieren: https://github.com/William-De71/gladys-ebusd.
ebusd benötigt Gladys >=5.3.0. Der Katalog in Gladys wird stündlich aktualisiert, eine neue Version ist also spätestens eine Stunde nach ihrer Veröffentlichung verfügbar.
Du nutzt Gladys noch nicht? Es ist kostenlos und Open Source: folge der Installationsanleitung, um loszulegen.
Über externe Integrationen
ebusd ist eine externe Integration: eine Community-Integration, die als Docker-Container verpackt und auf GitHub veröffentlicht wird. Gladys installiert sie mit einem Klick und führt sie in einer vom Kern isolierten Sandbox aus. Sie wird von William-De71 veröffentlicht und gepflegt, nicht vom Gladys-Kernteam.
- Alle Integrationen durchsuchen, native und aus der Community
- Deine eigene externe Integration bauen und veröffentlichen
- Quellcode auf GitHub — Quelle dieser Dokumentation