KNX Smart-Home-Integration, kostenlos und Open Source
Steuern Sie Ihre KNX-Anlage über eine IP-Schnittstelle: Licht, Rollläden, Sensoren, Szenen.
Veröffentlicht von William-De71
- Geräte
- Version 0.1.0
- Erfordert Gladys >=5.1.1
- ★ 0
Überblick
Diese Integration verbindet Gladys über eine KNX-IP-Schnittstelle oder einen KNX-IP-Router in Ihrem lokalen Netzwerk mit einer KNX-Anlage. Licht, Schalter, Rollläden und Vorhänge, Sensoren und Raumthermostate am KNX-Bus werden zu Gladys-Geräten: Sie steuern sie über das Dashboard und die Szenen, und ihre Zustände folgen dem Bus in Echtzeit.
KNX-Geräte lassen sich nicht automatisch finden: Die Bedeutung jeder Gruppenadresse steht in Ihrem ETS-Projekt. Sie deklarieren jedes Gerät einmal in der Konfiguration der Integration mit seinen Gruppenadressen und fügen es dann im Tab Entdecken wie jedes gefundene Gerät hinzu.
Alles bleibt in Ihrem lokalen Netzwerk (Badge lokal): Die Integration spricht per KNXnet/IP mit der Schnittstelle, keine Daten gehen ins Internet.
Voraussetzungen
- Gladys Assistant 5.1.1 oder neuer.
- Eine KNX-IP-Schnittstelle (Tunneling) oder ein KNX-IP-Router im selben Netzwerk wie Gladys, mit einem freien Tunnel.
- Ihr ETS-Projekt oder zumindest die Liste der Gruppenadressen der gewünschten Geräte (mit ihren Datenpunkttypen, DPT).
- Für eine KNX-IP-Secure-Schnittstelle: physikalische Adresse, Benutzer-ID und Passwort eines Tunnels (ETS, Eigenschaften der Schnittstelle).
Konfiguration
Verbindung
- Verbindung: UDP-Tunneling passt für die meisten Schnittstellen. Wählen Sie TCP-Tunneling für KNX IP Secure und neuere Schnittstellen. Routing (Multicast) benötigt einen KNX-IP-Router und erreicht den Container der Integration meist nicht: Tunneling ist vorzuziehen.
- Adresse der KNX-IP-Schnittstelle: ihre IP-Adresse oder ihr Hostname. Leer lassen, um die erste im Netzwerk gefundene Schnittstelle zu verwenden; die Schaltfläche KNX-IP-Schnittstellen suchen listet die antwortenden Schnittstellen auf.
- Port: 3671, sofern Ihre Schnittstelle keinen anderen verwendet.
- Physikalische Adresse von Gladys: optional beim Tunneling (die Schnittstelle vergibt die Adresse ihres Tunnels), beim Routing erforderlich (eine freie, in ETS reservierte Adresse der Linie).
- Speichern, dann Verbindung testen drücken.
KNX IP Secure
Wählen Sie TCP-Tunneling, aktivieren Sie KNX IP Secure verwenden und tragen Sie die physikalische Adresse des Tunnels (zum Beispiel 1.1.254), die Benutzer-ID des Tunnels und das Passwort des Tunnelbenutzers aus ETS ein. Der Geräte-Authentifizierungscode ist optional: Damit prüft die Integration, dass sie mit Ihrer Schnittstelle spricht. KNX Data Secure (verschlüsselte Gruppenkommunikation) wird nicht unterstützt.
Geräte deklarieren
Unten auf der Konfigurationsseite öffnet eine Schaltfläche pro Geräteart ein Formular. Gruppenadressen werden wie in ETS geschrieben: 1/2/3 (dreistufig), 1/515 (zweistufig) und 2563 (frei) sind dieselbe Adresse. Die Statusadresse ist das Statusobjekt des Aktors (Lesen-Flag in ETS gesetzt): Ohne sie behält Gladys den letzten Befehl als Zustand.
| Schaltfläche | Gruppenadressen | Gladys-Funktionen |
|---|---|---|
| Licht deklarieren | Schalten (DPT 1.001) und Status, Helligkeit (5.001) und Status, RGB-Farbe (232.600) und Status, Farbtemperatur (7.600) und Status | Ein/Aus, Helligkeit, Farbe, Farbtemperatur |
| Schalter deklarieren | Schalten (1.001) und Status | Ein/Aus (Steckdose, Ventil, Pumpe…) |
| Rollladen deklarieren | Auf/Ab (1.008), Stopp (1.007 oder 1.010), Position (5.001) und Status | Öffnen / Schließen / Stoppen, Position |
| Sensor deklarieren | Wert: Temperatur, Luftfeuchtigkeit, Helligkeit, CO2, Luftdruck, Windgeschwindigkeit, Leistung, Energiezähler, Spannung, Strom, Prozentsatz, Zähler | der Messwert mit seiner Einheit |
| Binärsensor deklarieren | Zustand (1.x): Bewegung, Anwesenheit, Fenster- oder Türkontakt, Rauch, Wasserleck, Regen, anderes | der Zustand |
| Thermostat deklarieren | Sollwert (9.001) und Status, gemessene Temperatur | Sollwert, Temperatur |
Die Hauptgruppenadresse (die Schalt-, Auf/Ab-, Wert- bzw. Sollwertadresse) identifiziert das Gerät: Dieselbe Art mit derselben Hauptadresse erneut zu deklarieren aktualisiert es. Geräte auflisten zeigt die Deklarationen, Deklariertes Gerät entfernen nimmt einen Namen oder eine Hauptadresse entgegen. Die Deklarationen werden in der Gladys-Konfiguration gespeichert, also auch in den Gladys-Backups.
Öffnen Sie dann den Tab Entdecken und fügen Sie die Geräte hinzu. Ein Rollladen ist in Gladys bei 100 % offen und bei 0 % geschlossen (KNX sagt das Gegenteil; aktivieren Sie Position invertieren, wenn Ihrer es bereits umkehrt). Eine als 4-Byte-Gleitkommazahl (DPT 14) gesendete Temperatur, Leistung oder Spannung wird ebenfalls verstanden.
Zustände und Szenen
- Zustände beim Start lesen und Zustände erneut lesen alle (Minuten): Die Integration fragt die Statusadressen nach ihrem Wert, sobald sie sich verbindet, dann in diesem Intervall (0: nie). KNX-Geräte senden ihre Änderungen selbst; das holt nur Telegramme nach, die gesendet wurden, während Gladys gestoppt war.
- Gruppenadressen für Szenen: Telegramme an diese Adressen starten die Szenen „Ein KNX-Telegramm wird empfangen“. Trennen Sie sie mit Kommas, verwenden Sie * für eine ganze Haupt- oder Mittelgruppe (1/0/, 2/) und fügen Sie :DPT hinzu, um den Wert zu dekodieren (1/0/7:9.001).
- Sprache der Funktionsnamen: die Sprache der Namen, die die Funktionen beim Hinzufügen eines Geräts erhalten.
Verwendung
Geräte
Die hinzugefügten Geräte verhalten sich wie jedes Gladys-Gerät: Dashboard, Räume, Verlauf, Szenen, Sprache und Chat. Ein Gerät ohne Statusadresse zeigt den letzten von Gladys gesendeten Befehl sowie die Befehle vom Bus (ein Wandtaster auf derselben Gruppenadresse).
Widget
Das Widget KNX-Bus zeigt die Verbindung, die Telegramme der letzten Minute, die Anzahl der deklarierten Geräte und die letzten Telegramme mit dem Gerätenamen und dem Wert. Zustände lesen fragt alle Statusadressen nach ihrem Wert, Neu verbinden öffnet eine neue Verbindung zur Schnittstelle. Seine Einstellungen: die Anzahl der angezeigten Telegramme und ein Filter für Gruppenadressen (1/, 2/1/).
Szenenauslöser
- Ein KNX-Telegramm wird empfangen: an einer Adresse aus dem Feld „Gruppenadressen für Szenen“. Filter: Gruppenadresse (dreistufige Form), Telegrammtyp (Schreiben, Antwort, Leseanfrage), Wert (true, false, 21.5…). Variablen: Gruppenadresse, Absender, Telegrammtyp, Wert, numerischer Wert, Rohdaten.
- Die KNX-Verbindung ist unterbrochen, Die KNX-Verbindung ist wiederhergestellt (nach einem Ausfall): die Schnittstelle und der Grund bzw. die Ausfalldauer in Sekunden.
Szenenaktionen
- Einen Wert auf den KNX-Bus senden: eine Gruppenadresse, ein Datenpunkttyp (1.001, 5.001, 9.001, 232.600…) und ein Wert (on, off, 21.5, #ff8000, ein Text oder eine Szenenvariable). Jede Gruppenadresse, auch wenn sie in Gladys kein Gerät ist.
- Einen Wert vom KNX-Bus lesen: fragt eine Gruppenadresse nach ihrem Wert; die folgenden Aktionen erhalten den Wert, den numerischen Wert und die Rohdaten.
- Eine KNX-Szene abrufen: sendet eine Szenennummer von 1 bis 64 (DPT 17.001) an eine Szenen-Gruppenadresse.
Szenenbeispiele
- Wenn der Taster „Alles aus“ im Eingang (Gruppenadresse 0/0/1 in „Gruppenadressen für Szenen“) aus sendet → die Gladys-Lichter ausschalten, die nicht KNX sind, und eine Benachrichtigung senden.
- Wenn die Alarmanlage scharf geschaltet wird → die KNX-Szene 3 „Abwesend“ auf 0/1/0 abrufen und die Rollläden schließen.
- Wenn die KNX-Verbindung unterbrochen ist → dem Haushalt eine Nachricht mit dem Grund senden.
Fehlerbehebung
- „Keine KNX-IP-Schnittstelle gefunden“: Die Suche läuft über den Gladys-Kern im lokalen Netzwerk; manche Schnittstellen antworten nicht darauf. Geben Sie die IP-Adresse der Schnittstelle in der Konfiguration ein.
- Die Verbindung schlägt fehl oder bricht ab: Eine Schnittstelle hat nur wenige Tunnel (oft 4 oder 5), geteilt mit ETS und anderer Software. Schließen Sie den Busmonitor von ETS oder reservieren Sie in ETS einen Tunnel für Gladys. Prüfen Sie bei KNX IP Secure die Benutzer-ID und das Passwort des Tunnels.
- Ein Zustand kommt nie zurück: Prüfen Sie, ob beim Statusobjekt des Aktors das Lesen-Flag in ETS gesetzt ist und ob die Statusadresse stimmt (der Busmonitor des Widgets zeigt, was ankommt).
- Ein falscher Wert (abwegige Temperatur, Prozentsatz bei 255): Der Datenpunkttyp der Adresse ist nicht der erwartete; prüfen Sie ihn in ETS.
- Ein Rollladen fährt in die falsche Richtung: Position invertieren umschalten und ihn erneut deklarieren (dieselbe Auf/Ab-Adresse: Das Gerät wird aktualisiert).
- Protokolle: Tab Protokolle der Integration. Für mehr Details fügen Sie dem Container die Umgebungsvariable
DEBUG=gladys-integration-sdkhinzu. Melden Sie Probleme auf GitHub mit der Gladys-Version, der Version der Integration, dem Schnittstellenmodell und den Protokollen.
KNX und das KNX-Logo sind Marken der KNX Association cvba. Diese Integration ist weder mit der KNX Association verbunden noch von ihr unterstützt oder zertifiziert.
Konfigurationseinstellungen
Diese Einstellungen fragt KNX in seinem Konfigurationsbildschirm in Gladys ab.
| Einstellung | Typ | Pflichtfeld | Beschreibung |
|---|---|---|---|
| Gladys mit Ihrer KNX-Anlage verbinden | section | Nein | Gladys kommuniziert mit dem KNX-Bus über eine KNX-IP-Schnittstelle oder einen KNX-IP-Router in Ihrem Netzwerk. Lassen Sie die Adresse leer, um die erste im Netzwerk gefundene zu verwenden. KNX-Geräte lassen sich nicht automatisch finden: Deklarieren Sie jedes unten mit den Schaltflächen „… deklarieren“ und den Gruppenadressen Ihres ETS-Projekts und fügen Sie es dann im Tab Entdecken hinzu. |
| Verbindung | select | Nein | Routing nutzt Multicast, das den Container der Integration meist nicht erreicht: Tunneling ist vorzuziehen. |
| Adresse der KNX-IP-Schnittstelle | string | Nein | IP-Adresse oder Hostname. Leer: die erste im Netzwerk gefundene Schnittstelle (die Schaltfläche „KNX-IP-Schnittstellen suchen“ listet sie auf). |
| Port | number | Nein | |
| Physikalische Adresse von Gladys | string | Nein | Optional beim Tunneling (die Schnittstelle vergibt die Adresse ihres Tunnels). Beim Routing erforderlich: eine freie, in ETS reservierte Adresse der Linie. |
| KNX IP Secure | section | Nein | Wählen Sie für eine KNX-IP-Secure-Schnittstelle TCP-Tunneling und tragen Sie den Tunnelbenutzer aus Ihrem ETS-Projekt ein (Eigenschaften der Schnittstelle, Tunnel-Reiter). KNX Data Secure (verschlüsselte Gruppenkommunikation) wird nicht unterstützt. |
| KNX IP Secure verwenden | boolean | Nein | |
| Physikalische Adresse des Tunnels | string | Nein | |
| Benutzer-ID des Tunnels | number | Nein | |
| Passwort des Tunnelbenutzers | secret | Nein | |
| Geräte-Authentifizierungscode (optional) | secret | Nein | Aus dem ETS-Projekt: Damit prüft die Integration, dass sie mit Ihrer Schnittstelle spricht. |
| Zustände und Szenen | section | Nein | KNX-Geräte senden ihre Änderungen selbst. Die Integration liest die Statusadressen zusätzlich beim Start und im gewählten Intervall, um Telegramme nachzuholen, die gesendet wurden, während Gladys gestoppt war. |
| Zustände beim Start lesen | boolean | Nein | |
| Zustände erneut lesen alle (Minuten) | number | Nein | 0: nie. |
| Gruppenadressen für Szenen | string | Nein | Telegramme an diese Adressen starten die Szenen „Ein KNX-Telegramm wird empfangen“. Trennen Sie sie mit Kommas; * deckt eine Haupt- oder Mittelgruppe ab; mit :DPT wird der Wert dekodiert (1/0/7:9.001). |
| Sprache der Funktionsnamen | select | Nein | Wird verwendet, wenn ein Gerät im Tab Entdecken hinzugefügt wird. |
So installierst du KNX in Gladys
- Öffne in Gladys Integrationen: KNX 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-knx: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-knx.
KNX benötigt Gladys >=5.1.1. 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
KNX 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 externen Integrationen durchsuchen
- Die nativen Integrationen entdecken, die in Gladys eingebaut sind
- Deine eigene externe Integration bauen und veröffentlichen
- Quellcode auf GitHub — Quelle dieser Dokumentation