GÜDE Expert Power Control 8221 Series, Manual

Page 1: ...Expert Power Control 8221 Series Expert Power Control 8226 Series Manual 2022 GUDE Systems GmbH Manual Ver 2 9 1 from Firmware Ver 1 9 ...

Page 2: ...2 Expert Power Control 8221 8226 2022 GUDESystems GmbH ...

Page 3: ...ing 14 2 1 Operating the device directly 15 2 2 Control Panel 15 2 3 Maintenance 17 2 3 1 Maintenance Page 20 2 3 2 Configuration Management 21 2 3 3 Bootloader Activation 22 3 Configuration 25 3 1 Power Ports 26 3 1 1 Watchdog 27 3 2 Ethernet 29 3 2 1 IP Address 29 3 2 2 IP ACL 31 3 2 3 HTTP 31 3 3 Protocols 33 3 3 1 Console 33 3 3 2 Syslog 35 3 3 3 SNMP 36 3 3 4 Radius 38 3 3 5 Modbus TCP 39 3 3...

Page 4: ...4 5 Radius 58 4 6 SNMP 59 4 6 1 Device MIB 8221 62 4 6 2 Device MIB 8226 64 4 7 SSL 67 4 8 Console 68 4 8 1 SSH 73 4 8 2 Console Cmd 8221 74 4 8 3 Console Cmd 8226 84 4 8 4 Serial Console 96 4 9 Modbus TCP 97 4 9 1 Sensor Tables 103 4 10 MQTT 105 4 10 1 Example HiveMQ 107 5 Support 109 5 1 Data Security 110 5 2 Contact 110 5 3 Declaration of Conformity 111 5 4 FAQ 111 113 Index ...

Page 5: ...Device Description ...

Page 6: ...owed to modify the device without our permission The device is NOT a toy It has to be used or stored out of range of children Care about packaging material Plastics has to be stored out of range of children Please recycle the packaging materials In case of further questions about installation operation or usage of the device which are not clear after reading the manual please do not hesitate to as...

Page 7: ...urn 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 an integrated web server with SSL encryption TLS 1 1 1 2 1 3 Control and configuration with CGI parameters and JSON messages via HTTP REST API SNMP v1 v2c and v3 trap...

Page 8: ...p to the stop otherwise there is no secure connection The plug must not wobble in the socket or there is no tight connection Plug the network cable into the Ethernet socket RJ45 If required setup a serial connection to the RS232 port Insert the optional external sensors into the sensor connectors Connect the consumers with the load outputs IEC C13 max 10A 1 5 Dual Circuit Characteristics The Exper...

Page 9: ...d neutral N to pro tect the internal electronics and power ports with failure detection permanently triggered thermal fuse The state of the protection is indicated on the front panel by a green or red flash A green flash means that the protection is active a red flash symbolizes that the overvoltage protection fails In addition the status of the overvoltage protection can be seen on the Webpage HT...

Page 10: ...ctivity 10 100 MBit s 10baseT Ethernet Power Supply internal power supply 90 265V AC 15 10 Overvoltage Protection single peak current for 20 80us pulse max clamping voltage 20 80us pulse Ipk 100 A 20 mm 250 J varistor disk 300V AC 10000 A 775 V Environment Operating temperature Storage temperature Humidity 0 C 50 C 20 C 70 C 0 95 non condensing Case powder coated galvanized steel sheet Measurement...

Page 11: ...oltage 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 4000 W 1 1 5 Reactive power 0 4000 Var 1 1 5 Apparent power 0 4000 VA 1 1 5 Power factor 0 1 0 01 3 Energy Counter Active Energy total 9 999 999 999 kWh 0 001 1 5 Active Energy resettable 9 999 999 999 kWh 0 001 1 5 1 8 Sensor Two external sensors can be connected to the Expert Power Con...

