Devices (zijbalkgroep BUILDING) is de plek waar elke widget van de installatie wordt aangemaakt en gekoppeld. Een apparaat (widget) is wat de bewoner in de app ziet en bedient; erachter zitten een of meer communicatieobjecten — de afzonderlijke waarden (schakelstatus, positie, temperatuur, …) die via een protocol verbonden zijn met de fysieke wereld.
Wat je nodig hebt: minstens één ruimte en één categorie (zie „Building Structure & Categories”), het betreffende protocol ingeschakeld (zie „Services & Protocols”) en een verbinding ervoor (zie „Connections”). De protocolspecifieke koppeling wordt per protocol behandeld: KNX (zie „KNX Integration”), Home Assistant (zie „Home Assistant Integration”), Modbus (zie „Modbus TCP Integration”), HTTP (zie „HTTP Integration”), MQTT (zie „MQTT Integration”), BACnet/IP (zie „BACnet/IP Integration”), TCP/UDP (zie „TCP/UDP Integration”), Sonos (zie „Devices Library & Sonos Binding”).
💡 Tip: Zoek een apparaat eerst in de Devices Library (zie „Devices Library & Sonos Binding”) voordat je het object voor object koppelt. Voor een ondersteunde omvormer, meter, lader, relais of luidspreker maakt de bibliotheek de widgets aan met alle objecten al gekoppeld — je hoeft alleen een adres in te voeren.
De Devices-werkruimte
De pagina heeft drie kolommen:
- Linkerkolom — bladeren. Filter de apparatenlijst op Rooms, Categories, Device Types of Protocols, elk met het aantal apparaten. De kolom biedt ook ingebouwde snelkoppelingen: Add Room, Add Category, Add Floor, Add Protocol.
- Midden — de apparatenlijst. Zoeken, filters en één rij per apparaat. De paginakop bevat een ronde pictogramknop zonder tekst (de tooltip luidt Health; hij opent de Health-pagina, zie „Value Transformations & Health”), daarna Categories (categorieën beheren, zie „Building Structure & Categories”), Add from library (de Devices Library, zie „Devices Library & Sonos Binding”) en Add Device.
- Rechterkolom — Communication objects. Het bronmateriaal om aan te koppelen, op twee tabbladen: KNX toont de groepsadresstructuur (zie „KNX Integration”), Home Assistant toont de entiteiten (zie „Home Assistant Integration”). De kolom is niet afhankelijk van het geselecteerde apparaat. Is hij verborgen, open hem dan opnieuw met de knop Show communication objects naast het zoekveld voor apparaten.

Per apparaatrij kun je:
- Het pictogram wijzigen — klik op de pictogramtegel aan het begin van de rij.
- Visible in the app in- of uitschakelen — een apparaat verbergen zonder het te verwijderen (handig voor apparaten die alleen logica of logging voeden).
- Het Activity-overzicht openen (zie „Device Activity Log”).
- Edit Device — de naam, beschrijving, ruimte, categorie, protocol, type of subtype wijzigen. Lees de waarschuwing onder „Widget types & sub-types” hieronder voordat je het type of subtype wijzigt.
- Show objects — de rij uitklappen om de communicatieobjecten van het apparaat te tonen.
- Het apparaat verwijderen (Delete, met bevestiging; dit kan niet ongedaan worden gemaakt).
Chips en pictogrammen geven de configuratie in één oogopslag weer. Op de apparaatrij zelf:
| Chip | Betekenis |
|---|---|
| Protocolchip | Het protocol (de verbinding) dat het apparaat gebruikt. |
| NO GLOBAL | Het apparaat is uitgesloten van globale commando's (zie „Alarm PIN & Global-Command Exclusions”). |
Klap het apparaat uit om de rest te zien. Een legenda boven de objectenlijst benoemt de vier pictogrammen die aan het einde van elke objectrij kunnen verschijnen:
| Legend | Betekenis |
|---|---|
| LOGGED | Een databasepictogram: dit object logt zijn historie (zie „Object Settings, Logging & Notifications”). |
| GRAFANA | Een grafiekknop, alleen op gelogde objecten: opent de Grafana-paneelbouwer (zie „Object Settings, Logging & Notifications”). |
| TRANSFORMS | De ronde knop die de transformatieketen van het object opent (zie „Value Transformations & Health”). |
| SETTINGS | Het tandwiel dat de objectinstellingen opent (Edit Object, zie „Object Settings, Logging & Notifications”). |
Op een alarmapparaat toont de kaart PIN CODE boven de objecten PIN SET of NO PIN (zie „Alarm PIN & Global-Command Exclusions”).
Een apparaat toevoegen
- Klik op Add Device.
- Voer de Device Name in.
- Kies het widget-Type en, waar een veld Subtype verschijnt, het subtype (zie „Widget types & sub-types” hieronder).
- Kies een Icon en voer optioneel een Description in.
- Kies de Room en de Category.
- Kies het Protocol — dit is de verbinding die het apparaat gebruikt (zie „Connections”). Camera-, videofoon- en webweergavetypen hebben geen veld Protocol.
- Klik op Create Device.
Het nieuwe apparaat heeft zijn objecten, maar geen enkele is al gekoppeld: een streepje in de koppelkolom betekent dat het object niet met de apparatuur is verbonden.
Om meerdere vergelijkbare apparaten tegelijk aan te maken, schakel je Add Multiple Devices in (alleen beschikbaar bij het toevoegen van een apparaat, niet bij het bewerken). Typ onder Additional Device Names de tweede naam en klik voor elke volgende naam op Add another device. Per naam wordt één apparaat aangemaakt met dezelfde instellingen; een lege regel wordt overgeslagen en het dialoogvenster controleert niet op dubbele namen. De knop wordt Create Devices.

Widget types & sub-types
Het widget-Type bepaalt alles over een apparaat: welke bedieningselementen de app toont en welke communicatieobjecten er bestaan. Objecten worden automatisch aangemaakt op basis van het apparaattype — je voegt nooit handmatig objecten toe. Veel typen bieden een Subtype dat de set bedieningselementen varieert. Bij een rolluik heeft SHUTTER de lamellen en is BLIND alleen positie. De lijst Type heeft een zoekveld en toont de namen in hoofdletterstijl, bijvoorbeeld Analog Input en Analog Output.
Elk object heeft:
- een richting — of de waarde binnenkomt (van het apparaat naar HyperVisu), uitgaat (commando's naar het apparaat) of beide;
- een datatype — boolean, getal, tekst, enzovoort.
Kies het type dat bij de fysieke functie past, niet bij het protocol: een via KNX aangestuurd licht en een Home Assistant-licht gebruiken hetzelfde lichtwidgettype. De volledige catalogus van typen, subtypen en hun objecten staat in de referentie van widgettypen (zie „Widget Types Overview”).
⚠️ Waarschuwing: Kies het type en subtype zorgvuldig. Als je het Type of Subtype later wijzigt in Edit Device, worden alle objecten van het apparaat vervangen door die van het nieuwe type en gaan alle koppelingen verloren. Het dialoogvenster toont geen waarschuwing en vraagt niet om bevestiging. Het wijzigen van de naam, het pictogram, de ruimte of de categorie behoudt de objecten.