Analogeingangsmesswerte

Diese Seite beschreibt ein einzelnes AnalogInputState-Element innerhalb von peripherals.analogInputs.

Dieses Array wird nur von Geräten mit Analogeingangskanälen zurückgegeben.

AnalogInputState-Schema

Feld	Typ	Erforderlich	Beschreibung
index	integer	Ja	Index des Analogeingangskanals, beginnend bei 1
type	string	Ja	Typcode. Aktueller Wert: CURRENT
value	number	Nein	Aktueller Stromwert des Analogeingangs
unit	string	Ja	Einheit des Analogeingangsstroms, fest auf mA
status	string	Ja	Kanalstatus. Werte: ONLINE, OFFLINE
measurement	object	Nein	Umgerechneter Messwert basierend auf der Gerätekonfiguration. Fehlt, wenn die Konfiguration nicht gesetzt oder unvollständig ist

Hinweise:

• Wenn ein Kanal nicht verbunden ist, kann das Feld value fehlen.
• value bedeutet immer den tatsächlichen Analogeingangsstrom in mA.
• Das Feld measurement wird nur zurückgegeben, wenn für das Gerät Analogeingangsbereich, Sensorbereich und Anzeigeeinheit konfiguriert sind und der Dienst den umgerechneten Messwert berechnen kann.

measurement-Schema

Feld	Typ	Erforderlich	Beschreibung
value	number	Ja	Umgerechneter Messwert
unit	string	Ja	Einheit des umgerechneten Messwerts aus der Gerätekonfiguration

type-Werte des Analogeingangs

Wert	Beschreibung
CURRENT	Strom

status-Werte des Kanals

Wert	Beschreibung
ONLINE	Analogeingang ist verbunden
OFFLINE	Analogeingang ist nicht verbunden

Beispiel

[
  {
    "index": 1,
    "type": "CURRENT",
    "value": 15.468,
    "unit": "mA",
    "status": "ONLINE",
    "measurement": {
      "value": 71.7,
      "unit": "C"
    }
  },
  {
    "index": 2,
    "type": "CURRENT",
    "value": 6.928,
    "unit": "mA",
    "status": "ONLINE"
  }
]

Kanäle ohne konfigurierte Umrechnung oder ohne Verbindung geben measurement nicht zurück:

[
  {
    "index": 1,
    "type": "CURRENT",
    "unit": "mA",
    "status": "OFFLINE"
  }
]