Page 12: ...ndensing 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 C air pressure range ext 1 7 hPa typical at 300 1100 hPa 20 0 C Protection IP68 Product Name 7201 7202 Cable length Connector RJ45 RJ45 temperature range 20 C to 80 C at 2 C max imum and 1 C typical 20 C to 80 C at 2 C max imum and 1 C typical air humidity range non conde...

Page 13: ...ystems GmbH Device Description 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 the name column deletes all stored Min and Max values ...

Page 14: ...Operating ...

Page 15: ...tton 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 s...

Page 16: ...green when the relay is closed or red in the open state If a bank has no voltage the state is represented by a gray Port icon An additional small clock icon indicates that a timer is active Timer can be activated by delay reset or batch mode Two outputs configured as twin ports are connected by a chain icon An activated Watchdog is represented by an eye icon An X means that the address that should...

Page 17: ...n be switched via a Perl script or external tools like wget More information is available on our support wiki at www 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...

Page 18: ...tures If an older firmware is newly installed the configuration data and the energy meters may be lost If the device then does 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 ca...

Page 19: ...er Bootloader Mode and choose in menu Search the item Bootloader Mode Devices only Enter the desired 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 allowe...

Page 20: ...configuration a Restart Device must be executed after the Upload Config File Export Saves the current configuration in a text file Saving the configuration should only be carried out 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 up...

Page 21: ... encrypted or hashed For the same reasons it is advisable to carefully handle the generated configuration files when archiv ing Editing the configuration file It is possible to customize a saved 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 larg...

Page 22: ...n and not completely when restarting as it would have been the case with an upload It can happen that events are triggered at the same time as 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 emai...

Page 23: ...he factory settings For devices with relays entering or exiting the bootloader mode does not change the state of the relays as long as the operating voltage is maintained 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 applic...

Page 24: ...ssed use a pin or paper clip The status LED will blink in a fast rhythm please wait until the LED blinks slowly about 5 seconds 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 25: ...Configuration ...

Page 26: ...default settings 192 168 0 2 either no DHCP server is present on the network or there could be no free IP address assigned to it 3 1 Power 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 facil...

Page 27: ...oltage failure is detected they keep their actual state This can lead to an increased total current consumption when the voltage is coming back since the activated connected devices are simultaneously turned on again Activation of this option makes sense if the input voltage of the device deviates strongly from the sinusoidal shape The internal signal evaluation might then erroneously assume a vol...

Page 28: ...port 25 for SMTP TCP port Enter the TCP port to be monitored When using ICMP pings this is not needed Hostname The name or IP address of the monitored network device Ping interval Select the frequency in seconds at which the ping packet is sent to each network device to check its operating status Ping retries After this number of consecutive unanswered ping requests the device is considered inacti...

Page 29: ...If a server that is connected to the monitored Port is in need for a long boot process e g it is doing a file system check the server would probably exceed the tripping time of the watchdog The server would be switched off and on again and the file system check is restarted This would be repeated endlessly count PING requests as unreplied when ethernet link down If the Ethernet link of the device ...

Page 30: ... The DHCP request lasts one minute until it is aborted During this time the IP address is not accessible It is therefore essential to deactivate DHCP for a static IP addresses Use IPv6 Protocol Activates IPv6 usage Use IPv6 Router Advertisement The Router Advertisement communicates with the router to make global IPv6 addresses available Use DHCP v6 Requests from an existing DHCPv6 server addresses...

Page 31: ...onds to ICMP pings from the network Enable IP filter Enable or disable the IP filter 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 Boo...

Page 32: ...sions 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 states Enable password protection Password access protection can be activated If the admi...

Page 33: ...assword 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 always be re entered If you have forgotten your password please activate the bootlo...

Page 34: ...fter 3 failed logins After 3 wrong entries of username or password the next login attempt is delayed SSH Enable SSH Enables the SSH protocol SSH TCP port Port on which SSH sessions are accepted Activate echo The echo setting for SSH Push messages Sends push messages via SSH SSH and Telnet Require user login Username and password are required Use radius server passwords Username and password are va...

