de Gateway configuration - Supergiovane/node-red-contrib-knx-ultimate GitHub Wiki

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

Navigation: Startseite Übersicht: ChangelogFAQSicherheitDoku: Sprachleiste KNX Geräteknoten: GatewayGerätKnotenschutz Weitere KNX‑Knoten: SzenencontrollerWatchDogLoggerGlobal ContextAlerterLaststeuerungViewerAuto‑ResponderHA‑Übersetzer HUE: BridgeLichtBatterieTasterKontaktGeräte‑SW‑UpdateLichtsensorBewegungSzeneTap DialTemperaturZigbee‑Konnektivität Beispiele: LoggerSwitch LightDimmingRGB colorRGBW color + WhiteCommand a scene actuatorDatapoint 213.x 4x SetpointDatapoint 222.x 3x SetpointDatapoint 237.x DALI diagsDatapoint 2.x 1 bit proprityDatapoint 22.x RCHH StatusDatetime to BUSRead StatusVirtual DeviceSubtype decodedAlexaApple HomekitGoogle HomeSwitch on/off POE port of Unifi switchSet configuration by msgScene Controller nodeWatchDog nodeGlobal Context nodeAlerter nodeLoad control nodeViewer nodeMySQL, InfluxDB, MQTT Sample


KNX Gateway Konfiguration

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.

Arbeit mit ETS‑CSV oder ESF

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) 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)
⚠️ **GitHub.com Fallback** ⚠️