Inhaltsverzeichnis
Werbung
Spezifikationen
4.10 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 all-
gemein 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 wer-
den. Eine Liste aller Kommandos findet sich im Kapitel Konsole
werden 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}"
Antwort vom Gerät an "de/gudesystems/epc/00:19:32:01:16:41/cmdres"
"{"type": "cli", "cmdres": ["OK."], "result": {"num": 0, "hint": "ok"}, "id": 10}"
Das JSON Objekt "result" gibt zurück, ob das Kommando valide war. Das Objekt
99
Expert Power Control 8021/8025
. Je nach Topic
68
© 2021 GUDE Systems GmbH
Werbung
Inhaltsverzeichnis
