Der Timberwolf Server kann mit mehreren MQTT Brokern verbunden werden. Für jede Verbindung ist zunächst ein MQTT Subsystem anzulegen.

Voraussetzungen

• MQTT Broker verfügbar: Ein MQTT Broker ist per TCP/IP erreichbar und kann genutzt werden
  hinweis Zur Anleitung: MQTT Broker in einem Docker Container installieren)

• Verbindungsdaten bekannt: Sie kennen die Daten für den MQTT Broker

Subsystem anlegen und Verbindung einrichten

Rufen Sie das Funktionsmodul auf unter MQTT → MQTT Broker

Betätigen Sie nun die Schaltfläche + MQTT Subsystem anlegen und Verbindung zu Broker hinzufügen

Open

Sie können nun die MQTT Broker Einstellungen vornehmen

Mindestens drei Parameter sind anzugeben:

• Name: Geben Sie eine Bezeichnung für dieses MQTT Subsystem an

• Adresse: Geben Sie die IP-Adresse bzw. den Hostnamen an, unter welcher der MQTT Broker erreichbar ist

• Client ID: Nach der Eingabe der Adresse erscheint eine automatisch generierte ID. Diese muss normalerweise nicht geändert werden, muss aber pro Verbindung zum Broker eindeutig sein.

Betätigen Sie anschließend die Schaltfläche Speichern und starten. Fertig.

Open

Erklärung

• Name: Als Name können Sie eine beliebige Bezeichnung eingeben. Diese muss innerhalb der Timberwolf Subsysteme eindeutig sein. Nach dem Speichern können Sie mit dem Link Verwalte Subsysteme diese Bezeichnung später ändern.

• Adresse: Sofern der MQTT Broker als lokaler Container im Timberwolf Server betrieben wird und ein Portmapping im Portainer für diesen Container erstellt wurde, dann ist dieser MQTT Broker unter der IP des Timberwolf Servers selbst erreichbar. In diesem Fall können Sie ‘localhost’ ohne Anführungszeichen eingeben.
  Hinweis MacVLAN: Sollten Sie den MQTT Broker in einem lokalen Container betreiben und auf dem Timberwolf Server sowie für diesen Container ist MacVLAN aktiviert, dann müssen Sie die IP-Adresse des Containers angeben ('localhost' funktioniert hier nicht).
  Hinweis MQTT Broker auf anderem Gerät: Sofern der MQTT Broker auf einem anderen Gerät ausgeführt wird, dann geben Sie hier dessen DNS-Namen oder dessen IP-Adresse ein.

• Port: Der übliche Port für den Zugriff auf den MQTT Broker ist 1883.

• Client ID: Diese ID muss einmalig für jede Verbindung mit dem genutzten MQTT Broker sein. Bei der Eingabe wird automatisch eine ID anhand der Timberwolf Nummer vorgeben. Kein weiterer MQTT Client darf die gleiche ID benutzen, da es ansonsten zu Kollisionen bzw. Instabilitäten der Verbindung kommt (automatische Abmeldung bei Konflikt).

• Zeitlimit für Verbindung: Dies ist ein Zeitlimit (“Timeout”) für die Verbindung zum MQTT Broker. Würde ein Broker auf eine Anforderung nicht in dieser Zeit antworten, wird ein interner Fehler erzeugt und die Verbindung anschließend neu aufgebaut. Wir empfehlen 30 Sekunden (Vorgabewert)

• Vorgabe QoS: Hier können die drei möglichen Quality of Service Stufen für MQTT für alle in Verbindung mit diesem Subsystem genutzten MQTT Topics eingestellt werden. Wir empfehlen Level 0 (Vorgabewert).
  Hinweis: Für die jeweiligen subskribierenden bzw. publizierenden Transaktionen im MQTT Geräte Manager kann das QoS jeweils einzeln eingestellt werden.

• Intervall Lebenszeichen: Der MQTT Client des Timberwolf Servers sendet ein regelmäßiges Lebenszeichen ('Heartbeat”) an den MQTT Broker. Wir empfehlen 60 Sekunden (Vorgabewert).

• Max. Transaktionen: Diese Option (“Max. Inflight”) definiert die maximale Anzahl der Publizierungen mit QoS Level 1 oder QoS Level 2, die gleichzeitig übertragen werden können. Der Standardwert ist 10 gleichzeitig übertragene Nachrichten mit QoS. Geben Sie 0 für keine Begrenzung an.
  Hinweis: Dieser Parameter muss zu den Einstellungen des MQTT Brokers passen.

• SSL Version: TLS wird derzeit noch nicht unterstützt, der Parameter kann damit nicht genutzt werden.

• Benutzername / Passwort: Geben Sie hier das Konto an, falls Sie für diese Verbindung die Nutzung einer Anmeldung im MQTT Broker hinterlegt haben. Wenn Sie den von uns empfohlenen MQTT Broker im Container ohne weitere Konfiguration nutzen, dann sind keine Konten angelegt und daher ist hier nichts einzugeben.

Mit den beiden im Screenshot markierten Eingaben und Betätigen von Speichern und starten ist das MQTT Subsystem angelegt und mit einem MQTT Broker mit Standardwerten verbunden.

In der Regel ist nichts weiter einzustellen.

Weiter geht es hiermit: Kommunikation mit MQTT Geräten konfigurieren