KNX-Befehl aus IP-Netzwerk mit Gira X1

[Partychr]

Hallo zusammen, ich würde gerne an einer Stelle eine Aussenbeleuchtung schalten, wenn das Garagentor auffährt.

In meiner Hausinstallation habe ich einen Gira X1 verbaut, welcher eine Verbindung vom LAN-Netzwerk zum KNX-System aufbaut.
Am Garagentor habe ich wiederrum einen LAN-Anschluss liegen.

Kann ich hier einen Befehl über einen potentialfreien Kontakt mit einem Bauteil o.ä. so verarbeiten dass dieser über mein Netzwerk einen Befehl an den X1 sendet und dieser einen Schaltbefehl im KNX auslöst ?

[Erik Jeschke]

Ja, grundsätzlich geht das über die Gira IoT REST API; ich würde bei der Auswahl eines LAN-Eingangsmoduls aber ausdrücklich prüfen, ob es die dafür nötigen HTTPS-Anfragen mit Anmeldung/Token und dem Schreiben eines Datenpunkts unterstützt – ein beliebiger URL-Aufruf allein reicht dafür nicht. Gira dokumentiert damit das Lesen und Schreiben der im GPA als Funktionen bereitgestellten Datenpunkte; die unten verlinkte API-v3-Dokumentation gilt beim X1 für Firmware 4.0. Der potentialfreie Kontakt müsste also zunächst von einem passenden Eingangsmodul erfasst und sein Zustandswechsel durch eine passende Softwareanbindung in den API-Aufruf übersetzt werden; eine konkrete Gerätekompatibilität würde ich vor dem Kauf anhand dieser Anforderungen prüfen. Welche Firmware hat Dein X1, und stellt der Torantrieb bereits einen potentialfreien Statuskontakt bereit oder soll ein zusätzlicher Torkontakt verwendet werden?

Quelle: Gira IoT REST API v3, Stand 31.08.2026, Abschnitte 1, 2.3, 4.2 und 6.3:
https://partner.gira.de/data3/Gira_I..._API_v3_DE.pdf

Gruß Erik

[Partychr]

Ja, grundsätzlich geht das über die Gira IoT REST API; ich würde bei der Auswahl eines LAN-Eingangsmoduls aber ausdrücklich prüfen, ob es die dafür nötigen HTTPS-Anfragen mit Anmeldung/Token und dem Schreiben eines Datenpunkts unterstützt – ein beliebiger URL-Aufruf allein reicht dafür nicht. Gira dokumentiert damit das Lesen und Schreiben der im GPA als Funktionen bereitgestellten Datenpunkte; die unten verlinkte API-v3-Dokumentation gilt beim X1 für Firmware 4.0. Der potentialfreie Kontakt müsste also zunächst von einem passenden Eingangsmodul erfasst und sein Zustandswechsel durch eine passende Softwareanbindung in den API-Aufruf übersetzt werden; eine konkrete Gerätekompatibilität würde ich vor dem Kauf anhand dieser Anforderungen prüfen. Welche Firmware hat Dein X1, und stellt der Torantrieb bereits einen potentialfreien Statuskontakt bereit oder soll ein zusätzlicher Torkontakt verwendet werden?

Quelle: Gira IoT REST API v3, Stand 31.08.2026, Abschnitte 1, 2.3, 4.2 und 6.3:
https://partner.gira.de/data3/Gira_I..._API_v3_DE.pdf

Gruß Erik

Die Firmware meines X1 ist: 2.8.858
Und ja, die Torsteuerung stellt potentialfreie Kontakte zur Verfügung

[Erik Jeschke]

Ich würde bei Deinem X1 mit 2.8.858 zunächst die API v2 prüfen, statt die zuvor verlinkte v3-Dokumentation zugrunde zu legen: Gira dokumentiert die v2 bereits für den X1 mit Firmware 2.4. Als rein lesenden Test kannst Du im lokalen Netz die Adresse https://DEINE-X1-IP/api/v2/ aufrufen; laut Gira ist dafür keine Anmeldung erforderlich, und eine erfolgreiche Antwort enthält unter anderem „version“, „deviceType“ und „deviceVersion“. Damit lässt sich die tatsächlich erreichbare API-Version prüfen, bevor Du ein LAN-Eingangsmodul auswählst; das bestätigt noch nicht dessen Kompatibilität. Falls der Aufruf scheitert, nenne bitte die konkrete Fehlermeldung, aber keine Zugangsdaten oder Tokens.

Quelle: Gira IoT REST API v2, Abschnitte 1, 2.3 und 3 (S. 3, 6–7):
https://partner.gira.de/data3/Gira_I..._API_v2_DE.pdf

Gruß Erik

[Hubertus81]

Die REST API ist aber mehr etwas für Entwickler. Du musst dich dort mit Tokens herumschlagen und diese bei Neustart und/oder nach gewissen Zeiten aktualisieren usw. Wenn möglich würde ich hier erstmal schauen ob der Weg über MQTT nicht sinnvoller ist. Bedingt natürlich dass ein Broker schon vorhanden ist. Wenn der LAN Anschluss ein Cat Kabel ist und nicht benötigt wird für LAN wäre es auch möglich die Cat Leitung dafür zu benutzen den potentialfreien Kontakt abzufragen und direkt auf einen KNX Binäreingang zu gehen.

[Partychr]

Die REST API ist aber mehr etwas für Entwickler. Du musst dich dort mit Tokens herumschlagen und diese bei Neustart und/oder nach gewissen Zeiten aktualisieren usw. Wenn möglich würde ich hier erstmal schauen ob der Weg über MQTT nicht sinnvoller ist. Bedingt natürlich dass ein Broker schon vorhanden ist. Wenn der LAN Anschluss ein Cat Kabel ist und nicht benötigt wird für LAN wäre es auch möglich die Cat Leitung dafür zu benutzen den potentialfreien Kontakt abzufragen und direkt auf einen KNX Binäreingang zu gehen.

Ja, das hat sich auch ziemlich kompliziert gelesen...
Das CAT-Kabel wird leider auch für eine Datenverbindung mit genutzt und es ist auch noch ein Switch dazwischen, daher scheidet eine Nutztung eines Binäreinganges leider erst einmal aus...

[Hubertus81]

Dann MQTT. KNX-IP würde auch gehen wäre aber mit höheren Kosten verbunden sofern IP Router usw noch net vorhanden ist. KNX-RF wäre auch möglich aber wenn man damit anfängt ebenfalls nicht ganz preiswert.
Kein Plan obs sowas gibt aber der Gira X1 kann auch Modbus TCP. Sprich ein Sensor mit Modbus TCP Schnittstelle sollte sich ebenfalls vom Gira X1 auslesen lassen.

[jiggy60]

Ein LAN Kabel, aber kein KNX Bus oder Datenleitung in die Garage gelegt?
Dann würde ich mal bei Shelly schauen und auf dem X1 mit HTTP Webrequests arbeiten. Da gibt es fertige Logiken für den X1 die den WebRequest verarbeiten und an KNX weiterleiten. Ist wahrscheinlich die günstigere Alternative als KNX-RF.

[Noschvie]

Kann der X1 KNX multicast oder hast du ein anderes Device, dass das unterstützt?

Gibt es für die REST API keinen Beispiel Flow für Python oder node.js ?