Reale Geräte liefern selten exakt den Wert, den die App benötigt: Ein Energiezähler sendet Zehntel-Kilowatt, ein Statusbyte bündelt acht Flags, ein Relais arbeitet mit invertierter Logik. Transformationen konvertieren objektbezogen zwischen Protokollwert und Anzeigewert. Die Health-Seite überwacht anschließend jede Verknüpfung und Transformation der Installation.
Transformationen
Jedes Kommunikationsobjekt kann eine geordnete Transformationskette enthalten. Öffnen Sie den Editor für Transformationen direkt in der Zeile des Objekts, klicken Sie auf Transformation hinzufügen und wählen Sie einen Typ aus:
| Typ | Funktion |
|---|---|
| Skalierung & Offset | Lineare Umrechnung: (Wert × Skalierung) + Offset. Einheitenumrechnung, Zählerskalierung. |
| Boolesch invertieren | Vertauscht wahr und falsch – für Protokolle, bei denen 0 EIN bedeutet. |
| Bit-Extraktion | Extrahiert einen Bitbereich aus einer Ganzzahl (Startbit, Bitanzahl, optional vorzeichenbehaftet). |
| Bit-Prüfung | Prüft ein einzelnes Bit einer Ganzzahl und gibt einen booleschen Wert zurück (optional invertiert). |
| Wertzuordnung | Ordnet diskrete Werte anderen Werten zu (Enum-Neuzuordnung), mit optionalem Standardwert und striktem Modus. |
| Wertebegrenzung (Clamp) | Begrenzt Werte auf einen Bereich (oder auf die Minimal-/Maximalwerte des Objekts). |
| Schwellenwert | Wandelt eine Zahl in einen booleschen Wert um (>, >=, <, <=, ==, != gegenüber einem Schwellenwert, mit optionaler Hysterese). |
| Runden | Rundet auf eine Genauigkeit (kaufmännisch runden, abrunden, aufrunden, abschneiden). |
Jede Transformation besitzt eine Richtung:
- Eingehend — Protokoll → Widget (was die App anzeigt).
- Ausgehend — Widget → Protokoll (was ein Steuerbefehl sendet).
- Beidseitig — wird in beiden Richtungen angewendet, sofern die Operation umkehrbar ist.
Transformationsketten werden der Reihe nach ausgeführt; Reihenfolge per Drag-and-Drop anpassbar. Eine Live-Vorschau erlaubt die Eingabe eines Testwerts, um das Ergebnis der Kette anhand von Beispielen unmittelbar zu überprüfen.
Validierung. Der Editor prüft die gesamte Kette gegen die Objekt- und Protokolldatentypen:
- Blockierende Fehler (z. B. Skalierungsfaktor null, inkompatibler Ausgabetyp für das Objekt) müssen vor dem Speichern behoben werden.
- Warnungen (z. B. typgewandelte oder potenziell verlustbehaftete Konvertierungen) erlauben das Speichern, markieren das Objekt jedoch weiterhin auf der Health-Seite.
Wann eine Transformation erforderlich ist
Der Arbeitsbereich „Geräte“ zeigt an, wenn eine Transformation erforderlich ist: über den DPT-Abweichungsdialog bei der KNX-Verknüpfung (siehe „KNX-Integration“) sowie über die Datentyp-Warnung in den Objekteinstellungen (siehe „Objekteinstellungen, Logging & Benachrichtigungen“). Bis die passende Transformation eingerichtet ist, wird das Objekt auf der Health-Seite aufgeführt.
Die Health-Seite
Öffnen Sie Health über die Kopfzeile der Geräteseite. Dort werden alle Objekte mit Problemen aufgelistet:
- eine inkompatible Verknüpfung Protokoll ↔ Widget (Datentypen stimmen nicht überein);
- ein Konfigurationsfehler in einer Transformation;
- ein kürzlich aufgetretener Laufzeitfehler (ein Wert konnte während des Betriebs nicht konvertiert werden).
Jede Zeile zeigt das Objekt, die Anzahl der Fehler nach Kategorie (Konfigurationsfehler, Laufzeitfehler) sowie detaillierte Angaben zum jeweiligen Problem. Aus der Zeile heraus können Sie:
- In Geräten öffnen — springt direkt zum Gerät, um die Verknüpfung oder die Kette anzupassen.
- Laufzeitfehler zurücksetzen — löscht die erfassten Laufzeitfehler für dieses Objekt oder für alle Objekte gleichzeitig, um die Fehlerbehebung im laufenden Betrieb zu validieren.
Liegen keine Fehler vor, meldet die Seite Keine Probleme gefunden – alle Widget-Objekte fehlerfrei.
💡 Tipp: Öffnen Sie nach der Inbetriebnahme die Health-Seite, nachdem die Installation einige Stunden in Betrieb war: So lassen sich Abweichungen erkennen, die erst bei realem Datenfluss auftreten.
