GÜDE Expert Sensor Box 7213, Manual

Page: 90 / 100

90
Expert Sensor Box 7213/7214 © 2022 GUDE Systems GmbH
Specifications
switchable ports.
· Default port for an unencrypted connection is port 1883.
· Default port for a TLS secured connection is port 8883.
· If the broker allows anonymous login, username and password are arbitrary, but a
username must be specified.
· If multiple MQTT clients are connected to a broker, the names of the clients must be
different. For this reason, "client_xxxx" is generated as the default name. Here "xxxx"
are the last 4 digits of the MAC address.
Message format
The MQTT messages of the device are always sent in JSON format. E.G..
{"type": "portswitch", "idx": 2, "port": "2", "state": 1, "cause": {"id": 2, "txt": "http"}, "ts":
1632}
This is a switching of the second port to the state on. The source of the switching com-
mand is CGI ("http"). The index is always numeric, "port" can also be alphanumeric for
devices with multiple banks, e.g. "A2". At the end follows a timestamp ("ts"), which in-
dicates the number of seconds the device is on, or unixtime if the device has synchron-
ized with an NTP server.
MQTT Topic Prefix
The topic prefix for the messages can be set in the MQTT configuration. A default would
be e.g. "de/gudesystems/epc/[mac]". Here "[mac]" is a placeholder for the MAC ad-
dress of the device, another possible placeholder is "[host]", which contains the host
name. An example topic for a switching message of the second port would then be:
"de/gudesystems/epc/00:19:32:01:16:41/switch/2".
Executing console commands
The device can be controlled remotely via MQTT using console commands. A list of all
commands can be found in the Console
chapter. Depending on the topic, the com-
mands are accepted in different formats.
As default the execution of commands is not allowed, but must be enabled in the
MQTT configuration! ("Permit CLI commands")
Format 1: Command 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}"
Response from device to "de/gudesystems/epc/00:19:32:01:16:41/cmdres"
"{"type": "cli", "cmdres": ["OK."], "result": {"num": 0, "hint": "ok"}, "id": 10}"
The JSON object "result" returns whether the command was valid. The object "id" in
the command is optional and is passed through in the response from the device. The
passed number can help to establish a synchronicity between command and response
via the broker.
64