GÜDE Expert Power Control 8001, Manual

Page 1: ... 2022 GUDE Systems GmbH Manual Ver 1 0 1 from Firmware Ver 1 0 Manual Expert Power Control 8001 ...

Page 2: ...2 Expert Power Control 8001 2022 GUDESystems GmbH ...

Page 3: ... Panel 13 2 3 Maintenance 15 2 3 1 Maintenance Page 17 2 3 2 Configuration Management 19 2 3 3 Bootloader Activation 20 3 Configuration 23 3 1 Power Ports 24 3 1 1 Watchdog 25 3 2 Ethernet 27 3 2 1 IP Address 27 3 2 2 IP ACL 29 3 2 3 HTTP 30 3 3 Protocols 31 3 3 1 Console 31 3 3 2 Syslog 32 3 3 3 SNMP 33 3 3 4 Radius 35 3 3 5 Modbus TCP 36 3 3 6 MQTT 37 3 4 Clock 38 3 4 1 NTP 38 3 4 2 Timer 39 3 4...

Page 4: ... ACL 54 4 4 IPv6 55 4 5 Radius 55 4 6 SNMP 56 4 6 1 Device MIB 8001 59 4 7 SSL 62 4 8 Console 63 4 8 1 SSH 67 4 8 2 Console Cmd 8001 69 4 9 Modbus TCP 80 4 9 1 Sensor Tables 86 4 10 MQTT 87 4 10 1 Example HiveMQ 89 5 Support 91 5 1 Data Security 92 5 2 Contact 92 5 3 Declaration of Conformity 93 5 4 FAQ 93 95 Index ...

Page 5: ...Device Description ...

Page 6: ...rved Please also observe the safety instructions and operating instructions of the other devices that are connected to the device The device is not a toy It must not be stored or operated within the reach of children Do not leave packaging material lying around carelessly Plastic sheets bags Styro foam parts etc could become a dangerous toy for children Please recycle the pack aging material If yo...

Page 7: ...ommands via SSH and Telnet SSH support with public key and passwords Individually parameterisable switch on delay of all outputs Programmable timetables and turn on turn off sequences Individually adjustable watchdog for each output which switches depending on ac cessibility network ping Dual TCP IP stack with IPv4 and IPv6 support IPv6 ready Control and monitoring of the device via Ethernet with ...

Page 8: ...elay switching contacts NO Commissioning Connect the device PCB terminal max 16A to the mains Plug the network cable into the Ethernet socket RJ45 Plug the optional external sensors into the sensor connections Connect the loads to be switched to the load outputs PCB terminal max 16A 1 5 Technical Specifications Connections 1 x Mains connection PCB terminal max 16 A 1 x Ethernet connection RJ45 1 x...

Page 9: ...uctor cross section 0 08 2 5 mm2 AWG 28 12 for solid and stranded conductors Rated voltage 300 V 1 5 1 Electrical Measurement typical fault tolerances for Ta 25 C I 1Arms 16Arms Un 90Vrms 265Vrms Electrical Measurement Specification Category Range Unit Resolu tion Inaccuracy typical Voltage 90 265 V 0 01 1 Current 0 16 A 0 001 1 5 Frequency 45 65 Hz 0 01 0 03 Phase 180 180 0 1 1 Active power 0 400...

Page 10: ...able length 2m 2m 2m 2m Connector RJ45 RJ45 RJ45 RJ45 temperature range 20 C to 80 C at 2 C maximum and 1 C typical 20 C to 80 C at 2 C maximum and 1 C typical 20 C to 80 C at 2 C maximum and 1 C typical 20 C to 80 C at 2 C maximum and 1 C typical air humidity range non condensing 0 100 3 maximum and 2 typical 0 100 3 maximum and 2 typical air pressure range full 1 hPa typical at 300 1100 hPa 0 40...

Page 11: ... non condensing 0 100 3 maximum and 2 typical The sensors are automatically detected after connect This is indicated by the green LED on the sensor port that is lit permanently The sensor values are displayed at the Control Panel web page A click on the link in the Name column opens the display of the Min and Max values The values in a column can be reset using the Reset button The Reset button in...

Page 12: ...Operating ...

