[Externe Integration] - KNX

Entwicklung
1

Hallo zusammen,

Um der Anforderung KNX-Protokoll-Integration nachzukommen, hier eine externe Integration, die Gladys mit einer KNX-Installation verbindet.

Was sie macht

Sie kommuniziert über den Bus via eine KNX-IP-Schnittstelle Ihres Netzwerks, nur lokal: Nichts wird ins Internet gesendet. Gladys hat keine native KNX-Integration.

KNX ermöglicht nicht die Erkennung von Geräten: Sie deklarieren jedes Gerät einmal mit seinen ETS-Gruppenadressen (Buttons „Licht deklarieren“, „Rollo deklarieren“… in der Konfiguration), und fügen es dann im Tab Entdeckung hinzu.

Funktionen

  • Geräte: Lichter (Dimmung, Farbe), Schalter, Rollos und Vorhänge, Sensoren (Temperatur, Luftfeuchtigkeit, CO2, Leistung, Energie…), binäre Sensoren (Bewegung, Fenstersensor, Rauch…), Thermostate.
  • Verbindung: UDP- oder TCP-Tunneling, KNX IP Secure, Routing; automatische Schnittstellensuche.
  • Widget „KNX-Bus“: Verbindung, Verkehr, letzte Telegramme.
  • Szenenauslöser: Telegramm empfangen auf ausgewählten Adressen, Verbindung verloren, Verbindung wiederhergestellt.
  • Szenenaktionen: Wert senden, Wert lesen, KNX-Szene aufrufen.

Beispiele für Szenen:

  • Wenn der „Alles ausschalten“-Knopf am Eingang „aus“ sendet → auch nicht-KNX-Lichter ausschalten;
  • Wenn der Alarm aktiviert wird → KNX-Szene „Abwesenheit“ aufrufen und Rollos schließen;
  • Wenn die KNX-Verbindung verloren geht → Haushalt benachrichtigen.

Installation

Verfügbar im Store im Laufe des Tages, sobald die Indexierung abgeschlossen ist (suchen Sie nach „KNX“), oder sofort über die Repository-URL: Integrationen → Integration installieren → https://github.com/William-De71/gladys-knx. Gladys 5.1.1 mindestens.

  1. Geben Sie die IP-Adresse der Schnittstelle ein (oder lassen Sie es leer), dann Verbindung testen.
  2. Deklarieren Sie Ihre Geräte mit ihren ETS-Gruppenadressen (1/2/3).
  3. Fügen Sie sie im Tab Entdeckung hinzu.
  4. Fügen Sie das Widget „KNX-Bus“ zu einem Dashboard hinzu.

Screenshots

Illustration generiert aus dem Code der Integration (kein Screenshot eines echten Gladys):

KNX-Bus-Widget (generierte Illustration)

Bekannte Einschränkungen

  • Nicht auf einer echten KNX-Installation getestet, nur gegen den KNXUltimate-Tunnelserver und automatisierte Tests: Ihr Feedback zu echter Hardware wird erwartet.
  • Kein Import des ETS-Projekts: Die Adressen werden manuell eingegeben.
  • Weder KNX Data Secure, noch Lüftung, noch Thermostatmodi (Komfort, Eco…) vorerst.
  • Das Multicast-Routing erreicht in der Regel nicht den Container: Bevorzugen Sie das Tunneling.
Wie es funktioniert, für Neugierige

Die Integration ist ein Node.js-Container, der die Bibliothek KNXUltimate (die von node-red-contrib-knx-ultimate) verwendet. Die Deklarationen werden in der Gladys-Konfiguration gespeichert, also in ihren Backups. Jedes Telegramm wird mit dem Datentyp-Punkt (DPT) seiner Adresse decodiert, und nur Änderungen werden an Gladys gesendet (maximal 240 Zustände pro Minute). Die Schnittstellensuche erfolgt über den Kern von Gladys, der allein im lokalen Netzwerk senden kann.

Ihr Feedback

Als Antwort auf diesen Thread oder in einem GitHub-Issue, mit den Versionen von Gladys und der Integration, dem Modell der Schnittstelle und den Protokollen (ideal mit DEBUG=gladys-integration-sdk).

Lizenz Apache 2.0. Danke an das Gladys-Team für die Dokumentation und das SDK für externe Integrationen, und an den Autor von KNXUltimate.

KNX ist eine Marke der KNX Association; dieses Projekt ist nicht damit verbunden.