de Gateway configuration - Supergiovane/node-red-contrib-knx-ultimate GitHub Wiki
🌐 Language: EN | IT | DE | 简体中文
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 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
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". |
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". |
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.
-
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) oder WARNING (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) |