🌐 Language: EN | IT | DE | FR | ES | 简体中文

Navigation: Startseite Übersicht: Changelog • FAQ • Sicherheit • Doku: Sprachleiste KNX Geräteknoten: Gateway • Gerät • Knotenschutz Weitere KNX‑Knoten: Szenencontroller • WatchDog • Logger • Global Context • Alerter • Laststeuerung • Viewer • Auto‑Responder • HA‑Übersetzer • IoT Bridge HUE: Bridge • Licht • Batterie • Taster • Kontakt • Geräte‑SW‑Update • Lichtsensor • Bewegung • Szene • Tap Dial • Temperatur • Zigbee‑Konnektivität Beispiele: Logger • Switch Light • Dimming • RGB color • RGBW color + White • Command a scene actuator • Datapoint 213.x 4x Setpoint • Datapoint 222.x 3x Setpoint • Datapoint 237.x DALI diags • Datapoint 2.x 1 bit proprity • Datapoint 22.x RCHH Status • Datetime to BUS • Read Status • Virtual Device • Subtype decoded • Alexa • Apple Homekit • Google Home • Switch on/off POE port of Unifi switch • Set configuration by msg • Scene Controller node • WatchDog node • Global Context node • Alerter node • Load control node • Viewer node • MySQL, InfluxDB, MQTT Sample Contribute to Wiki: Link

---

Dieser Node stellt die Verbindung zu deinem KNX/IP‑Gateway her.

Allgemein

Eigenschaft	Beschreibung
Name	Name des Nodes.
IP/Hostname	Multicast‑Adresse des ETH/KNX‑Routers oder Unicast‑IP einer KNX/IP‑Schnittstelle. Für Interfaces nutze die Geräte‑IP (z. B. 192.168.1.22); für Router 224.0.23.12. Hostname ist ebenfalls möglich.

Konfiguration

Eigenschaft	Beschreibung
IP Port	Verbindungsport. Standard: 3671.
IP Protocol	Tunnel UDP für KNX/IP‑Interfaces, Multicast UDP für KNX/IP‑Router. Auto erkennt automatisch (Standard).
KNX Physical Address	Physikalische KNX‑Adresse, z. B. 1.1.200. Standard: 15.15.22.
Bind to local interface	Lokales Netzwerk‑Interface für die Kommunikation. "Auto" wählt automatisch. Bei mehreren Interfaces (Ethernet/WLAN) ist eine manuelle Auswahl empfehlenswert, damit keine UDP‑Telegramme verloren gehen.
Automatically connect to KNX BUS at start	Automatisch beim Start verbinden. Standard: "Yes".
Secure credentials source	Bestimme, wie KNX Secure Daten bereitgestellt werden: ETS-Keyring-Datei ** (Data-Secure-Schlüssel und ggf. Tunneling-Zugangsdaten stammen aus dem Keyring),Manuelle Zugangsdaten ** (nur KNX IP Tunnelling Secure mit manuell eingetragenem Benutzer) oderKeyring + manuelles Tunnel-Passwort (Data-Secure-Schlüssel aus dem Keyring, Tunnel-Benutzer/-Passwort manuell). Wichtig: KNX Data Secure Telegramme benötigen immer eine Keyring-Datei.
Tunnel interface individual address	Sichtbar, sobald die Option manuelle Zugangsdaten umfasst (Manuelle Zugangsdaten oder Keyring + manuelles Tunnel-Passwort). Optionale KNX-Individualadresse der sicheren Tunnel-Schnittstelle (z. B. 1.1.1); leer lassen, damit KNX Ultimate automatisch verhandelt.
Tunnel user ID	Sichtbar bei manuellen Zugangsdaten. Optionale Kennung des KNX Secure Tunnel-Benutzers aus ETS.
Tunnel user password	Sichtbar bei manuellen Zugangsdaten. Passwort des KNX Secure Tunnel-Benutzers aus ETS.

KNX Secure im Überblick
• KNX Data Secure schützt Gruppenadress-Telegramme und benötigt immer eine Keyring-Datei mit den Gruppenschlüsseln.
• KNX IP Tunnelling Secure schützt den Verbindungsaufbau mittels Commissioning-Passwort. Je nach Modus stammt dieses aus dem Keyring oder wird manuell eingetragen.

Erweitert

