Inhaltsverzeichnis

Things

Letztes Update 2021/04/11 14:47

Things sind die Entitäten1), die einem System physisch hinzugefügt werden können und die möglicherweise viele Funktionen in einem bereitstellen können. Es ist wichtig zu beachten, dass Things keine Geräte sein müssen, sondern auch einen Webdienst oder eine andere verwaltbare Informations- und Funktionsquelle darstellen können. Aus Anwendersicht sind sie für den Einrichtungs- und Konfigurationsprozess relevant, nicht jedoch für den Betrieb.

Things können Konfigurationseigenschaften haben, die optional oder obligatorisch sein können. Solche Eigenschaften können grundlegende Informationen wie eine IP-Adresse, ein Zugriffstoken für einen Webdienst, oder eine gerätespezifische Konfiguration sein, die sein Verhalten ändert.

Channels (Kanäle)

Things bieten „Channels“, die die verschiedenen Funktionen darstellen, die das Thing bietet. Wenn das Thing die physische Einheit oder Informationsquelle ist, ist der Channeleine konkrete Funktion dieses Things . Eine physische Glühbirne kann einen Farbtemperaturchannel und einen Farbchannel haben, die beide die Funktionalität eines Glühbirnen-Thing für das System bereitstellen. Für Informationsquellen kann das Thing das lokale Wetter mit Informationen von einem Webdienst mit verschiedenen Channels wie Temperatur, Druck und Luftfeuchtigkeit sein.

Channels sind mit Items verknüpft, wobei solche Verknüpfungen der Klebstoff zwischen der virtuellen und der physischen Schicht sind. Sobald eine solche Verbindung hergestellt ist, reagiert ein Thing auf Ereignisse, die für ein Element gesendet wurden, das mit einem seiner Channels verknüpft ist. Ebenso sendet es aktiv Ereignisse für Items, die mit seinen Channels verknüpft sind.

Bridges (Brücken)

Eine besondere Art von Thing ist eine „Bridge“. Bridges sind Dinge, die dem System hinzugefügt werden müssen, um Zugriff auf andere Thing zu erhalten. Ein typisches Beispiel für eine Bridge ist ein IP-Gateway für ein nicht IP-basiertes Hausautomationssystem oder eine Webdienstkonfiguration mit Authentifizierungsinformationen, die möglicherweise von diesem Webdienst benötigt werden.

Discovery (Entdeckung)

Da viele Dinge automatisch entdeckt werden können, stehen spezielle Mechanismen zur Verfügung, die sich mit dem Umgang mit Automatisch entdeckten Dingen befassen.

Thing Status

Jedes Ding hat ein Statusobjekt, mit dessen Hilfe mögliche Probleme mit dem Gerät oder Dienst identifiziert werden können. Die folgende Tabelle gibt einen Überblick über die verschiedenen Status:

Status Beschreibung
UNINITIALIZED Dies ist der Anfangsstatus eines Things, wenn es hinzugefügt oder das Framework gestartet wird. Dieser Status wird auch zugewiesen, wenn der Initialisierungsprozess fehlgeschlagen ist oder die Bindung nicht verfügbar ist. An Channels gesendete Befehle werden nicht verarbeitet.
INITIALIZING Dieser Status wird zugewiesen, während die Bindung das Thing initialisiert. Es hängt von der Bindung ab, wie lange der Initialisierungsprozess dauert. An Channels gesendete Befehle werden nicht verarbeitet.
UNKNOWN Der Handler ist vollständig initialisiert, kann jedoch aufgrund der Art des dargestellten Geräts / Dienstes noch nicht wirklich sagen, ob das Thing ONLINE oder OFFLINE ist. Daher funktioniert das Thing möglicherweise bereits richtig und kann Befehle verarbeiten oder auch nicht. Das Framework darf jedoch Befehle senden, da einige funkbasierte Geräte möglicherweise ONLINE geschaltet werden, wenn ein Befehl an sie gesendet wird. Der Handler sollte darauf achten, das Thing so schnell wie möglich auf ONLINE oder OFFLINE umzustellen.
ONLINE Es wird davon ausgegangen, dass das durch eine Sache dargestellte Gerät / Dienst ordnungsgemäß funktioniert und Befehle verarbeiten kann.
OFFLINE Es wird angenommen, dass das durch eine Sache dargestellte Gerät / Dienst nicht richtig funktioniert und möglicherweise keine Befehle verarbeitet. Das Framework darf jedoch Befehle senden, da einige funkbasierte Geräte möglicherweise zu ONLINE zurückkehren, wenn ein Befehl an sie gesendet wird.
REMOVING Das durch eine Sache dargestellte Gerät / Dienst sollte entfernt werden, aber die Bindung hat das Löschen noch nicht bestätigt. Einige Bindungen müssen mit dem Gerät kommunizieren, um es vom System zu trennen. Die Sache funktioniert wahrscheinlich nicht und Befehle können nicht verarbeitet werden.
REMOVED Dieser Status zeigt an, dass das durch eine Things dargestellte Gerät / Dienst aus dem externen System entfernt wurde, nachdem das REMOVED vom Framework initiiert wurde. Normalerweise ist dieser Status ein Zwischenstatus, da das Ding aus der Datenbank entfernt wird, nachdem dieser Status zugewiesen wurde.

Die Status UNINITIALIZED, INITIALIZING und REMOVING werden vom Framework festgelegt, während die Status UNKNOWN, ONLINE und OFFLINE aus einer Bindung zugewiesen werden.

Zusätzlich wird der Status REMOVED durch die Bindung festgelegt, um anzuzeigen, dass der Entfernungsprozess abgeschlossen wurde, d.h., die Sache muss zuvor im Status REMOVING gewesen sein.

Statusübergänge

Das folgende Diagramm zeigt die zulässigen Statusübergänge:

Der Anfangsstatus einer Sache ist UNINITIALIZED. Von UNINITIALIZED geht das Ding in INITIALIZING. Wenn die Initialisierung fehlschlägt, kehrt das Ding zu UNINITIALIZED zurück. Wenn die Initialisierung erfolgreich ist, setzt die Bindung den Status des Things auf UNKNOWN, ONLINE oder OFFLINE, was bedeutet, dass der Thing-Handler vollständig initialisiert ist. Von einem dieser Status kann das Thing in UNINITIALIZED, REMOVING oder REMOVED zurückkehren. Die Status REMOVING und REMOVED können auch von jedem anderen Status aus erreicht werden.

Statusdetails

Ein Status wird mit einem Statusdetailobjekt weiter detailliert. In der folgenden Tabelle sind die verschiedenen Statusdetails für jeden Status aufgeführt:

UNINITIALIZED NONE Keine weiteren Statusdetails verfügbar.
HANDLER_MISSING_ERROR Der Handler kann nicht initialisiert werden, da die verantwortliche Bindung nicht verfügbar ist oder nicht gestartet wurde.
HANDLER_REGISTERING_ERROR Der Handler ist in der Dienstregistrierungsphase fehlgeschlagen.
HANDLER_CONFIGURATION_PENDING Der Handler ist registriert, kann jedoch aufgrund fehlender Konfigurationsparameter nicht initialisiert werden.
HANDLER_INITIALIZING_ERROR Der Handler ist in der Initialisierungsphase fehlgeschlagen.
BRIDGE_UNINITIALIZED Die mit diesem Thing verknüpfte Brücke wird nicht initialisiert.
DISABLED Das Thing wurde explizit deaktiviert.
INITIALIZING NONE Keine weiteren Statusdetails verfügbar.
UNKNOWN NONE Keine weiteren Statusdetails verfügbar.
ONLINE NONE Keine weiteren Statusdetails verfügbar.
CONFIGURATION_PENDING Das Thing wartet darauf, Konfigurationsinformationen auf ein Gerät zu übertragen. Einige Bindungen müssen mit dem Gerät kommunizieren, um sicherzustellen, dass die Konfiguration akzeptiert wird.
OFFLINE NONE Keine weiteren Statusdetails verfügbar.
COMMUNICATION_ERROR Fehler bei der Kommunikation mit dem Gerät. Dies kann ein vorübergehender Fehler sein.
CONFIGURATION_ERROR Ein Problem mit der Konfiguration einem Thing verhindert die Kommunikation mit dem dargestellten Gerät oder Dienst. Dieses Problem kann durch Neukonfiguration des Things behoben werden.
BRIDGE_OFFLINE Angenommen, das Thing ist offline, weil die entsprechende Brücke offline ist.
FIRMWARE_UPDATING Das Thing wird derzeit einem Firmware-Update unterzogen.
DUTY_CYCLE Das Thing befindet sich derzeit im Status DUTY_CYCLE, was bedeutet, dass es für die weitere Verwendung gesperrt ist.
GONE Das Thing wurde von der Brücke oder dem Netzwerk, zu dem es gehört, entfernt und steht nicht mehr zur Verfügung. Der Benutzer kann nun das Thing aus dem System entfernen.
REMOVING NONE Keine weiteren Statusdetails verfügbar.
REMOVED NONE Keine weiteren Statusdetails verfügbar.

Die Übersetzung steht unter der EPLv2 Lizenz.

Items  Items

1)
Entitäten sind Dinge (Things), die tatsächlich existieren, also ein Schalter o.ä.