Devices (gruppo BUILDING della barra laterale) è il punto in cui ogni widget dell'impianto viene creato e collegato. Un dispositivo (widget) è ciò che l'utente vede e controlla nell'app; dietro ci sono uno o più oggetti di comunicazione — i singoli valori (stato di un interruttore, posizione, temperatura, …) che si collegano al mondo fisico tramite un protocollo.
Cosa serve: almeno una stanza e una categoria (vedi «Building Structure & Categories»), il protocollo interessato abilitato (vedi «Services & Protocols») e una connessione per esso (vedi «Connections»). Il collegamento specifico di ogni protocollo è trattato per protocollo: KNX (vedi «KNX Integration»), Home Assistant (vedi «Home Assistant Integration»), Modbus (vedi «Modbus TCP Integration»), HTTP (vedi «HTTP Integration»), MQTT (vedi «MQTT Integration»), BACnet/IP (vedi «BACnet/IP Integration»), TCP/UDP (vedi «TCP/UDP Integration»), Sonos (vedi «Devices Library & Sonos Binding»).
💡 Suggerimento: Prima di collegare un dispositivo oggetto per oggetto, cercalo nella Devices Library (vedi «Devices Library & Sonos Binding»). Per un inverter, contatore, caricatore, relè o altoparlante supportato, la libreria crea i widget con tutti gli oggetti già collegati: basta inserire un indirizzo.
L'area di lavoro Devices
La pagina ha tre colonne:
- Colonna sinistra — navigazione. Filtra l'elenco dei dispositivi per Rooms, Categories, Device Types o Protocols, ciascuno con il numero di dispositivi. La colonna offre anche scorciatoie integrate: Add Room, Add Category, Add Floor, Add Protocol.
- Centro — l'elenco dei dispositivi. Ricerca, filtri e una riga per dispositivo. L'intestazione della pagina contiene un pulsante rotondo con icona e senza testo (il suggerimento a comparsa riporta Health; apre la pagina Health, vedi «Value Transformations & Health»), poi Categories (gestione delle categorie, vedi «Building Structure & Categories»), Add from library (la Devices Library, vedi «Devices Library & Sonos Binding») e Add Device.
- Colonna destra — Communication objects. Il materiale di origine da collegare, su due schede: KNX mostra l'albero degli indirizzi di gruppo (vedi «KNX Integration»), Home Assistant mostra le entità (vedi «Home Assistant Integration»). La colonna non dipende dal dispositivo selezionato. Se è nascosta, riaprila con il pulsante Show communication objects accanto al campo di ricerca dei dispositivi.

Per ogni riga di dispositivo puoi:
- Cambiare la sua icona — fai clic sul riquadro dell'icona all'inizio della riga.
- Attivare o disattivare Visible in the app — nascondere un dispositivo senza eliminarlo (utile per i dispositivi che alimentano solo logica o registrazione).
- Aprire la sua Activity (vedi «Device Activity Log»).
- Edit Device — modificare nome, descrizione, stanza, categoria, protocollo, tipo o sottotipo. Leggi l'avviso sotto «Widget types & sub-types» qui sotto prima di cambiare il tipo o il sottotipo.
- Show objects — espandere la riga per mostrare gli oggetti di comunicazione del dispositivo.
- Delete del dispositivo (con conferma; non può essere annullato).
Chip e icone riassumono la configurazione a colpo d'occhio. Nella riga del dispositivo stessa:
| Chip | Significato |
|---|---|
| Chip di protocollo | Il protocollo (connessione) usato dal dispositivo. |
| NO GLOBAL | Il dispositivo è escluso dai comandi globali (vedi «Alarm PIN & Global-Command Exclusions»). |
Espandi il dispositivo per vedere il resto. Una legenda sopra l'elenco degli oggetti indica le quattro icone che possono comparire alla fine di ogni riga di oggetto:
| Legend | Significato |
|---|---|
| LOGGED | Un'icona di database: questo oggetto registra il proprio storico (vedi «Object Settings, Logging & Notifications»). |
| GRAFANA | Un pulsante a grafico, solo sugli oggetti registrati: apre il costruttore di pannelli Grafana (vedi «Object Settings, Logging & Notifications»). |
| TRANSFORMS | Il pulsante rotondo che apre la catena di trasformazione dell'oggetto (vedi «Value Transformations & Health»). |
| SETTINGS | L'ingranaggio che apre le impostazioni dell'oggetto (Edit Object, vedi «Object Settings, Logging & Notifications»). |
Su un dispositivo di allarme, la scheda PIN CODE sopra gli oggetti mostra PIN SET oppure NO PIN (vedi «Alarm PIN & Global-Command Exclusions»).
Aggiungere un dispositivo
- Fai clic su Add Device.
- Inserisci il Device Name.
- Scegli il Type di widget e, dove compare un campo Subtype, il sottotipo (vedi «Widget types & sub-types» qui sotto).
- Scegli un'Icon e, facoltativamente, inserisci una Description.
- Scegli la Room e la Category.
- Scegli il Protocol — è la connessione usata dal dispositivo (vedi «Connections»). I tipi telecamera, videocitofono e vista web non hanno il campo Protocol.
- Fai clic su Create Device.
Il nuovo dispositivo ha i suoi oggetti, ma nessuno è ancora collegato: un trattino nella colonna di collegamento significa che l'oggetto non è connesso all'apparecchiatura.
Per creare più dispositivi simili in una volta, attiva Add Multiple Devices (disponibile solo quando si aggiunge un dispositivo, non quando se ne modifica uno). In Additional Device Names, digita il secondo nome e fai clic su Add another device per ogni nome aggiuntivo. Viene creato un dispositivo per nome con le stesse impostazioni; una riga vuota viene ignorata e la finestra non controlla i nomi duplicati. Il pulsante diventa Create Devices.

Widget types & sub-types
Il Type di widget decide tutto di un dispositivo: quali controlli mostra l'app e quali oggetti di comunicazione esistono. Gli oggetti vengono creati automaticamente in base al tipo di dispositivo: non si aggiungono mai oggetti a mano. Molti tipi offrono un Subtype che varia l'insieme dei controlli. Per una tapparella, SHUTTER ha le lamelle e BLIND solo la posizione. L'elenco Type ha un campo di ricerca e riporta i nomi con l'iniziale maiuscola, ad esempio Analog Input e Analog Output.
Ogni oggetto ha:
- una direzione — se il valore entra (dal dispositivo a HyperVisu), esce (comandi verso il dispositivo) o entrambe le cose;
- un tipo di dato — booleano, numero, testo e così via.
Scegli il tipo che corrisponde alla funzione fisica, non al protocollo: una luce comandata da KNX e una luce Home Assistant usano lo stesso tipo di widget luce. Il catalogo completo di tipi, sottotipi e dei relativi oggetti è nel riferimento dei tipi di widget (vedi «Widget Types Overview»).
⚠️ Avviso: Scegli con attenzione il tipo e il sottotipo. Cambiare in seguito Type o Subtype in Edit Device sostituisce tutti gli oggetti del dispositivo con quelli del nuovo tipo e ogni collegamento va perso. La finestra non mostra alcun avviso e non chiede conferma. Cambiare nome, icona, stanza o categoria mantiene gli oggetti.