Inhaltsverzeichnis
Werbung
Spezifikationen
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
"id" im Kommando ist optional und wird in der Antwort vom Gerät durchgereicht. Die
Übergebene Nummer kann helfen eine Synchronizität zwischen Kommando und Ant-
wort über den Broker herzustellen.
Format 2: Raw Text
Publish Topic: "de/gudesystems/epc/00:19:32:01:16:41/cmd/cli"
Publish Message: "port 2 state set 1"
Antwort vom Gerät an "de/gudesystems/epc/00:19:32:01:16:41/cmdres/cli"
"OK."
109
Expert Net Control 2111/2191
. Je nach Topic
83
© 2021 GUDE Systems GmbH
Werbung
Inhaltsverzeichnis