Page 35: ...VM protocol Enable UTF8 support Enables character encoding in UTF8 Push messages Sends push messages via serial console 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 Usernam...

Page 36: ...f the server to which the syslog information should be transmitted 3 3 3 SNMP SNMP get Enables the acceptance of SNMP GET commands SNMP set Allows the reception of SNMP SET commands SNMP UDP Port Sets the UDP port where SNMP 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 ...

Page 37: ...itself but only the key formed using the Authorization Algorithm If you want to change a pass word the complete password must always 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 5...

Page 38: ...hared 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 c...

Page 39: ...name 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 40: ...ts 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...

Page 41: ... Time 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 42: ...evel 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 advanced 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 ti...

Page 43: ...is 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 turn...

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

Page 45: ... manual 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 Decem...

Page 46: ...be 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...

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

Page 48: ...control 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 Probabi...

Page 49: ...ects 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 margin of when an event is generated after the measured value has crossed the chosen limit Message chan...

Page 50: ...ple 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 hysteresis range 48 9 C a message is generated for underrunning the upper limit inclusive hysteresis range 3 5 1 Port Switching Depending on the measured Current and the ...

Page 51: ...x 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 is ...

Page 52: ...he 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 Mai...

Page 53: ... Button Lock Disables the front buttons activates the key lock with the exception of the bootloader activation Dark Display The 7 segment display remains dark Front button activity temporarily switches the display on Default Display Selects the display of sensor values for both displays ...

Page 54: ...Specifications ...

Page 55: ...ad write names of Power 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 T...

Page 56: ...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 57: ...itch a port port 2 ON If you open a telnet or SSH connection the push 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 s...

Page 58: ...efix and a subnet ID An IPv6 network interface can be reached under several IP addresses Usually this is the case under a global 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 ...

Page 59: ...orarily stored there The RADIUS parameter Session Timeout therefore does not determine when the user 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 sim...

Page 60: ...2 are implemented SHA 384 and SHA512 are calculated purely in software If SHA 384 or SHA 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 a...

Page 61: ...SwitchEvtPort12 Since new firmware versions can generate many more different events this behavior quickly produces several 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 recogn...

Page 62: ... x OCTETS RW A textual string containing name of a Relay Port epc8221PortState 56 1 3 1 2 1 3 x INTEGER RW current state of a Relay Port epc8221PortSw itchCount 56 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 epc8221PortStartupMode 56 1 ...

Page 63: ... Forw ard Reactive Energy counter epc8221RevEnergyActive 56 1 5 1 2 1 20 x Gauge32 RO Reverse Active Energy counter epc8221RevEnergyReactive 56 1 5 1 2 1 21 x Gauge32 RO Reverse Reactive Energy counter epc8221RevEnergyActiveResetta ble 56 1 5 1 2 1 22 x Gauge32 RO Resettable Reverse Active Energy counter epc8221RevEnergyReactiveResett able 56 1 5 1 2 1 23 x Gauge32 RO Resettable Reverse Reactive E...

Page 64: ...e port An empty string disables this slot epc8226portNumber 58 1 3 1 1 0 Integer32 RO The number of Relay Ports epc8226PortIndex 58 1 3 1 2 1 1 x Integer32 RO A unique value greater than zero for each Relay Port epc8226PortName 58 1 3 1 2 1 2 x OCTETS RW A textual string containing name of a Relay Port epc8226PortState 58 1 3 1 2 1 3 x INTEGER RW current state of a Relay Port epc8226PortSw itchCou...

Page 65: ...uge32 RO Forw ard Reactive Energy counter epc8226Forw EnergyActiveResett able 58 1 5 1 2 1 18 x Gauge32 RO Resettable Forw ard Active Energy counter epc8226Forw EnergyReactiveRes ettable 58 1 5 1 2 1 19 x Gauge32 RO Resettable Forw ard Reactive Energy counter epc8226RevEnergyActive 58 1 5 1 2 1 20 x Gauge32 RO Reverse Active Energy counter epc8226RevEnergyReactive 58 1 5 1 2 1 21 x Gauge32 RO Reve...

