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.

Integrations-Alternativen

Es gibt zwei MQTT-Integrations-Alternativen:

• Flexibler Datenaustausch (empfohlen): Der flexible Datenaustausch ermöglicht den Empfang von Daten von Geräten (Uplink) sowie das Senden von Daten an Geräte (Downlink). Er ist äußerst flexibel und kann einfach implementiert werden.
• HTTP-Bridge (für Geräte-Migration): Die HTTP-Bridge ermöglicht die Migration von Geräten, die die HTTP-Schnittstelle verwenden, sodass sie stattdessen MQTT nutzen.

Authentifizierung und Sicherheit

Jede Gear Studio-Instanz verfügt über einen eigenen dedizierten MQTT-Server, der üblicherweise für sichere TLS-Verbindungen auf Port 8883 konfiguriert ist. Die MQTT-Server-Verbindung erfordert:

• Benutzername und Passwort, die über die Option "MQTT-Konfiguration" im Bereich "Sicherheit" der Gear Manager-Anwendung verwaltet werden können. Die Benutzer-ID wird auch als Suffix für alle MQTT-Topics verwendet.
• TLS-Zertifikat, das verwendet wird, damit das Gerät überprüfen kann, dass es mit dem richtigen Server verbunden ist.

Verwendung einer Client-ID

Einige MQTT-Clients erfordern die Definition einer "Client-ID" vor der Verbindung, während andere die Verwendung einer zufälligen ID ermöglichen. Wenn Sie explizit eine Client-ID definieren müssen, empfehlen wir die Verwendung einer Zeichenkette, die den Benutzernamen gefolgt von einem eindeutigen Suffix enthält. Sie können beispielsweise folgende Namenskonvention verwenden:

{client-secure-id}{generic-value}

E.g.: 16SAD5656S01

Dabei gilt:

• 16SAD5656S ist der in der Verbindung verwendete Benutzername, und
• 01 ist der "generic value", der für jede Verbindung unterschiedlich sein sollte.