Page 13: ...on for 2 5 seconds all ports are switched off 3 If you press Select again the LED for the first output starts flashing i e the output is selected Press Select again to select the next output Pressing and holding the Ok button for one second will toggle the state of the selected output If the ports are already All on or All off the corresponding mode is skipped Display Information If no port is sel...

Page 14: ...8001 a panel with buttons to control a single port appear The Port icon is green when the relay is closed or red in the open state An additional small clock icon indicates that a timer is active Timer can be activated by delay reset or batch mode An activated Watchdog is represented by an eye icon An X means that the address that should be observed could not be resolved Two circular arrows show a ...

Page 15: ...w gude info wiki 2 3 Maintenance The actual device generation with IPv6 and SSL allows all maintenance functions in the web interface to be carried out on the Maintenance Page Maintenance in the web interface The following functions are available from the maintenance web page Firmware Update Change the SSL certificate Load and save the configuration Restart the device Factory Reset Jump into the B...

Page 16: ...es not run correctly please restore the factory settings e g from the Maintenance Page Actions in Bootloader mode If the web interface of the device is no longer accessible the device can be put into Bootloader mode see chapter Bootloader activation The following functions can be executed using the GBL_Conf exe application Set IPv4 address net mask and gateway Turn HTTP password on and off Turn IP...

Page 17: ...ed settings in the edit window and save them with Save Config Deactivate the boot loader mode for the changes to take effect Select again All Devices in the Search menu of GBL_Conf exe The new network configuration is now displayed Changing the configuration with gbl_conf exe is explicitly only allowed in bootloader mode Factory Reset The device can be reset to the factory default via the web inte...

Page 18: ...in an SSL connection since it contains sensitive password information even if it is encrypted or hashed Restart Device Restarts the device without changing the status of the relays Some functions such as a firmware update or changing of the IP address and HTTP settings require a restart of the device A jump to the boot loader or a restart of the device lead by no means to a change of the relay sta...

Page 19: ...aved configuration file with a text editor for your own needs For example one scenario would be to use a script language to automate the creation of many customized versions of a configuration then equip a large number of devices with an individualized configuration Also Upload and restart with CGI commands can be done in scripting languages With use of the comment sign you can quickly hide single...

Page 20: ...the device is configured One should therefore a disable the function b completely parametrize c reactivate the function An example email enabled set 0 email sender set len 0 100 email recipient set len 0 100 email server set len 0 100 email port set 25 email security set 0 range 0 2 email auth set 0 range 0 2 email user set len 0 100 email passwd hash set len 0 100 email enabled set 1 range 0 1 2 ...

Page 21: ...ed Abandonment of the Bootloader Mode 1 via push button Hold both buttons for 3 seconds only if the device has 2 buttons 2 or Remove and connect the power supply without operating a button 3 by Software Start the GBL_Conf exe application Do a network search with the Search menu action In menu Program Device activate the item Enter Firmware For devices with relays entering or exiting the bootloader...

Page 22: ...rating 2 by Software Activate the Bootloader Mode of the device Start the GBL_Conf exe program In menu Program Device activate the item Reset to Fab Settings The status LED will blink in a fast rhythm please wait until the LED blinks slowly about 5 seconds ...

Page 23: ...Configuration ...

Page 24: ...r Ports Choose Power Port to configure This field is used to select the power ports to be con figured Label You can assign a name up to 15 characters for each of the power ports Using the name an identification of the the device connected to the port can be facilitated Start up Monitoring It is important that if necessary the condition of the power ports can be restored after a power failure There...

Page 25: ...g to automatically restart not responding server or NAS systems The mode IP master slave port allows you to switch a port depending on the availability of a remote device When a watchdog is activated it presents various information in the Control Panel The information is color coded Green text The watchdog is active and regularly receives ping replies Orange text The watchdog is currently enabled ...

Page 26: ...rs the connected device When there is no longer a reply after a set time the watchdog per forms the specified action usually a reset of the Power Port Now the watchdog waits until the monitored device reports again on the network This may take several minutes depending on the boot duration of the device Only when the device is accessible from network again the watchdog is re armed If the option Re...