Eigenschaft	Beschreibung
Echo sent message to all node with same Group Address	Leitet Flow‑Nachrichten an alle Nodes mit derselben GA weiter, so als kämen sie vom BUS. Nützlich bei KNX‑Emulation oder fehlender BUS‑Verbindung. Wird künftig standardmäßig aktiviert und dann entfernt.
Suppress repeated (R-Flag) telegrams fom BUS	Wiederholte BUS‑Telegramme (R‑Flag) ignorieren.
Suppress ACK request in tunneling mode	Für sehr alte KNX/IP‑Gateways: ACK ignorieren, alle Telegramme akzeptieren.
Delay between each telegram (ms)	KNX erlaubt max. 50 Telegramme/s. 25-50 ms sind üblich; bei langsamen Verbindungen höher (z. B. 200-500 ms).
Loglevel	Log‑Detailgrad. Standard: "Error".
Aktualisierung der Status-Badges	Legt fest, wie oft die Statusanzeige der Nodes erneuert wird. Mit einer Verzögerung werden Zwischenstände verworfen und nur der letzte Wert nach dem gewählten Intervall angezeigt. Wählen Sie Sofort, um das bisherige Echtzeitverhalten beizubehalten.

ETS‑Import

Eigenschaft	Beschreibung
If Group Address has no Datapoint	Wenn eine GA keinen DPT hat: Import abbrechen, GA überspringen oder GA mit Platzhalter‑DPT 1.001 übernehmen.
ETS group address list	Inhalt der ETS‑Datei (CSV/ESF) einfügen oder Dateipfad angeben (z. B. /home/pi/mycsv.csv). Siehe Hilfelinks.

Werkzeuge

Eigenschaft	Beschreibung
Gather debug info for troubleshoot	Button klicken und Ausgabe an ein GitHub‑Issue anhängen.
Get all used GA for KNX routing filter	Mit READ eine Textliste aller in Flows verwendeten GAs für dieses Gateway holen - zum Befüllen der Filtertabelle deines KNX/IP‑Routers.

Statt für jede GA einen Node anzulegen, importiere die ETS‑Gruppenadressen als CSV (empfohlen) oder ESF (ab v1.1.35, z. B. bei ETS Inside). Unterstützt ab ETS 4.

Seit v1.4.18 kann der Dateipfad direkt eingetragen werden (z. B. /home/pi/mycsv.csv).

Mit Universal mode (listen to all Group Addresses) wird der Node zu einem universellen I/O‑Node, der DPTs, GAs und Gerätenamen kennt. Eingehende Payloads werden mit passendem DPT kodiert; BUS‑Telegramme werden anhand des ETS‑DPT dekodiert.

Seit v1.1.11 ist der Universal‑Modus auch ohne ETS möglich: DPT und Wert per Nachricht übergeben. Bei BUS‑Eingang wird zusätzlich der RAW‑Wert ausgegeben und nach Möglichkeit ohne DPT dekodiert.

Hinweis: CSV enthält genaue DPTs inkl. Subtyp; ESF hat keinen Subtyp. Bevorzuge CSV, da ESF zu falschen Werten führen kann. Nach ESF‑Import DPTs prüfen/anpassen. Ab v1.4.1 ist Import auch zur Laufzeit per WatchDog möglich.

Video:

• **ETS‑CSV Gruppenadressen importieren ** Achtung: Im GA‑Namen dürfen keine Tabulator‑Zeichen vorkommen.**If Group Address has no Datapoint ** > Ohne DPT in ETS: Import abbrechen, GA überspringen oder mit Platzhalter‑DPT fortfahren.CSV‑Export in ETS

In ETS Gruppenadressenliste wählen → Rechtsklick → Exportieren. Optionen:
Output Format: CSV
CSV Format: 1/1 Name/Address
Export with header line: aktiv
CSV Separator: Tabulator
Dann den Dateitext hier einfügen. Datei muss pro GA einen DPT enthalten. Ergebnisse erscheinen in Node‑RED DEBUG.

Ergebnisse: ERROR ** (DPT fehlt → Import stoppt) oderWARNING ** (Subtyp fehlt → Default wird ergänzt, bitte prüfen). Subtyp ist die Zahl rechts vom Punkt, z. B. 5.001.ESF‑Export in ETS

Projekt wählen → Export‑Symbol (Pfeil nach oben) → ESF wählen (nicht .knxprod) → Inhalt im Feld "ETS group address list" einfügen.

Statusfarben des Nodes
	Auf Write‑Telegramme reagieren
	Schutz gegen zyklische Referenzen (siehe Seite)
	Auf Response‑Telegramme reagieren
	Node‑Wert automatisch als Response senden (Virtual Device)
	Auf Read‑Telegramme reagieren
	RBE‑Filter: Kein Telegramm gesendet
	Fehler oder getrennt
	Node deaktiviert wegen zyklischer Referenz (siehe Seite)