Ihr Netzwerk über MQTT steuern

Voraussetzungen

Um Ihr Netzwerk über MQTT zu steuern, müssen Sie ein Gateway in Ihrem Netzwerk konfiguriert haben. Anweisungen zur Einrichtung eines Gateways finden Sie in der Gateway-Einrichtungsanleitung. Das Gateway fungiert als MQTT-Client und ermöglicht es Ihnen, Nachrichten über MQTT-Topics an Ihr Netzwerk zu senden und von diesem zu empfangen. Daher benötigen Sie auch einen MQTT-Broker, der in Ihrem Netzwerk läuft.

Einrichtung

Um das Gateway als MQTT-Bridge zu verwenden, müssen Sie es konfigurieren. Dies umfasst die Konfiguration des MQTT-Clients des Gateways, um eine Verbindung zu Ihrem MQTT-Broker herzustellen. Zusätzlich müssen Sie das Netzwerk auf das Gateway hochladen, damit es Ihre Geräte, Gruppen und Szenen kennt.

Info

Die erforderliche Gateway-Firmware-Version für die MQTT-Konfiguration ist >6.0.0. Gateways mit älteren Firmwares zeigen die MQTT-Konfigurationsoption nicht an.

Alle Konfigurationen erfolgen über die MQTT-Konfigurationsseite.

• Gehen Sie zur Gateway-Gerätedetailseite
• Öffnen Sie das Kontextmenü
• Wählen Sie "MQTT konfigurieren"

Gateway MQTT-Konfiguration

Nachdem Sie das Gateway zu Ihrem Netzwerk hinzugefügt haben, können Sie es so konfigurieren, dass es eine Verbindung zu Ihrem MQTT-Broker herstellt.

Füllen Sie die folgenden Felder aus:

• MQTT-URL: Die URL, unter der Ihr MQTT-Broker verfügbar ist. Dies umfasst das Protokoll ("mqtt://" oder bei aktiviertem TLS "mqtts://") und die IP-Adresse oder den Hostnamen Ihres MQTT-Brokers sowie die Portnummer.
• Root-Topic: Das Root-Topic, unter dem das Gateway veröffentlichen und auf Nachrichten hören wird. Dies wird mit Ihrem aktuellen Netzwerknamen vorausgefüllt.
• Client ID: Eine eindeutige Kennung für den MQTT-Client des Gateways, lassen Sie leer für eine zufällige.
• Benutzername: Der Benutzername des MQTT-Clients des Gateways.
• Passwort: Das Passwort des MQTT-Brokers des Gateways.

Nachdem Sie alle erforderlichen Felder ausgefüllt haben, klicken Sie auf die Schaltfläche "Speichern", um die Konfiguration anzuwenden.

Zertifikat-Einrichtung

Wenn Sie TLS auf Ihrem MQTT-Broker aktiviert haben, müssen Sie das Zertifikat Ihres MQTT-Brokers für das Gateway bereitstellen. Geben Sie eine URL ein, die mit "mqtts://" beginnt, in das Feld MQTT-URL. Dies aktiviert die Optionen für Sie, ein Serverzertifikat (erforderlich) hochzuladen. Zusätzlich können Sie optional Client-Zertifikate und -Schlüssel hochladen.

Netzwerk-Upload

Wählen Sie auf der MQTT-Einstellungsseite "Netzwerk hochladen", um das Netzwerk auf das Gateway hochzuladen, damit es rohe "Mesh-Nachrichten" in nützliche MQTT-Topics übersetzen und sie mit den Geräten/Gruppen in Ihrem Netzwerk verknüpfen kann. Nachdem das Netzwerk geändert wurde (z. B. neue Gruppen hinzugefügt), muss dies wiederholt werden, um die Netzwerkdarstellung des Gateways zu aktualisieren.

Verfügbare Topics

Siehe MQTT API-Dokumentation für eine vollständige Dokumentation der verfügbaren Topics und Nachrichtenformate.