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

Navigazione: Home Panoramica: Changelog • FAQ • Sicurezza • Docs: Barra lingue Nodo KNX Dispositivo: Gateway • Dispositivo • Protezioni Altri Nodi KNX: Scene Controller • WatchDog • Logger • Global Context • Alerter • Controllo Carico • Viewer • Auto Responder • Traduttore HA • IoT Bridge HUE: Bridge • Luce • Batteria • Pulsante • Contatto • Aggiornamento SW • Sensore Luce • Movimento • Scena • Tap Dial • Temperatura • Connettività Zigbee Esempi: 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 Contribuisci alla Wiki: Link

---

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.

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:

• **Import ETS CSV Group Addresses ** ATTENZIONE: nel nome del GA non devono esserci caratteri di tabulazione.**If Group Address has no Datapoint ** > Se in ETS un GA non ha DPT, puoi: interrompere l'import, saltare il GA, oppure aggiungere il GA con DPT fittizio e continuare.Come esportare l'elenco GA in formato CSV da ETS

In ETS seleziona l'elenco GA, click destro → Esporta indirizzi di gruppo. Nella finestra di export imposta:
Output Format: CSV
CSV Format: 1/1 Name/Address
Export with header line: spuntato
CSV Separator: Tabulator
Poi incolla qui il contenuto del file.
Il file deve contenere i Datapoint per ogni GA. Il nodo analizza il file e mostra risultati nel DEBUG di Node‑RED.

Esiti possibili: ERROR ** (manca DPT → import interrotto) eWARNING** (manca sottotipo → aggiunto default, ma va verificato). Il sottotipo è il numero dopo il punto, es. 5.001.

I campi devono essere racchiusi tra virgolette ".

Come esportare l'elenco GA in formato ESF da ETS

In ETS seleziona il progetto, icona export (freccia in su), scegli formato ESF (non .knxprod). Copia e incolla 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)