Reële apparaten leveren zelden exact de waarde die de app vereist: een energiemeter verstuurt tienden van een kilowatt, een statusbyte bevat acht vlaggen of een relais gebruikt geïnverteerde logica. Transformaties converteren per object tussen de protocolwaarde en de weergegeven waarde. De Health-pagina bewaakt vervolgens elke binding en transformatie binnen de installatie.
Transformaties
Elk communicatieobject kan een geordende transformatieketen bevatten. Open de Transformations-editor van het object via de bijbehorende rij, klik op Add Transformation en kies een type:
| Type | Werking |
|---|---|
| Scale & Offset | Lineaire conversie: (waarde × schaal) + offset. Eenheidsconversies, meterschaling. |
| Invert Boolean | Wisselt true en false om — voor protocollen waarbij 0 AAN betekent. |
| Bit Extract | Extraheert een reeks bits uit een integer (startbit, aantal bits, optioneel signed). |
| Bit Check | Controleert één bit van een integer en retourneert een boolean (optioneel geïnverteerd). |
| Value Map | Koppelt discrete waarden aan andere waarden (enum-remapping), met een optionele standaardwaarde en strict mode. |
| Clamp | Begrenst waarden tot een bereik (of tot de min/max van het object zelf). |
| Threshold | Zet een getal om in een boolean (>, >=, <, <=, ==, != ten opzichte van een drempelwaarde, met optionele hysterese). |
| Round | Rondt af op een precisie (round, floor, ceiling, truncate). |
Elke transformatie heeft een richting (direction):
- Incoming — protocol → widget (wat de app weergeeft).
- Outgoing — widget → protocol (wat een commando verstuurt).
- Both — toegepast in beide richtingen wanneer de bewerking omkeerbaar is.
Ketens worden op volgorde uitgevoerd; sleep om de volgorde te wijzigen. Met een live preview kunt u een invoerwaarde typen en direct de uitvoer van de keten bekijken, inclusief voorbeelden.
Validatie. De editor valideert de volledige keten aan de hand van het object en de protocoltypen:
- Blokkades (bijv. een schaal van nul, incompatibele ketenuitvoer voor het objecttype) moeten vóór het opslaan worden opgelost.
- Waarschuwingen (bijv. een geforceerde of mogelijk met gegevensverlies gepaard gaande conversie) staan opslaan toe, maar laten het object gemarkeerd op de Health-pagina.
Wanneer een transformatie nodig is
De Devices-werkruimte geeft aan wanneer een transformatie vereist is: via het DPT-mismatch-dialoogvenster bij het koppelen van KNX (zie “KNX Integration”), en via de datatype-waarschuwing in de objectinstellingen (zie “Object Settings, Logging & Notifications”). Totdat de converterende transformatie is ingesteld, verschijnt het object op de Health-pagina.
De Health-pagina
Open Health via de paginakop van Devices. Hier worden alle objecten met een probleem vermeld:
- een incompatibele protocol ↔ widget-koppeling (een binding waarvan de typen niet overeenkomen);
- een configuratieprobleem in een transformatie;
- een recente runtime-fout (een waarde die tijdens runtime niet geconverteerd kon worden).
Elke rij toont het object, het aantal problemen per categorie (configuratiefouten, runtime-fouten) en de details van elk probleem. Vanuit een rij kunt u:
- Open in Devices — springt direct naar het apparaat om de binding of de keten aan te passen.
- Clear runtime errors — wist de geregistreerde runtime-fouten voor dat object, of voor alle objecten tegelijk, zodat u een oplossing met een schone lei kunt verifiëren.
Wanneer alles in orde is, meldt de pagina simpelweg: No problems found — all widget objects are healthy.
💡 Tip: Open na de inbedrijfstelling de Health-pagina nadat de installatie enkele uren actief is geweest: dit brengt afwijkingen aan het licht die pas zichtbaar worden zodra er werkelijke waarden binnenkomen.