Page 27: ... DNS server Use IPv4 DHCP Select yes if the TCP IP settings should be obtained directly from the DHCP server When the function is selected each time the device powers up it is checked if a DHCP server is available on the network If no DHCP server is available the last IP address is used However the DHCP cli ent tries to reach a DHCP server again every 5 minutes The DHCP request lasts one minute un...

Page 28: ... status Displays the IPv6 addresses over which the device can be accessed and additionally DNS and router addresses For IP changes a firmware reset is required This can be done in the Maintenance web page A restart of the device leads by no means to a change of the relay states Manual IPv6 Configuration The input fields for the manual setting of IPv6 addresses allow you to configure the prefix of ...

Page 29: ...here The IP filter represents an access control for incoming IP packets Please note that when IP access control is enabled HTTP and SNMP only work if the appropriate servers and clients are registered in the IP access control list If you choose a wrong IP ACL setting and locked yourself out please activate the Bootloader Mode and use GBL_Conf exe to deactivate the IP ACL Alternatively you can rese...

Page 30: ... server via the SSL TLS pro tocol Supported TLS versions Limits the supported TLS versions Enable Ajax autorefresh If this is activated the information of the status page is auto matically updated via http request AJAX For some HTTP configuration changes a firmware reset is required This can be done in the Maintenance web page A restart of the device leads by no means to a change of the relay stat...

Page 31: ...r the user name in the password entry mask of the browser In factory settings the password for the ad min is set to admin or user for the user password If the password mask is redisplayed only four bullets are shown as a symbolic placeholder since for security reasons the device never stores the password itself but only the SHA2 256 hash If you want to change a password the complete password must ...

Page 32: ...y the server Require user login Username and password are required Delay after 3 failed logins After 3 wrong entries of username or password the next login attempt is delayed Use radius server passwords Username and password are validated by a Radius Sever Use locally stored passwords Username and password are stored locally 3 3 2 Syslog Enable Syslog Enables the usage of Syslog Messages Syslog Se...

Page 33: ...P messages are received sysContact Value of RFC 1213 sysContact sysName Value of RFC 1213 sysName sysLocation Value of RFC 1213 sysLocation Enable SNMP v2 Activates SNMP v2 Because of security issues it is advisable to use only SNMP v3 and to disable SNMP v2 Accesses to SNMP v2 are always insecure Community public The community password for SNMP GET requests Community private The community passwor...

Page 34: ...ways be re entered The calculation of the password hashes varies with the selected algorithms If the Authentication or Privacy algorithms are changed the passwords must be re entered in the configuration dialog SHA 384 and SHA512 are calculated purely in software If SHA 512 is set on the configuration page the time for the key generation may take once up to approx 45 seconds Send SNMP traps Here y...

Page 35: ...ed secret Radius Shared Secret For compatibility reasons only use ASCII charac ters Timeout How long in seconds will be waited for a response from an Authentication Request Retries How often an authentication request is repeated after a timeout Use Backup Server Activates a Radius Backup server Backup Server Name or IP address of the Radius Backup server Shared secret Radius Shared Secret For comp...

Page 36: ...me Username input field for Radius test Test Password Password input field for Radius test The Test Radius Server function allows you to check whether a combination of User name and Password is accepted by the configured Radius Servers 3 3 5 Modbus TCP Enable Modbus TCP Enables Modbus TCP support Modus TCP port The TCP IP port number for Modbus TCP ...

Page 37: ... of a user have the same name the connection of one client is normally terminated Quality of Service QoS Sets the QoS value 0 or 1 of the MQTT publishes Keep alive ping interval This defines the time interval in which the client sends an MQTT ping Topic prefix Defines the beginning of the topic with which all messages are sent The strings mac and host symbolize the MAC address or the hostname of t...

Page 38: ...me information about connection duration the last publish and the last keep alive 3 4 Clock 3 4 1 NTP Enable Time Synchronization Enables the NTP protocol Primary NTP server IP address of the first NTP server Backup NTP server IP address of the second NTP server Used when the first NTP server does not respond Timezone The set time zone for the local time ...

