Mqtt; Nachrichtenformat; Ausführen Von Konsolen Kommandos - GUDE Systems Expert Power Control 8101 Serie Anleitung

Spezifikationen
4.7

MQTT

Dieses Gerät unterstützt MQTT 3.1.1 um konfigurierte Nachrichten zu verschicken, und
auch Kommandos entgegenzunehmen. Dieses Kapitel ist für alle Gude Geräte allgemein
gehalten, manche Gude Modelle haben keine schaltbaren Ports.
· Default Port für eine unverschlüsselte Verbindung ist Port 1883.
· Default Port für eine TLS gesicherte Verbindung ist Port 8883.
· Wenn der Broker einen anonymen Login erlaubt, sind Benutzername und Passwort
beliebig, aber ein Benutzername muss angegeben werden.
· Wenn mehrere MQTT Clients mit einem Broker verbunden sind, müssen die Namen
der Clients verschieden sein. Aus diesem Grund wird als Default Name "client_xxxx"
generiert. Dabei sind "xxxx" die 4 letzten Stellen der MAC-Adresse.

Nachrichtenformat

Die MQTT Nachrichten des Gerätes werden immer im JSON Format verschickt. Z.B.
{"type": "portswitch", "idx": 2, "port": "2", "state": 1, "cause": {"id": 2, "txt": "http"}, "ts":
1632}
Dies ist ein Schalten des zweiten Ports in den Zustand ("state") on. Die Quelle des
Schaltkommando ist CGI ("http"). Der Index ist immer numerisch, "port" kann bei Gerä-
ten mit mehreren Banks auch alphanumerisch sein, z.B. "A2". Am Ende folgt ein time-
stamp ("ts"), der die Anzalh der Sekunden anzeigt, die das Gerät eingeschaltet ist, oder
unixtime wenn das Gerät sich mit einem NTP-Server synchronisiert hat.
MQTT Topic Prefix
Das Topic Prefix für die Nachrichten ist in der MQTT Konfiguration einstellbar. Ein
Default wäre z.B. "de/gudesystems/epc/[mac]". Hier steht "[mac]" als Platzhalter für die
MAC-Adresse des Gerätes, ein weiterer möglicher Platzhalter ist "[host]", der den Host-
Namen beinhaltet. Ein Beispiel Topic für eine Schaltnachricht des zweites Ports wäre
dann:
"de/gudesystems/epc/00:19:32:01:16:41/switch/2".
Ausführen von Konsolen Kommandos
Das Gerät kann über MQTT komplett mit Konsolen Kommandos ferngesteuert werden.
Eine Liste aller Kommandos findet sich im Kapitel Konsole
die Kommandos in verschiedenen Formaten angenommen.
Als Default ist das Ausführen vom Kommandos nicht erlaubt, sondern muss in der
MQTT Konfiguration ("Permit CLI commands") freigeschaltet werden!
Format 1: Kommando in JSON Syntax
Publish Topic: "de/gudesystems/epc/00:19:32:01:16:41/cmd"
Publish Message: "{"type": "cli", "cmd": "port 2 state set 1", "id": 10}"
Expert Power Control 8101
. Je nach Topic werden
61
© 2023 GUDE Systems GmbH
88