Vai al contenuto
Elausys

HyperVisu / Integrazioni

Integrazione KNX

La connessione al bus, la programmazione con ETS in locale o da remoto, la libreria degli indirizzi di gruppo e l'associazione con trascinamento.

elausys · 21 luglio 2026
In questa pagina

Integrazione KNX

La pagina KNX del pannello di amministrazione è l'area di lavoro per tutto ciò che riguarda il KNX: la connessione al bus, l'accesso di programmazione ETS, la libreria degli indirizzi di gruppo, il monitor del bus, il KNX Bridge e i trigger KNX. Aprila dalla barra laterale. La pagina ha tre schede: Bridge, Bus monitor e Group addresses. Nelle schede Bridge e Bus monitor una barra di connessione mostra il Protocol, il Gateway IP e lo stato in tempo reale (Connected / Disconnected).

Pagina KNX, browser desktop.

Connessione e accesso ETS remoto

Cosa serve: una connessione KNX configurata (vedi “Connections”) che mostri Connected.

La barra di connessione riflette la connessione KNX configurata nella pagina Connections. Se mostra Disconnected, correggi prima la connessione lì — senza il bus nulla in questa pagina funziona.

Programmazione con ETS in locale. HyperVisu mantiene la propria connessione KNX mentre programmi con ETS: non c'è nulla da commutare e i widget restano attivi. La maggior parte delle interfacce KNX/IP consente solo un numero limitato di tunnel e HyperVisu ne occupa uno, quindi ETS ha bisogno di un altro tunnel libero sull'interfaccia (o di una propria interfaccia di programmazione).

Accesso ETS remoto. Per programmare il bus con ETS dall'esterno dell'edificio, attiva Remote ETS access. Si apre un tunnel protetto attraverso la connessione cloud e vengono visualizzati il Server e un numero di Port.

  1. Nella pagina KNX (scheda Bridge), attiva Remote ETS access. L'attivazione richiede alcuni secondi, il tempo di aprire il tunnel.
  2. Annota il server e il numero di porta visualizzati. La porta viene assegnata nuovamente a ogni attivazione dell'accesso.
  3. In ETS, configura una connessione KNX/IP tunnelling verso quel server e inserisci quella porta.
  4. Disattiva Remote ETS access al termine.

📘 Nota: Il tunnel remoto si chiude automaticamente dopo 8 ore. Riattivalo se serve più tempo e annota la nuova porta.

Scheda Bridge, scheda Remote ETS access attivata, con la porta del tunnel, il suggerimento "Use this port number in ETS" e la nota sulla disattivazione automatica.

Indirizzi di gruppo

La scheda Group addresses contiene la libreria degli indirizzi di gruppo del server — tutti gli indirizzi noti da ETS, consultabili come ETS project tree ("N main groups · M addresses"). È la stessa libreria che l'area di lavoro Devices offre per l'associazione con trascinamento.

  • Cerca per indirizzo, nome o tipo di datapoint con il campo di ricerca sopra l'albero.
  • Importa gli indirizzi da un'esportazione XML degli indirizzi di gruppo di ETS se non vuoi importare l'intero progetto: fai clic su Import Group Addresses nell'intestazione di questa scheda e scegli il file prodotto da ETS tramite Group Addresses → Export.

Seleziona un indirizzo nell'albero per aprire il relativo pannello di dettaglio:

CampoSignificato
Last valueIl valore decodificato più recente visto sul bus.
Last seenIl momento in cui è arrivato quel valore.
Used byOgni dispositivo e automazione associati a questo indirizzo ("Not used by any device or automation" quando è libero).
Watch on the bus monitorApre la scheda Bus monitor con un promemoria dell'indirizzo. La tabella non è filtrata: digita l'indirizzo in Search telegrams... per isolarne i telegrammi (vedi “KNX Bus Monitor”).

💡 Suggerimento: “Used by” è il modo più rapido per rispondere a “cosa succede se questo indirizzo cambia?” prima di modificare qualsiasi cablaggio.

Scheda Group addresses.

Associazione KNX

Nell'area di lavoro Devices, la scheda KNX della barra Communication objects mostra la ETS project tree — i tuoi indirizzi di gruppo, organizzati come in ETS — qualunque dispositivo sia selezionato. Se l'albero è vuoto, fai clic su Import Group Addresses nella barra e scegli l'esportazione degli indirizzi di gruppo di ETS (XML) (vedi “Group addresses” sopra).

Per associare:

  1. Espandi la riga del dispositivo (Show objects) per mostrarne gli oggetti di comunicazione.
  2. Trova l'indirizzo nell'albero oppure digita in Search group addresses....
  3. Trascina l'indirizzo di gruppo sulla riga dell'oggetto corrispondente. Durante il trascinamento, le righe vuote riportano Drop here to assign. L'indirizzo viene assegnato e l'oggetto assume il tipo di datapoint (DPT) dell'indirizzo dai dati ETS, con l'unità e il numero di decimali corrispondenti.
  4. Ripeti per ogni oggetto di comando e di feedback del dispositivo.
  5. Fai clic su Apply changes nella barra laterale, poi su Apply changes nella finestra Apply configuration changes (vedi “Admin Panel Tour”).

📘 Nota: Un indirizzo di gruppo si rilascia su una riga di oggetto alla volta. Non può essere rilasciato sul dispositivo nel suo insieme: solo un'entità Home Assistant riempie più oggetti con un solo rilascio (vedi “Home Assistant Integration”).

Un indirizzo di gruppo trascinato dall'albero ETS sulla riga dell'oggetto "Position" di un dispositivo espanso.

Quando il tipo di dati non corrisponde. Se il DPT dell'indirizzo di gruppo differisce da quello atteso dall'oggetto, la finestra Data type differs from object type spiega la discrepanza: all'oggetto verrà associato il tipo di dati reale dell'indirizzo ed è necessaria una trasformazione per convertire tra i due. Fai clic su Cancel e rilascia l'indirizzo corretto, oppure fai clic su Map anyway solo se intendi aggiungere la trasformazione — l'oggetto resta segnalato nella pagina Health finché non lo fai (vedi “Value Transformations & Health”).

💡 Suggerimento: Caso tipico: un byte di stato (DPT 5.010) che alimenta un oggetto booleano — usa Map anyway, poi aggiungi una trasformazione Bit Check (vedi “Value Transformations & Health”).

Domande frequenti

Devo scollegare HyperVisu prima di programmare con ETS?

No. HyperVisu mantiene la propria connessione KNX e i widget restano attivi mentre ETS programma. ETS ha solo bisogno di un proprio tunnel libero sull'interfaccia.

Per quanto tempo resta aperto l'accesso ETS remoto?

Il tunnel remoto protetto si chiude automaticamente dopo otto ore. Riattivalo se serve più tempo; la porta cambia ogni volta.

Posso importare gli indirizzi di gruppo senza un progetto ETS completo?

Sì. Importa un'esportazione XML degli indirizzi di gruppo di ETS nella scheda Group addresses.

Come associo un indirizzo di gruppo KNX?

Trascinalo dall'albero del progetto ETS su una riga di oggetto, un oggetto alla volta. L'oggetto assume il DPT importato. Poi applica le modifiche.

Cosa succede se il DPT non corrisponde all'oggetto?

La finestra di discrepanza spiega la conversione necessaria. Se selezioni Map anyway, aggiungi una trasformazione adatta; fino ad allora Health segnala l'oggetto.

Continua a esplorare

Trova le altre guide per questo prodotto nella documentazione.

Torna a Integrazioni