Zum Inhalt springen
Elausys

HyperVisu / Integrationen

KNX-Integration

Die Busverbindung, Programmierung mit ETS vor Ort oder per Fernzugriff, die Gruppenadressbibliothek und das Binden per Drag & Drop.

elausys · 21 Juli 2026
Auf dieser Seite

KNX-Integration

Die Seite KNX im Admin-Panel ist die Arbeitsfläche für alles rund um KNX: die Busverbindung, den ETS-Programmierzugang, die Gruppenadressbibliothek, den Busmonitor, die KNX Bridge und die KNX-Trigger. Öffnen Sie sie über die Seitenleiste. Die Seite hat drei Reiter: Bridge, Bus monitor und Group addresses. Auf den Reitern Bridge und Bus monitor zeigt eine Verbindungsleiste das Protocol, die Gateway IP und den aktuellen Status (Connected / Disconnected).

KNX-Seite, Desktop-Browser.

Verbindung und ETS-Fernzugriff

Was Sie brauchen: eine konfigurierte KNX-Verbindung (siehe „Connections“) mit dem Status Connected.

Die Verbindungsleiste spiegelt die KNX-Verbindung wider, die Sie auf der Seite Connections konfiguriert haben. Zeigt sie Disconnected, beheben Sie zuerst dort die Verbindung – ohne den Bus funktioniert auf dieser Seite nichts.

Programmieren mit ETS vor Ort. HyperVisu behält seine KNX-Verbindung, während Sie mit ETS programmieren: Es muss nichts umgeschaltet werden, und die Widgets bleiben aktuell. Die meisten KNX/IP-Schnittstellen erlauben nur eine begrenzte Anzahl von Tunneln, und HyperVisu belegt einen davon; ETS braucht daher einen weiteren freien Tunnel an der Schnittstelle (oder eine eigene Programmierschnittstelle).

ETS-Fernzugriff. Um den Bus von außerhalb des Gebäudes mit ETS zu programmieren, aktivieren Sie Remote ETS access. Dadurch wird über die Cloud-Verbindung ein gesicherter Tunnel geöffnet und der Server sowie eine Port-Nummer angezeigt.

  1. Schalten Sie auf der KNX-Seite (Reiter Bridge) Remote ETS access ein. Der Schalter braucht einige Sekunden, während der Tunnel geöffnet wird.
  2. Notieren Sie den angezeigten Server und die Portnummer. Der Port wird bei jeder Aktivierung des Zugangs neu vergeben.
  3. Konfigurieren Sie in ETS eine KNX/IP-Tunnelverbindung zu diesem Server und tragen Sie diesen Port ein.
  4. Schalten Sie Remote ETS access wieder aus, wenn Sie fertig sind.

📘 Note: Der Fernzugriffstunnel schließt sich automatisch nach 8 Stunden. Aktivieren Sie ihn erneut, wenn Sie mehr Zeit benötigen, und notieren Sie den neuen Port.

Reiter Bridge, Karte Remote ETS access aktiviert, mit dem Tunnel-Port, dem Hinweis „Use this port number in ETS“ und dem Hinweis zur automatischen Abschaltung.

Group addresses

Der Reiter Group addresses enthält die Gruppenadressbibliothek des Servers – jede aus ETS bekannte Adresse, durchsuchbar als ETS project tree („N main groups · M addresses“). Es ist dieselbe Bibliothek, die der Arbeitsbereich Devices für das Binden per Drag & Drop anbietet.

  • Suchen Sie mit dem Suchfeld oberhalb des Baums nach Adresse, Name oder Datenpunkttyp.
  • Importieren Sie Adressen aus einem ETS-Gruppenadressen-XML-Export, wenn Sie nicht das ganze Projekt importieren möchten: Klicken Sie in der Kopfzeile dieses Reiters auf Import Group Addresses und wählen Sie die Datei, die ETS über Group Addresses → Export erzeugt.

Wählen Sie eine Adresse im Baum aus, um ihr Detailfenster zu öffnen:

FeldBedeutung
Last valueDer zuletzt auf dem Bus gesehene dekodierte Wert.
Last seenWann dieser Wert eingetroffen ist.
Used byJedes Gerät und jede Automatisierung, die an diese Adresse gebunden ist („Not used by any device or automation“, wenn sie frei ist).
Watch on the bus monitorÖffnet den Reiter Bus monitor mit einem Hinweis auf die Adresse. Die Tabelle wird nicht gefiltert: Geben Sie die Adresse in Search telegrams... ein, um ihre Telegramme zu isolieren (siehe „KNX Bus Monitor“).

