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