01 — Home-Assistant-Add-on · kostenlos

KNX Monitor 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.

Add-on installieren Automationen

KNX Monitor als Add-on in Home Assistant auf dem iPad: links das Menü mit Gesundheit, Inbetriebnahme, Busmonitor, Topologie und mehr, in der Mitte die Übersicht mit Werten je Gruppenadresse, rechts die Details einer Adresse mit Verlauf und Telegramm

02 — Installieren

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-Monitor hinzufügen.
Starten: KNX Monitor 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 (.knxproj bis ETS6, auch mit Passwort) für Namen, Datentypen, Geräte und Räume. Das Passwort wird nicht gespeichert.

03 — Verbindung

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.send und knx.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.

04 — Automationen

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 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 KNX Monitor 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. KNX Monitor 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.
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.

1.1.30 · Glastaster Flur

21,5 °C

Mitteilungen bei Wächtern

Entwicklerwerkzeuge › Ereignisseknx_monitor_watcher

Taste drücken: Der Wächter schlägt an, das Ereignis erscheint hier.

Zum Ausprobieren: Für beide Tasten gibt es einen Wächter. Mit Mitteilungen kommt zusätzlich eine Benachrichtigung; wer selbst per Automation meldet, schaltet sie ab.

05 — Gerät

KNX Monitor als Gerät mit Entitäten.

Ist ein MQTT-Broker eingerichtet (meist das Mosquitto-Add-on), meldet sich das Add-on von selbst als Gerät an. Zugangsdaten musst du nicht eintragen.

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, mit Verlauf und Statistik in Home Assistant.
Gerätetrigger: Je Wächter einer, dazu Alarm und Störung an und aus. Sie stehen in der normalen Auswahl, ohne Ereignisnamen zu tippen.
Erreichbar: Stoppt das Add-on, zeigt Home Assistant das Gerät als nicht verfügbar.

06 — Dauerbetrieb

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). Anfragen von anderswo im Netz lehnt das Add-on ab.

07 — Optionen

Was sich in der Konfiguration einstellen lässt.

Unter Einstellungen › Add-ons › KNX Monitor › Konfiguration.

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.

08 — Fragen

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 KNX-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. MQTT bringt zusätzlich das Gerät mit Entitäten und Gerätetriggern.

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.

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?

Geplant, wenn genug Nutzer sie wollen: Erkennung beim Start, Dienste für Skripte, Diagnose und Reparaturhinweise. Stimm im Issue auf GitHub mit 👍 ab.

Etwas klappt nicht. Wie melde ich das?

Am besten mit einem Diagnosepaket, siehe Feedback. Dann brauchst du dein ETS-Projekt nirgends hochzuladen.

KNX ist eine eingetragene Marke der KNX Association. KNX Monitor ist kein Produkt der KNX Association.