💡 Tip: „Used by“ ist der schnellste Weg, die Frage „Was passiert, wenn sich diese Adresse ändert?“ zu beantworten, bevor Sie etwas umverdrahten.

Reiter Group addresses.

KNX binden

Im Arbeitsbereich Devices zeigt der Reiter KNX der Leiste Communication objects den ETS project tree – Ihre Gruppenadressen, so geordnet wie in ETS – unabhängig davon, welches Gerät ausgewählt ist. Ist der Baum leer, klicken Sie in der Leiste auf Import Group Addresses und wählen Ihren ETS-Gruppenadressexport (XML) (siehe „Group addresses“ oben).

So binden Sie:

  1. Klappen Sie die Gerätezeile auf (Show objects), um ihre Kommunikationsobjekte anzuzeigen.
  2. Suchen Sie die Adresse im Baum oder geben Sie sie in Search group addresses... ein.
  3. Ziehen Sie die Gruppenadresse auf die passende Objektzeile. Während des Ziehens zeigen leere Zeilen Drop here to assign. Die Adresse wird zugewiesen, und das Objekt übernimmt den datapoint type (DPT) der Adresse aus den ETS-Daten, mit passender Einheit und Anzahl der Nachkommastellen.
  4. Wiederholen Sie dies für jedes Befehls- und Rückmeldeobjekt des Geräts.
  5. Klicken Sie in der Seitenleiste auf Apply changes und anschließend im Dialog Apply configuration changes erneut auf Apply changes (siehe „Admin Panel Tour“).

📘 Note: Eine Gruppenadresse wird jeweils auf eine Objektzeile gezogen. Sie kann nicht auf das Gerät als Ganzes gezogen werden: Nur eine Home-Assistant-Entität befüllt mehrere Objekte in einem Zug (siehe „Home Assistant Integration“).

Eine Gruppenadresse wird aus dem ETS-Baum auf die Objektzeile „Position“ eines aufgeklappten Geräts gezogen.

Wenn der Datentyp nicht passt. Weicht der DPT der Gruppenadresse von dem ab, was das Objekt erwartet, erklärt der Dialog Data type differs from object type die Abweichung: Der tatsächliche Datentyp der Adresse wird an das Objekt gebunden, und es ist eine Transformation erforderlich, um zwischen beiden umzurechnen. Klicken Sie auf Cancel und ziehen Sie die richtige Adresse, oder klicken Sie nur dann auf Map anyway, wenn Sie die Transformation hinzufügen wollen – das Objekt bleibt auf der Seite Health markiert, bis Sie es tun (siehe „Value Transformations & Health“).

💡 Tip: Typischer Fall: Ein Statusbyte (DPT 5.010) speist ein boolesches Objekt – binden Sie trotzdem (Map anyway) und fügen Sie dann eine Bit Check-Transformation hinzu (siehe „Value Transformations & Health“).

Häufig gestellte Fragen

Muss ich HyperVisu trennen, bevor ich mit ETS programmiere?

Nein. HyperVisu behält seine KNX-Verbindung, und die Widgets bleiben aktuell, während ETS programmiert. ETS braucht lediglich einen eigenen freien Tunnel an der Schnittstelle.

Wie lange bleibt der ETS-Fernzugriff offen?

Der gesicherte Fernzugriffstunnel schließt sich automatisch nach acht Stunden. Aktivieren Sie ihn erneut, wenn Sie mehr Zeit brauchen; der Port ändert sich jedes Mal.

Kann ich Gruppenadressen ohne vollständiges ETS-Projekt importieren?

Ja. Importieren Sie auf dem Reiter Group addresses einen ETS-Gruppenadressen-XML-Export.

Wie binde ich eine KNX-Gruppenadresse?

Ziehen Sie sie aus dem ETS-Projektbaum auf eine Objektzeile, jeweils ein Objekt. Das Objekt übernimmt den importierten DPT. Wenden Sie anschließend die Änderungen an.

Was passiert, wenn der DPT nicht zum Objekt passt?

Der Dialog zur Abweichung erklärt die nötige Umwandlung. Wenn Sie Map anyway wählen, fügen Sie eine passende Transformation hinzu; bis dahin markiert Health das Objekt.

Weiter erkunden

Finden Sie die weiteren Anleitungen zu diesem Produkt in der Dokumentation.

Zurück zu Integrationen