Konvertierung von Rohdaten (Raw)
Die Konvertierung von Rohdaten führt Berechnungen an den von einem Gerät erhaltenen Daten durch und passt sie an die für die Eingabe in die Plattform benötigten Werte an. Dies ermöglicht die Verwendung von Geräten praktisch jeder Marke und jedes Modells, indem einfach Ausdrücke erstellt werden, die die vom Gerät gelieferten Werte konvertieren.
Wie kann ich Rohdaten in die Plattform einspeisen?
Rohdaten werden sowohl über HTTP als auch über MQTT unter Verwendung von APIs gesendet, die auf "Raw" enden. Um beispielsweise die Plattform mit Informationen von einem Temperatursensor unter Verwendung von "Raw"-Daten zu versorgen, muss die API "UpdateTemperatureSensorStatusRaw" verwendet werden. Es wird empfohlen, die folgende Tabelle zu konsultieren, um mehr über die verfügbaren Methoden zum Einspeisen von Rohdaten für jeden Endpunkt-Typ zu erfahren.
Verwendung von Ausdrücken und der Variable "RawData"
Alle APIs, die auf "Raw" enden, verfügen über einen Parameter "rawData", in dem das Gerät den gemessenen Wert melden muss. Dieser Wert wird intern in eine Variable namens "RawData" konvertiert, die im Ausdrucks-Evaluator verwendet werden kann.
Als Beispiel für eine Konvertierung verwenden wir einen Temperatursensor mit den folgenden Eigenschaften:
- Einheiten: Das Gerät meldet die Temperatur in Grad Fahrenheit.
- Messbereich: von -30 Grad Fahrenheit bis +140 Grad Fahrenheit.
- Die Temperatur wird in Zehntel Grad Fahrenheit gemeldet (d. h. sie hat keine Dezimalstellen, sondern wird mit 10 multipliziert).
Die CS Gear-Plattform erfordert jedoch, dass Temperaturen in Grad Celsius gemeldet werden, was daher eine Konvertierung erfordert. Um diese Konvertierung zu erreichen, sind die folgenden Schritte erforderlich:
- Den erhaltenen Wert durch 10 teilen.
- Die empfangene Temperatur von Grad Fahrenheit in Celsius umrechnen.
Um dies zu erreichen, sollte der folgende Ausdruck verwendet werden:
FahrenheitToCelsius(ToNumber(RawData) / 10)Dieser Ausdruck führt Folgendes aus:
- Verwendet die Variable RawData, die eine implizite Variable ist, die in allen Rohdaten-Konvertierungsoperationen existiert und den Rohdateninhalt als string darstellt.
- Verwendet die Funktion ToNumber, um die Variable RawData in einen entsprechenden numerischen Wert zu konvertieren.
- Teilt den erhaltenen Wert durch 10.
- Verwendet schließlich die Funktion FahrenheitToCelsius, um diesen Wert in Grad Celsius zu konvertieren.
Weitere Informationen
Weitere Informationen zur Verwendung von Ausdrücken finden Sie im Abschnitt Ausdrücke, der eine detailliertere Beschreibung der Ausdrucks-Engine, Datentypen, Operatoren, Funktionen und Beispiele für jeden enthält.
Endpunkt-Tagging
Ziel dieser Funktion ist es, Dashboard-Definitionen zu ermöglichen, die über mehrere Anlagen oder sogar verschiedene Kunden hinweg verwendet werden können, ohne dass unabhängige Kopien erstellt werden müssen.
Ausdrücke
Ausdrücke ermöglichen die Durchführung von Berechnungen, hauptsächlich für die Konvertierung von Rohdaten in Geräten. Was sind Ausdrücke? Ausdrücke sind Texte, die es ermöglichen, Daten auszuwerten, Berechnungen durchzuführen und einen einzelnen Wert zurückzugeben.