Geräte-Integration
Einführung
Dieser Abschnitt erklärt, wie Sie Geräte in die Gear Studio-Plattform integrieren, das heißt:
- Wie Sie Geräte dazu bringen, Daten an die Plattform zu senden.
- Wie Sie die Plattform dazu bringen, Daten an Geräte zu senden, sofern die Geräte dies unterstützen.
Sobald ein Gerät in die Plattform integriert ist, ist Folgendes möglich:
- Erstellen Sie Dashboards, die den Gerätestatus in Echtzeit anzeigen.
- Zeigen Sie Informationen in einer Vielzahl von Berichten an.
- Erstellen Sie konfigurierbare Alarme mit E-Mail- und SMS-Benachrichtigungen.
- Exportieren Sie Informationen über APIs.
- Überwachen und steuern Sie Geräte über Gear Studio-Webanwendungen.
- Überwachen und steuern Sie Geräte von iOS und Android aus mit der Gear Studio-App.
Wichtig: Die Geräte-Integration ist nicht nur für kommerzielle Geräte verfügbar, sondern ermöglicht auch die Verbindung von selbstgebauten Geräten auf Basis von Arduino, nodeMCU, Raspberry Pi und vielen mehr.
Wenn Sie nicht sicher sind, was genau ein „GerätGeräte und Endpunkte.
Wichtige Konzepte
Datennachrichten
Integrationen sind in erster Linie dafür verantwortlich, von Geräten empfangene Nachrichten zu verarbeiten, damit sie von der Plattform verarbeitet werden können, sowie Befehle, die von der Plattform gesendet werden, in ein Format umzuwandeln, das Geräte verarbeiten können. Es werden zwei Arten von Nachrichten berücksichtigt:
- Uplink: Uplink-Nachrichten sind alle Nachrichten, die von Geräten an die Plattform gesendet werden. Die Plattform muss in der Lage sein, Uplink-Nachrichten zu verarbeiten, um die relevanten Informationen zu speichern und zu verarbeiten.
- Downlink: Downlink-Nachrichten sind solche, die von der Plattform an Geräte gesendet werden, typischerweise in Form von Befehlen. Einige Geräte unterstützen keine Downlink-Nachrichten, während andere sie nur für bestimmte Konfigurationsvorgänge unterstützen.
Viele Geräte verfügen über eine native Integration in die Gear Studio-Plattform, und alles, was erforderlich ist, ist, sie korrekt zu verbinden und zu konfigurieren. Für Geräte, die nicht nativ unterstützt werden, besteht die Integration darin, zu definieren, wie Uplink-Nachrichten verarbeitet werden und wie Downlink-Nachrichten erstellt werden.
Gerätemodelle
Die Verarbeitung von Uplink- und Downlink-Nachrichten erfolgt pro Gerätemodell. Für nativ unterstützte Geräte ist die Integration bereits ohne zusätzlichen Aufwand verfügbar.
Wenn ein Gerät nicht nativ unterstützt wird, besteht die Integration hauptsächlich darin, ein Gerätemodell zu erstellen, das es korrekt repräsentiert, und anzugeben, wie Uplink-Nachrichten verarbeitet werden und wie Downlink-Nachrichten erstellt werden. In diesen Fällen können Skripte verwendet werden, um die gesamte Arbeit automatisch zu erledigen, sodass sich diese Gerätemodelle genauso verhalten, als wären sie nativ unterstützt.
Erste Schritte
Erstellen eines Zugriffstokens
Für Integrationen über HTTP, MQTT oder LoRaWAN ist es zunächst erforderlich, ein Zugriffstoken zu erstellen. Diese Seite enthält weitere Informationen zur Verwaltung von Zugriffstokens. Zugriffstokens ermöglichen die Kontrolle des Zugriffs und der Berechtigungen, die für jeden Vorgang verwendet werden.
Auswahl eines Gerätemodells
Es ist wichtig zu verstehen, ob das zu integrierende Gerät nativ auf der Plattform unterstützt wird. Wenn ja, ist keine zusätzliche Arbeit erforderlich. Wenn das Gerätemodell jedoch nicht unterstützt wird, müssen Sie ein neues Gerätemodell erstellen. Siehe diese Referenz für weitere Informationen zu diesem Thema.
Erstellen eines Geräts
Sobald Sie ein Zugriffstoken haben und die Plattform das zu integrierende Gerätemodell enthält, bleibt nur noch, es auf der Plattform zu erstellen, damit es sich verbinden kann. Dies kann erreicht werden, indem Sie dieser Anleitung folgen. Wenn Sie nicht sicher sind, was genau ein „GerätGeräte und Endpunkte.
Wenn das Gerätemodell nativ unterstützt wird oder wenn ein Gerätemodell erstellt wurde, um es zusammen mit einem Skript darzustellen, das die darin enthaltenen Endpunkte definiert, sind keine weiteren Schritte erforderlich. In einigen Fällen müssen Sie jedoch möglicherweise manuell Endpunkte innerhalb des Geräts erstellen. In diesem Fall können Sie dies tun, indem Sie dieser Anleitung folgen. Wenn Sie nicht sicher sind, was genau ein „EndpunktGeräte und Endpunkte.
Integrationsoptionen
Derzeit gibt es drei Integrationsalternativen, die im Folgenden detailliert beschrieben werden.
| Integration | Reference / Help |
|---|---|
| MQTT | Device integration via MQTT |
| HTTP | Device integration via HTTP |
| LoRaWAN | Integration through The Things Stack, Integration through ThingPark, Integration through Helium |
Ersetzung globaler Variablen
Dies ist der Prozess, bei dem eine lokale Variable (vom Kunden definiert) entfernt und durch eine globale Variable ersetzt wird, wobei diese Änderung auf alle Geräte, Modelle oder Umgebungen angewendet wird, in denen sie zuvor konfiguriert war.
MQTT
Einführung Dieser Abschnitt beschreibt die Integration mit der Gear Studio-Plattform über MQTT. Diese Funktionalität ermöglicht die Integration von Geräten verschiedener Hersteller sowie selbst gebauten Geräten mit Arduino, nodeMCU, Raspberry Pi und jeder anderen Plattform, die MQTT-Kommunikation mit TLS-Sicherheit unterstützt.