Accesso a Node-RED
HyperVisu include una potente integrazione con Node-RED che consente di creare automazioni personalizzate e integrarsi con sistemi esterni. Node-RED è uno strumento di programmazione basato su flussi che facilita la connessione di dispositivi hardware, API e servizi online senza una vasta conoscenza della programmazione.
Per accedere all'applicazione Node-RED:
- Naviga all'interfaccia di amministrazione di HyperVisu digitando l'indirizzo IP del tuo server in un browser web
- Accedi con le tue credenziali di amministrazione (nome utente e password)
- Clicca sul pulsante "Node-RED" nella pagina di amministrazione del server
- Si aprirà una nuova scheda del browser con la pagina di accesso a Node-RED
- Usa lo stesso nome utente e password dell'interfaccia di amministrazione di HyperVisu per accedere a Node-RED
Nota: L'ambiente Node-RED gira sull'hardware dello stesso server di HyperVisu, quindi tutte le integrazioni sono locali e non richiedono servizi cloud esterni.
Utilizzo dei nodi HyperVisu
HyperVisu estende Node-RED aggiungendo nodi personalizzati che rappresentano ciascun tipo di widget nel tuo sistema di automazione domestica. Questi nodi ti consentono di interagire direttamente con i tuoi dispositivi KNX da Node-RED.
Struttura del Nodo
L'integrazione di HyperVisu con Node-RED ruota attorno a un nodo principale "HyperVisu" che gestisce la connessione con il server e fornisce accesso a tutti i widget, stanze e categorie. Questo nodo centrale stabilisce e mantiene:
- Comunicazione con il server
- Aggiornamenti in tempo reale dei valori dei widget
Nodi personalizzati aggiuntivi rappresentano ciascun tipo di widget disponibile in HyperVisu:
- Pulsante - Per pulsanti con feedback di stato opzionale
- Interruttore della Luce - Per interruttori ON/OFF specificamente per l'illuminazione
- Interruttore ON/OFF - Per interruttori generali ON/OFF (prese di corrente, ecc.)
- Uscita Analogica - Per inviare valori analogici all'interno di un intervallo predefinito
- Persiana/Tenda - Per controllare persiane e tende
- Controllore di Temperatura - Per il controllo di riscaldamento/raffreddamento
- Dimmer - Per dimmer standard per l'illuminazione
- Dimmer RGB - Per controllare luci RGB(W)
- Dimmer Bianco Regolabile - Per regolare la temperatura del colore delle luci bianche
- Ingresso Analogico - Per visualizzare valori analogici con tendenze opzionali
- Ingresso Digitale - Per visualizzare valori di stato digitali
Sono disponibili anche nodi di comando globali:
- Luci Globali - Per controllare tutte le luci in una stanza o categoria
- Persiane Globali - Per controllare tutte le persiane in una stanza o categoria
- Scenario - Per attivare scenari predefiniti
Ogni nodo visualizza il suo nome e la stanza o categoria associata all'interno del nodo per una facile identificazione.
Ingressi e Uscite
I nodi widget hanno tipicamente più ingressi e uscite che corrispondono alle funzioni del widget. Ad esempio:
Nodo Dimmer:
- Ingressi: Attiva, Acceso, Spento, Punto di impostazione (valore di dimmerizzazione)
- Uscite: Stato (stato acceso/spento), Valore (livello di luminosità), Comando Acceso, Comando Spento
Nodo Persiana/Tenda:
- Ingressi: Su, Giù, Ferma, Punto di impostazione della tenda, Punto di impostazione delle lamelle
- Uscite: Movimento Su, Movimento Giù, Posizione della Tenda, Posizione delle Lamelle, Su, Giù, Ferma
Quando un nodo riceve o invia dati:
- Il payload del messaggio contiene il valore dell'uscita o dell'ingresso
- Un campo argomento contiene l'ID dell'oggetto widget
- Un campo widget contiene l'ID del widget
Questi formati standardizzati rendono facile elaborare messaggi tra nodi e costruire automazioni complesse.
Costruzione di Flussi
Node-RED utilizza un approccio di programmazione visiva in cui colleghi i nodi insieme per creare "flussi" di dati.
Collegare i Nodi
Per costruire un flusso nell'editor di Node-RED:
- Trova i nodi HyperVisu nel pannello dei nodi sul lato sinistro
- Trascina il tipo di nodo desiderato nel flusso
- Collega i nodi trascinando linee tra l'uscita di un nodo e l'ingresso di un altro
- I nodi elaborano i messaggi in sequenza mentre fluiscono attraverso le connessioni
I modelli di flusso di base includono:
- Flussi di attivazione: Un nodo di attivazione (come un ingresso o un evento temporale) causa un'azione tramite un nodo di uscita
- Flussi di trasformazione: I dati passano attraverso nodi funzione che modificano i valori prima che raggiungano i nodi di uscita
- Flussi decisionali: I nodi di commutazione instradano i messaggi in modo diverso in base ai valori ricevuti
- Flussi di integrazione: I nodi di sistemi diversi (MQTT, HTTP, ecc.) si collegano per scambiare dati
Configurazione dei Nodi
Ogni nodo HyperVisu deve essere configurato per connettersi a un widget specifico nel tuo sistema:
- Fai doppio clic su un nodo per aprire il suo pannello di configurazione
- Usa il menu a discesa per selezionare il widget a cui dovrebbe connettersi
- Filtra le opzioni per stanza, categoria e tipo di widget per trovare il widget giusto
- L'elenco mostra tutti i widget dello stesso tipo disponibili dalla tua configurazione HyperVisu
- Abilita/disabilita la pubblicazione del broker MQTT se necessario (invia i valori dei widget al broker MQTT integrato)
- Clicca su Fatto per salvare la configurazione
Per i widget virtuali, puoi inviare valori direttamente da Node-RED per aggiornare lo stato del widget, consentendoti di integrare sensori o sistemi che non sono direttamente collegati al tuo bus KNX.
Distribuzione dei Flussi
Dopo aver costruito e configurato i tuoi flussi:
- Clicca sul pulsante Distribuisci nell'angolo in alto a destra dell'interfaccia di Node-RED
- Attendi il messaggio di conferma che indica una distribuzione riuscita
- I tuoi flussi sono ora attivi e inizieranno a elaborare dati
L'ambiente Node-RED salva automaticamente i tuoi flussi e si riavvieranno quando il server HyperVisu viene riavviato.
Puoi visualizzare lo stato del flusso in tempo reale:
- Le connessioni attive mostrano indicatori di stato con valori
- Gli errori appaiono nel pannello di debug (accessibile tramite la barra laterale destra)
- I dati possono essere tracciati utilizzando nodi di debug posizionati nel flusso
Funzionalità Avanzate
Integrazione dei Comandi Globali
I comandi globali ti consentono di controllare più dispositivi contemporaneamente:
- Aggiungi un nodo Luci Globali o Persiane Globali al tuo flusso
- Configuralo per mirare a una stanza o categoria specifica
- Invia un messaggio "Acceso" o "Spento" all'ingresso del nodo per controllare tutte le luci in quella stanza
- Per le persiane, invia "Su" o "Giù" per controllare tutte le tende/persiane
Questo è particolarmente utile per creare scene o controlli basati sul tempo che influenzano più dispositivi.
Attivazione degli Scenari
Gli scenari di HyperVisu (gruppi predefiniti di stati dei dispositivi) possono essere attivati direttamente da Node-RED:
- Aggiungi un nodo Scenario al tuo flusso
- Configuralo per selezionare lo scenario specifico dall'elenco degli scenari disponibili
- Collega qualsiasi nodo di attivazione al suo ingresso
- Quando attivato, lo scenario verrà eseguito come se fosse attivato dall'app mobile
Questo ti consente di creare attivazioni complesse per i tuoi scenari basati su tempo, eventi esterni o dati dei sensori.
Integrazione dei Dispositivi IoT
Un grande vantaggio dell'integrazione di Node-RED è collegare dispositivi IoT non-KNX al tuo sistema HyperVisu:
Integrazione di Sensori Esterni:
- Crea un widget virtuale in HyperVisu
- Aggiungi il nodo Node-RED corrispondente (come Ingresso Analogico)
- Collega una fonte di dati esterna (MQTT, HTTP, ecc.) a questo nodo
- Quando arrivano dati, aggiorna il widget virtuale e appare nell'app HyperVisu
Controllo di Dispositivi Esterni:
- Crea un widget di uscita virtuale in HyperVisu
- Aggiungi il nodo Node-RED corrispondente (come Interruttore)
- Collega l'uscita a un nodo che controlla il tuo dispositivo esterno (richiesta HTTP, pubblicazione MQTT, ecc.)
- Quando controlli il widget virtuale in HyperVisu, attiva l'azione esterna
Il broker MQTT integrato può essere abilitato per qualsiasi widget, trasmettendo le sue modifiche di stato su argomenti che corrispondono all'ID dell'oggetto widget. Questo rende facile far rispondere altri dispositivi compatibili con MQTT agli eventi nella tua casa.
Esempi di Integrazione:
- Collega API meteo per visualizzare le condizioni esterne su widget virtuali
- Controlla dispositivi intelligenti che utilizzano protocolli diversi
- Registra dati di consumo energetico da contatori intelligenti in InfluxDB
- Costruisci logica personalizzata per automazioni avanzate basate su più condizioni
Sfruttando questa integrazione di Node-RED, puoi estendere HyperVisu oltre le sue capacità KNX native per creare una soluzione di smart home veramente completa che integra tutti i tuoi sistemi.