Supporto tecnico

+39 (0)424 1660208 support@ilevia.com

Logiche Flow

Cos'è Flow, l'editor grafico delle logiche ILEVIA: come aprirlo da ilevia Manager, i concetti di flow, nodo e collegamento, il progetto di esempio da scaricare e l'indice di tutte le guide sui nodi.

Logiche Flow

Flow è l'editor grafico con cui crei le logiche del server ILEVIA senza scrivere codice: metti dei nodi su un foglio di lavoro e li colleghi tra loro con dei fili. Ogni nodo fa una cosa sola (una porta AND, un temporizzatore, un confronto, un contatore…) e il filo porta il valore dall'uscita di un nodo all'ingresso del successivo. Il risultato è una catena che parte dai componenti dell'impianto (pulsanti, sensori, valori KNX) e arriva ad altri componenti (luci, valvole, notifiche).

L'editor Flow con un flow Sequencer, la finestra Operators e la finestra Properties
L'editor Flow: a sinistra gli operatori, al centro il flow, a destra le proprietà del nodo selezionato

Cosa serve

  • Un server ILEVIA con il modulo Logiche installato e avviato: è il modulo Logiche che esegue i flow sul server.

  • ilevia Manager con il progetto dell'impianto e un browser aggiornato (Chrome, Edge, Safari o Firefox).

  • Una connessione a Internet sul computer da cui lavori: l'editor è una web app all'indirizzo flow.ilevia.com.

Aprire l'editor Flow

L'editor si apre dalle impostazioni dell'utente amministratore in ilevia Manager:

  1. apri il progetto e scegli Users › Edit user sull'utente amministratore (il primo utente del progetto);

  2. nella riga App web trovi il gruppo Open flow;

  3. premi Open flow per aprire l'editor in una finestra di Manager, oppure l'icona a forma di globo (Open in browser) per aprirlo nel browser, o l'icona di copia (Copy link) per copiare il collegamento.

Il collegamento contiene il codice QR dell'utente (https://flow.ilevia.com/?qr=…): l'editor si collega così al tuo impianto e mostra i suoi componenti. Tratta questo collegamento come una password e non condividerlo.

Il gruppo Open flow compare solo per l'utente amministratore. Gli altri utenti vedono solo Open app.

I concetti di base

Termine

Significato

Flow

Un foglio di lavoro con una logica. Un impianto può avere molti flow, ognuno nella sua scheda.

Nodo

Un blocco della logica. Ha un nome che scegli tu, degli ingressi a sinistra, delle uscite a destra e delle proprietà (ritardi, condizioni, coordinate…).

Collegamento

Il filo che porta il valore da un'uscita a un ingresso. Un'uscita può alimentare più ingressi.

Componente

Un nodo legato a un componente del progetto di ilevia Manager (luce, tapparella, termostato…): leggerlo e scriverlo vuol dire leggere e comandare l'impianto.

Dummy

Un nodo che ha la forma di un componente ma non è ancora legato all'impianto: serve per provare e disegnare la logica prima di collegarla.

Evento

Ogni volta che un valore cambia, il nuovo valore percorre i fili e fa ricalcolare i nodi che incontra.

