Dopo la creazione del primo amministratore, il pannello di amministrazione propone la procedura guidata di configurazione nella finestra Your setup wizard is ready — fai clic su Start setup. La procedura ti accompagna nella messa in servizio: che tipo di progetto è, dove si trova, come raggiunge il bus KNX, quali servizi sono attivi e che cosa contiene l’edificio. Puoi anche aprirla in seguito con il pulsante Setup wizard della pagina System.
Come funziona la procedura guidata
- Nulla viene scritto sul server fino all’applicazione finale. Tutti i passi precedenti si limitano a preparare una bozza.
- La bozza resta dopo il ricaricamento della pagina — è conservata nel browser che stai usando, quindi puoi chiudere la pagina e tornare sullo stesso computer; le tue risposte sono ancora lì.
- Save & exit, nell’intestazione, esce dalla procedura e conserva la bozza per dopo. Skip setup — configure later, sotto l’elenco dei passi, esce dalla procedura e scarta la bozza. Entrambi portano alla pagina System.
- Spostati con Back e Continue. L’intestazione mostra l’avanzamento («Step 2 of 7» — il percorso ETS ha un passo in più, quindi arriva a 8).
Passo 1 — Modalità di configurazione
«How do you want to build this project?» Tre scelte:
- Import an ETS project (Fastest route) — carica il file
.knxprojdell’impianto e HyperVisu ricostruisce la supervisione a partire da ciò che ETS già conosce: edifici e locali diventano piani e locali, gli indirizzi di gruppo arrivano con nome e tipo, le funzioni ETS diventano dispositivi con i relativi oggetti di gruppo già assegnati. - Configure manually (No file needed) — descrivi tu stesso l’edificio. Indicato quando non c’è un progetto ETS a disposizione, o quando la supervisione non deve seguirlo.
- Restore a HyperVisu backup instead — un backup ripristina un server completo (locali, dispositivi, utenti e servizi), quindi il resto della procedura non serve. Choose a file non apre un selettore di file: esce dalla procedura e apre la pagina Backup & Restore, dove ripristini il file in Restore from file (vedi «Backup & Restore»). Lì non ti viene chiesta alcuna password né la selezione dei servizi — l’intero file viene ripristinato e sostituisce ciò che si trova sul server, compreso l’amministratore appena creato.
📘 Nota: Puoi cambiare idea più avanti — cambiando modalità torni al passo 4, perché le due schermate successive appartengono all’altro percorso. Ciò che hai inserito nel percorso abbandonato viene conservato, nel caso tu vi ritorni.
Passo 2 — Progetto e posizione
«Name the project and place it on the map.»
| Campo | Funzione |
|---|---|
| Project name | Come viene identificato questo impianto |
| Installer reference | Il tuo numero di progetto |
| App language | La lingua in cui si aprono le app mobile e web; ogni utente può cambiarla |
| City → Get coordinates | Scrivi la città e lascia che il server cerchi latitudine e longitudine |
| Latitude / Longitude | Compilate dalla ricerca, oppure inserite a mano |
| Timezone | L’orologio su cui funziona il server |
Le coordinate e il fuso orario determinano gli orari di alba e tramonto, le automazioni programmate e ogni marca temporale scritta dal server — impostali con precisione.
Passo 3 — Interfaccia bus KNX
«Connect to the bus.» La procedura cerca una volta sulla rete le interfacce KNX/IP all’apertura del passo ed elenca quelle che hanno risposto come schede con il nome dell’interfaccia, il tipo (Interface o Router), l’indirizzo e il numero di serie. Fai clic su Scan again per ripetere la ricerca.
Se nessuna risponde, oppure se l’interfaccia si trova su un’altra sottorete o dietro una VPN, usa Enter an address manually: digita l’indirizzo e la porta nello stesso campo, ad esempio 192.168.1.20:3671. Senza porta viene usata la 3671.
Imposta anche:
- Connection type — Tunnel (UDP, per un’interfaccia KNX/IP) o Multicast (per un router KNX/IP). Selezionando una scheda rilevata il tipo viene impostato automaticamente; per un indirizzo digitato a mano, impostalo tu.
- HyperVisu physical address — l’indirizzo individuale che il server stesso assume sul bus. È precompilato con
1.1.250e deve essere libero sul bus.
Il test di connessione. Fai clic su Run connection test per vedere fin dove arriva la connessione. Compaiono cinque risultati:
| Risultato | Che cosa indica |
|---|---|
| Host reachable | L’interfaccia risponde in rete (yes, con il tempo di risposta, oppure no). |
| Port 3671 / UDP | Se l’interfaccia ha risposto a una richiesta di descrizione. Può indicare not answered mentre il tunnel è aperto — alcune interfacce rispondono solo a una connessione reale. Non è un guasto. |
| Tunnel | Se è stato possibile aprire un tunnel (yes o no). |
| Assigned address | L’indirizzo che l’interfaccia ha assegnato al tunnel di prova. |
| Telegrams seen | Quanti telegrammi sono arrivati mentre il test ascoltava il bus. |
Quando il tunnel si apre, il pannello mostra Tunnel open e il piè di pagina riporta «Tunnel open — the bus answers.»
Un tunnel aperto dimostra la connessione; solo Telegrams seen dimostra un traffico reale sul bus. Una volta aperto il tunnel, il test resta in ascolto per circa cinque secondi, quindi 0 su un bus silenzioso non è un guasto. Per vedere del traffico, fai clic su Test again e aziona subito un interruttore a parete, mentre il test è in corso.
📘 Nota: Quando riesegui la procedura su un server già collegato al bus, il test non apre un secondo tunnel, perché ciò potrebbe interrompere la connessione in funzione. Segnala la connessione attiva e non conta alcun telegramma.
Se il tunnel non si apre, il pannello mostra No response e la procedura suggerisce di verificare tre cose: il tunnelling abilitato sull’interfaccia, nessun altro client ETS che occupi tutti i canali, e server e interfaccia sulla stessa VLAN.
Questo passo non blocca mai: puoi proseguire senza testare, oppure dopo un test fallito, e correggere la connessione in seguito.
Ancora nessun bus in cantiere? Fai clic su I'll configure KNX later. La procedura si applica senza connessione al bus — locali, dispositivi e servizi vengono creati normalmente, e tutto ciò che è associato al KNX resta inattivo finché non viene impostata un’interfaccia in Connections (vedi «Connections»).
Passo 4 — Servizi
«Which services should run?» Gli interruttori sono raggruppati in tre sezioni, le stesse della pagina Services. Ogni sezione riporta un’etichetta che indica quanto costa una modifica al suo interno:
| Sezione | Etichetta | Significato |
|---|---|---|
| Services | Changes need a restart | I servizi opzionali offerti da questo server, come il database dello storico, le dashboard, Node-RED, lo streaming delle telecamere e Home Assistant. Si avviano o si fermano solo al riavvio del server — la procedura propone il riavvio dopo l’applicazione (vedi «Final step — Review & apply» più sotto). |
| Communication protocols | Applied immediately | I protocolli con cui il server comunica con i dispositivi. |
| Application services | no restart needed | Meteo, prezzi dell’energia ed e-mail. |
Attivi per impostazione predefinita: i protocolli KNX e Virtual, e InfluxDB (il database dello storico). Il pulsante sopra le schede mostra quanti sono abilitati e ripristina questi valori predefiniti.
Una scheda con il badge API key needed richiede anche una chiave o delle credenziali: completale nella pagina Services dopo la procedura (vedi «Services & Protocols»).
Abilita solo ciò che questo progetto utilizza — ogni servizio costa memoria e tempo di avvio. Tutto può essere attivato in seguito da Services & protocols.
Percorso manuale — Struttura dell’edificio
(I passi 5–6 dipendono dalla modalità di configurazione. Questa schermata e la successiva compaiono nel percorso manuale.)
«List the floors and their rooms.»
- La procedura parte con un Ground floor (livello 0). Per aggiungere un altro piano, digita il nome nella riga Add a floor e premi Enter.
- Digita il nome di un locale e premi Enter per aggiungere il successivo — un locale per riga, alla velocità con cui riesci a scrivere.
- Per aggiungerne molti in una volta, usa Add several rooms at once: scegli il piano, digita i nomi separati da virgole («Bedroom 2, Bedroom 3, Dressing») e fai clic sul pulsante di aggiunta.
- Le icone sono facoltative per ora — l’app usa il nome del locale finché non ne imposti una.
- Fai clic su Continue to categories. Il pulsante resta disabilitato finché non c’è almeno un locale.
📘 Nota: La procedura non può impostare il livello di un piano. I piani sono numerati 0, 1, 2… nell’ordine in cui li aggiungi, quindi un seminterrato aggiunto qui riceve un livello positivo. Per dargli in seguito un livello negativo, apri Building → Floors, modifica il piano e cambia il Floor Number (vedi «Building Structure & Categories»).
Percorso manuale — Categorie
«Decide how the app groups devices.» Le categorie diventano i riquadri della schermata iniziale dell’app e i filtri di ogni locale; un dispositivo appartiene a una categoria e a un locale.
La procedura crea sette categorie predefinite: Lighting, Shutters, Heating, Sockets, Scenes, Energy, Security.
- Fai clic su un nome per rinominarlo.
- Rimuovi una categoria di cui il progetto non ha bisogno.
- Add a category tua (nome + icona), ad esempio «Home cinema».
Poi fai clic su Review everything per passare al passo finale (vedi «Final step — Review & apply» più sotto).
📘 Nota: Il percorso manuale non crea dispositivi. Aggiungili locale per locale dalla pagina Devices dopo la configurazione (vedi «The Devices Workspace»).
Percorso ETS — Selezione dell’importazione
(Questa schermata sostituisce quella precedente quando hai scelto «Import an ETS project».)
«Choose what to import.»
- Trascina il file
.knxproj(esportazione di un progetto ETS 5 o ETS 6) sull’area Drop the .knxproj file here, oppure fai clic su quell’area per scegliere il file. Non esiste un pulsante di sfoglia separato. - Se il progetto è protetto da password in ETS, inserisci la Project password e fai clic su Unlock and read. La password serve a leggere il file e non viene mai memorizzata.
- La procedura legge il progetto e propone tre parti selezionabili, ciascuna con i conteggi reali del tuo file:
- Building structure — i piani e i locali descritti dal progetto ETS («3 floors · 14 rooms»).
- Group addresses — la tabella completa degli indirizzi, così che il monitor del bus e il selettore di indirizzi conoscano ogni indirizzo per nome; vengono indicati i conteggi di tipizzati e non tipizzati.
- Devices from ETS functions — ogni funzione ETS diventa un dispositivo, già associato ai suoi indirizzi di gruppo.
- Deseleziona ciò che non vuoi e fai clic su Continue to categories. Lascia selezionata Building structure: senza di essa non ci sono locali sotto cui archiviare i dispositivi e dal progetto non viene creato nulla.
Il percorso ETS mostra poi la schermata Categories con le categorie prodotte dal progetto — una per ogni tipo di dispositivo descritto. Rinominale, cambia le icone o aggiungine una che il progetto non copre, come nella schermata Categories del percorso manuale. Una categoria ancora usata da dispositivi non può essere eliminata finché quei dispositivi non vengono spostati in un’altra categoria nella schermata di revisione. Fai clic su Review rooms and devices per passare alla revisione (vedi «ETS branch — Review import» più sotto).
Percorso ETS — Revisione dell’importazione
«Check what we found.» è il passaggio di correzione su tutto ciò che l’importazione creerà, organizzato come un albero di piani, locali e dispositivi. Prima di applicare puoi:
- Rinominare locali e dispositivi che sembrano ancora etichette ETS — il nome ETS originale resta visibile («was … in ETS»), con l’azione Revert.
- Cambiare il tipo di widget di un dispositivo quando l’importazione ha sbagliato — gli indirizzi associati limitano i tipi adatti.
- Spostare i dispositivi in un altro locale o in un’altra categoria, oppure Exclude quelli che l’app non deve mostrare.
- Confermare i tipi di datapoint dedotti — agli indirizzi senza DPT in ETS viene assegnato un tipo dedotto, contrassegnato per la conferma.
- Gestire il gruppo «No room found»: dispositivi reali il cui locale non è stato possibile determinare. Sposta ciascuno in un locale; quelli che restano vengono creati senza locale.
📘 Nota: Se il progetto non dichiara funzioni ETS, la procedura ricava i dispositivi dai canali degli attuatori e contrassegna ciascuno come guessed — verifica locali, nomi e tipi prima di continuare.
I filtri («Needs attention», «Renamed»), la ricerca e la scorciatoia «Next room with an issue» aiutano a scorrere rapidamente i progetti di grandi dimensioni. Puoi applicare con problemi ancora aperti e correggerli in seguito in Devices. Quando hai finito, fai clic su Review everything.
Passo finale — Revisione e applicazione
«Project Review» riassume tutto in sei schede — modalità di configurazione e progetto, posizione e ora, bus KNX, servizi, edificio, dispositivi e indirizzi — ciascuna con un collegamento Edit che riporta al relativo passo.
I problemi bloccanti sono elencati sopra le schede (ad esempio «No coordinates — the apply will stop on the settings stage», «No rooms — the app will open empty»). Correggili, oppure conferma che sono voluti.
Che cosa fa l’applicazione, in ordine:
- Scrive le impostazioni del server — posizione, fuso orario, interfaccia bus e i servizi che hai abilitato.
- Crea la struttura — piani, locali, categorie e, nel percorso ETS, dispositivi e indirizzi di gruppo.
- Riavvia il bridge KNX — una riconnessione; il bus in sé non viene toccato.
Fai clic su Apply and finish. Un pannello di avanzamento in tempo reale segue le fasi e mostra il tempo trascorso. Quando indica Setup complete, la procedura si chiude e si apre la pagina System.
📘 Nota: Se hai attivato o disattivato un servizio della sezione Services (vedi «Step 4 — Services» sopra), compare invece la finestra Reboot to finish setup: questi servizi si avviano o si fermano solo al riavvio del server, che richiede circa due minuti. Fai clic su Reboot now, oppure su Later e riavvia dalla pagina System quando ti conviene.
Se qualcosa va storto: l’esecuzione si ferma sulla fase che ha avuto esito negativo e te lo segnala. Ciò che le fasi precedenti hanno scritto resta al suo posto; Retry riesegue tutte le fasi, quindi, se l’errore è avvenuto tardi, controlla prima l’edificio nella pagina System. Se il server si è riavviato a metà dell’applicazione, la procedura segnala che il job è andato perso — controlla il risultato nella pagina System e riesegui la procedura se la struttura manca.