Page 39: ...el Sets the verbosity level for timer syslog output New Rule simple Timer Shows a dialog for a simple timer rule New Rule advanced Timer Brings up the dialog for complex timer settings 3 4 3 Timer Configuration In the timer configuration you have three options Create a simple timer add a complex timer or change an existing configuration Timer rules are only executed if the device has a valid time ...

Page 40: ... active In this example the period 9 00 to 17 00 is changed to 9 30 to 11 00 compared to the default input mask Also this rule should not be applied on Saturday and Sunday The rule we have now says that every day except Saturday and Sunday port 1 will be switched on at 9 30 and switched off after 1 5 hours Clicking on Save saves this rule We have now created 2 rules one for when the port is turned...

Page 41: ...th the De lete button If a rule is deleted the following rules move up The numbering of the following rules also changes by one This also applies to the index in the console commands A simple timer is directly enabled for a newly created complex timer enable trigger must be switched on manually You can set a probability and a jitter for the timer rules This makes random events possible In this exa...

Page 42: ...anual operation on the web page as long as the batch mode is running The Action PortSwitch function is only available for devices with switchable ports Extending a rule For demonstration purposes here is an extension to the simple timer from the previous example The action is now started not only at 9 30 but also at 17 30 There are other changes The timer is only active between October and Decembe...

Page 43: ... pressed during the mouse click For this rule on the Options tab the time period is limited to the range between 5 10 2021 and 5 4 2022 In this example the timer rule is only executed with a probabil ity Random Trigger Probability of 90 In this example port 1 and port 5 are enabled and disabled after 90 minutes by batch mode A popup on the mouse pointer shows the port number of the field Console C...

Page 44: ...lected if the option Perform CLI Cmd is activated in Options Example Switching a Port on a Date If you want to switch on a timer on a certain date at a certain time and switch it off at a later time you cannot do it directly with a simple timer Therefore it can be useful to cre ate the timer as a simple timer first and then customize it in the advanced dialog Switch port 3 on every day at 9 25 and...

Page 45: ...ntrol You can use the jitter e g for a shutter control In the classic example of a shutter con trol you do not always want to raise and lower the shutters at the same time in order to confuse potential burglars The jitter of 1800 seconds means that the action is executed randomly in a period between 30 minutes before and 30 minutes after the programmed time The probability Random Trigger Probabili...

Page 46: ...re and humidity can have dif ferent names even if they are from the same sensor Select Sensor Field Selects a data channel from a sensor Enable Messages Enables the generation of sensor messages Maximum Minimum value Here you can choose whether and at what Maximum Min imum temperature or humidity measurements limits the alerts are send via SNMP traps syslog or E Mail Hysteresis This describes the ...

Page 47: ... value is jittering around a sensor limit The following example shows the behavior for a temperature sensor and a hysteresis value of 1 An upper limit of 50 C is set Example 49 9 C is below the upper limit 50 0 C a message is generated for reaching the upper limit 50 1 C is above the upper limit 49 1 C is below the upper limit but in the hysteresis range 49 0 C is below the upper limit but in the ...

Page 48: ... max Port A2 Off below min Action matrix during operation when limit values are exceeded for given example to above max to below max to above min to below min from above max A1 On A1 On A1 On A2 Off from below max A1 Off A2 Off from above min A1 Off A2 Off from below min A1 Off A2 On A2 On A2 On Only the switching operations for which actions have been defined are triggered If no On or Off action ...

Page 49: ...f the E Mail server In the normal case this should be the same as the default that is determined by the setting SMTP Connection Secur ity SMTP Connection Security Transmission via SSL or no encryption SMTP Authentification password Authentication method of the E Mail Server Username User name that is registered with the SMTP E Mail server Set new password Enter the password for the login to the E ...

Page 50: ...t Panel Button Lock Disables the front buttons activates the key lock with the exception of the bootloader activation Allow switching all ports Allows to switch all ports on or off with the front panel buttons Display 1 default Selects what sensor is displayed in the display ...

Page 51: ...Specifications ...

Page 52: ...wer Ports relays or eFuses read write status of Port start configuration read write status Buzzer read write configuration of power sources EPC 8291 read write fan configuration EPC 8291 read measurement values of external sensors read measurement values of all energy sensors read NTP time and status resetting the energy meters read the status of Overvoltage Protection Modbus TCP read write status...

