Componenten en gateways: de basisbegrippen van Ilevia Manager

Wat gateways en componenten in Ilevia Manager zijn, hoe ze verbonden zijn en welke eigenschappen alle componenten gemeen hebben.

Een Ilevia Manager-project wordt opgebouwd met twee elementen: de gateways, die de Ilevia-server vertellen hoe met de installaties te communiceren, en de componenten, die aangeven wat moet worden aangestuurd of uitgelezen (een licht, een rolluik, een temperatuur, een scenario). Deze pagina legt beide concepten uit en de gemeenschappelijke eigenschappen van alle componenten.

Gateway

Een gateway is een communicatieconfiguratie: hiermee geeft u de server aan welk protocol gebruikt moet worden (KNX, Modbus, Vimar By-me, BTicino, MQTT, HTTP…) en hoe de installatie te bereiken is (IP-adres, poort, interface, inloggegevens). Dit hoeft niet noodzakelijk overeen te komen met een fysiek apparaat: op dezelfde server kunt u meerdere gateways hebben, ook van hetzelfde protocol.

Gateways worden aangemaakt in het tabblad Gateways met de knop +. Elke gateway verschijnt als een kaart met naam, protocol en ID.

Tabblad Gateways van Ilevia Manager met een geselecteerde Knx3-gateway — Het tabblad Gateways met een Knx3-gateway en de eigenschappen ervan

Alle gateways hebben deze eigenschappen:

Eigenschap	Betekenis
Name	Naam van de gateway, zoals die later in de componenten verschijnt (bijvoorbeeld Impianto KNX - Knx3).
Protocol	Het communicatieprotocol. Daaronder verschijnen de specifieke parameters van dat protocol.
Enabled	Als dit is uitgeschakeld, gebruikt de server de gateway niet en communiceren de gekoppelde componenten niet.
Remove	Verwijdert de gateway uit het project.

Naast de gateways die u zelf aanmaakt, bevat elk project enkele systeemgateways voor componenten die niet van een externe installatie afhangen: bijvoorbeeld Virtual (waarden die alleen door de server worden beheerd), Graphic UI - Gui (interfacecomponenten en diensten zoals spraakbediening), Multimedia - Video en Web - Url.

Raadpleeg voor de parameters van elk protocol het gateway-overzicht en de handleiding Een gateway toevoegen en verwijderen.

Componenten

Een component is een projectobject met een waarde: de status van een schakelaar, de stand van een rolluik, een temperatuur, de tekst van een informatiebericht. De server houdt de waarde up-to-date, de ILEVIA Control-app toont en bedient deze, en de logica's, scenario's en planningen gebruiken ze.

Elke component is gekoppeld aan een gateway: de gateway vertaalt de waarde naar het protocol van de installatie. Bijvoorbeeld: een Switch gekoppeld aan een Knx3-gateway verstuurt en ontvangt KNX-telegrammen met DPT 1.001; dezelfde Switch gekoppeld aan een Modbus-gateway leest en schrijft een register.

Tabblad Components van Ilevia Manager met bibliotheek, projectcomponenten en eigenschappen — Het tabblad Components: bibliotheek, projectcomponenten en eigenschappen

Het tabblad Components is verdeeld in drie kolommen:

Components Library: alle componenttypes, verdeeld per categorie (Home Automation, Scenery, Logic operations, Schedules, Voice Control, Charts, Energy, HVAC, Multimedia, IoT devices, Surveillance / Security, Access Control, Web services, Utilities…). Het zoekveld bovenaan vindt een type op naam.
My components: de componenten van het project. Om er een toe te voegen sleept u deze vanuit de bibliotheek. U kunt ze in groepen indelen.
Component's properties: de eigenschappen van de geselecteerde component. Rechtsboven ziet u het type (bijvoorbeeld switch) en de ID van de component.

De werkbalk van My components

Knop	Functie
Vergrootglas	Zoekt een component op naam.
Trechter	Filtert de lijst.
Pijlen omhoog/omlaag	Vouwt alle groepen uit of in.
Pijl terug / vooruit	Gaat terug naar de eerder geselecteerde component of naar de volgende.
Prullenbak	Verwijdert de geselecteerde componenten.
Map met +	Maakt een nieuwe groep aan.

De ID van de component

Elke component heeft een ID: een geheel getal dat deze uniek identificeert in het project. U vindt die op drie plaatsen:

in My components, onder de naam van de component (bijvoorbeeld Switch 12 heeft ID 12);
rechtsboven in de properties, naast het type (bijvoorbeeld switch 12);
in de componentopties in het tabblad User Interface, als UID.

De regels voor de ID:

