GÜDE Expert Power Control 8041 Series, Руководство пользователя

Страница: 108 / 118

108
Expert Power Control 8041/8045 © 2022 GUDE Systems GmbH
Specifications
· 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.
Format 2: Raw Text
Publish Topic: "de/gudesystems/epc/00:19:32:01:16:41/cmd/cli"
Publish Message: "port 2 state set 1".
69