Questa sezione descrive i componenti di un'installazione HyperVisu e la loro comunicazione reciproca. Comprendere la struttura facilita la pianificazione dell'installazione o la diagnosi dei problemi.
Il server HyperVisu
Il server HyperVisu è un dispositivo compatto installato nell'edificio — tipicamente nel quadro elettrico o in un locale tecnico, collegato alla rete locale. Esegue il software HyperVisu e una serie di servizi opzionali, memorizza l'intera configurazione localmente e costituisce il punto unico a cui si connettono tutti i client. I dati rimangono sul dispositivo.
I client
| Client | Dove viene eseguito | A cosa serve |
|---|---|---|
| App HyperVisu | Smartphone e tablet iOS e Android | Controllo quotidiano per gli utenti |
| Web app | Qualsiasi browser moderno | La stessa app, senza installare nulla |
| Modalità pannello a parete | Pannelli a parete da 4″ | Una presentazione semplificata e impaginata per pannelli fissi (vedere «Tablet e pannello a parete») |
| Pannello di amministrazione | Browser desktop | Configurazione e messa in servizio, solo per amministratori (vedere Parte IV) |
L'app adatta il proprio layout al fattore di forma: smartphone, tablet (barra laterale + dettaglio) e pannello a parete (quadri impaginati).
Accesso locale e cloud
È possibile accedere al server in due modi:
- Locale (LAN) — il client si collega direttamente all'indirizzo IP del server sulla rete locale. È la modalità più veloce e funziona senza connessione a Internet.
- Cloud (Elausys Cloud Service) — il server mantiene aperto un tunnel in uscita verso Elausys Cloud Service, consentendo ai client di raggiungerlo da qualsiasi luogo tramite l'indirizzo cloud univoco del server, ricavato dal numero di serie (vedere «Accesso al pannello di amministrazione»). Non richiede port forwarding, modifiche al firewall né IP pubblico statico.
L'app accetta sia l'indirizzo IP locale sia il numero di serie del server, gestendo automaticamente il passaggio tra connessione cloud e locale con fallback (vedere «Connessione e accesso»). All'interno dell'edificio utilizza il percorso locale ad alta velocità; da remoto, utilizza il tunnel cloud.
Servizi opzionali sul server
Il server può eseguire servizi aggiuntivi parallelamente al software principale. È consigliabile abilitare solo quelli necessari al progetto (vedere «Servizi e protocolli»):
- Database storico (InfluxDB) — memorizza le misurazioni nel tempo; alimenta grafici di andamento, contatori ed esportazioni.
- Dashboard (Grafana) — grafici professionali basati sul database storico.
- Node-RED — programmazione visiva a blocchi per integrazioni personalizzate.
- Streaming telecamere — ritrasmette i flussi video delle telecamere alle app.
- Home Assistant — un'istanza locale di Home Assistant, utile per integrare ecosistemi Zigbee, Z-Wave e altri in HyperVisu.
Protocolli supportati
| Protocollo | Dispositivi tipici | Note |
|---|---|---|
| KNX | L'installazione cablata dell'edificio | Tramite interfaccia KNX/IP (tunneling UDP) o router (multicast) |
| Modbus TCP | Inverter, stazioni di ricarica EV, pompe di calore, PLC | Registri interrogati tramite polling, server multipli (vedere «Integrazione Modbus TCP») |
| Home Assistant | Ecosistemi Zigbee, Z-Wave, Wi-Fi | Istanza locale o esterna (vedere «Integrazione Home Assistant») |
| HTTP | Dispositivi e servizi con API web | Polling e richieste in uscita (vedere «Integrazione HTTP») |
| MQTT | Zigbee2MQTT, Tasmota, Shelly, ESPHome e altri dispositivi gestiti da un broker MQTT | Sottoscrizione ai topic di stato, pubblicazione dei comandi; broker multipli (vedere «Integrazione MQTT») |
| BACnet/IP | Controllori HVAC, unità di trattamento aria (UTA), VAV, chiller, contatori | Sottoscrizioni Change-of-Value (COV) e polling; rilevamento di rete; una connessione per dispositivo (vedere «Integrazione BACnet/IP») |
| TCP/UDP | Dispositivi AV (AUDAC XMP44), proiettori PJLink, bridge seriale-su-IP, schede personalizzate | Frame di comando grezzi e pattern matching su TCP o UDP (vedere «Integrazione TCP/UDP») |
| Sonos | Diffusori Sonos, coppie stereo e sistemi home theatre | Controllo locale nativo — nessun account cloud né bridge; una connessione per abitazione (vedere «Integrazione Sonos») |
| Virtuale | Dispositivi puramente software | Gruppi, punti Node-RED, uscite del motore logico (vedere «Dispositivi virtuali e Node-RED») |
Flusso dei dati in sintesi
Ogni variazione di valore — dall'app, da uno scenario, da un'automazione o dall'impianto fisico — passa attraverso il server, che mantiene sincronizzati tutti i client.