KNX Gateway Konfiguration

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

Allgemein

Eigenschaft Beschreibung
Name Name des Nodes.
Gateway Gib die KNX/IP-Adresse bzw. den Hostnamen oder einen seriellen Pfad (z. B. /dev/ttyUSB0) ein. Im Dropdown erscheinen automatisch erkannte KNX/IP-Gateways sowie FT1.2-Seriellports; beim AuswĂ€hlen eines Serials wird das Protokoll auf Serial FT1.2 gesetzt und die UART-Defaults werden ĂŒbernommen.

Konfiguration

Eigenschaft Beschreibung
Gateway-Port Verbindungsport. Standard: 3671. FĂŒr Serial FT1.2 nicht verwendet.
Verbindungsprotokoll Tunnel UDP fĂŒr KNX/IP-Interfaces, Multicast UDP fĂŒr KNX/IP-Router, Serial FT1.2 fĂŒr TP/FT1.2-Adapter (wird automatisch gewĂ€hlt, wenn du einen Serialport auswĂ€hlst). Auto versucht, das passende Protokoll zu ermitteln.
Serial FT1.2 Modus Legt fest, wie die FT1.2-Schnittstelle initialisiert wird: KBerry/BAOS aktiviert die spezielle Initialisierung fĂŒr Weinzierl KBerry/BAOS-Module (Reset, BAOS-Link-Layer-Modus, keine GA-Filter), wĂ€hrend Standard FT1.2 einen generischen FT1.2-Adapter ohne KBerry-spezifische Schritte verwendet. Standard ist KBerry/BAOS.
KNX-Adresse Physikalische KNX-Adresse, z. B. 1.1.200. Standard: 15.15.22.
An lokale Netzwerk-Schnittstelle binden 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.
Beim Start automatisch mit dem KNX BUS verbinden Automatisch beim Start verbinden. Standard: “Yes”.
Quelle fĂŒr Secure-Zugangsdaten 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.
Individuelle Adresse der Tunnel-Schnittstelle 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-Benutzer-ID Sichtbar bei manuellen Zugangsdaten. Optionale Kennung des KNX Secure Tunnel-Benutzers aus ETS.
Tunnel-Benutzerpasswort 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.
‱ KNX/IP Secure (Tunnel-Handshake) gilt nur fĂŒr IP-Transporte (Tunnel TCP / sicheres Routing). KNX Data Secure schĂŒtzt Gruppenadress-Telegramme und kann sowohl ĂŒber IP (Tunneling/Routing) als auch ĂŒber TP via Serial FT1.2 verwendet werden, sofern ein ETS-Keyring vorhanden ist.

Erweitert

Eigenschaft Beschreibung
Suppress repeated (R-Flag) telegrams fom BUS Wiederholte BUS-Telegramme (R-Flag) ignorieren.
Bus-ACK-Anforderung unterdrĂŒcken Bus-ACK. Wenn aktiviert, fordern die an den KNX-Bus gesendeten Telegramme (Tunnel UDP, Multicast und Serial FT1.2) keine BestĂ€tigung der empfangenden GerĂ€te mehr an. Bei Tunnel UDP und “Auf Tunnelling-ACK warten” auf Automatisch wartet der Knoten außerdem nicht mehr auf die BestĂ€tigung der Schnittstelle. Nur aktivieren, wenn Ihre Schnittstelle es erfordert, z. B. einige alte oder Weinzierl-KNX/IP-Schnittstellen, eibPORT und Loxone. Standard: deaktiviert.
Auf Tunnelling-ACK warten (Tunnel UDP) Schnittstellen-ACK. Bei Tunnel UDP wartet der Knoten, bis die KNX/IP-Schnittstelle jedes Telegramm bestĂ€tigt: Ein unbestĂ€tigtes Telegramm wird noch einmal gesendet, dann wird die Verbindung geschlossen und neu aufgebaut. Automatisch wartet nur, wenn “Bus-ACK-Anforderung unterdrĂŒcken” deaktiviert ist, wie in frĂŒheren Versionen. Ja wartet immer, Nein nie. eibPORT- und Loxone-Gateways benötigen “Bus-ACK-Anforderung unterdrĂŒcken” zusammen mit Ja.
Flow-Bubbles-Plugin aktivieren Zeigt im Editor neben jedem KNX Device Node eine kleine farbige Bubble an. Die Bubble spiegelt den zuletzt vom Gateway empfangenen Live-Status wider und wird abgeblendet, wenn die Daten veraltet sind. NĂŒtzlich bei Inbetriebnahme und Debugging. Standard: deaktiviert.
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).
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.
Status Datum/Uhrzeit-Format Legt fest, wie Datum/Uhrzeit im Status-Badge angezeigt werden (nĂŒtzlich, wenn das OS-Locale nicht konfigurierbar ist).
Benutzerdefiniertes Format Wird verwendet, wenn Benutzerdefiniert (Tokens) gewĂ€hlt ist. Tokens: YYYY, YY, MMM, MM, DD, HH, mm, ss, A, a, Z. Verwenden Sie [Text] fĂŒr Literale.
Locale ĂŒberschreiben Optionales Locale (BCP47), z. B. de-DE oder en-GB. FĂŒr Monatsnamen (MMM) bei benutzerdefiniertem Format.

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.

