Gude 8311-1, Manual

Page: 77 / 86

77
Expert PDU Energy 8311 © 2022 GUDE Systems GmbH
Specifications
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".
Response from device to "de/gudesystems/epc/00:19:32:01:16:41/cmdres/cli"
"OK."
Format 3: Simplified port switching
Publish Topic: "de/gudesystems/epc/00:19:32:01:16:41/cmd/port/2"
Publish Message: "0" or "1".
Response from device to "de/gudesystems/epc/00:19:32:01:16:41/cmdres/port/2"
"0" or "1"
This special form exists only for the port switching commands.
56