DataPoint
Das DataPoint-Objekt repräsentiert einen Wert, der typischerweise verwendet wird, um den Zustand eines Endpunkts zu einem bestimmten Zeitpunkt darzustellen.
Eigenschaften
value (number) Die Eigenschaft value repräsentiert den Endpunkt-Wert als Zahl. Siehe die Tabelle am Ende dieses Abschnitts für die Endpunkt-Typen, auf die diese Eigenschaft anwendbar ist, und ihre Bedeutung.
Beispiele
Dieses Beispiel zeigt den aktuellen Wert des ersten Endpunkts eines Geräts über die Log-Konsole.
env.log('Endoint value: ', myDevice.endpoints.byIndex(0).getCurrentValue().value);isOn (boolean) Die Eigenschaft isOn gibt an, ob der Endpunkt derzeit eingeschaltet ist. Siehe die Tabelle am Ende dieses Abschnitts für die Endpunkt-Typen, auf die diese Eigenschaft anwendbar ist, und ihre Bedeutung.
Beispiele
Dieses Beispiel zeigt den aktuellen Zustand des ersten Endpunkts eines Geräts über die Log-Konsole.
env.log('Endoint state: ', myDevice.endpoints.byIndex(0).getCurrentValue().isOn);state (number) Die Eigenschaft state gibt den aktuellen Zustand des Endpunkts an. Diese Eigenschaft gilt für Endpunkte vom Typ IAS Sensor.
Beispiele
Dieses Beispiel zeigt den aktuellen Zustand des ersten Endpunkts eines Geräts über die Log-Konsole.
env.log('Endoint state: ', myDevice.endpoints.byIndex(0).getCurrentValue().state);position (number) Die Eigenschaft position gibt die aktuelle Position für Endpunkte vom Typ Closure an.
Beispiele
Dieses Beispiel zeigt die aktuelle Position des ersten Endpunkts eines Geräts über die Log-Konsole.
env.log('Endoint position: ', myDevice.endpoints.byIndex(0).getCurrentValue().position);mode (number) Die Eigenschaft mode gibt den aktuellen Modus eines Endpunkts vom Typ Thermostat an.
Beispiele
Dieses Beispiel zeigt den aktuellen Modus des ersten Endpunkts eines Geräts über die Log-Konsole.
env.log('Thermostat mode: ', myDevice.endpoints.byIndex(0).getCurrentValue().mode);fanMode (number) Die Eigenschaft fanMode gibt den aktuellen Lüfter-Modus eines Endpunkts vom Typ Thermostat an.
Beispiele
Dieses Beispiel zeigt den aktuellen Lüfter-Modus des ersten Endpunkts eines Geräts über die Log-Konsole.
env.log('Fan mode: ', myDevice.endpoints.byIndex(0).getCurrentValue().fanMode);setpoint (number) Die Eigenschaft setpoint gibt die gewünschte Temperatur für einen Endpunkt vom Typ Thermostat an.
Beispiele
Dieses Beispiel zeigt die gewünschte Temperatur des ersten Endpunkts eines Geräts über die Log-Konsole.
env.log('Setpoint: ', myDevice.endpoints.byIndex(0).getCurrentValue().setpoint);ambientTemperature (number) Die Eigenschaft ambientTemperature gibt die aktuelle Umgebungstemperatur eines Endpunkts vom Typ Thermostat an.
Beispiele
Dieses Beispiel zeigt die aktuelle Umgebungstemperatur des ersten Endpunkts eines Geräts über die Log-Konsole.
env.log('Ambient temperature: ', myDevice.endpoints.byIndex(0).getCurrentValue().ambientTemperature);latitude (number) Die Eigenschaft latitude gibt den Breitengrad für einen Endpunkt vom Typ Location Tracker an.
Beispiele
Dieses Beispiel zeigt die aktuellen Koordinaten des ersten Endpunkts eines Geräts über die Log-Konsole.
var v = myDevice.endpoints.byIndex(0).getCurrentValue();
env.log('Coordinates: ', v.latitude, ' - ', v.longitude);longitude (number) Die Eigenschaft longitude gibt den Längengrad für einen Endpunkt vom Typ Location Tracker an.
Beispiele
Dieses Beispiel zeigt die aktuellen Koordinaten des ersten Endpunkts eines Geräts über die Log-Konsole.
var v = myDevice.endpoints.byIndex(0).getCurrentValue();
env.log('Coordinates: ', v.latitude, ' - ', v.longitude);flags (number) Die Eigenschaft flags gibt die besonderen Bedingungen eines Endpunkts vom Typ Location Tracker an.
Beispiele
Dieses Beispiel zeigt die Flags des ersten Endpunkts eines Geräts über die Log-Konsole.
env.log('Flags: ', myDevice.endpoints.byIndex(0).getCurrentValue().flags);activeEnergy (number) Die Eigenschaft activeEnergy gibt die Wirkenergie eines Endpunkts vom Typ Energy Meter an.
Beispiele
Dieses Beispiel zeigt die Wirk-, Blind- und Scheinenergie des ersten Endpunkts eines Geräts über die Log-Konsole.
var v = myDevice.endpoints.byIndex(0).getCurrentValue();
env.log('Energy (active / reactive / apparent): ', v.activeEnergy, '/', v.reactiveEnergy, '/', v.apparentEnergy);reactiveEnergy (number) Die Eigenschaft reactiveEnergy gibt die Blindenergie eines Endpunkts vom Typ Energy Meter an.
Beispiele
Dieses Beispiel zeigt die Wirk-, Blind- und Scheinenergie des ersten Endpunkts eines Geräts über die Log-Konsole.
var v = myDevice.endpoints.byIndex(0).getCurrentValue();
env.log('Energy (active / reactive / apparent): ', v.activeEnergy, '/', v.reactiveEnergy, '/', v.apparentEnergy);apparentEnergy (number) Die Eigenschaft apparentEnergy gibt die Scheinenergie eines Endpunkts vom Typ Energy Meter an.
Beispiele
Dieses Beispiel zeigt die Wirk-, Blind- und Scheinenergie des ersten Endpunkts eines Geräts über die Log-Konsole.
var v = myDevice.endpoints.byIndex(0).getCurrentValue();
env.log('Energy (active / reactive / apparent): ', v.activeEnergy, '/', v.reactiveEnergy, '/', v.apparentEnergy);text (string) Die Eigenschaft text gibt den Text an, der einem Endpunkt vom Typ Text Container zugeordnet ist.
Beispiele
Dieses Beispiel zeigt den Text, der dem ersten Endpunkt eines Geräts zugeordnet ist, über die Log-Konsole.
env.log('Text: ', myDevice.endpoints.byIndex(0).getCurrentValue().text);DataPoint-Objekt-Eigenschaften für jeden Endpunkt-Typ
| Property | Endpoint type | Meaning |
|---|---|---|
| value | Numeric endpoints (scalar, discrete, etc.) | Current value |
| Appliance | Off: 0On: 1 | |
| Dimmer | Off: 0On: current level | |
| Closure | Current position | |
| IAS Sensor | Current state | |
| isOn | Appliance / Dimmer / Thermostat | Off: falseOn: true |
| Closure | Stopped: falseMoving: true | |
| state | IAS Sensor | Current state |
| position | Closure | Current position |
| mode | Thermostat | Current mode |
| fanMode | Thermostat | Current fan mode |
| setpoint | Thermostat | Desired temperature |
| ambientTemperature | Thermostat | Ambient temperature |
| latitude | Location tracker | Latitude |
| longitude | Location tracker | Longitude |
| flags | Location tracker | Location flags |
| activeEnergy | Energy Meter | Active energy |
| reactiveEnergy | Energy Meter | Reactive energy |
| apparentEnergy | Energy Meter | Apparent energy |
| text | Text container | Current text |
Ergebnis der Geräteadress-Validierung
Das Ergebnisobjekt der Geräteadress-Validierung repräsentiert das Ergebnis einer Geräteadress-Validierung, das typischerweise in Konfigurationsskripten für Gerätemodelle verwendet wird.
Daten-Payload
Das Daten-Payload-Objekt repräsentiert einen von einem Gerät empfangenen Payload, beispielsweise von einem Gerät mit MQTT-, HTTP- oder LoRaWAN-Konnektivität. Das Objekt ermöglicht den Zugriff auf empfangene Daten...