Geräte

10min

Gerätedaten
Geräte verfügen grundsätzlich über Kanäle und Parameter. Kanäle repräsentieren hierbei einzelne Sensoren oder Aktoren eines Gerätes. Die (Betriebs)Parameter hingegen sind soft- oder hardwarebasierte Einstellungen, welche das Verhalten des Gerätes beeinflussen.
SimpleIoTCoreThingDTO
Alle spezialisierten Geräte bauen auf diesem Objekt auf. Es enthält alle grundlegenden Felder welche für ein Gerät minimal notwendig sind.
Feld
Datentype
Beschreibung
id
String
Eindeutige ID des Gerätes im System
type
String
Basisgerätetyp
name
String
Der zugewiesene Name des Gerätes
refId
String
Referenz ID zu Angabe des Gerätetypes
channels
Object
Jedes Feld des Objektes repräsentiert einen Kanal für welchen ein Wertcontainer hinterlegt ist
parameters
Object
Jedes Feld des Objektes repräsentiert einen Parameter für welchen ein Wertcontainer hinterlegt ist
Folgende Werte können im Feld "type" stehen.
Type
Beschreibung
GENERIC
Basisgerätedatentyp für alle Geräte
ENOCEAN
EnOcean basierte Geräte
TIMER
Virtuelles Timergerät
SimpleIoTCoreThingDTO
SimpleIoTCoreThingDTO 2
{
   "id":"5e79f680-2a96-49c8-8224-b35ee9d637c8",
   "name":"Heater control 0",
   "refId":"unknown",
   "type":"GENERIC",
   "channels":{
      "OperatingMode":{
         "type":"STATE",
         "descriptionId":"DFA38DFEDC00C9242F78C77F595AA455",
         "changeable":true,
         "value":"NORMAL_MODE"
      },
      "Temperature":{
         "type":"NUMBER_DOUBLE",
         "descriptionId":"951D86219EBEA29CAFEFEDB8340619DE",
         "changeable":true,
         "value":0
      },
      "SetPoint":{
         "type":"NUMBER_DOUBLE",
         "descriptionId":"AFA6AB10C4BC33F920B67E4261AB3410",
         "changeable":true,
         "value":8
      },
      "Heating":{
         "type":"STATE",
         "descriptionId":"1276DCDD634F711EFD017C013BE819B8",
         "changeable":false,
         "value":"UNKNOWN"
      },
      "Priority":{
         "type":"STATE",
         "descriptionId":"7FF06AB573E6FA5BFF463DC19F0983E0",
         "changeable":true,
         "value":"OFF"
      }
   },
   "parameters":{
      "General settings--Trigger only if changed":{
         "type":"STATE",
         "descriptionId":"6FC32A753246132013FF3A6B38D42D18",
         "changeable":true,
         "value":"true"
      },
      "Device settings--Priority":{
         "type":"STATE",
         "descriptionId":"6FC32A753246132013FF3A6B38D42D18",
         "changeable":true,
         "value":"false"
      },
      "Device settings--Time base":{
         "type":"NUMBER_DOUBLE",
         "descriptionId":"71415BB9E79CC237F9D183C84F337022",
         "changeable":true,
         "value":15
      },
      "Device settings--Control mode":{
         "type":"STATE",
         "descriptionId":"84CCB9E475EC2664AEBD86397E92260F",
         "changeable":true,
         "value":"PWM"
      },
      "Device settings--Hysteresis":{
         "type":"NUMBER_DOUBLE",
         "descriptionId":"D7A4D9A8DA15AB2DFAED6E6B51C8A9EB",
         "changeable":true,
         "value":4
      }
   }
}
{
   "id":"5e79f680-2a96-49c8-8224-b35ee9d637c8",
   "name":"Heater control 0",
   "refId":"unknown",
   "type":"GENERIC",
   "channels":{
      "OperatingMode":{
         "type":"STATE",
         "descriptionId":"DFA38DFEDC00C9242F78C77F595AA455",
         "changeable":true,
         "value":"NORMAL_MODE"
      },
      "Temperature":{
         "type":"NUMBER_DOUBLE",
         "descriptionId":"951D86219EBEA29CAFEFEDB8340619DE",
         "changeable":true,
         "value":0
      },
      "SetPoint":{
         "type":"NUMBER_DOUBLE",
         "descriptionId":"AFA6AB10C4BC33F920B67E4261AB3410",
         "changeable":true,
         "value":8
      },
      "Heating":{
         "type":"STATE",
         "descriptionId":"1276DCDD634F711EFD017C013BE819B8",
         "changeable":false,
         "value":"UNKNOWN"
      },
      "Priority":{
         "type":"STATE",
         "descriptionId":"7FF06AB573E6FA5BFF463DC19F0983E0",
         "changeable":true,
         "value":"OFF"
      }
   },
   "parameters":{
      "General settings--Trigger only if changed":{
         "type":"STATE",
         "descriptionId":"6FC32A753246132013FF3A6B38D42D18",
         "changeable":true,
         "value":"true"
      },
      "Device settings--Priority":{
         "type":"STATE",
         "descriptionId":"6FC32A753246132013FF3A6B38D42D18",
         "changeable":true,
         "value":"false"
      },
      "Device settings--Time base":{
         "type":"NUMBER_DOUBLE",
         "descriptionId":"71415BB9E79CC237F9D183C84F337022",
         "changeable":true,
         "value":15
      },
      "Device settings--Control mode":{
         "type":"STATE",
         "descriptionId":"84CCB9E475EC2664AEBD86397E92260F",
         "changeable":true,
         "value":"PWM"
      },
      "Device settings--Hysteresis":{
         "type":"NUMBER_DOUBLE",
         "descriptionId":"D7A4D9A8DA15AB2DFAED6E6B51C8A9EB",
         "changeable":true,
         "value":4
      }
   }
}
﻿
SimpleIoTCoreEnOceanDTO
Erweiterung des SimpleIoTCoreThing um EnOcean relevante Informationen.
Folgende zusätzliche Felder sind vorhanden:
Feld
Datentype
Beschreibung
signalStrength
Number
Signalstärke des letzten empfangenen Signals in Prozent. 0 - 100%
acknowledgeChannels
Object
Jedes Feld des Objektes repräsentiert einen Empfangskanal. Der Feldwert ist die verwendete EURID des Kanals oder ein leerer String falls keine ID zugewiesen ist.
transmissionChannels
Object
Jedes Feld des Objektes repräsentiert einen Sendekanal. Der Feldwert ist die verwendete Sende ID eines der verfügbaren EnOcean Gateways oder ein leerer String falls keine ID zugewiesen ist.
Es ist möglich das es im "transmissionChannels" Objekt keine Felder gibt. Dies bedeutet das dieses Gerät keine Sendekanäle unterstützt.
SimpleIoTCoreEnOceanDTO 1
SimpleIoTCoreEnOceanDTO 2
{
   "id":"d5da720e-2ad6-4c86-88c0-f84390f76570",
   "name":"Fenstergriff",
   "refId":"enocean.hoppe.windowhandle",
   "type":"ENOCEAN",
   "channels":{
      "WindowHandle":{
         "type":"STATE",
         "descriptionId":"7F5679889E7910087244AE399DB8CECA",
         "changeable":false,
         "value":"CLOSED"
      }
   },
   "signalStrength":93,
   "assignableAcknowledgeNames":[
      "default"
   ],
   "possibleTransmissionNames":[
      
   ],
   "acknowledgeChannels":{
      "default":"1104311"
   },
   "transmissionChannels":{
      
   }
}
{
   "id":"d5da720e-2ad6-4c86-88c0-f84390f76570",
   "name":"Fenstergriff",
   "refId":"enocean.hoppe.windowhandle",
   "type":"ENOCEAN",
   "channels":{
      "WindowHandle":{
         "type":"STATE",
         "descriptionId":"7F5679889E7910087244AE399DB8CECA",
         "changeable":false,
         "value":"CLOSED"
      }
   },
   "signalStrength":93,
   "assignableAcknowledgeNames":[
      "default"
   ],
   "possibleTransmissionNames":[
      
   ],
   "acknowledgeChannels":{
      "default":"1104311"
   },
   "transmissionChannels":{
      
   }
}
﻿
SimpleIoTCoreTimerDTO
Erweiterung des SimpleIoTCoreThing um timerspezifische Felder.
Folgende zusätzliche Felder sind vorhanden:
Feld
Datentype
Beschreibung
enabled
Boolean
Gibt an ob der Timer aktiviert ist oder nicht.
visible
Boolean
Gibt an ob der Timer sichtbar ist (nur Clients).
mode
String
Betriebsmodus des Timers.
timerType
String
Type des Timers.
time
Number
Eine Zeitangabe als Unix Timestamp. Die Angabe des Zeistempels erfolgt dabei für Werte mit Datum für unabhängig von der lokalen Zeitzone in UTC+0. Die Uhrzeit wird modulo 86400 gerechnet.  Ansonsten berechnet sich der Tag und Monat bei wiederkehrender Ausführung aus dem eingestellten Datum bzw Wert im Feld time. 
offset
Number
Anzuwendende Zeitverschiebung in Minuten (+/-).
period
Number
Angabe der Minuten für die periodische Auslösung.
selectedDays
Array
Ausgewählte Tage als String Array.
﻿
Folgende Typen können im Feld "timerType" verwendet werden:
Type
Beschreibung
ONCE
Einmalige Ausführung des Timers an einem Tag zu einer bestimmten Uhrzeit.
DAILY
Tägliche Ausführung des Timers um eine bestimmte Uhrzeit.
WEEKLY
Wöchentliche Ausführung des Timers um eine bestimmte Uhrzeit.
MONTHLY
Monatliche Ausführung des Timers an einem bestimmten Tag, um eine bestimmte Uhrzeit.
YEARLY
Jährliche Ausführung des Timers an einem bestimmten Tag, um eine bestimmte Uhrzeit.
SELECTED_DAYS
Ausführung des Timers zu bestimmten Wochentagen.
PERIODIC
Periodische Ausführung des Timer nach einem festgelegten Intervall.
Im Feld "mode" sind folgende Werte möglich.
Mode
Beschreibung
NORMAL
Normaler Betriebsmodus
SUNRISE
Timer Auslösung bezieht sich auf den berechneten Sonnenaufgang inkl. Offset.
SUNSET
Timer Auslösung bezieht sich auf den berechneten Sonnenuntergang inkl. Offset.
Im Feld "selectedDays" kann ein Array mit den ausgewählten Tagen hinterlegt werden.
Tag
MONDAY
TUESDAY
WEDNESDAY
THURSDAY
FRIDAY
SATURDAY
SUNDAY
Die folgende Tabelle zeigt dies Auswertung des Feldes time in Abhängigkeit des Timertyps. Als Beispiel wird timeStamp = 1707150600 gewählt, dies entspricht Dienstag, 05.02.2024 16:30:00 Uhr UTC+0.
Type
Auswertung
ONCE
Dienstag, 05.02.2024 16:30:00 Uhr
DAILY
Täglich um 16:30:00 Uhr
WEEKLY
Dientags um 16:30:00 Uhr
MONTHLY
Immer am 05. eines Monats um 16:30:00 Uhr
YEARLY
Immer am 05.02. um 16:30:00 Uhr
SELECTED_DAYS
Um 16:30:00 Uhr an den ausgewählten Tagen
PERIODIC
Feld wird nicht ausgewertet
SimpleIoTCoreTimerDTO 1
SimpleIoTCoreTimerDTO 2
SimpleIoTCoreTimerDTO 3
{
   "id":"83b42f35-bd4d-460a-953b-38e2e22deebc",
   "name":"timer_once",
   "refId":"generic.virtual.timer",
   "type":"TIMER",
   "channels":{
      "TimerOn":{
         "type":"STATE",
         "descriptionId":"7FF06AB573E6FA5BFF463DC19F0983E0",
         "changeable":true,
         "value":"ON"
      },
      "Trigger":{
         "type":"STATE",
         "descriptionId":"02595BE69384636622E81F8AD7978D70",
         "changeable":false,
         "value":"NOT_TRIGGERED"
      }
   },
   "parameters":{},
   "enabled":true,
   "visible":true,
   "mode":"NORMAL",
   "time":1706094480,
   "offset":0,
   "timerType":"ONCE",
   "period":0,
   "selectedDays":[]
}
{
   "id":"83b42f35-bd4d-460a-953b-38e2e22deebc",
   "name":"timer_once",
   "refId":"generic.virtual.timer",
   "type":"TIMER",
   "channels":{
      "TimerOn":{
         "type":"STATE",
         "descriptionId":"7FF06AB573E6FA5BFF463DC19F0983E0",
         "changeable":true,
         "value":"ON"
      },
      "Trigger":{
         "type":"STATE",
         "descriptionId":"02595BE69384636622E81F8AD7978D70",
         "changeable":false,
         "value":"NOT_TRIGGERED"
      }
   },
   "parameters":{},
   "enabled":true,
   "visible":true,
   "mode":"NORMAL",
   "time":1706094480,
   "offset":0,
   "timerType":"ONCE",
   "period":0,
   "selectedDays":[]
}
﻿
SimpleIoTCoreThingDeletedDTO
Feld
Datentype
Beschreibung
id
String
Eindeutige ID des Gerätes im System.
SimpleIoTCoreThingDeletedDTO
{
  "id" : "76dd6b1f-3f6a-4c02-b6d7-3539cd03201c"
}
{
  "id" : "76dd6b1f-3f6a-4c02-b6d7-3539cd03201c"
}
﻿
﻿

