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 logic

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).

The Flow editor with a Sequencer flow, the Operators window, and the Properties window
The Flow editor: operators on the left, the flow in the center, node properties on the right

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:

  1. open the project and choose Users > Edit user on the administrator user (the first user in the project);

  2. in the Web app row, find the Open flow group;

  3. 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 KB

The 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

The Flow editor

Toolbar, windows, flow tabs, layout, language.

Creating, saving, and uploading flows

Adding and connecting nodes, saving to file, Upload and Download, simulation, logs.

Components and Dummy

Using plant components in flows and Dummy nodes.

Boolean operators

AND, OR, XOR, NOT, and the TRG input.

Functions

IF, Math, Range, Filter, and Javascript.

Sequences

Sequencer and Scenario sequence.

Gates, selectors, and flip-flops

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

Timers and counters

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

Variables

Boolean, Number, String, and Color, also with persistent value.

KNX nodes

Feedback and Command on KNX group addresses.

Practical examples

Night courtesy light, hysteresis thermostat, open-door alarm.

Limits and best practices

What to know before putting a flow into service.

In this section

The Flow editor The Flow editor sections: toolbar, flow tabs, Operators, Components and Properties windows, Logs window, window layout, language and user menu. Create, save and upload flows How to create a flow, add and connect nodes, add inputs and outputs, save the work to a file, upload flows to the server with Upload, download them with Download, test them, and read the logs. Components and Dummies in flows How to use plant components in flows (lights, dimmers, shutters, thermostats, scenarios…) and Dummy nodes: inputs and outputs of all kinds, readings and commands, usage examples. Boolean operators: AND, OR, XOR, NOT The Flow Boolean category nodes: AND, OR, XOR and NOT with truth tables, additional inputs, the TRG input to evaluate only on command, and usage examples. Functions: IF, Math, Range, Filter, Javascript The nodes in the Functions category of Flow: comparisons with IF, calculations with Math, scale conversions with Range, value filtering with Filter, and custom code with the Javascript node, with properties and examples. Sequences: Sequencer and Scenario The nodes in the Sequences category of Flow: Sequencer, which switches outputs on one at a time for their own duration, and Scenario, which sends a series of commands at regular intervals. Properties, commands, and examples. Gates, selectors and flip-flops The nodes in the Gates category of Flow: Selector, Binary Encoder, Numeric Encoder and Decoder for routing signals, T Flip-Flop, RS, D and D Latch for storing a state, with tables and examples. Timers and counters The nodes in the Timers and counters categories of the Flow: Timer, Stairs Light, Trigger, Numeric Trigger, Astronomy Clock, Date/Hour, Repeat Command, Oscillator, Clock, and Counter, with properties, units of measure, and examples. Variables: Boolean, Number, String, Color The nodes in the Variables category of the Flow: boolean, numeric, text, and color variables used to store values, set constants, and preserve a state even after the server restarts with Persistent value. KNX nodes: Feedback and Command The KNX nodes in Flow: Feedback reads a group address, Command writes to a group address. Choice of datapoint type (DPT), address, composite DPT fields, gateway requirements, and examples. Practical flow examples Three complete Flow logic examples explained step by step: night courtesy light with motion sensor, hysteresis thermostat in Javascript, and open-door alarm with alarm counting. Flow: limits and best practices What to know before commissioning flows on a plant: how to work safely, organize flows, avoid loops and repeated commands, node measurement units, and current limitations.

Last updated: