Interfaccia Web del Server Thinknx

L'interfaccia web del server Thinknx permette di gestire, configurare e monitorare il dispositivo attraverso un normale browser, senza utilizzare software aggiuntivi.

Attraverso questa interfaccia è possibile consultare le informazioni del server, modificare le impostazioni di rete, gestire le licenze, configurare i servizi cloud, effettuare aggiornamenti e utilizzare gli strumenti di diagnostica.

Le funzionalità disponibili possono variare in base al modello del server, alla versione firmware installata e alle licenze attive.

Per accedere all'interfaccia web è necessario conoscere l'indirizzo IP del server Thinknx.

Collegare il computer alla stessa rete locale del server e aprire un browser.

Inserire l'indirizzo IP del dispositivo nella barra degli indirizzi.

A partire dal firmware 1.1.10.25 è disponibile la nuova interfaccia web tramite HTTPS sulla porta 443.

È inoltre disponibile l'interfaccia web precedente tramite HTTP sulla porta 5051.

Gli indirizzi IP riportati sono esclusivamente esempi e devono essere sostituiti con l'indirizzo effettivo del server.

Per accedere alle impostazioni è necessario effettuare il login utilizzando le credenziali del server.

Una volta autenticati, nella parte superiore della pagina vengono visualizzati:

• Nome dell'utente connesso.
• Data e ora dell'ultimo accesso.
• Pulsante per la modifica della password.
• Pulsante per effettuare il logout.

L'interfaccia web è organizzata attraverso un menu principale situato nella parte superiore della pagina.

Le principali sezioni disponibili sono:

La pagina Home fornisce una panoramica del dispositivo e permette di accedere rapidamente alle principali funzionalità.

È suddivisa in diverse aree.

La sezione Collegamenti permette di accedere direttamente alle seguenti funzionalità:

• Carica configurazione: apre la pagina dedicata al caricamento del progetto e alla gestione delle impostazioni.
• Rete e KNX: permette di configurare i parametri di rete e la connessione al bus KNX.
• Lingua: permette di modificare la lingua dell'interfaccia web.
• Bus Monitor: apre lo strumento di monitoraggio del traffico KNX.

La sezione Manutenzione permette di eseguire operazioni di riavvio e spegnimento.

Sono disponibili tre comandi:

Nella parte inferiore della Home viene visualizzato un riepilogo delle informazioni principali del dispositivo.

Tra queste:

• Intestatario della licenza.
• Numero di serie.
• Server ID.
• Indirizzo MAC.
• Versione firmware.
• Numero massimo di client.

Queste informazioni possono essere richieste dal supporto tecnico Thinknx per identificare il dispositivo e verificare la compatibilità delle funzionalità disponibili.

La sezione Config permette di caricare una nuova configurazione, esportare le impostazioni del server ed eseguire operazioni di pulizia e ripristino.

Le principali operazioni disponibili sono:

• Caricamento di una nuova configurazione generata tramite Thinknx Configurator.
• Download del backup delle impostazioni.
• Eliminazione delle impostazioni del Configurator.
• Eliminazione delle impostazioni utente.
• Ripristino delle impostazioni di fabbrica.

Questa funzione permette di caricare nel server una nuova configurazione generata attraverso un'esportazione dedicata dal software Thinknx Configurator.

Per procedere:

1. Aprire il progetto in Thinknx Configurator.
2. Utilizzare il comando di esportazione dedicato al caricamento della configurazione sul server.
3. Salvare il file generato sul computer.
4. Accedere alla sezione Config dell'interfaccia web.
5. Premere Seleziona file e individuare il file precedentemente esportato.
6. Premere Upload per avviare il trasferimento.
7. Attendere il completamento della procedura e verificare il messaggio di conferma.

Il caricamento può essere effettuato anche attraverso le funzionalità di distribuzione del Thinknx Configurator.

Il pulsante Download permette di scaricare un backup delle impostazioni memorizzate nel server.

Il file contiene informazioni relative alla configurazione del dispositivo, come scenari, automazioni e altre impostazioni.

Il backup può inoltre essere inviato al supporto tecnico Thinknx per consentire un'analisi delle impostazioni e recuperare eventuali informazioni utili alla diagnosi di problematiche.

