Busclear als Teil von Home Assistant.
Der Busmonitor in der Seitenleiste, auf jedem Gerät mit Home Assistant. Er nutzt auf Wunsch die Verbindung deiner KNX-Integration statt eines eigenen Tunnels, liefert Trigger für Automationen und erscheint mit MQTT als eigenes Gerät mit Entitäten. Kostenlos, mit allen Werkzeugen, für eine Installation.
In zwei Minuten in der Seitenleiste.
- Repository
- „Add-on installieren“ oben antippen oder in Home Assistant unter Einstellungen › Add-ons › Add-on-Store › ⋮ › Repositories die Adresse
https://github.com/regetskcob/KNX-Monitorhinzufügen. - Starten
- Busclear installieren, starten und „In der Seitenleiste anzeigen“ einschalten. Das Add-on läuft für amd64 und aarch64, also auch auf Home Assistant Green, Yellow und dem Raspberry Pi.
- Verbinden
- Gateway wählen oder die KNX-Integration mitnutzen (siehe Verbindung). Das Add-on bleibt danach verbunden, auch ohne offenen Browser.
- Projekt
- ETS-Projekt importieren (
.knxprojbis ETS6, auch mit Passwort) für Namen, Datentypen, Geräte und Räume. Das Passwort wird nicht gespeichert.
Eigener Tunnel oder gar keiner.
Ist die KNX-Integration eingerichtet, schlägt das Add-on vor, ihre Verbindung mitzunutzen. Das spart einen Tunnelplatz am Gateway.
- Home Assistant
- Kein eigener Tunnel: Das Add-on liest, was die KNX-Integration empfängt, und sendet über
knx.sendundknx.read. KNX Secure entschlüsselt die Integration. - Tunnel
- UDP oder TCP mit fester Tunneladresse auf Wunsch. Nötig für Programmiermodus, Adresse prüfen und den Busmonitor mit Quittungen.
- Routing
- Multicast über einen IP-Router, belegt keinen Tunnelplatz.
- IP Secure
- Gesicherter Tunnel mit Benutzer und Passwort oder dem Keyring aus der ETS.
Wächter, Alarme und Bus als Trigger.
Das Add-on feuert Ereignisse in Home Assistant, auch ohne offenen Browser. Im Automations-Editor nimmst du sie als Trigger „Ereignis“, mit der Integration oder MQTT auch als Gerätetrigger.
- Wächter
- Ein Wächter schlägt an (
knx_monitor_watcher). Mit Name, Gruppenadresse, Absender und Wert. Wächter legst du in Busclear unter Werkzeuge › Wächter an. - Alarm
- Ein Alarm- oder Störungsobjekt geht an oder aus (
knx_monitor_alarm), etwa ein Rauchmelder oder eine Gerätestörung. Busclear erkennt sie aus dem ETS-Projekt. - Bus
- Die Busverbindung geht verloren oder steht wieder (
knx_monitor_bus). Gemeldet werden nur echte Wechsel, nicht jeder Verbindungsversuch. - Blueprints
- Mit einem Klick importieren: Wächter, Alarm oder Störung, Busverbindung, hohe Buslast, wenig Speicher.
- Mitteilungen
- Ohne eigene Automation meldet das Add-on Alarme und Wächter als Home-Assistant-Benachrichtigung. Wer selbst meldet, schaltet das in der Konfiguration ab und bekommt nichts doppelt.
knx_monitor_watcher- Taste drücken: Der Wächter schlägt an, das Ereignis erscheint hier.
Busclear als Gerät mit Entitäten.
Zwei Wege, beide ohne Zugangsdaten: die Integration „Busclear“ über HACS, die Home Assistant beim Start des Add-ons von selbst findet, oder MQTT, wenn ein Broker eingerichtet ist (meist das Mosquitto-Add-on).
- Bus verbunden
- Verbindungsstatus, gut für Automationen mit „seit 5 Minuten“ oder fürs Dashboard.
- Aufzeichnung
- Schalter zum Pausieren und Fortsetzen der Daueraufzeichnung, etwa wenn die ETS den einzigen Tunnelplatz braucht.
- Busaktivität
- Telegramme pro Minute und heute, Wiederholungen pro Minute, letztes Telegramm, Buslast, offene Alarme, Verfügbarkeit der letzten 24 Stunden und freier Speicher, mit Verlauf und Statistik in Home Assistant.
- Gerätetrigger
- Je Wächter einer, dazu Alarm und Störung an und aus, Bus weg und wieder da. Sie stehen in der normalen Auswahl, ohne Ereignisnamen zu tippen. Die Integration bringt außerdem Bedingungen (Bus verbunden, Alarm offen, wenig Speicher) und Ereignis-Entitäten.
- Reparaturen
- Die Integration meldet unter Einstellungen › Reparaturen, wenn der Bus länger weg ist, der Speicher knapp wird oder eine Gruppenadresse, die sonst regelmäßig sendet, verstummt. Mit „Ignorieren“ ist der Hinweis weg, bis die Adresse wieder sendet.
- Erreichbar
- Stoppt das Add-on, zeigt Home Assistant das Gerät als nicht verfügbar.
Zeichnet auf, auch wenn niemand hinsieht.
- Verlauf
- Jedes Telegramm landet in einer Tagesdatei, fertige Tage werden gepackt. Aufbewahrung und Größe stellst du in der App ein.
- Lücken
- Einmal pro Minute notiert das Add-on, ob der Bus verbunden war. Die Tagesliste erklärt Lücken, etwa „Bus 3 min getrennt“.
- Backups
- Verlauf, Einstellungen und ein importierter Keyring gehören zu den Backups von Home Assistant.
- Zugriff
- Nur über Home Assistant (Ingress), dazu die Integration mit eigenem Schlüssel. Anfragen von anderswo im Netz lehnt das Add-on ab.
Was sich in der Konfiguration einstellen lässt.
Unter Einstellungen › Add-ons › Busclear › Konfiguration.
- Nur lesen
read_only: Der Server sendet nichts auf den Bus, auch keine Leseanfragen. Standard an; ausschalten, wenn du aus dem Add-on Werte schreiben oder abfragen willst.- Alarme
alarm_notifications: Benachrichtigung bei Alarmen und Störungen, Standard an.- Wächter
watcher_notifications: Benachrichtigung bei Wächtern, Standard an.- Push
notify_service: zusätzlich als Push über einen Benachrichtigungsdienst, z. B.notify.mobile_app_iphone.- Karte
dashboard_card: meldet die Dashboard-Karte „Busclear Diagramm“ als Ressource an, Standard an.- Telegramme
mqtt_telegrams: Vorschau, schickt jedes Telegramm als JSON anknx_monitor/telegram/1/2/3, mit Name, DPT und Wert, soweit das ETS-Projekt sie kennt. Standard aus; Rückmeldung gern in Issue #11.- Secure
mqtt_secure_telegrams: schickt auch mit KNX Data Secure geschützte Telegramme, dann entschlüsselt. Wer den Broker lesen kann, sieht genau die Werte, die die Verschlüsselung schützen soll. Standard aus.
Häufige Fragen zum Add-on
Kostet das Add-on etwas?
Nein. Das Add-on bleibt kostenlos, mit allen Werkzeugen und Langzeitverlauf, für eine Installation.
Ist das Add-on Open Source?
Ja. Der Quellcode von App, Add-on und Busclear Box steht unter der GPLv3 auf GitHub. Alles, was der Server auf den Bus schickt, läuft dort durch eine Datei. Nicht dabei sind die kommerziellen Teile: Konto, Lösung für Elektrobetriebe und Bauherren-Paket. Name und Logo sind ausgenommen, ein Fork braucht einen eigenen Namen.
Belegt das Add-on einen Tunnel am Gateway?
Mit eigenem Tunnel ja, genau einen, den sich alle offenen Ansichten teilen. Mit der Verbindungsart „Home Assistant“ keinen: Dann nutzt es die Verbindung der KNX-Integration. Für den Busmonitor mit Quittungen gibt es den Tunnel kurz frei und holt ihn danach zurück.
Brauche ich MQTT?
Nein. Ereignisse, Blueprints und Benachrichtigungen gehen ohne. Das Gerät mit Entitäten und Gerätetriggern bringt die Integration auch ohne Broker; MQTT ist die Alternative, etwa wenn du ohnehin Mosquitto nutzt.
Wo liegen meine Daten?
Im Datenordner des Add-ons auf deinem Home Assistant, unverschlüsselt und Teil der Home-Assistant-Backups; schütze sie mit einem Sicherungsschlüssel. Von sich aus schickt das Add-on nichts ins Internet und nichts an uns. Daten gehen nur an Ziele, die du selbst einrichtest, etwa ntfy, einen Webhook oder InfluxDB. Mehr in der Datenschutzerklärung.
Wie viel Speicher braucht der Verlauf?
Wenig. Abgeschlossene Tage werden gepackt, das sind rund 20 MB pro Million Telegramme; der laufende Tag liegt ungepackt bei rund 95 MB pro Million. Bei 20.000 Telegrammen am Tag sind das etwa 12 MB im Monat. Standard sind 7 Tage und höchstens 1.000 MB, beides stellst du in der App ein.
Ich lade ein geändertes ETS-Projekt hoch. Was passiert mit dem Verlauf?
Nichts geht verloren. Der Verlauf speichert die Telegramme roh, Namen und DPTs kommen beim Anzeigen aus dem aktuellen Projekt. Nach dem Hochladen tragen also auch ältere Telegramme die neuen Namen. Nur schon exportierte PDF- und CSV-Dateien behalten die alten; eine ETS-Datei enthält nur die rohen Telegramme.
Ich nutze ioBroker oder ein NAS statt Home Assistant.
Derselbe Server läuft auch als Docker-Container, mit Passwort statt Home-Assistant-Anmeldung und auf Wunsch mit MQTT, etwa für den MQTT-Adapter von ioBroker. Anleitung und compose.yaml auf GitHub. Einen eigenen ioBroker-Adapter gibt es, wenn genug Nutzer ihn wollen: mit 👍 abstimmen.
Gibt es eine eigene Integration?
Ja, „Busclear“ über HACS: Erkennung beim Start, Sensoren, Gerätetrigger und Bedingungen, Dienste für Skripte, Diagnose und Reparaturhinweise. Ohne Supervisor (Home Assistant Container) verbindet sie sich mit einer Busclear Box oder dem Docker-Container über einen Kopplungslink mit „Verwalten“.
Etwas klappt nicht. Wie melde ich das?
Am besten mit einem Diagnosepaket, siehe Feedback. Dann brauchst du dein ETS-Projekt nirgends hochzuladen.