Page 53: ...sages are simple text messages that are sent via UDP to a syslog server Under Linux normally a syslog daemon is already running eg syslog ng for Microsoft Windows systems some freeware programs are available on the market The syslog messages are sent for the following events Turning on the device Enable disable of syslog in the configuration Switching of the Ports Exceeding of the max min values o...

Page 54: ...h messages are either preconfigured or you switch on the push messages temporarily with console telnet pushmsgs set 1 or console ssh pushmsgs set 1 From now on push messages will be sent asynchron ously on this channel The asynchronous nature of the messages can cause problems on a connection if you send commands yourself at the same time There are then the possibilities Filter all incoming charac...

Page 55: ...al address and the link local address Address Notation IPv6 addresses are noted in 8 hexadecimal blocks at 16 bit while IPv4 normally is noted in decimal The seperator is a colon not a period E g 1234 4ef0 0 0 0019 32ff fe00 0124 Leading zeros may be omitted within a block The previous example can be rewritten as 1234 4ef0 0 0 19 32ff fe00 124 One may omit one or more successive blocks if they con...

Page 56: ...ser has to login again but at what intervals the RADIUS servers are asked again 4 6 SNMP SNMP can be used for status information via UDP port 161 Supported SNMP com mands are GET GETNEXT GETBULK SET To query via SNMP you need a Network Management System such as HP OpenView OpenNMS Nagios etc or the simple command line tools of NET SNMP software The device supports SNMP protocols v1 v2c and v3 If t...

Page 57: ...512 is set on the configuration page the time for the key generation may take once up to approx 45 seconds Encryption The methods DES 3DES AES 128 AES 192 and AES 256 are supported in combination with HMAC MD5 96 and HMAC SHA 96 For the HMAC SHA 2 proto cols there is currently neither RFC nor draft that will allow for cooperation with an en cryption While in the settings AES 192 and AES256 the key...

Page 58: ...everal hundred trap definitions To limit this overabundance of trap definitions the trap design has been changed to create only one specific trap for each event type The port or sensor number is now available in the trap as an index OID within the variable bindings In order to recognize this change directly the Notification area in the MIB table has been moved from sysObjectID 0 to sysObjectID 3 T...

Page 59: ... 1 3 x INTEGER RW current state of a Relay Port epc8001PortSw itchCount 100 1 3 1 2 1 4 x Integer32 RO The total number of sw itch actions ocurred on a Relay Port Does not count sw itch commands w hich w ill not sw itch the ralay state so just real relay sw itches are displayed here epc8001PortStartupMode 100 1 3 1 2 1 5 x INTEGER RW set Mode of startup sequence off on remember last state epc8001P...

Page 60: ... counter epc8001RevEnergyReactive 100 1 5 1 2 1 21 x Gauge32 RO Reverse Reactive Energy counter epc8001RevEnergyActiveResetta ble 100 1 5 1 2 1 22 x Gauge32 RO Resettable Reverse Active Energy counter epc8001RevEnergyReactiveResett able 100 1 5 1 2 1 23 x Gauge32 RO Resettable Reverse Reactive Energy counter epc8001LineSensorName 100 1 5 1 2 1 100 x OCTETS RW A textual string containing name of a ...

Page 61: ...c8001spRevEnergyActiveReset table 100 1 5 5 2 1 22 x Gauge32 RO Resettable Reverse Active Energy counter epc8001spRevEnergyReactiveRes ettable 100 1 5 5 2 1 23 x Gauge32 RO Resettable Reverse Reactive Energy counter epc8001CPUSensorVsystem 100 1 5 14 1 0 Gauge32 RO System Voltage on CPU Board epc8001CPUSensorVaux 100 1 5 14 2 0 Gauge32 RO Auxiliary Voltage on CPU Board epc8001CPUSensorVmain 100 1 ...

Page 62: ...enerate the local certificate anew at the touch of a button since the required ran dom numbers in an embedded device are usually not independent enough However you can create new certificates and import them to the device The server accepts RSA 2048 4096 and ECC Elliptic Curve Cryptography certificates Usually OpenSSL is used to create an SSL certificate For Windows for example there is the light ...