Il comando Elimina impostazioni configurator elimina le impostazioni degli scenari derivate dal progetto caricato.

Questa operazione comporta un riavvio del server.

Il comando Elimina impostazioni utente elimina le impostazioni personalizzate dall'utente, come schedulazioni, scenari e dati di partenza.

Questa operazione comporta un riavvio del server.

Il pulsante Ripristino di fabbrica permette di eliminare tutte le impostazioni e il progetto memorizzati nel dispositivo, riportando il server allo stato di fabbrica.

L'operazione comporta un riavvio completo del server.

Il menu Server contiene le principali impostazioni di configurazione e amministrazione del dispositivo.

Le sezioni disponibili comprendono:

• Stato.
• Access Control.
• Licenze & Codici
• Utenti.
• Network & KNX.
• Aggiornamenti.
• Data e ora.
• Controllo vocale.
• ThinknxCloud.
• Integration Kit.
• Stato memoria.
• Lingua.

Le sezioni seguenti descrivono le principali funzionalità disponibili.

La sezione Stato permette di consultare le informazioni relative al dispositivo e al suo funzionamento.

Le informazioni visualizzate comprendono:

• Intestatario della licenza.
• Numero di serie.
• Server ID.
• Indirizzo MAC.
• Versione software.

• Numero massimo di client supportati.
• Numero attuale di client connessi.
• Codice dell'ultimo client connesso.
• Indirizzo IP dell'ultimo client connesso.
• Tempo trascorso dall'avvio del server.
• Tempo trascorso dall'avvio del processo.
• Data e ora della configurazione caricata.

Quando disponibili, vengono visualizzati anche:

• Numero di PBX registrati.
• Stato della connessione VNC.
• Temperatura.
• Umidità.
• Luminosità.

Il pulsante Calibra sensore permette di accedere alla calibrazione dei sensori disponibili.

Nella parte inferiore della pagina è presente l'elenco delle funzionalità abilitate sul dispositivo.

Le licenze disponibili dipendono dalla configurazione commerciale del server.

La sezione Access Control permette di gestire i codici utilizzati dalle funzionalità di controllo accessi.

È possibile:

• Visualizzare i codici esistenti.
• Creare nuovi codici.
• Modificare o eliminare i codici.
• Assegnare un ruolo.
• Configurare un intervallo di validità.
• Applicare una tabella oraria.
• Assegnare aree aggiuntive.
• Esportare i codici.

La tabella dei codici permette di consultare lo stato e le proprietà di ciascun elemento.

La sezione License & Code permette di gestire i codici di licenza e i client autorizzati a connettersi al server.

I codici di licenza abilitano le funzionalità disponibili sul server Thinknx.

La pagina permette di visualizzare i codici installati e aggiungere nuove licenze.

Per aggiungere una licenza:

1. Richiedere il codice di licenza a Thinknx fornendo le informazioni identificative del server.
2. Inserire il codice nell'apposito campo.
3. Premere Aggiungi licenza.

Ogni client autorizzato alla connessione è identificato da un codice.

La sezione permette di:

• Visualizzare i client registrati.
• Abilitare o disabilitare i codici.
• Modificare la descrizione.
• Gestire le proprietà disponibili.
• Eliminare i codici non più necessari.
• Aggiungere nuovi codici client.

La pagina visualizza inoltre il numero massimo di client abilitati e le informazioni relative all'ultimo client connesso.

La sezione Push Notification permette di inviare una notifica push agli utenti abilitati.

Questa funzionalità può essere utilizzata per comunicare informazioni agli utenti attraverso i dispositivi client associati al server.

La sezione Utenti permette di gestire gli utenti autorizzati all'accesso e alla gestione dell'impianto.

La sezione Network & KNX permette di configurare la connettività del server e le impostazioni relative al bus KNX.

La pagina è suddivisa in diverse aree.

La prima sezione mostra le impostazioni di rete attualmente utilizzate.

Tra queste:

• Stato del client DHCP.
• Indirizzo IP.
• Subnet Mask.
• Indirizzo Gateway.
• DNS primario.
• DNS secondario.

