Flow-logica
Wat is Flow, de grafische editor voor ILEVIA-logica: hoe je hem opent vanuit ilevia Manager, de concepten flow, node en verbinding, het voorbeeldproject om te downloaden en de index van alle handleidingen over nodes.
Flow is de grafische editor waarmee je de logica van de ILEVIA-server maakt zonder code te schrijven: je plaatst nodes op een werkblad en verbindt ze met lijnen. Elke node doet maar één ding (een AND-poort, een timer, een vergelijking, een teller…) en de lijn voert de waarde van de uitvoer van een node naar de ingang van de volgende. Het resultaat is een keten die begint bij de componenten van de installatie (drukknoppen, sensoren, KNX-waarden) en eindigt bij andere componenten (verlichting, ventielen, meldingen).
Benodigd
Een ILEVIA-server met de module Logiche geïnstalleerd en gestart: het is de module Logiche die de flows op de server uitvoert.
ilevia Manager met het project van de installatie en een bijgewerkte browser (Chrome, Edge, Safari of Firefox).
Een internetverbinding op de computer waarop je werkt: de editor is een webapp op
flow.ilevia.com.
De Flow-editor openen
De editor wordt geopend vanuit de gebruikersinstellingen van de beheerder in ilevia Manager:
open het project en kies Users > Edit user bij de beheerdergebruiker (de eerste gebruiker van het project);
in de regel App web vind je de groep Open flow;
druk op Open flow om de editor te openen in een Manager-venster, of op het wereldbolpictogram (Open in browser) om hem in de browser te openen, of op het kopieerpictogram (Copy link) om de link te kopiëren.
De link bevat de QR-code van de gebruiker (https://flow.ilevia.com/?qr=…): zo maakt de editor verbinding met je installatie en toont hij de componenten ervan. Beschouw deze link als een wachtwoord en deel hem niet.
De groep Open flow verschijnt alleen voor de beheerdergebruiker. Andere gebruikers zien alleen Open app.
De basisconcepten
Term | Betekenis |
|---|---|
Flow | Een werkblad met een logica. Een installatie kan meerdere flows hebben, elk in zijn eigen tabblad. |
Node | Een blok in de logica. Het heeft een door jou gekozen naam, ingangen links, uitgangen rechts en eigenschappen (vertragingen, voorwaarden, coördinaten…). |
Verbinding | De lijn die de waarde van een uitgang naar een ingang voert. Eén uitgang kan meerdere ingangen voeden. |
Component | Een node die gekoppeld is aan een component van het project in ilevia Manager (licht, rolluik, thermostaat…): lezen en schrijven betekent de installatie uitlezen en aansturen. |
Dummy | Een node die de vorm heeft van een component maar nog niet aan de installatie gekoppeld is: bedoeld om de logica te testen en te tekenen vóór je hem koppelt. |
Evenement | Telkens wanneer een waarde verandert, reist de nieuwe waarde over de lijnen en zorgt ervoor dat de nodes die hij tegenkomt opnieuw worden berekend. |
Elke ingang en elke uitgang heeft een type, naast de naam geschreven in het paneel Properties:
Boolean: aan/uit, waar/onwaar (1/0);
Number: een getal, met of zonder decimalen (temperaturen, percentages, niveaus);
String: een tekst;
Color: een kleur in hexadecimaal formaat (
#FF0000);Select: een keuze uit een lijst (bijvoorbeeld de voorwaarde van een IF).
Wanneer een waarde op een ingang van een ander type aankomt, converteert de server deze: bijvoorbeeld de tekst "1" wordt true op een Boolean-ingang en het getal 22,5 wordt de tekst "22.5" op een String-ingang.
Het voorbeeldproject
Voor elke node in deze handleidingen is er een kant-en-klare voorbeeldflow om te openen. Download het project en open het in de editor met de knop Open File (het tweede pictogram linksboven): je vindt 33 flows, één per functie, plus drie volledige voorbeelden.
JSONilevia-flow-examples.json163.3 KBDe voorbeelden gebruiken alleen nodes Dummy, Variabelen en KNX: ze kunnen in elke installatie worden geopend zonder de bestaande componenten aan te passen. Om ze echt te gebruiken, vervang je de Dummy's door de componenten van je installatie (zie Componenten en Dummy).
Een bestand openen laadt de flows alleen in de editor. De server voert ze uit na het commando Upload: controleer vóór het laden op een echte installatie de KNX-adressen en gekoppelde componenten.
De handleidingen
Handleiding | Inhoud |
|---|---|
Werkbalk, vensters, flowtabbladen, lay-out, taal. | |
Nodes toevoegen en verbinden, opslaan naar bestand, Upload en Download, simulatie, log. | |
De componenten van de installatie in flows gebruiken en de Dummy-nodes. | |
AND, OR, XOR, NOT en de TRG-ingang. | |
IF, Math, Range, Filter en Javascript. | |
Sequencer en Scenario sequence. | |
Selector, encoder, Decoder, Flip-Flop T, RS, D en Latch D. | |
Counter, Timer, Stairs Light, Trigger, Numeric Trigger, Astronomy Clock, Date/Hour, Repeat Command, Oscillator en Clock. | |
Boolean, Number, String en Color, ook met persistente waarde. | |
Feedback en Command op KNX-groepsadressen. | |
Nachtelijk oriëntatielicht, thermostaat met hysterese, alarm voor open deur. | |
Wat je moet weten voordat je een flow in bedrijf neemt. |