Page 66: ...rd Reactive Energy counter epc8226spForw EnergyActiveRes ettable 58 1 5 5 2 1 18 x Gauge32 RO Resettable Forw ard Active Energy counter epc8226spForw EnergyReactiveR esettable 58 1 5 5 2 1 19 x Gauge32 RO Resettable Forw ard Reactive Energy counter epc8226spRevEnergyActive 58 1 5 5 2 1 20 x Gauge32 RO Reverse Active Energy counter epc8226spRevEnergyReactive 58 1 5 5 2 1 21 x Gauge32 RO Reverse Rea...

Page 67: ...e some possible workarounds Use secure certificates official certificate authority or marked as secure in the OS or use of the Firefox browser or use of ECC 256 no RSA certificates or configure to TLS v1 2 only Creating your own Certificates The SSL stack is supplied with a specially newly generated self signed certificate There is no function to generate the local certificate anew at the touch of...

Page 68: ...key and certificate both files are concatenated to one file Linux cat server crt server key server pem Windows copy server crt server key server pem The created server pem can only be uploaded in the maintenance section of the device If several certificates Intermediate CRT s should also be uploaded to the device one should make sure that firstly the server certificate and secondly the Intermediat...

Page 69: ...tp subtopics appears This means that there is an other level for http With the command http help all commands below http are shown Alternatively with entering http you can select the http level and help shows all the commands on the selected level The command back again selects the top level It is possible to use help at any position http passwd help provides all com mands that have the prefix htt...

Page 70: ...ul instructions without special return value will be acknowledged by OK All other return values are output within a single line There are of two exceptions 1 Some configuration changes that affect TCP IP and UDP need a restart to be ap plied These parameters are output on two lines In the first line the current value is shown on the second row the value after a restart In the Cmd Overview table th...

Page 71: ...ot in the used Telnet client the IAC commands sent at the beginning can appear as interfering characters in the command line partially invisible Editing The following edit functions are available when the terminal supports VT100 and Raw Mode is deactivated Entered characters are inserted at the cursor position Keys Function Left Right moves cursor left or right Pos1 End moves cursor to the beginni...

Page 72: ...t Sensors portsensor all 0 1 2 3 12 show P 1 L Power Port 0 13000Wh 1 0W 2 225V 3 0A 12 998218s P 2 L Power Port 0 13000Wh 1 0W 2 225V 3 0A 12 996199s P 12 L Power Port 0 13000Wh 1 0W 2 225V 3 0A 12 998218s This command outputs all port sensor values in one line A list of all fields according to the energy sensor table is passed as parameter In this example these are the fields Absolute Active Ene...

Page 73: ...a radius server If you want to use SSH in a terminal Activ ate echo should be enabled Public Keys The following public keys are accepted Key type Length RSA 2048 4096 ECDSA 256 384 Generation with PuTTYgen Generated keys can be copied directly from e g PuTTYgen and inserted into the Configuration Console input field Public keys are accepted in SSH2 or OpenSSH format Generation with ssh keygen The ...

Page 74: ...sole telnet enabled set OFF 0 ON 1 enables telnet on off console telnet enabled show show s if telnet enabled console telnet port set ip_port sets telnet port console telnet port show show s telnet port console telnet raw set OFF 0 ON 1 sets raw mode disables editing on off console telnet raw show show s if raw mode enabled console telnet echo set OFF 0 ON 1 enables echo on off console telnet echo...

Page 75: ...w s if login enabled console serial login local set OFF 0 ON 1 enables local login on off console serial login local show show s if local login enabled console serial login radius set OFF 0 ON 1 enables login for RADIUS on off console serial login radius show show s 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...

Page 76: ...beeper mode set CONTINOUS 0 INTERMITTENT 1 sets beeper tone extsensor port_num sen_type sen_field events beeper mode show show s beeper tone extsensor port_num sen_type sen_field maxval set num sets maximum value for sensor 6 extsensor port_num sen_type sen_field maxval show show s maximum value for sensor 6 extsensor port_num sen_type sen_field minval set num sets minimum value for sensor 6 extse...