È possibile abilitare DHCP oppure configurare manualmente i parametri di rete.

In caso di configurazione manuale, inserire i valori richiesti e premere Salva cambiamenti alla rete.

La pagina permette di abilitare o disabilitare l'interfaccia Wi-Fi del dispositivo.

Dopo aver modificato l'impostazione, premere Salva cambiamenti rete wifi.

La prima abilitazione potrebbe richiedere un riavvio completo del dispositivo.

La sezione Diagnostica rete permette di verificare lo stato della connessione e la raggiungibilità dei servizi necessari al funzionamento del server.

Scorrere fino alla sezione Diagnostica rete e premere il pulsante Controlla stato.

Si aprirà la pagina dedicata alla verifica delle connessioni e dei servizi di rete.

Premere Verifica rete per avviare i controlli.

La diagnostica verifica i seguenti servizi:

• Connessione ethernet: verifica la risoluzione della rete esterna, prerequisito essenziale per i servizi cloud.
• Thinknx Cloud: verifica la connettività verso i servizi Thinknx Cloud.
• Connessione client remoto: verifica la raggiungibilità del server da Internet sulla porta client.
• Assistenza remota: verifica la disponibilità del servizio utilizzato dal personale tecnico Thinknx.
• Manutenzione remota: verifica la connettività necessaria al servizio di manutenzione remota.
• Risoluzione DNS esterna: verifica che il MyThinknx ID punti all'indirizzo IP pubblico attuale del server.

Al termine della verifica, ogni servizio viene identificato da un indicatore colorato che ne rappresenta lo stato.

• Verde – OK: il servizio è raggiungibile e funziona correttamente.
• Giallo – Warning: sono state rilevate alcune anomalie di connettività. La diagnostica indica le porte o i servizi non raggiungibili. Queste anomalie non compromettono necessariamente tutte le funzionalità del server.
• Rosso – Errore: la connettività necessaria non è disponibile e le funzionalità interessate non possono essere utilizzate.

Per maggiori informazioni sulla verifica della connettività necessaria alla manutenzione remota, consultare:

Manutenzione Remota

La sezione permette di configurare la modalità di utilizzo delle impostazioni KNX.

Sono disponibili:

• Sovrascritte: utilizza le impostazioni definite direttamente nell'interfaccia web.
• Da progetto: utilizza le impostazioni provenienti dal progetto Thinknx Configurator.

Le impostazioni disponibili comprendono l'indirizzo fisico KNX e l'abilitazione dell'interfaccia KNXnet/IP.

Dopo aver effettuato le modifiche, premere Salva cambiamenti imp. KNX.

Per una spiegazione completa della configurazione dell'interfaccia KNXnet/IP, consultare:

Configurazione dell'interfaccia KNXnet/IP

La sezione VNC permette di abilitare o disabilitare il servizio VNC del dispositivo.

Il servizio consente di accedere remotamente all'interfaccia grafica del server attraverso un client VNC.

La porta utilizzata è:

5900 TCP

Per modificare lo stato del servizio:

1. Selezionare Avvia VNC oppure Ferma VNC.
2. Premere Salva cambiamenti VNC.

La sezione Aggiornamenti permette di verificare la disponibilità di nuove versioni software per il server Thinknx.

Per verificare gli aggiornamenti disponibili:

1. Accedere alla sezione Aggiornamenti.
2. Verificare che il server disponga di una connessione Internet funzionante.
3. Premere Verifica aggiornamenti.
4. Attendere il completamento della ricerca.

Se sono disponibili aggiornamenti compatibili, sarà possibile procedere seguendo le indicazioni visualizzate.

La sezione Data e ora permette di configurare l'orologio interno del server.

La pagina mostra:

• Fuso orario corrente.
• Ora attuale.
• Data attuale.
• Stato della sincronizzazione Internet.
• Server NTP configurato.

È possibile abilitare la sincronizzazione automatica tramite un server NTP.

Per configurarla:

1. Abilitare la sincronizzazione Internet.
2. Selezionare il fuso orario.
3. Inserire l'indirizzo del server NTP.
4. Salvare le modifiche.

Quando la sincronizzazione automatica non viene utilizzata, è possibile inserire manualmente:

