Configurazione del KNX Gateway

Questo nodo si connette al tuo KNX/IP Gateway.

Generale

ProprietĂ  Descrizione
Nome Nome del nodo.
IP/Hostname Indirizzo multicast dell’ETH/KNX Router o indirizzo IP unicast dell’interfaccia. Con una KNX/IP Interface usa l’IP dell’interfaccia (es. 192.168.1.22). Con un KNX/IP Router usa l’indirizzo multicast 224.0.23.12. Puoi inserire anche un Hostname .

Configurazione

ProprietĂ  Descrizione
IP Port Porta di connessione. Default: 3671.
IP Protocol Tunnel UDP per interfacce KNX/IP, Multicast UDP per router KNX/IP. Lascia Auto per l’autorilevamento (default).
KNX Physical Address Indirizzo fisico KNX, es. 1.1.200. Default: 15.15.22.
Bind to local interface Interfaccia di rete locale usata dal nodo. Lascia “Auto” per selezione automatica. Se hai più interfacce (Ethernet/Wi‑Fi), è consigliato impostarla manualmente per evitare perdita di telegrammi UDP. Default: “Auto”.
Automatically connect to KNX BUS at start Connessione automatica al BUS all’avvio. Default: “Yes”.
Secure credentials source Scegli come fornire i dati KNX Secure: File keyring ETS ** (le chiavi Data Secure e, se presenti, le credenziali di tunnelling arrivano dal keyring),Credenziali manuali ** (solo KNX IP Tunnelling Secure con utente inserito a mano) oppureFile keyring + password tunnel manuale (chiavi Data Secure dal keyring, utente/password del tunnel impostati manualmente). Ricorda: i telegrammi KNX Data Secure richiedono sempre un file keyring.
Tunnel interface individual address Visibile quando la modalità selezionata prevede credenziali manuali (Credenziali manuali o File keyring + password tunnel manuale). Indirizzo individuale opzionale dell’interfaccia tunnel sicura (es. 1.1.1); lascia vuoto per negoziazione automatica da parte di KNX Ultimate.
Tunnel user ID Visibile quando sono attive credenziali manuali. ID opzionale dell’utente tunnel KNX Secure definito in ETS.
Tunnel user password Visibile quando sono attive credenziali manuali. Password dell’utente tunnel KNX Secure configurata in ETS.

Nota su KNX Secure
• KNX Data Secure protegge i telegrammi sugli indirizzi di gruppo e richiede sempre un file keyring con le chiavi di gruppo.
• KNX IP Tunnelling Secure protegge l’handshake della connessione tramite una password di commissioning, che può essere letta dal keyring oppure inserita manualmente in base alla modalità scelta.

Avanzate

ProprietĂ  Descrizione
Echo sent message to all node with same Group Address Inoltra ai nodi con lo stesso GA i msg inviati dal flow, come se provenissero dal BUS. Utile in emulazione KNX o senza connessione al BUS. Opzione in deprecazione e presto abilitata di default. Default: abilitato.
Suppress repeated (R-Flag) telegrams fom BUS Ignora i telegrammi ripetuti (flag R) dal BUS. Default: disabilitato.
Suppress ACK request in tunneling mode Per vecchie interfacce KNX/IP: ignora l’ACK e accetta tutti i telegrammi. Default: disabilitato.
Delay between each telegram (ms) Lo standard KNX prevede max 50 telegrammi/s. Un intervallo 25-50ms è adeguato. Con gateway remoto su link lento aumenta (es. 200-500ms).
Loglevel Livello di log per il debug. Default: “Error”.
Limitazione aggiornamento stato nodi Imposta ogni quanto aggiornare il badge di stato dei nodi. Con un ritardo attivo gli stati intermedi vengono ignorati e viene mostrato solo l’ultimo dopo l’intervallo scelto. Seleziona Immediato per mantenere l’aggiornamento in tempo reale.

Import file ETS