Page 63: ...diates are assembled e g cat server crt IM1 crt IM2 crt server key server pem An uploaded certificate will be preserved when a device is put back to factory de faults Performance Considerations If RSA 4096 certificates are used the first access to the web server can take 8 10 seconds because the math unit of the embedded CPU is highly demanded After that the parameters are in the SSL session cache...

Page 64: ... position http passwd help provides all com mands that have the prefix http passwd You will find a complete list of all possible device commands in the chapter Cmd Over view Parameter If parameters are expected for the command the parameter may be passed as numeric or constant If e g you get the following line as help http server set http_both 0 https_only 1 http_only 2 the following instruction p...

Page 65: ... after a restart In the Cmd Overview table this is marked with Note 2 2 Other configurations such as the assigned IPv6 addresses have several values that can change dynamically This is marked with Note 3 in the Cmd Overview table Numerical Returns For parameters that support constants these constants are output as return values To better deal with scripting languages it may be easier to work only ...

Page 66: ...es character under the cursor Backspace deletes character left of cursor Up Down shows input lines history Tab Ctrl Tab completes the word at cursor Ctrl C clears the line Sensor Examples a External Sensors extsensor all show E 1 L 7106 0 21 3 C 1 35 1 3 1013hPa 4 5 2 C 5 16 0 C E 2 L 7102 0 21 2 C 1 35 4 4 5 3 C 5 15 9 C The command lists one connected external sensor per line and the individual ...

Page 67: ... example these are the fields Absolute Active Energy 0 Power Active 1 Voltage 2 Current 3 and Reset Time 12 portsensor 2 0 1 2 3 12 show portsensor 2 1 show These variants give the sensor values of the field list or a sensor to at Outlet Port 2 d Displaying Port Relays port all state 1 show P1 ON P2 OFF P3 ON P4 OFF P5 OFF P6 OFF P7 OFF P8 ON The command port all state MODE0 0 MODE1 1 MODE2 2 show...

Page 68: ...TTYgen and inserted into the Configuration Console input field Public keys are accepted in SSH2 or OpenSSH format Generation with ssh keygen The tool ssh keygen is mostly shipped with Linux and Windows to generate SSH keys Here is an example to generate an ECDSA 384 key ssh keygen t ecdsa b 384 f ssh key In the file ssh pub is then the private key the content of ssh key pub is inserted into the fi...

Page 69: ... echo set OFF 0 ON 1 enables echo on off console telnet echo show show s if echo enabled console telnet activeneg set OFF 0 ON 1 enables telnet active negotiation IAC on off console telnet activeneg show show s if active negotiation enabled console telnet login set OFF 0 ON 1 enables login on off console telnet login show show s if login enabled console telnet login local set OFF 0 ON 1 enables lo...

Page 70: ...me email passw d set passw d sets SMTP passw ord email passw d hash set passw d sets crypted SMTP passw ord email testmail send test email ethernet enters cmd group ethernet ethernet mac show show s MAC address ethernet link show show s 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 ...

Page 71: ...N 1 ABOVEMAX 2 BELOWMAX 3 port show show s Port for Pow er Port Sw itching actions 6 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 Pow er Port Sw itching actions 6 extsensor port_num sen_type sen_field BELOWMIN 0 ABOVEMIN 1 ABOVEMAX 2 BELOWMAX 3 state show show s Port state for Pow er Port Sw itching actions 6 ...

Page 72: ...led show show s if manual IPv6 addresses are enabled 3 ip6 manual address 1 4 set ip_address sets manual IPv6 address ip6 manual address 1 4 show show s manual IPv6 address 3 ip6 manual gatew ay set ip_address sets manual IPv6 gatew ay address ip6 manual gatew ay show show s manual IPv6 gatew ay address 3 ip6 manual dns 1 2 set ip_address sets manual IPv6 DNS server address ip6 manual dns 1 2 show...