Page 77: ... show show s if http passw ord enabled http passw d local set OFF 0 ON 1 enables local login on off http passw d local show show s if local login enabled http passw d radius set OFF 0 ON 1 enables login for RADIUS on off http passw d radius show show s if RADIUS login enabled http passw d user set passw d sets http user passw ord http passw d admin set passw d sets http admin passw ord http passw ...

Page 78: ... to label linesensor line_num label show show s 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 show s if events are enabled linesensor line_num energy_sensor events type set EVT_SYSLOG 0 EVT_SNMP 1 EVT_EMAIL 2 E VT_SMS 3 EVT_GSMEMAIL 4 EVT_BEEPER 5 enables different event types linesensor line_num ener...

Page 79: ...imum value for line meter L linesensor line_num minval show LEGACY show s minimum value for line meter L linesensor line_num hyst set float LEGACY sets hysterese value for line meter L linesensor line_num hyst show LEGACY show s hysterese value for line meter L linesensor line_num BELOWMIN 0 ABOVEMIN 1 ABOVEMAX 2 BELOWMAX 3 port set port_num LEGACY sets Port for Pow er Port Sw itching actions L li...

Page 80: ...label show show s port label name port port_num tw inport set OFF 0 ON 1 sets port tw inport state to on off port port_num tw inport show show s port num tw inport state port port_num initstate coldstart set OFF 0 ON 1 REMEMBER 2 sets port coldstart initialization port port_num initstate coldstart show show s port coldstart initialization port port_num initstate repow er set INIT_STATE 0 CURRENT_S...

Page 81: ...ONDARY 1 retries set 0 99 sets server number of retries radius PRIMARY 0 SECONDARY 1 retries show show s server number of retries radius chap enabled set off 0 on 1 enables CHAP radius chap enabled show show s if CHAP is enabled radius message auth set off 0 on 1 enables request message authentication radius message auth show show s if request message authentication is enabled radius default timeo...

Page 82: ...ushdns flush DNS cache system uptime number of seconds the device is running system name show show s device name system version show show s actual firmw are version system display disp_num default extsensor port_num sen_type set sen_field show s external sensor system display disp_num default linesensor line_num set sen_field show s energy line sensor system display disp_num default set BLANK 0 LO...

Page 83: ...rule_num action mode show show s if sw itch or cli cmd timer rule_num action SWITCH1 0 SWITCH2 1 OFF 0 ON 1 set port_list sets port list for sw itch cmd timer rule_num action SWITCH1 0 SWITCH2 1 OFF 0 ON 1 show show s port list for sw itch cmd timer rule_num action delay set 0 65535 delay betw een cmds timer rule_num action delay show show s delay betw een cmds timer rule_num action console set cm...

Page 84: ...ve Energy Resettable VARh 21 Residual Current A Dependent on the device model Residual Current may not be supported External Sensor Type Table sen_type Constants 7x01 0 7x04 0 7x02 1 7x05 1 7x06 2 Index Description Products 0 Temperature 7001 7101 7201 0 Temperature 7004 7104 7204 1 Temperature Humidity 7002 7102 7202 1 Temperature Humidity 7005 7105 7205 2 Temperature Humidity Air Pressure 7006 7...

Page 85: ...ables delay after 3 login fails on off console telnet login delay show show s if login delay enabled console telnet pushmsgs config set OFF 0 ON 1 enables persistent push msgs console telnet pushmsgs config show show s if persistent push msgs are enabled console telnet pushmsgs set OFF 0 ON 1 enables temporary push msgs console telnet pushmsgs show show s if temporary push msgs are enabled console...

Page 86: ...rver address email server show show s email SMTP server address email port set ip_port sets email SMTP port email port show show s email SMTP port email security set NONE 0 STARTTLS 1 SSL 2 sets SMTP connection security email security show show s SMTP connection security email auth set NONE 0 PLAIN 1 LOGIN 2 sets email authentication email auth show show email authentication email user set usernam...