Feld	Datentype	Beschreibung
id	String	Eindeutige ID des Gerätes im System
type	String	Basisgerätetyp
name	String	Der zugewiesene Name des Gerätes
refId	String	Referenz ID zu Angabe des Gerätetypes
channels	Object	Jedes Feld des Objektes repräsentiert einen Kanal für welchen ein Wertcontainer hinterlegt ist
parameters	Object	Jedes Feld des Objektes repräsentiert einen Parameter für welchen ein Wertcontainer hinterlegt ist

Type	Beschreibung
GENERIC	Basisgerätedatentyp für alle Geräte
ENOCEAN	EnOcean basierte Geräte
TIMER	Virtuelles Timergerät

Feld	Datentype	Beschreibung
signalStrength	Number	Signalstärke des letzten empfangenen Signals in Prozent. 0 - 100%
acknowledgeChannels	Object	Jedes Feld des Objektes repräsentiert einen Empfangskanal. Der Feldwert ist die verwendete EURID des Kanals oder ein leerer String falls keine ID zugewiesen ist.
transmissionChannels	Object	Jedes Feld des Objektes repräsentiert einen Sendekanal. Der Feldwert ist die verwendete Sende ID eines der verfügbaren EnOcean Gateways oder ein leerer String falls keine ID zugewiesen ist.

