Flow logic
What is Flow, the graphical editor for ILEVIA logic: how to open it from ilevia Manager, the concepts of flow, node and connection, the sample project to download, and the index of all node guides.
Flow is the graphical editor you use to create ILEVIA server logic without writing code: you place nodes on a workspace and connect them with wires. Each node does one thing only (an AND gate, a timer, a comparison, a counter…) and the wire carries the value from one node’s output to the next node’s input. The result is a chain that starts from plant components (pushbuttons, sensors, KNX values) and reaches other components (lights, valves, notifications).

Requirements
An ILEVIA server with the Logic module installed and running: it is the Logic module that executes flows on the server.
ilevia Manager with the plant project and an up-to-date browser (Chrome, Edge, Safari, or Firefox).
An Internet connection on the computer you are working from: the editor is a web app at
flow.ilevia.com.
Opening the Flow editor
The editor is opened from the administrator user settings in ilevia Manager:
open the project and choose Users > Edit user on the administrator user (the first user in the project);
in the Web app row, find the Open flow group;
press Open flow to open the editor in a Manager window, or the globe icon (Open in browser) to open it in the browser, or the copy icon (Copy link) to copy the link.
The link contains the user QR code (https://flow.ilevia.com/?qr=…): this is how the editor connects to your plant and shows its components. Treat this link like a password and do not share it.
The Open flow group appears only for the administrator user. Other users see only Open app.
Basic concepts
Term | Meaning |
|---|---|
Flow | A workspace containing a logic. A plant can have many flows, each in its own tab. |
Node | A logic block. It has a name you choose, inputs on the left, outputs on the right, and properties (delays, conditions, coordinates…). |
Connection | The wire that carries the value from an output to an input. One output can feed multiple inputs. |
Component | A node linked to a component in the ilevia Manager project (light, blind, thermostat…): reading and writing it means reading and controlling the plant. |
Dummy | A node that looks like a component but is not yet linked to the plant: it is used to test and draw the logic before connecting it. |
Event | Whenever a value changes, the new value travels through the wires and causes the nodes it reaches to be recalculated. |
Each input and each output has a type, shown next to the name in the Properties panel:
Boolean: on/off, true/false (1/0);
Number: a number, with or without decimals (temperatures, percentages, levels);
String: text;
Color: a color in hexadecimal format (
#FF0000);Select: a choice from a list (for example the condition of an IF).
When a value reaches an input of a different type, the server converts it: for example, the text "1" becomes true on a Boolean input, and the number 22.5 becomes the text "22.5" on a String input.
The sample project
For each node in these guides, there is a ready-to-open sample flow. Download the project and open it in the editor with the Open File button (the second icon at the top left): you will find 33 flows, one per function, plus three complete examples.
JSONilevia-flow-examples.json163.3 KBThe examples use only Dummy, Variables, and KNX nodes: they can be opened in any plant without affecting the existing components. To use them for real, replace the Dummies with the components of your plant (see Components and Dummy).
Opening a file loads the flows only in the editor. The server runs them after the Upload command: before uploading them to a real plant, check the KNX addresses and connected components.
The guides
Guide | Content |
|---|---|
Toolbar, windows, flow tabs, layout, language. | |
Adding and connecting nodes, saving to file, Upload and Download, simulation, logs. | |
Using plant components in flows and Dummy nodes. | |
AND, OR, XOR, NOT, and the TRG input. | |
IF, Math, Range, Filter, and Javascript. | |
Sequencer and Scenario sequence. | |
Selector, encoder, Decoder, T Flip-Flop, RS, D, and D Latch. | |
Counter, Timer, Stairs Light, Trigger, Numeric Trigger, Astronomy Clock, Date/Hour, Repeat Command, Oscillator, and Clock. | |
Boolean, Number, String, and Color, also with persistent value. | |
Feedback and Command on KNX group addresses. | |
Night courtesy light, hysteresis thermostat, open-door alarm. | |
What to know before putting a flow into service. |