Page 87: ... port_num sen_type sen_field publish timer show show s 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 show s 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 Pow er Port Sw itching actions 6 extse...

Page 88: ...p6 routadv enabled set OFF 0 ON 1 enables IPv6 router advertisement ip6 routadv enabled show show s IPv6 router advertisement state 3 ip6 dhcp enabled set OFF 0 ON 1 enables IPv6 DHCP on off ip6 dhcp enabled show show s if IPv6 DHCP is enabled 3 ip6 address show show all IPv6 addresses 4 ip6 gatew ay show show all IPv6 gatew ays 4 ip6 dns show show all IPv6 DNS server 4 ip6 manual enabled set OFF ...

Page 89: ... publish mode linesensor line_num energy_sensor publish mode show show s 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 show s 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 sh...

Page 90: ...bled set OFF 0 ON 1 enable mqtt mqtt broker_idx enabled show show s if mqtt enabled mqtt broker_idx server set dns_name sets broker name mqtt broker_idx server show show s broker name mqtt broker_idx tls enabled set OFF 0 ON 1 enable TLS mqtt broker_idx tls enabled show show s if TLS enabled mqtt broker_idx port set ip_port set broker TCP IP port mqtt broker_idx port show show s broker TCP IP port...

Page 91: ... 1 sets if w atchdog active w hen eth link dow n port port_num w atchdog link dow n show show s if w atchdog active w hen eth link dow n port port_num w atchdog host set dns_name sets port w atchdog host target port port_num w atchdog host show show s port w atchdog host target port port_num w atchdog port set ip_port sets port w atchdog TCP port port port_num w atchdog port show show s port w atc...

Page 92: ...sensor publish timer show show s publish time interval portsensor port_num energy_sensor publish delta set float sets publish delta value portsensor port_num energy_sensor publish delta show show s publish delta value portsensor port_num energy_sensor BELOWMIN 0 ABOVEMIN 1 ABOVEMAX 2 BELOWMAX 3 port set port_num set sets pow er port for sensor values action portsensor port_num energy_sensor BELOWM...

Page 93: ...r number of retries radius PRIMARY 0 SECONDARY 1 retries show show s server number of retries radius chap enabled set off 0 on 1 enables CHAP radius chap enabled show show s if CHAP is enabled radius message auth set off 0 on 1 enables request message authentication radius message auth show show s if request message authentication is enabled radius default timeout set num_secs sets default session...

Page 94: ... bootloader enters bootloader mode system flushdns flush DNS cache system uptime number of seconds the device is running system name show show s device name system version show show s actual firmw are version system display disp_num default extsensor port_num sen_type set sen_field show s external sensor system display disp_num default linesensor line_num set sen_field show s energy line sensor sy...

Page 95: ...ule_num action mode set SWITCH 1 CLI 2 sets sw itch or cli cmd timer rule_num action mode show show s if sw itch or cli cmd timer rule_num action SWITCH1 0 SWITCH2 1 OFF 0 ON 1 set port_list sets port list for sw itch cmd timer rule_num action SWITCH1 0 SWITCH2 1 OFF 0 ON 1 show show s port list for sw itch cmd timer rule_num action delay set 0 65535 delay betw een cmds timer rule_num action delay...

Page 96: ...ctive Energy Resettable Wh 20 Absolute Reactive Energy Resettable VARh 21 Residual Current A Dependent on the device model Residual Current may not be supported External Sensor Type Table sen_type Constants 7x01 0 7x04 0 7x02 1 7x05 1 7x06 2 Index Description Products 0 Temperature 7001 7101 7201 0 Temperature 7004 7104 7204 1 Temperature Humidity 7002 7102 7202 1 Temperature Humidity 7005 7105 72...

