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 Geräte allgemein
gehalten, manche 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.
· W enn der Broker einen anonymen Login erlaubt, sind Benutzername und Passwort
beliebig, aber ein Benutzername muss angegeben werden.
· W enn 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.
Je nach Topic 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
ANS3101RM
KESS Power Solutions GmbH
Werbung
Inhaltsverzeichnis