Feld	Datentype	Beschreibung
enabled	Boolean	Gibt an ob der Timer aktiviert ist oder nicht.
visible	Boolean	Gibt an ob der Timer sichtbar ist (nur Clients).
mode	String	Betriebsmodus des Timers.
timerType	String	Type des Timers.
time	Number	Eine Zeitangabe als Unix Timestamp. Die Angabe des Zeistempels erfolgt dabei für Werte mit Datum für unabhängig von der lokalen Zeitzone in UTC+0. Die Uhrzeit wird modulo 86400 gerechnet. Ansonsten berechnet sich der Tag und Monat bei wiederkehrender Ausführung aus dem eingestellten Datum bzw Wert im Feld time.
offset	Number	Anzuwendende Zeitverschiebung in Minuten (+/-).
period	Number	Angabe der Minuten für die periodische Auslösung.
selectedDays	Array	Ausgewählte Tage als String Array.

Type	Beschreibung
ONCE	Einmalige Ausführung des Timers an einem Tag zu einer bestimmten Uhrzeit.
DAILY	Tägliche Ausführung des Timers um eine bestimmte Uhrzeit.
WEEKLY	Wöchentliche Ausführung des Timers um eine bestimmte Uhrzeit.
MONTHLY	Monatliche Ausführung des Timers an einem bestimmten Tag, um eine bestimmte Uhrzeit.
YEARLY	Jährliche Ausführung des Timers an einem bestimmten Tag, um eine bestimmte Uhrzeit.
SELECTED_DAYS	Ausführung des Timers zu bestimmten Wochentagen.
PERIODIC	Periodische Ausführung des Timer nach einem festgelegten Intervall.

Mode	Beschreibung
NORMAL	Normaler Betriebsmodus
SUNRISE	Timer Auslösung bezieht sich auf den berechneten Sonnenaufgang inkl. Offset.
SUNSET	Timer Auslösung bezieht sich auf den berechneten Sonnenuntergang inkl. Offset.

Tag
MONDAY
TUESDAY
WEDNESDAY
THURSDAY
FRIDAY
SATURDAY
SUNDAY

Type	Auswertung
ONCE	Dienstag, 05.02.2024 16:30:00 Uhr
DAILY	Täglich um 16:30:00 Uhr
WEEKLY	Dientags um 16:30:00 Uhr
MONTHLY	Immer am 05. eines Monats um 16:30:00 Uhr
YEARLY	Immer am 05.02. um 16:30:00 Uhr
SELECTED_DAYS	Um 16:30:00 Uhr an den ausgewählten Tagen
PERIODIC	Feld wird nicht ausgewertet

Feld	Datentype	Beschreibung
id	String	Eindeutige ID des Gerätes im System.

Aktualisiert 25 Mar 2024

Hat Ihnen diese Seite geholfen?

Simple IoT Core

ALS NÄCHSTES

Werte