Page 73: ...energy_sensor publish delta show show s publish delta value linesensor line_num energy_sensor BELOWMIN 0 ABOVEMIN 1 ABOVEMAX 2 BELOWMAX 3 port set port_num sets Port for Pow er Port Sw itching actions linesensor line_num energy_sensor BELOWMIN 0 ABOVEMIN 1 ABOVEMAX 2 BELOWMAX 3 port show show s Port for Pow er Port Sw itching actions linesensor line_num energy_sensor BELOWMIN 0 ABOVEMIN 1 ABOVEMAX...

Page 74: ..._idx passw d hash set passw d sets hashed passw d mqtt broker_idx client set name sets client name mqtt broker_idx client show show s client name mqtt broker_idx qos set QOS0 0 QOS1 1 sets QoS level mqtt broker_idx qos show show s QoS level mqtt broker_idx keepalive set num_secs sets keep alive time mqtt broker_idx keepalive show show s keep alive time mqtt broker_idx topic set name sets topic pre...

Page 75: ... set num sets port w atchdog ping retries port port_num w atchdog pingretries show show s port w atchdog ping retries port port_num w atchdog retrybooting set OFF 0 ON 1 sets port w atchdog retry booting to on off port port_num w atchdog retrybooting show show s port w atchdog retry booting state port port_num w atchdog bootretries set num sets port w atchdog retry boot timeout port port_num w atc...

Page 76: ...how show s state for sensor values action portsensor port_num events set OFF 0 ON 1 LEGACY enables sensor events on off L portsensor port_num events show LEGACY show s if sensor events are enabled L portsensor port_num events type set EVT_SYSLOG 0 EVT_SNMP 1 EVT_EMAIL 2 E VT_SMS 3 EVT_GSMEMAIL 4 EVT_BEEPER 5 E VT_DISPLAY 6 EVT_CONSOLE 7 EVT_MQTT 8 LEGACY enables different event types 1 portsensor ...

Page 77: ... 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 show s SNMP v2 public community snmp system CONTACT 0 NAME 1 LOCATION 2 set text sets sysLocation sysName...

Page 78: ...nts type set EVT_SYSLOG 0 EVT_SNMP 1 EVT_EMAIL 2 E VT_SMS 3 EVT_GSMEMAIL 4 EVT_BEEPER 5 E VT_DISPLAY 6 EVT_CONSOLE 7 EVT_MQTT 8 enables different event types system SWITCH_PORT 0 events type show show s w hat 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 show s if mqtt retain set system panel enabled set...

Page 79: ...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 show s console echo state vt100 numeric set OFF 0 ON 1 sets numeric mode vt100 numeric show show s numeric mode state vt100 reset resets terminal Notes 1 Legacy The command has been replaced by a newer version 2 Command can be ...

Page 80: ...2 1 Temperature Humidity 7005 7105 7205 2 Temperature Humidity Air Pressure 7006 7106 7206 External Sensor Field Table sen_field Index Description Unit 0 Temperature C 1 Humidity 2 Digital Input bool 3 Air Pressure hPa 4 Dew Point C 5 Dew Point Temperature Difference C 4 9 Modbus TCP Important All calculations in this chapter are based on addresses starting at 0 For some Modbus TCP Utilities howev...

Page 81: ... Holding Registers Fan Mode 0x010 0x01f Holding Registers This chapter is general for all Gude devices Depending on the device type some ports or certain sensors are not available The Unit ID is ignored because the device is uniquely identified by its IP address Supported Modbus TCP Functions Function Request Code Read Coils 0x01 Read Discrete Inputs 0x02 Write Single Coil 0x05 Write Multiple Coil...

Page 82: ...f see table Power Source Sensors 0x8240 0x827f see table Residual Current Monitor 0x8280 0x82cf see table Info Area Address Width Information 0 16 bit Number of Ports Relay 1 16 bit Number of Ports Outlets with Energy Measurement 2 16 bit Number of Banks 3 16 bit Number of Line In 4 16 bit Phases per line 5 16 bit Number of Inputs Sensor Type Description Address Width Information 0x080 to 0x083 16...

Page 83: ...r 4 Dew Point 0 1 C 5 Dew Point Difference 0 1 C For example the humidity of the second port has the address 0x100 1 8 1 0x109 Energy Sensors We distinguish the line sensors which correspond to the input circuits and the port sensors which measure the energy that is passed over the switched port The meas ured values of the energy sensors are returned as signed 32 bit integers The high order 16 bit...

