Architettura di sistema e limiti
Numero massimo di Home Gateway per ciascun server ThinKnx:
- PICCOLO e K2: 1
- Altri server: 5
Numero massimo di dispositivi ZigBee per ciascun Home Gateway:
- Per ciascun Home Gateway: 60
Se l’applicazione richiede la gestione di un numero superiore di Home Gateway per server ThinKnx o un numero superiore di dispositivi ZigBee per Home Gateway, contattare il servizio di assistenza tecnica per un’analisi di fattibilità approfondita.
Prerequisiti
Richiede server alla versione 1.1.10.28 e Thinknx App alla versione 1.2.42 o successive
Configurare l’Home Gateway per la comunicazione con il server Thinknx.
Indicatori LED dell’Home Gateway:
- Viola = modalità Thinknx attiva
- Blu = modalità Gewiss attiva (compatibile con l’app Gewiss)
Opzione 1 – Configurazione standard Home Gateway
- Avviare l’app Home Gateway
- Selezionare Configura nuova casa dal “menu hamburger” (in alto a destra)
- Per identificare l’Home Gateway da configurare, seguire le istruzioni guidate dall’app e premere Continua
Percorso Wiki: Opzione 1 – Configurazione standard Home Gateway
- Premere Configura con Thinknx
- Configurare i seguenti parametri per consentire all’Home Gateway di connettersi al Broker MQTT (in esecuzione sul server Thinknx) e alla rete Wi-Fi locale:
- Indirizzo IP e porta del Broker MQTT
- Indirizzo IP: lo stesso indirizzo IP del server Thinknx
- Porta: sempre 48883
- Rete Wi-Fi
- Nome: nome della rete Wi-Fi
- Sicurezza: sempre WPA2-PSK
- Password: password della rete Wi-Fi
- Al termine di questa fase di configurazione:
- La configurazione dell’Home Gateway è completata correttamente se il LED dell’Home Gateway è bianco fisso
- Premere quindi il pulsante Continua per procedere con la configurazione utilizzando il tool Thinknx Configurator
Opzione 2 – Configurazione tramite Thinknx Up
- Abilitare la configurazione Gewiss nell’app Thinknx Up
- Andare in Settings → App → Thinknx Up → Show Gewiss settings
- Aprire l’app Thinknx Up
- Accedere al menu Settings
- Scorrere fino in fondo e selezionare Start Gewiss System Configuration
- Tenere premuto il pulsante di programmazione dell’Home Gateway per 4 secondi finché il LED inizia a lampeggiare
- Attendere che il lampeggio si interrompa per completare l’associazione
- Inserire il nome della rete Wi-Fi (SSID), rispettando maiuscole e minuscole
- Inserire la password Wi-Fi
- Selezionare il tipo di sicurezza (es. WPA2-PSK2)
- Abilitare Thinknx se disponibile
- Inserire l’indirizzo IP del server Thinknx
Creazione impianto Gewiss Smart Home in Thinknx
Aggiungere nel menu System l’oggetto Gewiss Home Gateway.
Avviare la configurazione del gateway: fare clic sul pulsante con i tre puntini.
Fare clic sul pulsante Aggiungi.
Definire il nome: inserire nel campo Nome il nome del proprio impianto Smart Home (es.: My Home). Fare clic sul pulsante con i tre puntini nel campo di configurazione.
Fare clic sulla scheda Configurazione.
Nel campo Impianto selezionare il mac-address dell’Home Gateway (selezionare il mac-address del proprio Home Gateway dalla lista).
Nel campo Modalità selezionare:
- Local: quando si vuole creare la configurazione della rete ZigBee da zero (creazione rete, binding, ecc.)
- Cloud: quando si vuole caricare una configurazione ZigBee già creata tramite app Home Gateway e migrata su Thinknx (verrà richiesto l’account per accedere all’impianto)
Di seguito sono riportati i passaggi per migrare un impianto configurato con l’app Home Gateway su Thinknx:
- Dal menu dell’app Home Gateway selezionare Manage the Home
- Selezionare Managing the gateway
- Selezionare Configure the gateway
- Selezionare ThinKnx parameters
- Premere Modifying the parameters
- Seguire le istruzioni fornite dall’app
Fare clic sul pulsante Ottieni Configurazione.
A questo punto è possibile avviare la configurazione della rete ZigBee (creazione rete, definizione binding, ecc.), come descritto nel capitolo successivo:
Schede di configurazione
Canali La scheda Canali elenca tutti i dispositivi ZigBee aggiunti al progetto.
Rete La scheda Rete consente la creazione della rete ZigBee durante la prima messa in servizio oppure l’aggiunta di dispositivi ZigBee in una fase successiva (ad es. manutenzione).
- Apri Rete – apre la rete ZigBee (Coordinator) e consente ai dispositivi ZigBee di unirsi; i dispositivi associati vengono elencati nella finestra di destra
- Chiudi Rete – chiude la rete ZigBee (Coordinator)
- Elenco dispositivi annunciati – elenca tutti i dispositivi associati alla rete
- Aggiungi Dispositivi – aggiunge al progetto tutti i dispositivi selezionati nella finestra di destra; i dispositivi aggiunti vengono quindi elencati nella finestra di sinistra
Funzioni speciali per la gestione dei dispositivi ZigBee: Le seguenti funzioni vengono attivate facendo clic con il tasto sinistro su un dispositivo specifico:
- Identify – attiva il dispositivo per identificarlo sul campo
- Copia – copia negli appunti le seguenti informazioni del dispositivo: ID, codice IEEE, Modello
- Rinomina – rinomina il dispositivo
- Rimuovi – rimuove il dispositivo dal progetto mantenendolo associato alla rete ZigBee
- Ripristina – ripristino alle impostazioni di fabbrica; il dispositivo viene rimosso anche dalla rete ZigBee
- Aiuto – apre il browser predefinito sul sito Gewiss relativo al dispositivo ZigBee selezionato
Facendo clic sull’icona della lente, viene attivata la funzione Identifica dispositivi.
Quando un dispositivo ZigBee viene attivato sul campo (ad esempio premendo il pulsante locale di un dimmer), il dispositivo corrispondente nella finestra di sinistra viene evidenziato. La funzione si interrompe facendo nuovamente clic sull’icona della lente.
Parametri Questa scheda consente di definire e modificare i parametri dei dispositivi ZigBee inclusi nel progetto. I valori dei parametri definiscono il comportamento del dispositivo.
Nella finestra di sinistra sono elencati tutti i dispositivi ZigBee. Nella finestra centrale vengono mostrati i parametri del dispositivo selezionato.
- Elenco Parametri – carica i parametri dal dispositivo ZigBee selezionato
- Salva – salva i parametri modificati
Nella finestra di destra è possibile inviare comandi direttamente al dispositivo selezionato.
Esempio: per un Dimmer sono disponibili i seguenti comandi:
- On – accende il dimmer
- Off – spegne il dimmer
- DimTo – imposta il livello di illuminazione (valore compreso tra 0 e 1; 0,2 = 20%)
Per i sensori (sensore acqua, sensore porta, sensore di movimento, ecc.) non è possibile inviare comandi, ma in questa scheda è possibile definire direttamente gli attuatori per le condizioni di allarme ON e OFF.
La finestra è suddivisa in due sezioni:
- Comportamento – definisce il comportamento del sensore
- Canali Collegati – attuatori comandati quando l’allarme è ON o OFF
Esempio: Se vengono impostati Comportamento quando Vero = 0 e Comportamento quando Falso = 1, e il canale collegato controlla la valvola dell’acqua, la valvola si apre quando viene rilevata una perdita d’acqua e si chiude quando l’allarme termina.
Bindings I binding consentono ai dispositivi ZigBee di scambiarsi direttamente comandi ZigBee.
Esempio: per controllare una luce tramite un pulsante ZigBee, è necessario creare un binding tra il pulsante e l’attuatore.
- Cerca
- Identificare il comando premendo il pulsante fisico
- Il nome del comando appare nella finestra di sinistra
- Gli attuatori compatibili vengono elencati nella finestra centrale
- Selezionare uno o più attuatori
- Selezionare il tipo di comando
- Fare clic su Aggiungi per creare il binding
Dopo la creazione:
- Il binding creato viene mostrato nella finestra in basso a sinistra
- Tutti i binding vengono elencati nella finestra di destra (solo eliminabili)
- Fare clic su Stop quando tutti i binding sono stati definiti
Smart Plate Questa scheda viene utilizzata per configurare le Smart Plate.
Per aggiungere una Smart Plate:
- Inserisci – identificare la Smart Plate digitando il suo ID (riportato sulla piastra)
- Cerca – metodo consigliato:
- Coprire il sensore di prossimità per almeno 5 secondi
- La Smart Plate viene identificata
- Fare clic su Stop
Per configurare la Smart Plate:
- Configura – apre la finestra di configurazione, che consente di configurare tutte le funzioni e i parametri della Smart Plate
- Lista – definisce la composizione dei dispositivi installati all’interno della Smart Plate
- Partendo da sinistra, i dispositivi della Smart Plate devono essere selezionati tra quelli elencati nella finestra di sinistra
- Cerca – identifica i dispositivi collegati premendo i pulsanti locali
- Partendo da sinistra, è sufficiente «premere» (pulsante locale) di ciascun dispositivo collegato incluso nella Smart Plate
- Se sono presenti dispositivi «tradizionali» è necessario specificarlo
- Le icone dei dispositivi collegati non possono essere modificate (dipendono dalla funzione del dispositivo)
- Shift – consente di definire i comandi associati alla funzione Shift della Smart Plate:
- Fare clic su ciascun «device» (un device può avere uno o due pulsanti, vedere il simbolo [+]) per definire l’attuatore da comandare e il comando da inviare; nell’esempio seguente è definito l’invio di un comando ON alla Smart Plug tramite il primo pulsante a sinistra:
- Per definire le icone visualizzate quando la funzione Shift è attiva, fare clic su ciascuna icona e selezionare l’icona desiderata dalla libreria proposta:
- Proprietà – definisce il comportamento della Smart Plate (lingua, colore della striscia LED, visualizzazione in standby)
- Impostazioni Allarmi – definisce gli allarmi visualizzati sulla Smart Plate:
- Flooding – quando uno dei sensori acqua rileva una perdita d’acqua
- Window – quando uno dei sensori finestra rileva una finestra aperta
- Movement – quando uno dei sensori di movimento rileva un movimento
- Smoke – quando uno dei sensori fumo rileva la presenza di fumo
- Connectivity – quando uno dei dispositivi ZigBee presenta problemi di connettività
I messaggi di allarme possono essere visualizzati su tutte le Smart Plate oppure solo su quelle selezionate.
Batteryless Questa scheda consente di definire i comandi inviati dai pulsanti Batteryless.
- Aggiungi – aggiunge un pulsante Batteryless
- Nella finestra in basso a sinistra viene riportato il «binding creato»
- Nella finestra di destra vengono riportati tutti i «binding creati»; è possibile modificare/eliminare ciascuno
Per configurare un pulsante Batteryless:
- Inserire il QR-Code associato al pulsante Batteryless
- Leggere con lo Smartphone il QR-Code applicato sul retro del pulsante Batteryless
- Riportare il Qr-Code nel campo denominato «Qr-Code»
- Selezionare se configurarlo come pulsante a 4 o a 2 tasti
- Assegnare un nome al pulsante Batteryless
- Configurare ciascun singolo pulsante (A0, A1, B0, B1) definendo l’attuatore da comandare (es. Light) e il comando da inviare (es.: Toggle)
Diagnostica Questa scheda viene utilizzata principalmente per operazioni di manutenzione.
- Ripristina Dispositivi – ripristino alle impostazioni di fabbrica di uno o di tutti i dispositivi
- Replace device – sostituzione di un dispositivo guasto
Associazioni per Thinknx Up e KNX
Questa sezione descrive come creare associazioni tra oggetti Thinknx e oggetti Gewiss Connected Smart Home.
Gli oggetti Thinknx rappresentano un collegamento logico ai dispositivi Gewiss Smart Home e devono essere utilizzati ogni volta che dati Smart Home (comandi, stati, misure) sono necessari all’interno delle funzioni Thinknx, come ad esempio: data logging, scene e funzioni logiche.
Per creare le associazioni:
- Andare in Sistema
- Selezionare Gewiss Home Gateway
- Selezionare l’Hub desiderato
Le sezioni seguenti consentono l’assegnazione dei dispositivi Gewiss Smart Home a Thinknx e agli indirizzi di gruppo KNX.
Luci
Questa sezione consente di definire oggetti Thinknx associati ai dispositivi luce Smart Home.
- Fare clic sui tre puntini alla fine della riga Lights
- Selezionare Aggiungi
Definire i seguenti parametri:
- Nome – nome dell’oggetto Thinknx
- Dispositivo – selezionare il dispositivo luce Smart Home
- Gateway KNX – abilitare per collegare l’oggetto a un indirizzo KNX
- Tipo Lampada – On/Off, Dimmer, Any
- Gruppo Comando KNX e stato – indirizzi di gruppo KNX collegati all’oggetto
Termostati
Questa sezione consente di definire oggetti Thinknx associati ai termostati Smart Home.
- Fare clic sui tre puntini alla fine della riga Thermostats
- Selezionare Aggiungi
Definire i seguenti parametri:
- Nome – nome dell’oggetto Thinknx
- Dispositivo – selezionare il termostato Smart Home
- Gateway KNX – abilitare per collegare l’oggetto a un indirizzo KNX
- Gruppi KNX – indirizzi di gruppo KNX collegati all’oggetto
Oscuranti
Questa sezione consente di definire oggetti Thinknx associati ai dispositivi tapparella Smart Home.
- Fare clic sui tre puntini alla fine della riga Shutters
- Selezionare Aggiungi
Definire i seguenti parametri:
- Nome – nome dell’oggetto Thinknx
- Dispositivo – selezionare il dispositivo tapparella Smart Home
- Gateway KNX – abilitare per collegare l’oggetto a un indirizzo KNX
- Gruppi KNX – indirizzi di gruppo KNX collegati all’oggetto
Valori Analogici
Questa sezione consente di definire oggetti Thinknx associati a valori Smart Home (stati, misure, allarmi, ecc.).
- Fare clic sui tre puntini alla fine della riga Analog values
- Selezionare Aggiungi
Definire i seguenti parametri:
- Nome – nome dell’oggetto Thinknx
- Dispositivo – selezionare il dispositivo Smart Home
- Proprietà monitorata – selezionare il valore da associare (stato, misura, allarme)
- Gateway KNX – abilitare per collegare l’oggetto a un indirizzo KNX
- Valore e Feedback KNX – indirizzi di gruppo KNX collegati all’oggetto
Assegnazione oggetti per il controllo
Questa sezione descrive come visualizzare e controllare gli oggetti Gewiss Smart Home nelle pagine di supervisione Thinknx.
Passi generali:
- Aggiungere un oggetto grafico Thinknx alla pagina di supervisione
- Associare l’oggetto Thinknx corrispondente
- Configurare i parametri dell’oggetto
Controllo di una luce ON/OFF
- Aggiungere Lampada alla pagina di supervisione
- Configurare i parametri:
- Tipo di accensione – ON/OFF normalmente aperto
- Tipo bus – Gewiss Smart Home
- Hub – selezionare l’Home Gateway
- Luce – selezionare l’oggetto luce Thinknx
Controllo di una luce dimmerabile
- Aggiungere Lampada alla pagina di supervisione
- Configurare i parametri:
- Tipo di accensione – Dimmer
- Tipo bus– Gewiss Smart Home
- Hub – selezionare l’Home Gateway
- Luce – selezionare l’oggetto dimmer Thinknx
Controllo di una tapparella
- Aggiungere Motorizzazioni alla pagina di supervisione
- Configurare i parametri:
- Tipo bus – Gewiss Smart Home
- Hub – selezionare l’Home Gateway
- Oscurante – selezionare l’oggetto tapparella Thinknx
Controllo di un termostato
- Aggiungere Chronotermostato alla pagina di supervisione
- Configurare i parametri:
- Tipo bus – Gewiss Smart Home
- Hub – selezionare l’Home Gateway
- Chronotermostato – selezionare l’oggetto termostato Thinknx
Visualizzazione di un valore
Consente la visualizzazione di misure, allarmi o valori di stato.
- Aggiungere Valore Analogico alla pagina di supervisione
- Configurare i parametri:
- Sorgente Dato – Gewiss Smart Home
- Hub – selezionare l’Home Gateway
- Valore – selezionare l’oggetto analogico Thinknx
I valori possono essere analogici (es. temperatura) oppure binari (es. allarme).
Scrittura di un valore parametro
Scrittura di un valore parametro su un dispositivo Gewiss Smart Home. Per scrivere un valore parametro:
- Aggiungere Comando Generico alla pagina di supervisione
- Definire i parametri associati a questo oggetto
- Comando – selezionare il dispositivo Gewiss Smart Home e quindi il valore (es. parametro) da scrivere
Facendo clic sulla proprietà Comando, il configuratore aiuta a identificare il valore da scrivere utilizzando un semplice albero di navigazione, che consente di esplorare tutti gli oggetti definiti nel sistema.
Seguire questi passaggi:
- Selezionare il Gewiss Home Gateway a cui appartiene il dispositivo desiderato
- Selezionare il dispositivo desiderato (nell’esempio, un termostato)
- Selezionare il parametro del dispositivo da scrivere (nell’esempio, il parametro Imposta Stagione, che definisce come opera l’algoritmo del termostato:
- Inverno per raffrescamento
- Estate per riscaldamento)
Con questo approccio è possibile definire un pulsante di comando generico (in una pagina di supervisione) per impostare la modalità operativa del termostato su raffrescamento (estate) o riscaldamento (inverno).
Comandi tra Home Gateway differenti
Un server Thinknx può gestire più di un Home Gateway. Come per altri protocolli e sistemi gestiti da Thinknx, è possibile utilizzare un comando proveniente da un dispositivo collegato a un Home Gateway (es. un pulsante) per controllare un dispositivo o un’azione appartenente a un Home Gateway differente.
Ad esempio: un pulsante connesso (es. GWA1241) appartenente a un Home Gateway può comandare:
- un attuatore connesso (es. GW10826),
- oppure attivare un’altra azione (es. visualizzare un messaggio su una Smart Plate)
appartenente a un altro Home Gateway.
Allo stesso modo, un pulsante connesso può comandare qualsiasi attuatore tramite altri protocolli (es. KNX, Modbus, ecc.).
L’oggetto utilizzato per questo scopo è l’oggetto Gateway Generico.
I passaggi sono:
- Definire un oggetto Thinknx associato al pulsante desiderato della Gewiss Smart Home (es. comando ausiliario, pulsante connesso, pulsante batteryless connesso)
- Definire un oggetto Universal Gateway attivato dal comando connesso e configurare, come azione, l’attuazione desiderata su un dispositivo appartenente a un altro Home Gateway
Esempio: comando tra due Home Gateway differenti
In questo esempio, quando viene premuto un pulsante cablato a un ingresso ausiliario di un dispositivo connesso, viene visualizzato un messaggio su una Smart Plate appartenente a un altro Home Gateway.
Step 1 – Definizione dell’oggetto Valore Analogico
Definire un oggetto Thinknx Valore Analogico associato all’ingresso ausiliario del dispositivo connesso a cui è collegato il pulsante.
Configurare i seguenti parametri:
- Nome – nome dell’oggetto
- Dispositivo – selezionare il dispositivo connesso e l’ingresso ausiliario utilizzato per il comando (nell’esempio: ingresso ausiliario 1 del dispositivo “Light”)
- Proprietà monitorata – selezionare la proprietà che attiva il comando (per questo esempio è sufficiente Stato Acceso/Spento)
- Tipo di Dato KNX – definire il tipo dato utilizzando i tipi dato KNX (in questo esempio il valore è un comando, quindi Booleano è appropriato)
- Gruppo Valore KNX – non utilizzato in questo esempio
- Gruppo Feedback KNX – indirizzo di gruppo KNX associato a questo comando
Ogni volta che il pulsante viene premuto o rilasciato, viene inviato un telegramma su questo indirizzo KNX:
- valore 1 quando il pulsante è premuto
- valore 0 quando il pulsante è rilasciato
Questo indirizzo KNX verrà utilizzato per attivare l’oggetto Universal Gateway definito nel passaggio successivo.
Step 2 – Definizione dell’oggetto Universal Gateway
Definire l’oggetto Gateway Generico che attiva l’azione desiderata su un dispositivo appartenente a un altro Home Gateway (nell’esempio: visualizzazione di un messaggio su una Smart Plate).
- Andare nella sezione Sistema
- Aggiungere un oggetto Gateway Generico
Un singolo oggetto Universal Gateway può gestire fino a tre azioni indipendenti. In questo esempio viene utilizzata una sola azione: C1.
Step 3 – Configurazione dei parametri del Universal Gateway
Configurare l’oggetto Universal Gateway come segue:
- Nome – nome dell’oggetto Universal Gateway
- Gruppo KNX – indirizzo di gruppo KNX su cui viene ricevuto il telegramma di attivazione (nell’esempio: 6/6/6, lo stesso indirizzo utilizzato dall’oggetto Analog Value)
- Tipo di Dato – definire il tipo dato utilizzando i tipi dato KNX (in questo esempio: Booleano)
- C1 Abilitazione – abilitare l’azione C1
- C1 Comando – selezionare il comando/azione da eseguire (nell’esempio: visualizzare il messaggio “Buongiorno” scorrevole da sinistra verso destra su una Smart Plate, con la striscia LED lampeggiante verde a 1 Hz)
Configurare la condizione di attivazione:
- C1 Condizione – selezionare Invia se uguale
- C1 Parametri condizione – impostare il valore a 1
Con questa configurazione, il messaggio viene visualizzato sulla Smart Plate quando il valore ricevuto dall’indirizzo KNX 6/6/6 è 1, ovvero quando il pulsante collegato all’ingresso ausiliario viene premuto.
Aggiornamento OTA dei dispositivi
Dopo aver distribuito il progetto, in locale o cloud, aprire il client di ThinKNX.
Selezionare se caricare su locale o cloud con una delle voci presentate nell’immagine successiva.
Se il progetto si carica su cloud inserire la seriale del server e la password del cloud.
Se il progetto si carica in locale inserire l’URL Configurator, visualizzabile sul Configuratore, preceduto da http: (vedere l’esempio in figura in cui viene mostrato prima l’URL sul Configuratore e poi come inserirlo sul client).
Caricato il progetto, aprirlo e premere sulle funzioni che sono state create sul Configurator.
Scorrere verso il basso fino a raggiungere la voce impostazioni, al fianco della quale sono presenti i tre punti, e premere su questi ultimi.
Nella pagina che si apre in seguito premere su gestore OTA ed effettuare il login.
Si visualizzano tutti gli impianti presenti sul server.
Selezionare l’impianto e i dispositivi che si vogliono aggiornare dell’impianto scelto.
N.B. Se sull’impianto non sono presenti dispositivi da aggiornare verrà visualizzata la scritta “Nessun dispositivo trovato”.
- it/gw_manager.txt
- Ultima modifica: 2026/05/21 10:49
- da francesco








































