Datei-Cache-Steuerung

Eigenschaft Beschreibung
Loglevel Log-Detailgrad. Standard: “Error”. Das Log ist von der Schreibverschleiß-Verwaltung nicht betroffen.
Schreibverschleiß-Verwaltung Legt fest, wie oft KNX Ultimate seine Dateien auf den DatentrĂ€ger schreibt: GA-Werte, Szenen des Scene Controllers, AutoResponder-Werte, Logger-Datei und Viewer-Verlauf. NĂŒtzlich, um den Verschleiß von SD-Karten zu verringern. Dateien werden nur geschrieben, wenn sich ihr Inhalt geĂ€ndert hat. AktualitĂ€t zuerst (Standard) speichert Änderungen alle 5 Sekunden. Ausgewogen speichert sie nur beim Verbinden oder Trennen des Gateways sowie wenn Node-RED stoppt oder das Gateway neu bereitgestellt wird. Schreiben deaktivieren schreibt nie auf den DatentrĂ€ger: Die Daten bleiben nur im Speicher, und bei jedem Neustart von Node-RED gehen alle aktuellen GA-Werte und die von den KNX-Ultimate-Knoten gespeicherten Daten verloren. Benutzerdefiniertes Intervall speichert Änderungen im gewĂ€hlten Intervall (5 Sekunden bis 30 Tage) sowie wenn Node-RED stoppt oder das Gateway neu bereitgestellt wird.
Schreibintervall Sichtbar bei Benutzerdefiniertes Intervall. Wert und Einheit (Sekunden, Minuten, Stunden, Tage) des Schreibintervalls.

Ist das Schreiben deaktiviert, zeigen die KNX-Ultimate-Knoten, die Dateien verwenden (Device mit initialem Lesen aus Datei, Scene Controller, AutoResponder, Logger mit Speicherung in Datei, Viewer), einen Hinweis in ihrem Editor.

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) 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.

<table style="font-size:12px">
    <tr><th colspan="2" style="font-size:14px">Statusfarben des Nodes</th></tr>
    <tr><td><img src="https://raw.githubusercontent.com/Supergiovane/node-red-contrib-knx-ultimate/master/img/greendot.png"></td><td>Auf Write-Telegramme reagieren</td></tr>
    <tr><td><img src="https://raw.githubusercontent.com/Supergiovane/node-red-contrib-knx-ultimate/master/img/greenring.png"></td><td>Schutz gegen zyklische Referenzen (<a href="https://supergiovane.github.io/node-red-contrib-knx-ultimate/wiki/Protections" target="_blank">siehe Seite</a>)</td></tr>
    <tr><td><img src="https://raw.githubusercontent.com/Supergiovane/node-red-contrib-knx-ultimate/master/img/bluedot.png"></td><td>Auf Response-Telegramme reagieren</td></tr>
    <tr><td><img src="https://raw.githubusercontent.com/Supergiovane/node-red-contrib-knx-ultimate/master/img/bluering.png"></td><td>Node-Wert automatisch als Response senden (<a href="https://supergiovane.github.io/node-red-contrib-knx-ultimate/wiki/-Sample---Virtual-Device" target="_blank">Virtual Device</a>)</td></tr>
    <tr><td><img src="https://raw.githubusercontent.com/Supergiovane/node-red-contrib-knx-ultimate/master/img/greudot.png"></td><td>Auf Read-Telegramme reagieren</td></tr>
    <tr><td><img src="https://raw.githubusercontent.com/Supergiovane/node-red-contrib-knx-ultimate/master/img/greyring.png"></td><td>RBE-Filter: Kein Telegramm gesendet</td></tr>
    <tr><td><img src="https://raw.githubusercontent.com/Supergiovane/node-red-contrib-knx-ultimate/master/img/reddot.png"></td><td>Fehler oder getrennt</td></tr>
    <tr><td><img src="https://raw.githubusercontent.com/Supergiovane/node-red-contrib-knx-ultimate/master/img/redring.png"></td><td>Node deaktiviert wegen zyklischer Referenz (<a href="https://supergiovane.github.io/node-red-contrib-knx-ultimate/wiki/Protections" target="_blank">siehe Seite</a>)</td></tr>
</table>