Page 97: ...rn the re lays on and off individually Syntax w x y z w prefix 0x80 x command 0x31 to turn on 0x32 for turning off y port number 0x01 z check byte must be x xor y Before the KVM protocol is recognized the Enable binary KVM protocol entry must be activated in the Console configuration KVM Examples Port Power On Power Off 1 0x80 0x31 0x01 0x30 0x80 0x32 0x01 0x33 2 0x80 0x31 0x02 0x33 0x80 0x32 0x02...

Page 98: ...Sensors 0x8200 0x823f Input Registers Power Source Sensors 0x8240 0x827f Input Registers Residual Current Monitor 0x8280 0x82cf Input Registers Bank Power Source Select 0x000 0x00f 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 devic...

Page 99: ...mal Line Energy Sensors 0x400 0x39ff see table Port Energy Sensors 0x3a00 0x81ff see table Bank Energy Sensors 0x8200 0x823f 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 Lin...

Page 100: ...rature 0 1 C 1 Humidity 0 1 2 Digital Input bool 3 Air Pressure 1 hPa millibar 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 th...

Page 101: ...Energy Wh 18 Reverse Reactive Energy VARh 19 Reverse Active Energy Resettable 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 returne...

Page 102: ... for second module 0x8280 1 8 3 0x828b Offset Addr Module 0 Sensor Field Unit 0 0x8280 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 Po...

Page 103: ...ternal sensors addresses Input Register Sensor field Port 1 Port 2 Temperature 0x100 0x108 Humidity 0x101 0x109 Digital input 0x102 0x10a Air Pressure 0x103 0x10b Dew Point 0x104 0x10c Dew Point Difference 0x105 0x10d 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...

Page 104: ... 0x3fa8 5 0x3a0a 0x3b2a 0x3c4a 0x3d6a 0x3e8a 0x3faa 6 0x3a0c 0x3b2c 0x3c4c 0x3d6c 0x3e8c 0x3fac 7 0x3a0e 0x3b2e 0x3c4e 0x3d6e 0x3e8e 0x3fae 8 0x3a10 0x3b30 0x3c50 0x3d70 0x3e90 0x3fb0 9 0x3a12 0x3b32 0x3c52 0x3d72 0x3e92 0x3fb2 10 0x3a14 0x3b34 0x3c54 0x3d74 0x3e94 0x3fb4 11 0x3a16 0x3b36 0x3c56 0x3d77 0x3e96 0x3fb6 12 0x3a18 0x3b38 0x3c58 0x3d78 0x3e98 0x3fb8 13 0x3a1a 0x3b3a 0x3c5a 0x3d7a 0x3e9a...

Page 105: ...to receive com mands 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 cli...

Page 106: ... 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...

Page 107: ...te 1 port 2 name Power Port state 0 port 3 name Power Port state 0 port 4 name Power Port state 0 line_in voltage 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 ...

Page 108: ... www hivemq com and create a new cluster In 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 109: ...Support ...

Page 110: ...SNMPv3 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 brok...

Page 111: ...l link status 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 D...

Page 112: ... the 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 Du...

Page 113: ...ircuit 8 E Electrical Measurement 11 E Mail 51 Ethernet connnector 7 F Factory Reset 17 FAQ 111 Firmware Upload 17 Firmware Update 20 G GBL_Conf exe 17 H HTTP 31 HTTPS 31 I Installation 7 IP ACL 31 57 IP Address 29 IPv6 58 L load Configuration 20 M Maintenance 17 messages 55 Modbus TCP 97 MQTT 40 105 N NTP 41 O Ok button 7 Operating the device directly 15 Overvoltage Protection 9 P Power Ports 26 ...

Page 114: ...114 Expert Power Control 8221 8226 2022 GUDESystems GmbH Index Status LED 15 syslog 35 T Technical Specifications 10 Timer 42 Timer Configuration 42 TLS 67 W Watchdog 27 ...

Page 115: ...115 Expert Power Control 8221 8226 2022 GUDESystems GmbH Expert Pow er Control 8221 8226 2022 GUDE Systems GmbH 3 16 2022 ...