Regel	Betekenis
Toegewezen door Manager	Wanneer u een component toevoegt, geeft Manager deze het eerstvolgende nummer dat hoger is dan het hoogste nummer dat al in het project aanwezig is. U kiest dit niet en kunt het niet wijzigen.
Uniek in het project	Twee componenten binnen hetzelfde project hebben nooit dezelfde ID. Ook de groepen in My components krijgen een nummer uit dezelfde reeks (bijvoorbeeld New group 11 en daarna Switch 12).
Stabiel	Het wijzigen van naam, titel, pictogrammen, gateway of parameters verandert de ID niet. Ook Component type behoudt de ID: de component verandert van type maar blijft dezelfde.
Nieuw bij kopieën	Een gekopieerde of gedupliceerde component is een nieuwe component en krijgt een nieuwe ID.
Gescheiden van de gateways	Gateways hebben hun eigen nummering (de ID in het gatewaytabblad): ID 1 van een gateway en ID 1 van een component zijn verschillende dingen.

De naam is voor mensen, de ID voor het systeem. Alle koppelingen tussen componenten gebruiken de ID: de app-interface, Copy value to, de logica's en scenario's, scripts, de Voice Control Manager en HomeKit. Daarom kunt u een component hernoemen zonder koppelingen te verbreken.

Als u een component verwijdert en een identieke nieuwe aanmaakt, heeft de nieuwe een andere ID: koppelingen met de oude (interface, logica's, scripts, spraakassistenten) worden niet automatisch overgezet en moeten opnieuw worden gemaakt. Pas indien mogelijk de bestaande component aan in plaats van deze te verwijderen.

Vermeld bij supportaanvragen naast de naam ook de ID van de component: namen kunnen herhaald worden, ID's niet.

Gemeenschappelijke eigenschappen van alle componenten

De eigenschappen verschillen per componenttype en gateway, maar bepaalde onderdelen zijn altijd aanwezig.

Bovenaan

Eigenschap	Betekenis
Name	Naam van de component in het project (verplicht).
Componementtype	Voor sommige typen zet het component om naar een vergelijkbaar type (bijvoorbeeld een Switch naar Lock of Pulse, een Info naar Set point).
Gateway	De gateway waarmee het component communiceert. Als je die wijzigt, veranderen ook de protocolparameters verderop.
Tags	Labels om componenten te groeperen: er zijn voorgedefinieerde labels (Light, Sockets, Motorizations, Temperature, Scenarios, Security, Energy…) en je kunt nieuwe maken door de naam te typen en op Enter te drukken. Sommige labels activeren functies, bijvoorbeeld Show in recorder webpage.
User interface / Google / Alexa title	De naam die wordt weergegeven in de ILEVIA Control-app en gebruikt door spraakassistenten.
User interface icons	De pictogrammen van het component in de interface (voor componenten met twee toestanden: één voor de uit-stand en één voor de aan-stand).
Online guide	Opent de online handleiding van het component.

Onder de pictogrammen staan drie knoppen:

Copy icons: kopieert de pictogrammen van het component.
Paste icons: plakt de gekopieerde pictogrammen.
Paste as link: plakt de pictogrammen als koppeling: het component gebruikt altijd de pictogrammen van de bron, ook als die later wijzigen. De koppeling wordt verwijderd met Remove link.

In het midden: parameters van het type en het protocol

Onder de algemene eigenschappen staan de parameters die specifiek zijn voor het componenttype (bijvoorbeeld het gedrag van de knop van een Switch) en, in een vak met de naam van het protocol, de parameters van de gekozen gateway: groepsadressen voor KNX, registers voor Modbus, topics voor MQTT en zo verder. Voor een volledig voorbeeld zie Switch-component met gateway Knx3.

Onderaan

Speciale functies, Copy value to, Note, User data en Remove in de eigenschappen van een component — Het onderste deel van de eigenschappen

Eigenschap	Betekenis
Save last value	De server slaat de laatste waarde op en herstelt die na een herstart.
Use recurring values	De server verwerkt ook waarden die gelijk zijn aan de vorige in plaats van ze te negeren.
Copy value to	Wanneer de waarde verandert, wordt die gekopieerd naar het gekozen component. De pijl ernaast selecteert dat component.
Bidirectional linking	De kopie werkt in beide richtingen.
Note	Vrije notities voor wie de installatie configureert.
User data	Vrij veld voor aangepaste gegevens van het component.
Remove	Verwijdert het component uit het project.

De speciale functies en Copy value to verschijnen alleen bij de componenttypen die ze ondersteunen.

Van componenten naar de interface

Componenten verschijnen niet vanzelf in de app: op het tabblad User Interface zet je ze op de pagina's en in de kamers die de gebruiker in ILEVIA Control ziet. Een component kan ook zonder grafische weergave bestaan en alleen dienen voor logica en scenario's.

Wanneer het project klaar is, upload je het naar de server met Project > Upload to server: gateway, componenten en interface worden dan actief.