it:gw_manager

Architettura di sistema e limiti

 Architettura di sistema

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)
  • Avviare l’app Home Gateway
  • Selezionare Configura nuova casa dal “menu hamburger” (in alto a destra)

 Avvio configurazione

 Avvio configurazione

  • Per identificare l’Home Gateway da configurare, seguire le istruzioni guidate dall’app e premere Continua

 Avvio configurazione

 Avvio configurazione

  • Premere Configura con Thinknx

 Avvio configurazione

  • 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

 Avvio configurazione

 Avvio configurazione

 Avvio configurazione

  • 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
  • Abilitare la configurazione Gewiss nell’app Thinknx Up
    • Andare in Settings → App → Thinknx Up → Show Gewiss settings

 Avvio configurazione

  • Aprire l’app Thinknx Up
  • Accedere al menu Settings
  • Scorrere fino in fondo e selezionare Start Gewiss System Configuration

 Impostazioni Gewiss

  • 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

 Impostazioni di rete

Creazione impianto Gewiss Smart Home in Thinknx

Aggiungere nel menu System l’oggetto Gewiss Home Gateway.

 Aggiunta Gewiss Home Gateway

Avviare la configurazione del gateway: fare clic sul pulsante con i tre puntini.

 Avvio configurazione gateway

Fare clic sul pulsante Aggiungi.

 Pulsante Add

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.

 Nome impianto

Fare clic sulla scheda Configurazione.

 Tab Configuration

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)

 Configurazione Plant e Mode

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

 Migrazione impianto

Fare clic sul pulsante Ottieni Configurazione.

 Request configuration

A questo punto è possibile avviare la configurazione della rete ZigBee (creazione rete, definizione binding, ecc.), come descritto nel capitolo successivo:

Canali La scheda Canali elenca tutti i dispositivi ZigBee aggiunti al progetto.

 Dispositivi ZigBee

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

 Creazione rete

  • Aggiungi Dispositivi – aggiunge al progetto tutti i dispositivi selezionati nella finestra di destra; i dispositivi aggiunti vengono quindi elencati nella finestra di sinistra

 Aggiunta dispositivi

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

 Azioni dispositivo

Facendo clic sull’icona della lente, viene attivata la funzione Identifica dispositivi.

 Identificazione sul campo

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.

 Dispositivo identificato

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%)

 Parametri dimmer

 Comandi dimmer

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.

 Parametri sensore

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

 Configurazione 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

 Elenco binding

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

 Rilevamento Smart Plate

Per configurare la Smart Plate:

  • Configura – apre la finestra di configurazione, che consente di configurare tutte le funzioni e i parametri della Smart Plate

 Configurazione 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

 Elenco moduli

  • 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)

 Localizzazione moduli

  • Shift – consente di definire i comandi associati alla funzione Shift della Smart Plate:

 Funzione Shift

  • 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:

 Comando Shift

 Panoramica Shift

  • Per definire le icone visualizzate quando la funzione Shift è attiva, fare clic su ciascuna icona e selezionare l’icona desiderata dalla libreria proposta:

 Selezione icona

  • 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.

 Impostazioni allarmi

 Visualizzazione allarmi

Batteryless Questa scheda consente di definire i comandi inviati dai pulsanti Batteryless.

  • Aggiungi – aggiunge un pulsante Batteryless

 Aggiunta pulsante

  • 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

 Binding pulsante

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

 QR code

  • 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)

 Pulsante 1

 Pulsante 2

 Pulsante 3

 Pulsante 4

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

 Diagnostica

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.

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

 Aggiunta luce

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

 Parametri luce

Questa sezione consente di definire oggetti Thinknx associati ai termostati Smart Home.

  • Fare clic sui tre puntini alla fine della riga Thermostats
  • Selezionare Aggiungi

 Aggiunta termostato

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

 Parametri termostato

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

 Aggiunta tapparella

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

 Parametri tapparella

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

 Aggiunta valore

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

 Parametri valore

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
  • 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 ON/OFF

  • 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 dimmer

  • 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 tapparella

  • 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

 Controllo termostato

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).

 Visualizzazione valore

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

 Comando generico

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).

 Selezione parametro

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

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.

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.

 Analog Value

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

 Universal Gateway

Un singolo oggetto Universal Gateway può gestire fino a tre azioni indipendenti. In questo esempio viene utilizzata una sola azione: C1.

 Azioni 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)

 Configurazione C1

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.

 Selezione modalità caricamento

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).

 URL Configurator

 Inserimento URL nel client

Caricato il progetto, aprirlo e premere sulle funzioni che sono state create sul Configurator.

 Apertura funzioni

Scorrere verso il basso fino a raggiungere la voce impostazioni, al fianco della quale sono presenti i tre punti, e premere su questi ultimi.

 Accesso impostazioni

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.

 Selezione dispositivi

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