ProprietĂ  Descrizione
If Group Address has no Datapoint Se un GA non ha datapoint: interrompi import, salta il GA o aggiungi un datapoint fittizio 1.001 e continua.
ETS group address list Incolla qui il contenuto del file ETS (CSV o ESF) oppure indica un percorso file (es. /home/pi/mycsv.csv). Consulta i link di help per i dettagli.

Utility

ProprietĂ  Descrizione
Gather debug info for troubleshoot Clicca il pulsante e allega l’output alla issue su GitHub: aiuta molto l’analisi.
Get all used GA for KNX routing filter Clicca READ per ottenere l’elenco di tutti i GA usati nei flow associati a questo gateway, utile per popolare la tabella filtri del tuo KNX/IP Router.

Lavorare con i file ETS CSV o ESF

Invece di creare un nodo per ogni GA da controllare, puoi importare il file ETS di indirizzi di gruppo in formato CSV (consigliato) o ESF (da v1.1.35, utile con ETS Inside). ETS supportata: v4+.

Da v1.4.18 puoi anche indicare direttamente il percorso al file nel campo (es.: /home/pi/mycsv.csv).

Con Universal mode (listen to all Group Addresses) il nodo diventa I/O universale, consapevole di Datapoint, GA e nomi dispositivi. Invia un payload al nodo e lui codifica col DPT corretto; viceversa, decodifica i telegrammi in arrivo usando il DPT dell’ETS.

Da v1.1.11 puoi usare la modalitĂ  universale anche senza file ETS: invia al nodo un messaggio con tipo DPT e valore. Alla ricezione da BUS, il nodo emette anche il RAW e prova a decodificare senza DPT.

Nota: il file CSV contiene DPT precisi con sottotipo; l’ESF è più semplice e non include il sottotipo. Se puoi, preferisci il CSV: l’ESF può generare valori errati; controlla e correggi eventuali DPT dopo l’import. Da v1.4.1 è possibile importare anche a runtime via msg (nodo WatchDog).

Video:

Importare l’elenco GA in formato CSV

Attenzione. Nel nome dell’indirizzo di gruppo non devono esserci caratteri di tabulazione. Se in ETS un GA non ha un datapoint puoi scegliere di interrompere l’import, saltare il GA oppure aggiungerlo con un datapoint temporaneo 1.001 e proseguire.

Esportare il CSV da ETS

  1. In ETS apri la vista Indirizzi di gruppo, fai clic destro nell’elenco e seleziona Esporta indirizzi di gruppo.
  2. Nella finestra di export imposta:
    • Output format: CSV
    • CSV format: 1/1 Name/Address
    • Export with header line: attivo
    • CSV separator: Tabulator
  3. Esporta il file e incolla il contenuto nel campo ETS group address list (oppure indica il percorso del file).

Cosa aspettarsi durante l’import

  • Il file CSV deve contenere un datapoint per ogni GA.
  • Il gateway analizza il file e riporta l’esito nel pannello debug di Node‑RED:
    • ERROR – datapoint mancante; l’import viene interrotto.
    • WARNING – sottotipo mancante; viene applicato un valore predefinito ma è consigliato verificarlo (il sottotipo è il numero dopo il punto, es. 5.001).
  • I campi devono essere racchiusi tra virgolette, per esempio:

"Attuatori luci"	"0/-/-"	""	""	""	""	"Auto"

Importare l’elenco GA in formato ESF

  1. In ETS seleziona il progetto, clicca l’icona di export (freccia verso l’alto) e scegli il formato ESF (non .knxprod).

  2. Copia il contenuto del file oppure indica il percorso nel campo ETS group address list del gateway.

    Significato colori stato nodo
    Reagisci a telegrammi di scrittura
    Protezione da riferimenti circolari (vedi pagina)
    Reagisci a telegrammi di risposta
    Invio automatico del valore del nodo come risposta al BUS (Virtual Device)
    Reagisci a telegrammi di lettura
    Filtro RBE: nessun telegramma è stato inviato
    Errore o disconnesso
    Nodo DISABILITATO per riferimento circolare (vedi pagina)