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
Gerätetyp Name
Die Gerätetyp-ID wird als eindeutiger Bezeichner Ihres Gerätetyps verwendet, z. B. beim Batch-Import von Geräten.
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.
Externe Datenquelle
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")
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")
Status: ermöglicht die Auswahl des Gerätetyps aus der Dropdown-Liste Gerätetyp bei der Konfiguration von Geräten im Workplace
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
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:
Zur Kontrolle
Offline
Wert muss größer sein als der Wert von To Check
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.
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:
Gehen Sie zu Ihrer Umgebung (https://studio.cobundu.com ) und melden Sie sich an
Wählen Sie den Standort aus, und fügen Sie manuell einen Sensor über "Neues Gerät hinzufügen"
Wählen Sie die entsprechende Gerätetyp aus der Dropdown-Liste. Je nach ausgewähltem Gerätetyp wird ein Standardsatz von Kanälen aktiviert
Füllen Sie das Geräte-ID die in der Nutzlast verwendet wird, um über diesen Datenpunkt zu berichten*
Geben Sie eine sinnvoller Name (z.B. Kundennummer_Etage_Fläche) in Gerätename.
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:
Gehen Sie zu Ihrer Umgebung (https://studio.cobundu.com ) und melden Sie sich an
Wählen Sie den Standort aus, und fügen Sie manuell einen Sensor über "Neues Gerät hinzufügen"
Wählen Sie die entsprechende Gerätetyp aus der Dropdown-Liste. Je nach ausgewähltem Gerätetyp wird ein Standardsatz von Kanälen aktiviert
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>
Geben Sie eine sinnvoller Name (z.B. Kundennummer_Etage_Fläche) in Gerätename.
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
Fehlersuche
Suche