MQTT eng
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 command 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 indicates the number of seconds the device is on, or unixtime if the device has synchronized 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 commands 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.
Device Data Summary
In the Device Data Summary the most important data of the device are summarized in a JSON object and sent periodically in a configurable time interval. This summary depends on the properties of the device and the connected sensors, and could look like this:
Topic: en/gudesystems/epc/00:19:32:01:16:41/device/telemetry
Message:
Command list
logout | go to login prompt when enabled |
quit | quits telnet session - nothing in serial console |
back | back one cmd level |
help | show all cmds from this level |
help all | show all cmds |
clock | enters cmd group "clock" |
clock ntp enabled set {OFF=0|ON=1} | enables ntp |
clock ntp enabled show | shows if ntp enabled |
clock timezone set {minutes} | sets timezone |
clock timezone show | shows timezone |
clock dst enabled set {OFF=0|ON=1} | enables dst |
clock dst enabled show | shows if dst is enabled |
clock manual set "{hh:mm:ss yyyy-mm-dd}" | sets time and date manually |
clock show | shows actual time and date |
clock ntp server {PRIMARY=0|BACKUP=1} set "{dns_name}" | sets ntp server name |
clock ntp server {PRIMARY=0|BACKUP=1} show | shows ntp server name |
console | enters cmd group "console" |
console version | shows unique console version number |
console telnet enabled set {OFF=0|ON=1} | enables telnet on/off |
console telnet enabled show | shows if telnet enabled |
console telnet port set {ip_port} | sets telnet port |
console telnet port show | shows telnet port |
console telnet raw set {OFF=0|ON=1} | sets raw mode (disables editing) on/off |
console telnet raw show | shows if raw mode enabled |
console telnet echo set {OFF=0|ON=1} | enables echo on/off |
console telnet echo show | shows if echo enabled |
console telnet activeneg set {OFF=0|ON=1} | enables telnet active negotiation (IAC) on/off |
console telnet activeneg show | shows if active negotiation enabled |
console telnet login set {OFF=0|ON=1} | enables login on/off |
console telnet login show | shows if login enabled |
console telnet login local set {OFF=0|ON=1} | enables local login on/off |
console telnet login local show | shows if local login enabled |
console telnet login radius set {OFF=0|ON=1} | enables login for RADIUS on/off |
console telnet login radius show | shows if RADIUS login enabled |
console telnet login delay set {OFF=0|ON=1} | enables delay (after 3 login fails) on/off |
console telnet login delay show | shows if login delay enabled |
console telnet pushmsgs config set {OFF=0|ON=1} | enables persistent push msgs |
console telnet pushmsgs config show | shows if persistent push msgs are enabled |
console telnet pushmsgs set {OFF=0|ON=1} | enables temporary push msgs |
console telnet pushmsgs show | shows if temporary push msgs are enabled |
console telnet user set "{username}" | sets login user name |
console telnet user show | shows login user name |
console telnet passwd set "{passwd}" | sets login password |
console telnet passwd hash set "{passwd}" | sets login hashed password |
console ssh enabled set {OFF=0|ON=1} | enables SSH |
console ssh enabled show | shows if SSH enabled |
console ssh port set {ip_port} | sets SSH port |
console ssh port show | shows SSH port |
console ssh echo set {OFF=0|ON=1} | enables echo on/off |
console ssh echo show | shows if echo enabled |
console ssh pushmsgs config set {OFF=0|ON=1} | enables persistent push msgs |
console ssh pushmsgs config show | shows if persistent push msgs are enabled |
console ssh pushmsgs set {OFF=0|ON=1} | enables temporary push msgs |
console ssh pushmsgs show | shows if temporary push msgs are enabled |
console ssh public hash set "{passwd}" | sets hash of SSH public key |
console ssh public hash show | shows hash of SSH public key |
console serial enabled set {OFF=0|ON=1} | enables serial console on/off |
console serial enabled show | shows if serial console enabled |
console serial raw set {OFF=0|ON=1} | sets raw mode (disables editing) on/off |
console serial raw show | shows if raw mode enabled |
console serial echo set {OFF=0|ON=1} | enables echo on/off |
console serial echo show | shows if echo enabled |
console serial kvm set {OFF=0|ON=1} | enables binary KVM cmds on serial port on/off |
console serial kvm show | shows if binary KVM cmds enabled |
console serial utf8 set {OFF=0|ON=1} | enables UTF8 support |
console serial utf8 show | shows if UTF8 enabled |
console serial login set {OFF=0|ON=1} | enables login on/off |
console serial login show | shows if login enabled |
console serial login local set {OFF=0|ON=1} | enables local login on/off |
console serial login local show | shows if local login enabled |
console serial login radius set {OFF=0|ON=1} | enables login for RADIUS on/off |
console serial login radius show | shows if RADIUS login enabled |
console serial login delay set {OFF=0|ON=1} | enables delay (after 3 login fails) on/off |
console serial login delay show | shows if login delay enabled |
console serial pushmsgs config set {OFF=0|ON=1} | enables persistent push msgs |
console serial pushmsgs config show | shows if persistent push msgs are enabled |
console serial pushmsgs set {OFF=0|ON=1} | enables temporary push msgs |
console serial pushmsgs show | shows if temporary push msgs are enabled |
console serial user set "{username}" | sets login user name |
console serial user show | shows login user name |
console serial passwd set "{passwd}" | sets login password |
console serial passwd hash set "{passwd}" | sets login hashed password |
enters cmd group "email" | |
email enabled set {OFF=0|ON=1} | enables email on/off |
email enabled show | shows if email is enabled |
email sender set "{email_addr}" | sets email sender address |
email sender show | shows email sender address |
email recipient set "{email_addr}" | sets email recipient address |
email recipient show | shows email recipient address |
email server set "{dns_name}" | sets email SMTP server address |
email server show | shows email SMTP server address |
email port set {ip_port} | sets email SMTP port |
email port show | shows email SMTP port |
email security set {NONE=0|STARTTLS=1|SSL=2} | sets SMTP connection security |
email security show | shows SMTP connection security |
email auth set {NONE=0|PLAIN=1|LOGIN=2} | sets email authentication |
email auth show | show email authentication |
email user set "{username}" | sets SMTP username |
email user show | shows SMTP username |
email passwd set "{passwd}" | sets SMTP password |
email passwd hash set "{passwd}" | sets crypted SMTP password |
email testmail | send test email |
ethernet | enters cmd group "ethernet" |
ethernet mac show | shows MAC address |
ethernet link show | shows ethernet link state |
ethernet phyprefer set {10MBIT_HD=0|10MBIT_FD=1|100MBIT_HD=2|100MBIT_FD=3} | sets preferred speed for PHY Auto Negotiation |
ethernet phyprefer show | shows preferred speed for PHY Auto Negotiation |
extinput | enters cmd group "extinput" |
extinput {port_num} {inp_num} state show | shows input state |
extinput all state {MODE0=0|MODE1=1|MODE2=2} show | shows input state of all ports in 3 different view modes |
extinput {port_num} {inp_num} name set "{name}" | sets sensor name to label |
extinput {port_num} {inp_num} name show | shows label of sensor |
extinput {port_num} {inp_num} invert enabled set {OFF=0|ON=1} | inverts input on/off |
extinput {port_num} {inp_num} invert enabled show | shows if input inverted |
extinput {port_num} {inp_num} label {LOW=0|HIGH=1} set "{name}" | sets input low/high text |
extinput {port_num} {inp_num} label {LOW=0|HIGH=1} show | shows input low/high text |
extinput {port_num} {inp_num} events set {OFF=0|ON=1} | enables input events on/off |
extinput {port_num} {inp_num} events show | shows if input events are enabled |
extinput {port_num} {inp_num} events type set "{EVT_SYSLOG=0,EVT_SNMP=1,EVT_EMAIL=2
,EVT_BEEPER=5,EVT_DISPLAY=6,EVT_CONS OLE=7,EVT_MQTT=8}" |
enables different event types |
extinput {port_num} {inp_num} events type show | shows what event types are enabled |
extinput {port_num} {inp_num} publish mode set
{NONE=0|INTERVAL=1|DELTA=2| INTERV_DELTA=3} |
sets publish mode |
extinput {port_num} {inp_num} publish mode show | showshows publish mode |
extinput {port_num} {inp_num} publish mqtt retain set {OFF=0|ON=1} | sets mqtt retain |
extinput {port_num} {inp_num} publish mqtt retain show | shows if mqtt retain set |
extinput {port_num} {inp_num} publish timer set {num_secs} | sets publish time interval |
extinput {port_num} {inp_num} publish timer show | shows publish time interval |
extinput {port_num} {inp_num} {LOW=0|HIGH=1} port set {port_num} | sets Port for Power Port Switching actions |
extinput {port_num} {inp_num} {LOW=0|HIGH=1} port show | shows Port for Power Port Switching actions |
extinput {port_num} {inp_num} {LOW=0|HIGH=1 state set {OFF=0|ON=1|DISABLED=2} | sets Port state for Power Port Switching actions |
extinput {port_num} {inp_num} {LOW=0|HIGH=1} state show | shows Port state for Power Port Switching actions |
extsensor | enters cmd group "extsensor" |
extsensor all show | shows all values from connected external sensors |
extsensor all show | shows all plugged sensors and fields |
extsensor {port_num} {sen_field} value show | shows sensor value |
extsensor {port_num} {sen_type} label set "{name}" | sets sensor name to label |
extsensor {port_num} {sen_type} label show | shows label of sensor |
extsensor {port_num} type show | shows type of sensor |
extsensor {port_num} {sen_type} {sen_field} events set {off=0|on=1} | enables sensor events on/off |
extsensor {port_num} {sen_type} {sen_field} events show | shows if sensor events are enabled |
extsensor {port_num} {sen_type} {sen_field}
events type set "{EVT_SYSLOG=0,EVT_SNMP=1,EVT_EMAIL=2 ,EVT_SMS=3,EVT_GSMEMAIL=4,EVT_BEEPER =5,EVT_DISPLAY=6,EVT_CONSOLE=7,EVT_M QTT=8}" |
enables different event types |
extsensor {port_num} {sen_type} {sen_field} events type show | shows what event types are enabled |
extsensor {port_num} {sen_type} {sen_field}
events beeper mode set {CONTINOUS=0| INTERMITTENT=1} |
sets beeper tone |
extsensor {port_num} {sen_type} {sen_field} events beeper mode show | shows beeper tone |
extsensor {port_num} {sen_type} {sen_field} maxval set {num} | sets maximum value for sensor |
extsensor {port_num} {sen_type} {sen_field} maxval show | shows maximum value for sensor |
extsensor {port_num} {sen_type} {sen_field} minval set {num} | sets minimum value for sensor |
extsensor {port_num} {sen_type} {sen_field} minval show | shows minimum value for sensor |
extsensor {port_num} {sen_type} {sen_field} hyst set {num} | sets hysterese value for sensor |
extsensor {port_num} {sen_type} {sen_field} hyst show | shows hysterese value for sensor |
extsensor {port_num} {sen_type} {sen_field}
publish mode set {NONE=0|INTERVAL=1| DELTA=2|INTERV_DELTA=3} |
sets publish mode |
extsensor {port_num} {sen_type} {sen_field} publish mode show | shows publish mode |
extsensor {port_num} {sen_type} {sen_field} publish mqtt retain set {OFF=0|ON=1} | sets mqtt retain |
extsensor {port_num} {sen_type} {sen_field} publish mqtt retain show | shows if mqtt retain set |
extsensor {port_num} {sen_type} {sen_field} publish timer set {num_secs} | sets publish time interval |
extsensor {port_num} {sen_type} {sen_field} publish timer show | shows publish time interval |
extsensor {port_num} {sen_type} {sen_field} publish delta set {float} | sets publish delta value |
extsensor {port_num} {sen_type} {sen_field} publish delta show | shows publish delta value |
extsensor {port_num} {sen_type} {sen_field}
{BELOWMIN=0|ABOVEMIN=1|ABOVEMAX=2| BELOWMAX=3} port set {port_num} |
sets Port for Power Port Switching actions |
extsensor {port_num} {sen_type} {sen_field}
{BELOWMIN=0|ABOVEMIN=1|ABOVEMAX=2| BELOWMAX=3} port show |
shows Port for Power Port Switching actions |
extsensor {port_num} {sen_type} {sen_field}
{BELOWMIN=0|ABOVEMIN=1|ABOVEMAX=2| BELOWMAX=3} state set {OFF=0|ON=1| DISABLED=2} |
sets Port state for Power Port Switching actions |
extsensor {port_num} {sen_type} {sen_field}
{BELOWMIN=0|ABOVEMIN=1|ABOVEMAX=2| BELOWMAX=3} state show |
shows Port state for Power Port Switching actions |
extsensor period set {24H=0|12H=1|2H=2|1H=3|30MIN=4} | sets sensor Min/Max measurement period |
extsensor period show | shows sensor Min/Max measurement period |
extsensor beeper set {OFF=0|ON=1} | enables beeper sensor alarms |
extsensor beeper show | shows if beeper sensor alarms are enabled |
extsensor {port_num} {sen_field} calib set {float} | sets calibration offset for temperature or humidity |
extsensor {port_num} {sen_field} calib show | shows calibration offset for temperature or humidity |
http | enters cmd group "http" |
http server set {HTTP_BOTH=0|HTTPS_ONLY=1|HTTP_ONLY=22|HTTPS_REDIR=3} | sets accepted connection types |
http server show | shows accepted connection types |
http port set {ip_port} | sets http port |
http port show | shows http port |
http portssl set {ip_port} | sets https port |
http portssl show | shows https port |
http tls mode set {TLS12=0|TLS13_12=1|TLS13=2|TLS13_12_11=3} | restricts TLS mode |
http tls mode show | shows TLS mode restriction |
http auth mode set {BASIC=0|SESSION=1|SESSION_EXT=2} | sets http session authentication mode |
http auth mode show | shows http session authentication mode and compatibility |
http passwd enabled set {OFF=0|ON=1} | enables http password on/off |
http timeout admin set {num_secs} | sets admin session timeout |
http timeout admin show | shows admin session timeout |
http timeout user set {num_secs} | sets user session timeout |
http timeout user show | shows user session timeout |
http passwd enabled show | shows if http password enabled |
http passwd local set {OFF=0|ON=1} | enables local login on/off |
http passwd local show | shows if local login enabled |
http passwd radius set {OFF=0|ON=1} | enables login for RADIUS on/off |
http passwd radius show | shows if RADIUS login enabled |
http passwd user set "{passwd}" | sets http user password |
http passwd admin set "{passwd}" | sets http admin password |
http passwd hash user set "{passwd}" | sets hashed http user password
http passwd hash admin set "{passwd}" sets hashed http admin password |
ip4 | enters cmd group "ip4" |
ip4 hostname set "{name}" | sets device hostname |
ip4 hostname show | shows device hostname |
ip4 address set "{ip_address}" | sets IPv4 address |
ip4 address show | shows IPv4 address |
ip4 netmask set "{ip_address}" | sets IPv4 netmask |
ip4 netmask show | shows IPv4 netmask |
ip4 gateway set "{ip_address}" | sets IPv4 gateway address |
ip4 gateway show | shows IPv4 gateway address |
ip4 dns set "{ip_address}" | sets IPv4 DNS server address |
ip4 dns show | shows IPv4 DNS server address |
ip4 dhcp enabled set {OFF=0|ON=1} | enables IPv4 DHCP on/off |
ip4 dhcp enabled show | shows IPv4 DHCP state |
ip6 | enters cmd group "ip6" |
ip6 enabled set {OFF=0|ON=1} | enables IPv6 on/off |
ip6 enabled show | shows if IPv6 is enabled |
ip6 routadv enabled set {OFF=0|ON=1} | enables IPv6 router advertisement |
ip6 routadv enabled show | shows IPv6 router advertisement state |
ip6 dhcp enabled set {OFF=0|ON=1} | enables IPv6 DHCP on/off |
ip6 dhcp enabled show | shows if IPv6 DHCP is enabled |
ip6 address show | show all IPv6 addresses |
ip6 gateway show | show all IPv6 gateways |
ip6 dns show | show all IPv6 DNS server |
ip6 manual enabled set {OFF=0|ON=1} | enables manual IPv6 addresses |
ip6 manual enabled show | shows if manual IPv6 addresses are enabled |
ip6 manual address {1..4} set "{ip_address}" | sets manual IPv6 address |
ip6 manual address {1..4} show | shows manual IPv6 address |
ip6 manual gateway set "{ip_address}" | sets manual IPv6 gateway address |
ip6 manual gateway show | shows manual IPv6 gateway address |
ip6 manual dns {1..2} set "{ip_address}" | sets manual IPv6 DNS server address |
ip6 manual dns {1..2} show | shows manual IPv6 DNS server address |
ipacl | enters cmd group "ipacl" |
ipacl ping enabled set {OFF=0|ON=1} | enables ICMP ping on/off |
ipacl ping enabled show | shows if ICMP ping enabled |
ipacl enabled set {OFF=0|ON=1} | enable IP filter on/off |
ipacl enabled show | shows if IP filter enabled |
ipacl filter {ipacl_num} set "{dns_name}" | sets IP filter {ipacl_num} |
ipacl filter {ipacl_num} show | shows IP filter {ipacl_num} |
linesensor | enters cmd group "linesensor" |
linesensor all {field_list} show | shows energy sensors according field list of all line sensors |
linesensor {line_num} {field_list} show | shows energy sensors according field list of one line sensor |
linesensor {line_num} {energy_sensor} value show | shows energy sensor of given line |
linesensor {line_num} ovp show | show state of Overvoltage Protection |
linesensor {line_num} counter reset | resets energy metering counter |
linesensor {line_num} label set "{name}" | sets line meter to label |
linesensor {line_num} label show | shows label of line meter |
linesensor {line_num} {energy_sensor} events set {OFF=0|ON=1} | enables events on/off |
linesensor {line_num} {energy_sensor} events show | shows if events are enabled |
linesensor {line_num} {energy_sensor} events type set "{EVT_SYSLOG=0,EVT_SNMP=1,EVT_EMAIL=2,EVT_SMS=3,EVT_GSMEMAIL=4,EVT_BEEPER =5}" | enables different event types |
linesensor {line_num} {energy_sensor} events type show | shows what event types are enabled |
linesensor {line_num} {energy_sensor} events beeper mode set {CONTINOUS=0| INTERMITTENT=1} | sets beeper tone |
linesensor {line_num} {energy_sensor} events beeper mode show | shows beeper tone |
linesensor {line_num} {energy_sensor} maxval set {float} | sets maximum value for line meter |
linesensor {line_num} {energy_sensor} maxval show | shows maximum value for line meter |
linesensor {line_num} {energy_sensor} minval set {float} | sets minimum value for line meter |
linesensor {line_num} {energy_sensor} minval show | shows minimum value for line meter |
linesensor {line_num} {energy_sensor} hyst set {float} | sets hysterese value for line meter |
linesensor {line_num} {energy_sensor} hyst show | shows hysterese value for line meter |
linesensor {line_num} {energy_sensor} publish mode set {NONE=0|INTERVAL=1|DELTA=2| INTERV_DELTA=3} | sets publish mode |
linesensor {line_num} {energy_sensor} publish mode show | shows publish mode |
linesensor {line_num} {energy_sensor} publish mqtt retain set {OFF=0|ON=1} | sets mqtt retain |
linesensor {line_num} {energy_sensor} publish mqtt retain show | shows if mqtt retain set |
linesensor {line_num} {energy_sensor} publish timer set {num_secs} | sets publish time interval |
linesensor {line_num} {energy_sensor} publish timer show | shows publish time interval |
linesensor {line_num} {energy_sensor} publish delta set {float} | sets publish delta value |
linesensor {line_num} {energy_sensor} publish delta show | shows publish delta value |
linesensor {line_num} {energy_sensor}
{BELOWMIN=0|ABOVEMIN=1|ABOVEMAX=2| BELOWMAX=3} port set {port_num} |
sets Port for Power Port Switching actions |
linesensor {line_num} {energy_sensor} {BELOWMIN=0|ABOVEMIN=1|ABOVEMAX=2|
BELOWMAX=3} port show |
shows Port for Power Port Switching actions |
linesensor {line_num} {energy_sensor} {BELOWMIN=0|ABOVEMIN=1|ABOVEMAX=2|
BELOWMAX=3} state set {OFF=0|ON=1| DISABLED=2} |
sets Port state for Power Port Switching actions |
linesensor {line_num} {energy_sensor} {BELOWMIN=0|ABOVEMIN=1|ABOVEMAX=2|
BELOWMAX=3} state show |
shows Port state for Power Port Switching actions |
linesensor {line_num} events set {OFF=0|ON=1} | LEGACY - enables events on/off |
linesensor {line_num} events show | LEGACY - shows if events are enabled |
linesensor {line_num} events type set "{EVT_SYSLOG=0,EVT_SNMP=1,EVT_EMAIL=2
,EVT_SMS=3,EVT_GSMEMAIL=4,EVT_BEEPER=5,EVT_DISPLAY=6,EVT_CONSOLE=7,EVT_M QTT=8}" |
LEGACY - enables different event types |
linesensor {line_num} events type show | LEGACY - shows what event types are enabled |
linesensor {line_num} maxval set {float} | LEGACY - sets maximum value for line meter |
linesensor {line_num} maxval show | LEGACY - shows maximum value for line meter |
linesensor {line_num} minval set {float} | LEGACY - sets minimum value for line meter |
linesensor {line_num} minval show | LEGACY - shows minimum value for line meter |
linesensor {line_num} hyst set {float} | LEGACY - sets hysterese value for line meter |
linesensor {line_num} hyst show | LEGACY - shows hysterese value for line meter |
linesensor {line_num} {BELOWMIN=0| ABOVEMIN=1|ABOVEMAX=2|BELOWMAX=3}
port set {port_num} |
LEGACY - sets Port for Power Port Switching actions |
linesensor {line_num} {BELOWMIN=0| ABOVEMIN=1|ABOVEMAX=2|BELOWMAX=3}
port show |
LEGACY - shows Port for Power Port Switching actions |
linesensor {line_num} {BELOWMIN=0|ABOVEMIN=1|ABOVEMAX=2|BELOWMAX=3}
state set {OFF=0|ON=1|DISABLED=2} |
LEGACY - sets Port state for Power Port Switching actions |
linesensor {line_num} {BELOWMIN=0| ABOVEMIN=1|ABOVEMAX=2|BELOWMAX=3}
state show |
LEGACY - shows Port state for Power Port
Switching actions |
linesensor beeper set {OFF=0|ON=1} | enables beeper for line meter alarms |
linesensor beeper show | shows if beeper for line meter alarms is enabled |
modbus | enters cmd group "modbus" |
modbus enabled set <off=0/on=1> | enables Modbus TCP support |
modbus enabled show | shows if Modbus is enabled |
modbus port set <ip_port> | sets Modbus TCP port |
modbus port show | shows Modbus TCP port |
mqtt | enters cmd group "mqtt" |
mqtt {broker_idx} enabled set {OFF=0|ON=1} | enable mqtt |
mqtt {broker_idx} enabled show | shows if mqtt enabled |
mqtt {broker_idx} server set "{dns_name}" | sets broker name |
mqtt {broker_idx} server show | shows broker name |
mqtt {broker_idx} tls enabled set {OFF=0|ON=1} | enable TLS |
mqtt {broker_idx} tls enabled show | shows if TLS enabled |
mqtt {broker_idx} port set {ip_port} | set broker TCP/IP port |
mqtt {broker_idx} port show | shows broker TCP/IP port |
mqtt {broker_idx} user set "{username}" | sets username |
mqtt {broker_idx} user show | shows username |
mqtt {broker_idx} passwd set "{passwd}" | sets password |
mqtt {broker_idx} passwd hash set "{passwd}" | sets hashed passwd |
mqtt {broker_idx} client set "{name}" | sets client name |
mqtt {broker_idx} client show | shows client name |
mqtt {broker_idx} qos set {QOS0=0|QOS1=1} | sets QoS level |
mqtt {broker_idx} qos show | shows QoS level |
mqtt {broker_idx} keepalive set {num_secs} | sets keep-alive time |
mqtt {broker_idx} keepalive show | shows keep-alive time |
mqtt {broker_idx} topic set "{name}" | sets topic prefix |
mqtt {broker_idx} topic show | shwos topic prefix |
mqtt {broker_idx} console enabled set {OFF=0| ON=1} | permit console cmds |
mqtt {broker_idx} console enabled show | shows if console cmds allowed |
mqtt {broker_idx} device data timer set {num_secs} | sets telemetry interval |
mqtt {broker_idx} device data timer show | shows telemetry interval |
port | enters cmd group "port" |
port {port_num} state set {OFF=0|ON=1} | sets port to new state |
port {port_num} state show | shows port state |
port all state set "{port_list}" {OFF=0|ON=1} | sets several ports in one cmd - e.g. port all state set "1,3,5" 1 |
port all state {MODE0=0|MODE1=1|MODE2=2} show | shows all port states in 3 different view modes |
port all set {OFF=0|ON=1|OFF_REV=2|ON_REV=3} | switch all ports on/off forward or reverse |
port restart all set {REINIT=0| OFF_REV_REINIT=1,OFF_REINIT=2} | reinit coldstart sequence (optional first all off) |
port {port_num} reset | start reset sequence for port |
port {port_num} toggle | toggles port |
port {port_num} batch set {OFF=0|ON=1} wait {num_secs} {OFF=0|ON=1} | starts batch mode for port |
port {port_num} batch cancel | cancels batch mode |
port {port_num} label set "{name}" | sets port label name |
port {port_num} label show | shows port label name |
port {port_num} initstate coldstart set {OFF=0| ON=1|REMEMBER=2} | sets port coldstart initialization |
port {port_num} initstate coldstart show | shows port coldstart initialization |
port {port_num} initstate delay set {num} | sets port init delay |
port {port_num} initstate delay show | shows port init delay |
port {port_num} repowerdelay set {num} | sets port repower delay |
port {port_num} repowerdelay show | shows port repower delay |
port {port_num} resettime set {num} | sets port reset duration |
port {port_num} resettime show | shows port reset duration |
port {port_num} watchdog enabled set {OFF=0| ON=1} | sets port watchdog to on/off |
port {port_num} watchdog enabled show | shows port watchdog state |
port {port_num} watchdog mode set {OFF=0| PORT_RESET=1|IP_MS=2|IP_MS_INV=3} | sets port watchdog mode |
port {port_num} watchdog mode show | shows port watchdog mode |
port {port_num} watchdog type set {WD_ICMP=0| WD_TCP=1} | sets port watchdog type |
port {port_num} watchdog type show | shows port watchdog type |
port {port_num} watchdog link down set {OFF=0| ON=1} | sets if watchdog active when eth link down |
port {port_num} watchdog link down show | shows if watchdog active when eth link down |
port {port_num} watchdog host set "{dns_name}" | sets port watchdog host target |
port {port_num} watchdog host show | shows port watchdog host target |
port {port_num} watchdog port set {ip_port} | sets port watchdog TCP port |
port {port_num} watchdog port show | shows port watchdog TCP port |
port {port_num} watchdog pinginterval set {num} | sets port watchdog ping interval |
port {port_num} watchdog pinginterval show | shows port watchdog ping interval |
port {port_num} watchdog pingretries set {num} | sets port watchdog ping retries |
port {port_num} watchdog pingretries show | shows port watchdog ping retries |
port {port_num} watchdog retrybooting set {OFF=0|ON=1} | sets port watchdog retry booting to on/off |
port {port_num} watchdog retrybooting show | shows port watchdog retry booting state |
port {port_num} watchdog bootretries set {num} | sets port watchdog retry boot timeout |
port {port_num} watchdog bootretries show | hows port watchdog retry boot timeout |
radius | enters cmd group "radius" |
radius {PRIMARY=0|SECONDARY=1} enabled set <off=0/on=1> | enables radius client |
radius {PRIMARY=0|SECONDARY=1} enabled show | show if radius client enabled |
radius {PRIMARY=0|SECONDARY=1} server set "<dns_name>" | sets radius server address |
radius {PRIMARY=0|SECONDARY=1} server show | shows radius server address |
radius {PRIMARY=0|SECONDARY=1} password set "{passwd}" | sets radius server shared secret |
radius {PRIMARY=0|SECONDARY=1} password hash set "{passwd}" | sets radius server crypted shared secret |
radius {PRIMARY=0|SECONDARY=1} auth timeout set {num_secs} | sets server request timeout |
radius {PRIMARY=0|SECONDARY=1} auth timeout show | shows server request timeout |
radius {PRIMARY=0|SECONDARY=1} retries set {0..99} | sets server number of retries |
radius {PRIMARY=0|SECONDARY=1} retries show | shows server number of retries |
radius chap enabled set <off=0/on=1> | enables CHAP |
radius chap enabled show | shows if CHAP is enabled |
radius message auth set <off=0/on=1> | enables request message authentication |
radius message auth show | shows if request message authentication is enabled |
radius default timeout set {num_secs} | sets default session timeout (when not returned as Session-Timout Attribute) |
radius default timeout show | shows default session timeout |
rcmb | enters cmd group "rcmb" |
rcmb {mod_num} state show | show rcmb module state |
rcmb {mod_num} {RMS=0|DC=1} value show | shows RMS/DC RC values |
rcmb {mod_num} {RMS=0|DC=1} output show | shows module RMS/DC outputs |
rcmb {mod_num} {RMS=0|DC=1} events set {OFF=0|ON=1} | enables sensor events on/off |
rcmb {mod_num} {RMS=0|DC=1} events show | shows if sensor events are enabled |
rcmb {mod_num} {RMS=0|DC=1} events type set "{EVT_SYSLOG=0,EVT_SNMP=1,EVT_EMAIL=2,EVT_BEEPER=5,EVT_DISPLAY=6,EVT_CONS
OLE=7,EVT_MQTT=8}" |
enables different event types |
rcmb {mod_num} {RMS=0|DC=1} events type show | shows what event types are enabled |
rcmb {mod_num} {RMS=0|DC=1} events beeper mode set {CONTINOUS=0|INTERMITTENT=1} | sets beeper tone |
rcmb {mod_num} {RMS=0|DC=1} events beeper mode show | shows beeper tone |
rcmb {mod_num} {RMS=0|DC=1} maxval set {float} | sets maximum value for sensor |
rcmb {mod_num} {RMS=0|DC=1} maxval show | shows maximum value for sensor |
rcmb {mod_num} {RMS=0|DC=1} minval set {float} | sets minimum value for sensor |
rcmb {mod_num} {RMS=0|DC=1} minval show | shows minimum value for sensor |
rcmb {mod_num} {RMS=0|DC=1} hyst set {float} | sets hysterese value for sensor |
rcmb {mod_num} {RMS=0|DC=1} hyst show | shows hysterese value for sensor |
rcmb {mod_num} {RMS=0|DC=1} publish mode set {NONE=0|INTERVAL=1|DELTA=2|
INTERV_DELTA=3} |
sets publish mode |
rcmb {mod_num} {RMS=0|DC=1} publish mode show | shows publish mode |
rcmb {mod_num} {RMS=0|DC=1} publish mqtt retain set {OFF=0|ON=1} | sets mqtt retain |
rcmb {mod_num} {RMS=0|DC=1} publish mqtt retain show | shows if mqtt retain set |
rcmb {mod_num} {RMS=0|DC=1} publish timer set {num_secs} | sets publish time interval |
rcmb {mod_num} {RMS=0|DC=1} publish timer show | shows publish time interval |
rcmb {mod_num} {RMS=0|DC=1} publish delta set {float} | sets publish delta value |
rcmb {mod_num} {RMS=0|DC=1} publish delta show | shows publish delta value |
rcmb {mod_num} {RMS=0|DC=1} {BELOWMIN=0| ABOVEMIN=1|ABOVEMAX=2|BELOWMAX=3} port set {port_num} | sets power port for sensor values action |
rcmb {mod_num} {RMS=0|DC=1} {BELOWMIN=0| ABOVEMIN=1|ABOVEMAX=2|BELOWMAX=3} port show | shows power port for sensor values action |
rcmb {mod_num} {RMS=0|DC=1} {BELOWMIN=0| ABOVEMIN=1|ABOVEMAX=2|BELOWMAX=3} state set {OFF=0|ON=1|DISABLED=2} | sets state for sensor values action |
rcmb {mod_num} {RMS=0|DC=1} {BELOWMIN=0|
ABOVEMIN=1|ABOVEMAX=2|BELOWMAX=3} state show |
shows state for sensor values action |
snmp | enters cmd group "snmp" |
snmp port set {ip_port} | sets SNMP UDP port |
snmp port show | shows SNMP UDP port |
snmp snmpget enabled set {OFF=0|ON=1} | enables SNMP GET cmds on/off |
snmp snmpget enabled show | show if SNMP GET cmds are enabled |
snmp snmpset enabled set {OFF=0|ON=1} | enables SNMP SET cmds on/off |
snmp snmpset enabled show | show if SNMP SET cmds are enabled |
snmp snmpv2 enabled set {OFF=0|ON=1} | enables SNMP v2 on/off |
snmp snmpv2 enabled show | show if SNMP v2 is enabled |
snmp snmpv2 public set "{text}" | enables SNMP v3 on/off |
snmp snmpv2 public show | show if SNMP v3 isenabled |
snmp snmpv2 private set "{text}" | sets SNMP v2 public cummnity |
snmp snmpv2 private show | shows SNMP v2 public community |
snmp system {CONTACT=0|NAME=1| LOCATION=2} set "{text}" | sets sysLocation/sysName/sysContact |
snmp system {CONTACT=0|NAME=1|LOCATION=2} show | gets sysLocation/sysName/sysContact |
snmp snmpv3 enabled set {OFF=0|ON=1} | sets SNMP v2 private community |
snmp snmpv3 enabled show | shows SNMP v2 private community |
snmp snmpv3 username set "{text}" | sets SNMP v3 username |
snmp snmpv3 username show | shows SNMP v3 username |
snmp snmpv3 authalg set {NONE=0|MD5=1| SHA1=2|SHA256=3|SHA384=4|SHA512=5} | sets SNMP v3 authentication |
snmp snmpv3 authalg show | show SNMP v3 authentication algorithm |
snmp snmpv3 privalg set {NONE=0|DES=1| 3DES=2|AES128=3|AES192=4|AES256=5| AES192*=6|AES256*=7} | sets SNMP v3 privacy algorithm |
snmp snmpv3 privalg show | show SNMP v3 privacy algorithm |
snmp snmpv3 authpasswd set "{passwd}" | sets SNMP v3 authentication password |
snmp snmpv3 privpasswd set "{passwd}" | sets SNMP v3 privacy password |
snmp snmpv3 authpasswd hash set "{passwd}" | sets SNMP v3 authentication hashed password |
snmp snmpv3 privpasswd hash set "{passwd}" | sets SNMP v3 privacy hashed password |
snmp trap type set {NONE=0|V1=1|V2=2|V3=3} | sets type of SNMP traps |
snmp trap type show | show SNMP trap type |
snmp trap receiver {trap_num} set "{dns_name}" | sets address and port of SNMP trap receiver {trap_num} |
snmp trap receiver {trap_num} show | show address and port of SNMP trap receiver {trap_num} |
syslog | enters cmd group "syslog" |
syslog enabled set {OFF=0|ON=1} | enables syslog msgs on/off |
syslog enabled show | show if syslog enabled |
syslog server set "{dns_name}" | sets address of syslog server |
syslog server show | shows address of syslog server |
system | enters cmd group "system" |
system beeper manual set {OFF=0|ON=1} {millisec} | manually sets beeper with optional duration |
system beeper manual show | shows beeper state |
system restart | restarts device |
system fabsettings | restore fab settings and restart device |
system bootloader | enters bootloader mode |
system flushdns | flush DNS cache |
system uptime | number of seconds the device is running |
system name show | shows device name |
system version show | shows actual firmware version |
system display {disp_num} default extsensor {port_num} {sen_type} set {sen_field} | shows external sensor |
system display {disp_num} default linesensor {line_num} set {sen_field} | shows energy line sensor |
system display {disp_num} default set {BLANK=0,LOCAL_TIME=1,UTC_TIME=2} | shows other contents |
system display {disp_num} default show | shows default setting for display |
system display default hash set "{data}" | sets hashed display setting |
system display default hash show | shows hashed display setting |
system sensor {VSYS=0|VAUX=1|VMAIN=2| TCPU=3} show | shows internal sensors if model supports it |
system {SWITCH_PORT=0} events set {OFF=0| ON=1} | enable global events |
system {SWITCH_PORT=0} events show | shows if global events enabled |
system {SWITCH_PORT=0} events type set "{EVT_SYSLOG=0,EVT_SNMP=1,EVT_EMAIL=2,EVT_SMS=3,EVT_GSMEMAIL=4,EVT_BEEPER
=5,EVT_DISPLAY=6,EVT_CONSOLE=7,EVT_MQTT=8}" |
enables different event types |
system {SWITCH_PORT=0} events type show | shows what event types are enabled |
system {SWITCH_PORT=0} events mqtt retain set {OFF=0|ON=1} | sets mqtt retain |
system {SWITCH_PORT=0} events mqtt retain show | shows if mqtt retain set |
system panel enabled set {OFF=0|ON=1} | blocks panel buttons when not enabled |
system panel enabled show | shows if panel buttons are enabled |
system panel port all set {OFF=0|ON=1} | enable siwtch all relays from panel buttons |
system panel port all show | shows if siwtch all relays from panel buttons enabled |
timer | enters cmd group "timer" |
timer enabled set {OFF=0|ON=1} | enables timer functions |
timer enabled show | shows if timer a enabled |
timer syslog facility set {0..23} | sets facility level for timer syslog |
timer syslog facility show | shows facility level for timer syslog |
timer syslog verbose set {0..7} | sets verbose level for timer syslog |
timer syslog verbose show | shows verbose level for timer syslog |
timer {rule_num} enabled set {OFF=0|ON=1} | enables rule |
timer {rule_num} enabled show | shows if rule is enabled |
timer {rule_num} name set "{name}" | sets name of rule |
timer {rule_num} name show | shows name of rule |
timer {rule_num} {FROM=0|UNTIL=1} set "{yyyymm-dd}" | sets date range of rule |
timer {rule_num} {FROM=0|UNTIL=1} show | shows date range of rule |
timer {rule_num} trigger jitter set {0..65535} | sets jitter for rule |
timer {rule_num} trigger jitter show | show jitter of rule |
timer {rule_num} trigger random set {0..100} | sets probability for rule |
timer {rule_num} trigger random show | shows rule probability |
timer {rule_num} trigger {HOUR=0|MIN=1|SEC=2| DAY=3|MON=4|DOW=5} set "{time_date_list}" | sets time date list |
timer {rule_num} trigger {HOUR=0|MIN=1|SEC=2| DAY=3|MON=4|DOW=5} show | shows time date list |
timer {rule_num} action mode set {SWITCH=1| CLI=2} | sets switch or cli cmd |
timer {rule_num} action mode show | shows if switch or cli cmd |
timer {rule_num} action {SWITCH1=0| SWITCH2=1} {OFF=0|ON=1} set "{port_list}" | sets port list for switch cmd |
timer {rule_num} action {SWITCH1=0| SWITCH2=1} {OFF=0|ON=1} show | shows port list for switch cmd |
timer {rule_num} action delay set {0..65535} | delay between cmds |
timer {rule_num} action delay show | shows delay between cmds |
timer {rule_num} action console set "{cmd}" | sets cmd string |
timer {rule_num} action console show | shows cmd string |
timer {rule_num} action hash set "{data}" | sets action binary form |
timer {rule_num} action hash show | shows action binary form |
timer {rule_num} delete | delete one timer |
timer delete all | delete all timer |
vt100 | enters cmd group "vt100" |
vt100 echo set {OFF=0|ON=1} | sets console echo state |
vt100 echo show | shows console echo state |
vt100 numeric set {OFF=0|ON=1} | sets numeric mode |
vt100 numeric show | shows numeric mode state |
vt100 reset | resets terminal |