Page 84: ...le Wh 20 Reverse Reactive Energy Resettable VARh 21 Residual Current Type A mA 22 Neutral Current mA Whether the measured values Residual Current and Neutral Current are suppor ted depends on the respective device model For measured values such as Neutral Cur rent which are independent of the phase the same value is returned for all phases DC Energy Sensors With the EPC 8291 8290 devices the volta...

Page 85: ...0 Residual Current RMS Type B 0 1 mA 1 0x8281 Residual Current DC Type B 0 1 mA 2 0x8282 Output RMS bool 3 0x8283 Output DC bool 4 0x8284 Module State Whether a Residual Current Monitor Type B RCMB module is present depends on the particular device model Holding Registers Device Resource Start End Function Bank Power Source 0x000 0x00f Sets Power Source for Bank Fan Mode 0x010 0x01f 0 Automatic 1 ...

Page 86: ...ature 0x100 Humidity 0x101 Digital input 0x102 Air Pressure 0x103 Dew Point 0x104 Dew Point Difference 0x105 A value of 0x8000 means that no sensor is plugged into the corresponding port or the corresponding field in the sensor is not available Line In Energy Addresses Input Register Offset Sensor Field Line 1 0 Absolute Active Energy 0x400 1 Power Active 0x402 2 Voltage 0x404 3 Current 0x406 4 Fr...

Page 87: ...e 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...

Page 88: ...nse 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...

Page 89: ...ltage 242 48 current 0 000 sensors idx 1 name 7105 data field temperature v 21 1 unit deg C field humidity v 71 9 unit field dew_point v 15 8 unit deg C field dew_diff v 5 3 unit deg C ts 210520 4 10 1 Example HiveMQ What does an MQTT configuration look like using HiveMQ as an example Create a free or commercial account at www hivemq com and create a new cluster ...

Page 90: ...n the Manage Clusters section go to Access Management and add an MQTT user with name and password In the MQTT configuration of the Gude device transfer the hostname of the HiveMQ broker as well as username and password Additionally activate TLS and set the correct port ...

Page 91: ...Support ...

Page 92: ...Pv3 Disable SNMP v2 access Enable STARTTLS or SSL in the e mail configuration Archive configuration files securely they contain sensitive information In the IP ACL enter only the devices that require access to HTTP or SNMP Use SSH if possible since Telnet is not encrypted Set login for telnet or serial console Use MQTT 3 1 1 only with TLS and password Only permit MQTT CLI commands when the broker ...

Page 93: ...atus LED is green to the device but you can not access the web server bring the device into bootloader mode and search for it with GBL_Conf exe Then check the TCP IP parameters and change them if necessary If the device is not found by GBL_Conf exe in bootloader mode you can reset the set tings to factory defaults as the last option Why is a device sporadically no longer accessible when DHCP is ac...

Page 94: ...e E Mail configuration in the Recipient Address field it is possible to enter multiple e mail addresses separated by commas The input limit is 100 characters 7 Why did the MIB tables change after the firmware update Since the number of possible event types was increased the previous trap design res ulted in an excess of trap definitions See Change in Trap Design 8 Importing an older firmware Durin...

Page 95: ...lectrical Measurement 9 E Mail 49 Ethernet connnector 7 F Factory Reset 15 FAQ 93 Feature Matrix 6 Firmware Upload 15 Firmware Update 17 G GBL_Conf exe 15 H HTTP 30 HTTPS 30 I Installation 7 IP ACL 29 54 IP Address 27 IPv6 55 L load Configuration 17 M Maintenance 15 messages 52 Modbus TCP 36 80 MQTT 37 87 N NTP 38 O Ok button 7 Operating the device directly 13 P Power Ports 24 R Radius 35 55 Resta...

Page 96: ...96 Expert Power Control 8001 2022 GUDESystems GmbH Index T Technical Specifications 8 Timer 39 Timer Configuration 39 TLS 62 W Watchdog 25 ...

Page 97: ...97 Expert Power Control 8001 2022 GUDESystems GmbH Expert Pow er Control 8001 2022 GUDE Systems GmbH 3 16 2022 ...