Ogni ingresso e ogni uscita ha un tipo, scritto accanto al nome nel pannello Properties:

  • Boolean: acceso/spento, vero/falso (1/0);

  • Number: un numero, con o senza decimali (temperature, percentuali, livelli);

  • String: un testo;

  • Color: un colore in formato esadecimale (#FF0000);

  • Select: una scelta da un elenco (per esempio la condizione di un IF).

Quando un valore arriva su un ingresso di tipo diverso il server lo converte: per esempio il testo "1" diventa true su un ingresso Boolean e il numero 22,5 diventa il testo "22.5" su un ingresso String.

Il progetto di esempio

Per ogni nodo di queste guide c'è un flow di esempio pronto da aprire. Scarica il progetto e aprilo nell'editor con il pulsante Open File (la seconda icona in alto a sinistra): trovi 33 flow, uno per funzione, più tre esempi completi.

JSONilevia-flow-examples.json163.3 KB

Gli esempi usano solo nodi Dummy, Variabili e KNX: si aprono in qualunque impianto senza toccare i componenti esistenti. Per usarli davvero sostituisci i Dummy con i componenti del tuo impianto (vedi Componenti e Dummy).

Aprire un file carica i flow solo nell'editor. Il server li esegue dopo il comando Upload: prima di caricarli su un impianto reale controlla indirizzi KNX e componenti collegati.

Le guide

Guida

Contenuto

L'editor Flow

Barra degli strumenti, finestre, schede dei flow, layout, lingua.

Creare, salvare e caricare i flow

Aggiungere e collegare i nodi, salvare su file, Upload e Download, simulazione, log.

Componenti e Dummy

Usare i componenti dell'impianto nei flow e i nodi Dummy.

Operatori booleani

AND, OR, XOR, NOT e l'ingresso TRG.

Funzioni

IF, Math, Range, Filter e Javascript.

Sequenze

Sequencer e Scenario sequence.

Porte, selettori e flip-flop

Selector, encoder, Decoder, Flip-Flop T, RS, D e Latch D.

Temporizzatori e contatori

Counter, Timer, Stairs Light, Trigger, Numeric Trigger, Astronomy Clock, Date/Hour, Repeat Command, Oscillator e Clock.

Variabili

Boolean, Number, String e Color, anche con valore persistente.

Nodi KNX

Feedback e Command su indirizzi di gruppo KNX.

Esempi pratici

Luce di cortesia notturna, termostato con isteresi, allarme porta aperta.

Limiti e buone pratiche

Cosa sapere prima di mettere un flow in servizio.

In questa sezione

L'editor Flow Le parti dell'editor Flow: barra degli strumenti, schede dei flow, finestre Operators, Components e Properties, finestra Logs, layout delle finestre, lingua e menu utente. Creare, salvare e caricare i flow Come creare un flow, aggiungere e collegare i nodi, aggiungere ingressi e uscite, salvare il lavoro su file, caricare i flow sul server con Upload, scaricarli con Download, provarli e leggere i log. Componenti e Dummy nei flow Come usare nei flow i componenti dell'impianto (luci, dimmer, tapparelle, termostati, scenari…) e i nodi Dummy: ingressi e uscite di ogni tipo, letture e comandi, esempi d'uso. Operatori booleani: AND, OR, XOR, NOT I nodi della categoria Boolean del Flow: AND, OR, XOR e NOT con tabelle di verità, ingressi aggiuntivi, l'ingresso TRG per valutare solo su comando ed esempi d'uso. Funzioni: IF, Math, Range, Filter, Javascript I nodi della categoria Functions del Flow: confronti con IF, calcoli con Math, conversioni di scala con Range, filtro dei valori con Filter e codice personalizzato con il nodo Javascript, con proprietà ed esempi. Sequenze: Sequencer e Scenario I nodi della categoria Sequences del Flow: Sequencer, che accende le uscite una alla volta ciascuna per il suo tempo, e Scenario, che esegue una serie di comandi a intervalli regolari. Proprietà, comandi ed esempi. Porte, selettori e flip-flop I nodi della categoria Gates del Flow: Selector, Binary Encoder, Numeric Encoder e Decoder per instradare i segnali, Flip-Flop T, RS, D e Latch D per memorizzare uno stato, con tabelle ed esempi. Temporizzatori e contatori I nodi delle categorie Timers e Counters del Flow: Timer, Stairs Light, Trigger, Numeric Trigger, Astronomy Clock, Date/Hour, Repeat Command, Oscillator, Clock e Counter, con proprietà, unità di misura ed esempi. Variabili: Boolean, Number, String, Color I nodi della categoria Variables del Flow: variabili booleane, numeriche, di testo e di colore per memorizzare valori, impostare costanti e conservare uno stato anche dopo il riavvio del server con Persistent value. Nodi KNX: Feedback e Command I nodi KNX del Flow: Feedback legge un indirizzo di gruppo, Command scrive su un indirizzo di gruppo. Scelta del datapoint type (DPT), indirizzo, campi dei DPT composti, requisiti del gateway ed esempi. Esempi pratici di flow Tre logiche Flow complete spiegate passo per passo: luce di cortesia notturna con sensore di movimento, termostato con isteresi in Javascript e allarme porta aperta con conteggio degli allarmi. Flow: limiti e buone pratiche Cosa sapere prima di mettere in servizio i flow su un impianto: come lavorare in sicurezza, organizzare i flow, evitare cicli e comandi ripetuti, unità di misura dei nodi e limiti attuali.

Ultimo aggiornamento: