/
Benutzerdefinierte Gerätetypen

Benutzerdefinierte Gerätetypen

Schwierigkeitsgrad: Experte

Lernziele

Nach der Lektüre dieses Artikels werden Sie in der Lage sein:

  • Identifizieren Sie, welche Datentypen von Spacewell Workplace unterstützt werden

  • Konfigurieren Sie Webhook & Autorisierungstoken, um Ihre externen Datenquellen mit Workplace zu verbinden


Angenommen, es gibt bereits Sensoren, die Daten im Gebäude sammeln, und Sie möchten deren Daten in die Workplace IOT-Plattform integrieren. Spacewell bietet einen generischen Endpunkt (mit Webhooks) für die meisten seiner Sensordatentypen, um Sensordaten von Drittanbieterplattformen zu integrieren, zu verarbeiten und zu speichern.

Sobald diese Verbindung hergestellt ist, ist es möglich, benutzerdefinierte Gerätetypen zu erstellen, um die Sensorverwaltung zu optimieren und effizienter zu gestalten:

  • Eindeutige und beschreibende Gerätetypbezeichnungen helfen bei der Unterscheidung zwischen den Sensoren und ermöglichen eine schnelle und genaue Identifizierung bei der Fehlersuche oder dem Austausch von Sensoren

  • Anpassbare Schwellenwerteinstellungen für jeden Gerätetyp lösen Warnmeldungen und proaktive Wartungsmaßnahmen aus und gewährleisten eine optimale Sensorleistung

Voraussetzungen

Der Sensorhersteller muss den Spacewell Webhook, die unterstützten Datentypen und die Nutzdaten einhalten, siehe External Data Sources

In Ihrer Workplace-Umgebung müssen die Sensor-IDs eindeutig sein und die Hersteller-ID vorangestellt werden.
Die Kombination von Geräte-IDs von mehreren Drittanbietern in einer externen Datenquelle birgt das Risiko von Konflikten.

Gerätetypen auf dem Workplace konfigurieren

Wie man Zugang erhält

  • Gehen Sie zu Studio

  • Anmeldung mit Ihren Anmeldedaten

  • Wählen Sie Integrationen > Gerätetypen in der Studio 2.0-Schnittstelle

  • Wählen Sie "Neu hinzufügen".

Allgemein

  1. Gerätetyp Name

  2. Die Gerätetyp-ID wird als eindeutiger Bezeichner Ihres Gerätetyps verwendet, z. B. beim Batch-Import von Geräten.

    1. Benutzerdefinierte Gerätetyp-IDs enthalten immer das Präfix "Generic|".

Die Gerätetyp-ID darf nur Kleinbuchstaben, numerische Zeichen oder das Symbol - enthalten.

Nach dem Speichern ist es im Bearbeitungsmodus nicht mehr möglich, die Gerätetyp-ID zu aktualisieren.

  1. Externe Datenquelle

    1. eine bestimmte Externe Datenquelle auswählen, wenn die Daten für diesen Gerätetyp immer von einer Externen Datenquelle bereitgestellt werden sollen. Das Herstellen dieser 1-on-1-Verbindung ist für die Geräteregistrierung im Workplace von Vorteil (siehe unten Kapitel "Geräte im Workplace konfigurieren")

    2. Wählen Sie "Beliebig", wenn die Daten für diesen Gerätetyp aus verschiedenen externen Datenquellen stammen können. In diesem Fall ist die Geräteregistrierung im Workplace etwas komplexer (siehe unten Kapitel "Geräte im Workplace konfigurieren")

  1. Status: ermöglicht die Auswahl des Gerätetyps aus der Dropdown-Liste Gerätetyp bei der Konfiguration von Geräten im Workplace

  2. Gerätebild: Behalten Sie das Standardbild bei, wählen Sie ein allgemeines Bild oder laden Sie ein Bild Ihres Gerätetyps hoch. Dieses Bild wird auf der Seite Geräteetikett

 

image-20240522-160705.png

Sensor Gesundheit

Der Sensorzustand ergibt sich aus der letzten Kommunikation des Sensors mit der Workplace Platform. Die Kommunikation kann ein Sensorwert oder ein Heartbeat sein. Da jeder Gerätetyp seine eigene Heartbeat-Frequenz hat, wird der Zustand des Geräts pro Gerätetyp ausgewertet. Für weitere Informationen siehe How to monitor Sensor Health

Geben Sie numerische Werte ein, die verwendet werden, um den Status der mit dem Gerätetyp verbundenen Geräte zu ändern:

  1. Zur Kontrolle

  2. Offline

    1. Wert muss größer sein als der Wert von To Check

image-20240523-154234.png

Sensor-Details

Von der Liste der unterstützten DatentypenWählen Sie aus, welche Kanäle für den Gerätetyp, den Sie erstellen, relevant sind. Mit anderen Worten: Welche Art von Sensordaten werden von Geräten, die für diesen Gerätetyp eingerichtet sind, an Workplace gesendet?

  • CO₂

  • Zähler

  • Fußgängerimpuls (in)

  • Fußgängerimpuls (aus)

  • Personalbestand

  • Luftfeuchtigkeit

  • Anwesenheit*

  • Puls

  • Radon

  • Temperatur

  • VOC

* Anwesenheit

Bei Anwesenheits-/Bewegungsmeldern gibt es einen Unterschied in der Art und Weise, wie einige die Abwesenheit von Anwesenheit bestätigen oder eben nicht bestätigen:

  • Wählen Sie "Nein", wenn das Gerät Anwesenheitsdaten sendet, um die Belegung zu bestätigen, und möglicherweise Daten sendet, um den Leerstand zu bestätigen, aber diese Leerstandsbestätigung nicht sendet, sobald der Standort verfügbar ist (~ ist nicht zuverlässig in der Bestätigung des Leerstands)

  • Wählen Sie "Ja", wenn das Gerät Anwesenheitsdaten sendet, um die Belegung zu bestätigen, und auch Daten sendet, um den Leerstand zu bestätigen, sobald der Standort wieder verfügbar ist

 

 

Wenn ein Sensor die Vakanz nicht zuverlässig bestätigt, d.h. wenn wir nicht 100%ig sicher sind wenn der Standort wieder verfügbar ist, können Sie den Symbolabfall auf dem Live-Grundriss über Live floorplan settings | Occupancy settings.

 

Beispiel 1. PIR-Bewegungsmelder

Der PIR-Bewegungssensor in diesem Beispiel sendet Daten, die "Anwesenheit erkannt" bestätigen, sobald er ausgelöst wird. In diesem Sinne ist der Sensor zuverlässig in der Übermittlung von Anwesenheitsbestätigungen.

Entfernt sich der Benutzer jedoch vom Sensor, obwohl der Raum objektiv frei ist, sendet der Sensor nicht sofort eine Statusänderung. Der Sensor ist also unzuverlässig bei der Übermittlung von Leerstandsbestätigungen.

Wählen Sie bei der Erstellung dieses Gerätetyps "unzuverlässig".

 

Beispiel 2. Personenzählsensor mit Belegungsdaten

Der Kopfzählungssensor in diesem Beispiel sendet jede Minute Daten:

  • Die Daten können 1 oder höher sein, was bedeutet, dass mindestens eine Person erkannt wird. Dies kann als "Anwesenheit erkannt" interpretiert werden, da der Ort besetzt ist.

  • Die Daten können den Wert "0" haben, was bedeutet, dass keine Mitarbeiterzahl festgestellt wurde - was in Wirklichkeit mit "keine Anwesenheit festgestellt" oder "dieser Standort ist frei" übersetzt werden kann.

In diesem Fall wird Workplace, auch wenn jemand einen Raum betritt, um etwas zu holen, und den Raum sofort wieder verlässt, nach spätestens 2 Minuten mit der Information aktualisiert, dass an diesem Ort keine Belegung (mehr) festgestellt wurde.

Wählen Sie bei der Erstellung dieses Gerätetyps "zuverlässig".

Geräte im Workplace konfigurieren

Voraussetzungen

  • die Bestätigung haben, daß die Verbindung der externen Datenquelle zum Workplace erfolgreich war, siehe External Data Sources | Test your setup

  • die Bestätigung haben, welcher Datentyp zur Übermittlung der Daten verwendet werden soll

  • die Liste der Geräte-IDs haben, die Daten von der externen Datenquelle an die Workplace-Plattform senden werden

 

Abhängig von der (bekannten) Verbindung zwischen dem Gerätetyp und einer bestimmten externen Datenquelle werden unterschiedliche Informationen benötigt, um Geräte im Workplace zu konfigurieren:

1. Wenn der Gerätetyp für die Verbindung mit einer bestimmten externen Datenquelle eingerichtet ist

Die Einrichtung einer 1-on-1-Verbindung zwischen Gerätetyp und externer Datenquelle ist für die Geräteregistrierung in Workplace Studio von Vorteil:

  1. Gehen Sie zu Ihrer Umgebung (https://studio.cobundu.com ) und melden Sie sich an

  2. Wählen Sie den Standort aus, und fügen Sie manuell einen Sensor über "Neues Gerät hinzufügen"

  3. Wählen Sie die entsprechende Gerätetyp aus der Dropdown-Liste. Je nach ausgewähltem Gerätetyp wird ein Standardsatz von Kanälen aktiviert

  4. Füllen Sie das Geräte-ID die in der Nutzlast verwendet wird, um über diesen Datenpunkt zu berichten*

  5. Geben Sie eine sinnvoller Name (z.B. Kundennummer_Etage_Fläche) in Gerätename.

  6. Der Ort wird auf der Grundlage Ihrer Vorauswahl im Ortsbaum ausgefüllt.

 

Weitere Informationen darüber, wie Sie mehrere neue Geräte zu Studio hinzufügen können, finden Sie unter Configure devices (add, remove, import, and export).

 

 

2. Wenn der Gerätetyp für die Verbindung mit einer "beliebigen" externen Datenquelle eingerichtet ist

Wählen Sie "Beliebig", wenn die Daten für diesen Gerätetyp aus verschiedenen externen Datenquellen stammen könnten. In diesem Fall ist die Geräteregistrierung im Workplace etwas komplexer:

  1. Gehen Sie zu Ihrer Umgebung (https://studio.cobundu.com ) und melden Sie sich an

  2. Wählen Sie den Standort aus, und fügen Sie manuell einen Sensor über "Neues Gerät hinzufügen"

  3. Wählen Sie die entsprechende Gerätetyp aus der Dropdown-Liste. Je nach ausgewähltem Gerätetyp wird ein Standardsatz von Kanälen aktiviert

  4. Füllen Sie das Geräte-IDVerwenden Sie die Mieter-ID und die Quellen-ID, die unter Einstellungen > Externe Datenquellen verfügbar sind. Halten Sie sich an das Format <Mieter_id>-<Quelle_id>|<Geräte_id>

zum Beispiel

  • wenn Sie einen Sensor mit der ID "123" konfigurieren möchten (eindeutige Geräte-ID, die in der Nutzlast(im Falle eines Drittanbieters muss der Drittanbieter diese Angaben machen)

  • in einer Umgebung mit der Mieter-ID "spacewell"

  • wo eine externe Datenquelle mit der Quell-ID "testgeneric" eingerichtet wurde

wird die Spacewell-Geräte-ID

"spacewell-testgeneric|123"

  1. Geben Sie eine sinnvoller Name (z.B. Kundennummer_Etage_Fläche) in Gerätename.

  2. Der Standort wird anhand Ihrer Vorauswahl im Standortbaum ausgefüllt

Weitere Informationen darüber, wie Sie mehrere neue Geräte zu Studio hinzufügen können, finden Sie unter Configure devices (add, remove, import, and export).

 

FAQ

Je nach Art des Sensors senden sie möglicherweise nicht regelmäßig Herzschläge oder Daten. Wenn sie Daten senden und dann nur bei einer Wertänderung eine Nachricht senden, kann es sein, dass Sie nur Bruchstücke von Daten erhalten (z. B. ein Zeitfenster von 15 Minuten mit Daten über die Temperatur und den Rest des Tages nichts), was zu Verwirrung führen würde, wenn Sie versuchen, die Dashboards zu lesen.

Um dies zu umgehen, können Sie Spacewell veranlassen, die Daten pro generischer Endpunkt-/Gerätetyp-Ebene für eine beliebige Zeitspanne zu kopieren.

Zum Beispiel könnten wir für den Sensortyp "Generic PIR" ein "copy in further time slots" einstellen und dieser Wert würde für alle Generic PIR Sensorwerte gelten, die bei uns für Ihren Mieter eingehen. Natürlich werden die Daten nur so lange kopiert, bis wieder neue Daten eintreffen. Wenn also ein Wert am Montag um 9 Uhr eingeht und die Konfiguration sagt "Kopie für 7 Tage", und am Mittwoch um 8 Uhr ein neuer Wert eingeht, dann wird der neue Wert ab Mittwoch um 8 Uhr für 7 Tage übernommen, oder bis ein neuer Wert eingeht.

Wenden Sie sich an Ihren Kundenbetreuer, um dies einzurichten.

Im Workplace können Sie einen Gerätetyp deaktivieren, aber nicht löschen. Die Löschung würde sich auf Geräte auswirken, die mit diesem Gerätetyp erstellt wurden.

Fehlersuche

Stellen Sie sicher, dass die folgende Konfiguration vorhanden ist:

  • Die im Workplace angelegte Sensor-ID folgt der beschriebenen Logik und enthält:

    • Umgebung Mieter-ID

    • Externe Datenquellen-ID

    • Unique_device_id, die in der Nutzlast erwähnt wird (im Falle eines Drittanbieters muss diese vom Drittanbieter bereitgestellt werden)

  • Die Sensordaten werden gemäß den erforderlichen External Data Sources | Supported data types & payload

  • die relevanten Sensordatenkanäle für das Gerät auf der Spacewell-Plattform aktiviert sind

 


 

Suche

Search