• Ora.
• Minuti.
• Giorno.
• Mese.
• Anno.

Premere Salva cambiamenti per applicare i nuovi valori.

La sezione Controllo vocale permette di gestire le integrazioni del server Thinknx con gli assistenti vocali.

Le integrazioni comprendono:

• Apple HomeKit: visualizzazione del codice di associazione, gestione dell'abbinamento e ripristino del servizio.
• Amazon Alexa: visualizzazione dello stato dell'associazione e gestione dell'account collegato.
• Google Home: Soon to be available.

Per maggiori informazioni sulla configurazione e sull'utilizzo delle integrazioni vocali, consultare la guida dedicata:

Controllo vocale

La sezione ThinknxCloud permette di gestire i parametri del server associati ai servizi cloud Thinknx.

La pagina è suddivisa in tre aree principali:

• Configurazione e stato del servizio Cloud.
• Gestione degli utenti Thinknx Portal.
• Manutenzione Remota.

Per utilizzare i servizi ThinknxCloud è necessario effettuare una prima configurazione direttamente dall'interfaccia web del server.

Accedere alla sezione:

Server → ThinknxCloud

Premere il pulsante Abilita ThinknxCloud.

Durante la procedura verrà richiesto di inserire:

• Indirizzo email dell'installatore: indirizzo email da associare al servizio ThinknxCloud.
• Password del Cloud: password dedicata al server, utilizzata per il caricamento e la gestione dei progetti attraverso il Cloud.

Una volta completata la configurazione, il servizio Cloud verrà abilitato e saranno disponibili le relative impostazioni di gestione.

Una volta abilitato il servizio, la pagina mostra le impostazioni correnti.

Le informazioni disponibili comprendono:

• Stato dell'abilitazione Cloud.
• Stato della connessione Cloud.
• Indirizzo email associato.
• Stato di abilitazione MyThinknx.
• MyThinknx ID.
• Codice di sottoscrizione.
• Scadenza della sottoscrizione.
• Servizi disponibili.
• Stato dell'Integration Kit.
• Spazio utilizzato e disponibile.

Sono presenti diversi comandi per la gestione del servizio:

Questa sezione permette di associare nuovi utenti Thinknx Portal al server e consultare gli account già collegati.

Per associare un nuovo utente:

1. Premere Associa un utente.
2. Effettuare l'accesso al Thinknx Portal.
3. Completare la procedura di associazione.

Una volta associato, l'utente viene visualizzato nella tabella dedicata.

La pagina permette inoltre di consultare le informazioni degli utenti e rimuovere le associazioni esistenti.

La funzionalità Manutenzione Remota consente al System Integrator di stabilire un tunnel verso il server attraverso Internet.

Il tunnel permette di accedere all'interfaccia web del dispositivo e utilizzare ETS per effettuare operazioni di programmazione KNX da remoto.

La pagina permette di abilitare o disabilitare il servizio e consultare lo stato corrente della connessione.

La sezione Integration Kit permette di gestire il servizio dedicato all'integrazione con applicazioni e sistemi esterni.

Attraverso questa funzionalità è possibile utilizzare le interfacce di integrazione messe a disposizione dal server Thinknx.

Per la configurazione e l'utilizzo delle API, consultare la documentazione dedicata all'Integration Kit.

La sezione Stato memoria permette di verificare lo stato di salute della memoria interna del server Thinknx.

Premendo Avvia check memoria, il server esegue una procedura di verifica della memoria.

Questa funzione è utile per individuare eventuali problemi legati alla memoria interna del dispositivo.

La sezione Lingua permette di modificare la lingua utilizzata dall'interfaccia web.

Le lingue disponibili sono:

• English.
• Italiano.
• Deutsch.

Selezionare la lingua desiderata per modificare la visualizzazione delle pagine.

Il menu Riavvio permette di accedere alle operazioni di manutenzione del dispositivo.

Gli stessi comandi sono disponibili nella pagina Home.

Riavvia il software del server senza effettuare un riavvio completo del dispositivo.

Riavvia completamente il server Thinknx.

Durante questa operazione il dispositivo risulterà temporaneamente non raggiungibile.

