Gude Expert Net Control 2302, Manual

Page: 78 / 88

78
Expert Net Control 2302 © 2021 GUDE Systems GmbH
Specifications
NextObjectID 1 Byte 0x00
Number of Objects 1 Byte 0x03
Object ID 1 Byte 0x00
Object Length 1 Byte n1
Object Value n1 Bytes "Company Id"
Object ID 1 Byte 0x00
Object Length 1 Byte n2
Object Value n2 Bytes "Product Id"
Object ID 1 Byte 0x00
Object Length 1 Byte n3
Object Value n3 Bytes "Product Version"
4.10 MQTT
This device supports MQTT 3.1.1 to send configured messages and also to receive
commands. This chapter is general for all Gude devices, some Gude models do not
have 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
address 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.
61