Avvia la procedura di spegnimento del server.

Il menu Monitor permette di accedere agli strumenti di monitoraggio del server.

Selezionando KNX Bus Monitor è possibile visualizzare il traffico sul bus KNX e interagire direttamente con gli indirizzi di gruppo.

Il monitor è suddiviso in diverse aree.

La tabella principale mostra i telegrammi KNX rilevati.

Le informazioni visualizzate comprendono:

• Time: ora di ricezione del telegramma.
• Sender: indirizzo fisico del dispositivo mittente.
• Destination: indirizzo di gruppo di destinazione.
• Data: valore trasportato dal telegramma.

Il monitor aggiorna periodicamente i telegrammi visualizzati.

È inoltre presente un comando per cancellare i messaggi attualmente mostrati.

La sezione dedicata all'invio permette di scrivere o leggere valori sul bus KNX.

È possibile configurare:

• Indirizzo di gruppo.
• Lunghezza del dato.
• Tipo di dato.
• Opzioni disponibili.
• Valore da inviare.

I pulsanti Invia e Leggi permettono rispettivamente di inviare un telegramma o effettuare una richiesta di lettura.

La funzione KNX Recorder permette di abilitare il salvataggio dei telegrammi KNX.

La pagina visualizza:

• Stato del recorder.
• Dimensione del database.
• Spazio disponibile.

È possibile esportare i telegrammi registrati in formato XML compatibile con ETS.

I filtri disponibili permettono di selezionare:

• Periodo temporale.
• Indirizzo di gruppo di destinazione.
• Indirizzo fisico del dispositivo mittente.

Dopo aver configurato i parametri, premere Scarica log per ETS.

La sezione Log Monitor, accessibile dal menu Monitor, permette di visualizzare i log generati durante il funzionamento del server Thinknx.

Attraverso questa pagina è possibile consultare i messaggi di sistema e le informazioni relative alle operazioni eseguite dal server.

I log rappresentano uno strumento utile per verificare il comportamento del dispositivo e individuare eventuali anomalie durante il funzionamento dell'impianto.

Le informazioni visualizzate possono comprendere:

• Messaggi di sistema.
• Informazioni relative al funzionamento dei servizi.
• Eventuali errori o anomalie.
• Messaggi diagnostici generati durante l'esecuzione delle operazioni.

• Verificare che il server sia acceso e correttamente alimentato.
• Verificare che il computer sia collegato alla rete corretta.
• Controllare l'indirizzo IP utilizzato.
• Verificare la raggiungibilità del dispositivo tramite ping.
• Controllare che venga utilizzato il protocollo e la porta corretti.
• Verificare eventuali restrizioni di rete o firewall.

• Verificare il nuovo indirizzo IP configurato.
• Controllare che l'indirizzo appartenga alla rete corretta.
• Verificare subnet mask e gateway.
• Riaprire il browser utilizzando il nuovo indirizzo.

• Verificare la connessione Internet.
• Controllare la configurazione del gateway e dei DNS.
• Eseguire la diagnostica nella sezione Network & KNX.
• Verificare lo stato della connessione nella pagina ThinknxCloud.

• Verificare la connessione fisica al bus KNX.
• Controllare le impostazioni KNX nella sezione Network & KNX.
• Verificare che l'interfaccia KNXnet/IP sia abilitata, se necessaria.
• Consultare il KNX Bus Monitor per verificare il traffico.

• Verificare che la connessione Internet sia stabile.
• Controllare la versione firmware corrente.
• Verificare la compatibilità hardware del dispositivo.
• Non interrompere l'alimentazione durante l'aggiornamento.

In caso di anomalie durante il funzionamento del server, consultare la sezione:

Monitor → Log Monitor

Verificare la presenza di eventuali messaggi di errore o informazioni diagnostiche utili a individuare il problema.

Se il problema persiste, contattare il supporto tecnico Thinknx indicando il modello del server, il numero di serie, la versione firmware e una descrizione delle anomalie riscontrate.

Per approfondire le singole funzionalità, consultare le guide dedicate:

• Configurazione dell'interfaccia KNXnet/IP
• Manutenzione Remota
• Controllo vocale