background image

73

Expert Power Control 8041/8045 

 

                                                                                                                                                                                                      © 2022 GUDE Systems GmbH

Specifications

(12).

>linesensor 1 

"0,1,2,3,12"

 show

>linesensor 1 1 show

These variants give the sensor values of the field list or of a sensor at Line-In 1.

 For devices with Overvoltage Protection, the "linesensor all" command also outputs

the state of the protection ("OVP=x"). A "1" means ok, a "0" a failure of the protection.

c) Port 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 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" returns the
switching state of all relays in 3 possible formats.

e) Switching Port Relays

#port all state set "1,2,12" 1

OK.

The command syntax "port all state set "{port_list}" {OFF=0|ON=1}" sets a list of ports
to ON=1 or OFF=0.

4.8.1

SSH

The device supports SSH-2 connections with either public key authentication or user
name and password. The "login" must be enabled for SSH. Users and passwords can be
stored locally or retrieved via a radius server. If you want to use SSH in a terminal, Activ-
ate echo should be enabled.

Public Keys

Summary of Contents for Expert Power Control 8041 Series

Page 1: ...Expert Power Control 8041 Series Expert Power Control 8045 Series Manual 2022 GUDE Systems GmbH Manual Ver 1 2 1 from Firmware Ver 1 2 ...

Page 2: ...2 Expert Power Control 8041 8045 2022 GUDESystems GmbH ...

Page 3: ...vice 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 32 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 6 MQTT 40 3 4 Clock 41 3 4...

Page 4: ... 59 4 6 SNMP 59 4 6 1 Device MIB 8041 62 4 6 2 Device MIB 8045 64 4 7 SSL 68 4 8 Console 69 4 8 1 SSH 73 4 8 2 Console Cmd 8041 75 4 8 3 Console Cmd 8045 86 4 8 4 Serial Console 99 4 9 Modbus TCP 100 4 9 1 Sensor Tables 105 4 10 MQTT 107 4 10 1 Example HiveMQ 110 5 Support 112 5 1 Data Security 113 5 2 Contact 113 5 3 Declaration of Conformity 114 5 4 FAQ 114 116 Index ...

Page 5: ...Device Description ...

Page 6: ...st not be used in condensing or excessively hot environments Please also observe the other instructions in the instructions for proper handling of the device Because of safety and approval issues it is not allowed 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 ra...

Page 7: ...ains connection Console commands via SSH Telnet and serial interface 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 m...

Page 8: ...r Over Voltage Protection red surge protection is inactive 3 Status LED 4 Current power consumption 7 segment display In the Revision 2 model variant with new display 1 2x 7 segment displays partly with unit LEDs 2 12 plain text indicators on off for the status of the outputs 3 Status LED 4 LED indicator for Over Voltage Protection green Over Voltage protection active red inactive 5 Select button ...

Page 9: ... 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 Overvoltage Protection The device contains an overvoltage protection The protection is based on input side va...

Page 10: ...curs only once during operation ex actly at the moment in which the protection fails In addition at the start up of the device a message is generated when the overvoltage protection is not active 1 6 Technical Specifications Interfaces 1 x Mains supply IEC C20 max 16 A 1 x Ethernet port RJ45 1 x Serial connector D SUB RS232 2 x RJ45 for external sensor Load Outputs 8041 1 8045 1 12 x Load Outputs ...

Page 11: ... 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 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 7 Sensor Two external sensors can be connected to the Expert Power C...

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: ...8041 8045 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 sh...

Page 17: ...itch off After the selected time they are automatically switched to the second preselected state Optionally the device can 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 Maint...

Page 18: ... test start the browser in private mode During a firmware update old data formats are sometimes converted to new struc 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 lo...

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: ...wer 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 The...

Page 27: ...set the port is reset This allows e 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 tex...

Page 28: ...tors 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 ...

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

Page 30: ...v6 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 o...

Page 31: ...er 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 r...

Page 32: ...web 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 s...

Page 33: ... for 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 mu...

Page 34: ...y after 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...

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: ...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 margin of when an event is generated after...

Page 50: ...revents that too much messages are generated when a sensor 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 hy...

Page 51: ...low 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 acti...

Page 52: ...s of 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...

Page 53: ...sables 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 X default Selects the display of sensor values for both displays Revision 1 devices have only one display ...

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: ... 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 of attached sensors State chang...

Page 57: ...2 Console Push Messages Push messages can be activated on the console channels Telnet SSH or serial con sole which output sensor values at timed intervals every n seconds or as of a configur able change in the magnitude of the sensor value on that channel The generated mes sage always starts with a and ends with a CR LF Example Switch a port port 2 ON If you open a telnet or SSH connection the pus...

Page 58: ... ACL setting and locked yourself out please activate the Bootloader Mode and use GBL_Conf exe to deactivate the IP ACL Alternatively you can reset the device to factory default 4 4 IPv6 IPv6 Addresses IPv6 addresses are 128 bit long and thus four times as long as IPv4 addresses The first 64 bit form a so called prefix the last 64 bit designate a unique interface identifier The prefix is composed o...

Page 59: ...ompted again If this attribute is not returned the default timeout entry from the configuration is used instead Filter Id If the value admin is set for this attribute then an admin rights are assigned for the login otherwise only user access Service Type This is an alternative to Filter Id A service type of 6 or 7 means ad min rights for the HTTP login otherwise only limited user access HTTP Login...

Page 60: ...ain To enforce limited access we recommend the use of DMZ or IP ACL SNMP v3 Because the device has no multiuser management only one user default name stand ard is detected in SNMP v3 From the User based Security Model USM MIB vari ables there is a support of usmStats counter The usmUser variables will be added with the enhancement of additional users in later firmware versions The system has only ...

Page 61: ...er enough entropy for key lengths of AES 192 or AES 256 From the foregoing considerations we would recommended at present HMAC SHA 96 with AES 128 as authentication and encryption method Change in Trap Design In older MIB tables a separate trap was defined for each combination of an event and a port number This results in longer lists of trap definitions for the devices For ex ample from epc8221Sw...

Page 62: ...1 1 1 2 1 1 x Integer32 RO A unique value greater than zero for each receiver slot epc8041TrapAddr 85 1 1 1 2 1 2 x OCTETS RW DNS name or IP address specifying one Trap receiver slot A port can optionally be specified name port An empty string disables this slot epc8041portNumber 85 1 3 1 1 0 Integer32 RO The number of Relay Ports epc8041PortIndex 85 1 3 1 2 1 1 x Integer32 RO A unique value great...

Page 63: ...gy counter Writing 0 resets all resettable counter epc8041AbsEnergyReactiveReset table 85 1 5 1 2 1 14 x Gauge32 RO Resettable Absolute Reactive Energy counter epc8041ResetTime 85 1 5 1 2 1 15 x Gauge32 RO Time in seconds since last Energy Counter reset epc8041Forw EnergyActive 85 1 5 1 2 1 16 x Gauge32 RO Forw ard Active Energy counter epc8041Forw EnergyReactive 85 1 5 1 2 1 17 x Gauge32 RO Forw ...

Page 64: ...TEGER RO show s the output S2 of the RCMB module epc8041RCMBModuleStatus 85 1 5 16 1 6 x Unsigned32 RO RCMB Module Status Word epc8041SensorIndex 85 1 6 1 1 1 x Integer32 RO None epc8041TempSensor 85 1 6 1 1 2 x Integer32 RO actual temperature epc8041HygroSensor 85 1 6 1 1 3 x Integer32 RO actual humidity epc8041AirPressure 85 1 6 1 1 5 x Integer32 RO actual air pressure epc8041Dew Point 85 1 6 1 ...

Page 65: ...umber of suppported Pow er Channels epc8045Pow erIndex 87 1 5 1 2 1 1 x Integer32 RO Index of Pow er Channel entries epc8045ChanStatus 87 1 5 1 2 1 2 x Integer32 RO 0 data not active 1 data valid epc8045AbsEnergyActive 87 1 5 1 2 1 3 x Gauge32 RO Absolute Active Energy counter epc8045Pow erActive 87 1 5 1 2 1 4 x Integer32 RO Active Pow er epc8045Current 87 1 5 1 2 1 5 x Gauge32 RO Actual Curent o...

Page 66: ...ex of Single Port Pow er Channel entries Indices 0 5 mean Ports A1 to A6 6 11 are Ports B1 to B6 epc8045spChanStatus 87 1 5 5 2 1 2 x Integer32 RO 0 data not active 1 data valid epc8045spAbsEnergyActive 87 1 5 5 2 1 3 x Gauge32 RO Absolute Active Energy counter epc8045spPow erActive 87 1 5 5 2 1 4 x Integer32 RO Active Pow er epc8045spCurrent 87 1 5 5 2 1 5 x Gauge32 RO Actual Curent on Pow er Cha...

Page 67: ...w received NTP time as unixtime secs since 1 January 1970 epc8045NTPLastValidTimestamp 87 1 5 15 3 0 Unsigned32 RO show seconds since last valid NTP timestamp received epc8045RCMBInfoIndex 87 1 5 16 1 1 x Integer32 RO Index of RCMB Info entries epc8045RCMBCurrentRMS 87 1 5 16 1 2 x Unsigned32 RO Actual Residual Current RMS on Pow er Channel According Type B IEC 60755 Only visible on models that su...

Page 68: ... generate 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 ligh...

Page 69: ...rmediates 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 ca...

Page 70: ...any 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 instructio...

Page 71: ...ue 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 onl...

Page 72: ...letes 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 individu...

Page 73: ...is 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 sh...

Page 74: ...PuTTYgen 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 ...

Page 75: ...net 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...

Page 76: ...w s if login delay enabled console serial pushmsgs config set OFF 0 ON 1 enables persistent push msgs console serial pushmsgs config show show s if persistent push msgs are enabled console serial pushmsgs set OFF 0 ON 1 enables temporary push msgs console serial pushmsgs show show s if temporary push msgs are enabled console serial user set username sets login user name console serial user show sh...

Page 77: ...or 6 extsensor port_num sen_type sen_field minval show show s minimum value for sensor 6 extsensor port_num sen_type sen_field hyst set num sets hysterese value for sensor 6 extsensor port_num sen_type sen_field hyst show show s hysterese value for sensor 6 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 ...

Page 78: ... passw d hash admin set passw d sets hashed http admin passw ord ip4 enters cmd group ip4 ip4 hostname set name sets device hostname ip4 hostname show show s device hostname 3 ip4 address set ip_address sets IPv4 address ip4 address show show s IPv4 address 3 ip4 netmask set ip_address sets IPv4 netmask ip4 netmask show show s IPv4 netmask 3 ip4 gatew ay set ip_address sets IPv4 gatew ay address i...

Page 79: ...hat 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 show s beeper tone linesensor line_num energy_sensor maxval set float sets maximum value for line meter linesensor line_num energy_sensor maxval show show s maximum value for line meter linesensor line_num energy_...

Page 80: ... 0 ABOVEMIN 1 ABOVEMAX 2 BELOWMAX 3 port show LEGACY show s Port for Pow er Port Sw itching actions L linesensor line_num BELOWMIN 0 ABOVEMIN 1 ABOVEMAX 2 BELOWMAX 3 state set OFF 0 ON 1 DISABLED 2 LEGACY sets Port state for Pow er Port Sw itching actions L linesensor line_num BELOWMIN 0 ABOVEMIN 1 ABOVEMAX 2 BELOWMAX 3 state show LEGACY show s Port state for Pow er Port Sw itching actions L lines...

Page 81: ...rt port_num resettime set num sets port reset duration port port_num resettime show show s port reset duration port port_num w atchdog enabled set OFF 0 ON 1 sets port w atchdog to on off port port_num w atchdog enabled show show s port w atchdog state port port_num w atchdog mode set OFF 0 PORT_RESET 1 IP_MS 2 IP_MS_INV 3 sets port w atchdog mode port port_num w atchdog mode show show s port w at...

Page 82: ... DC 1 events set OFF 0 ON 1 enables sensor events on off rcmb mod_num RMS 0 DC 1 events show show s if sensor events are enabled rcmb mod_num RMS 0 DC 1 events type set EVT_SYSLOG 0 EVT_SNMP 1 EVT_EMAIL 2 E VT_BEEPER 5 EVT_DISPLAY 6 EVT_CONSOLE 7 EVT_MQTT 8 enables different event types rcmb mod_num RMS 0 DC 1 events type show show s w hat event types are enabled rcmb mod_num RMS 0 DC 1 events bee...

Page 83: ...sets SNMP v2 private community snmp snmpv3 enabled show show s SNMP v2 private community snmp snmpv3 username set text sets SNMP v3 username snmp snmpv3 username show show s 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 AES...

Page 84: ... all relays from panel buttons enabled system sensor VSYS 0 VAUX 1 VMAIN 2 TCPU 3 show show s internal sensors if model supports it timer enters cmd group timer timer enabled set OFF 0 ON 1 enables timer functions timer enabled show show s if timer a enabled timer syslog facility set 0 23 sets facility level for timer syslog timer syslog facility show show s facility level for timer syslog timer s...

Page 85: ...t may show several lines 5 Please see the Energy Sensor Table for the right energy index 6 Please see the External Type and External Sensor Field Tables for the correct sensor index Energy Sensor Table energy_sensor Index Description Unit 0 Forward Active Energy Wh 1 Power Active W 2 Voltage V 3 Current A 4 Frequency 0 01 hz 5 Power Factor 0 001 6 Power Angle 0 1 degree 7 Power Apparent VA 8 Power...

Page 86: ...minutes sets timezone clock timezone show show s timezone clock dst enabled set OFF 0 ON 1 enables dst clock dst enabled show show s if dst is enabled clock manual set hh mm ss yyyy mm dd sets time and date manually clock show show s 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 show s ntp server name console ent...

Page 87: ... serial enabled show show s if serial console enabled console serial raw set OFF 0 ON 1 sets raw mode disables editing on off console serial raw show show s if raw mode enabled console serial echo set OFF 0 ON 1 enables echo on off console serial echo show show s if echo enabled console serial kvm set OFF 0 ON 1 enables binary KVM cmds on serial port on off console serial kvm show show s if binary...

Page 88: ...sor port_num sen_type sen_field events set off 0 on 1 enables sensor events on off 6 extsensor port_num sen_type sen_field events show show s if sensor events are enabled 6 extsensor port_num sen_type sen_field 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 enables different event types 6 extsensor port_num sen_typ...

Page 89: ...server show show s accepted connection types http port set ip_port sets http port http port show show s http port http portssl set ip_port sets https port http portssl show show s https port http tls mode set TLS12 0 TLS13_12 1 TLS13 2 TLS13_12_11 3 restricts TLS mode http tls mode show show s TLS mode restriction http ajax enabled set OFF 0 ON 1 enables ajax autorefresh on off http ajax enabled s...

Page 90: ...linesensor enters cmd group linesensor linesensor all field_list show show s energy sensors according field list of all line sensors 5 linesensor line_num field_list show show s energy sensors according field list of one line sensor 5 linesensor line_num energy_sensor value show show s energy sensor of given line 5 linesensor line_num ovp show show state of Overvoltage Protection linesensor line_n...

Page 91: ...bled L linesensor line_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 L linesensor line_num events type show LEGACY show s w hat event types are enabled L linesensor line_num maxval set float LEGACY sets maximum value for line meter L linesensor line_num maxval show LEGACY s...

Page 92: ...rt_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 show s all port states in 3 different view modes 4 port all set OFF 0 ON 1 OFF_REV 2 ON_REV 3 sw itch all ports on off forw ard 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 re...

Page 93: ...s energy metering counter portsensor port_num energy_sensor events set OFF 0 ON 1 enables sensor events on off portsensor port_num energy_sensor events show show s if sensor events are enabled portsensor port_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 E VT_DISPLAY 6 EVT_CONSOLE 7 EVT_MQTT 8 enables different event types portsensor p...

Page 94: ...GACY sets minimum value for sensor L portsensor port_num minval show LEGACY show s minimum value for sensor L portsensor port_num hyst set num LEGACY sets hysterese value for sensor L portsensor port_num hyst show LEGACY show s hysterese value for sensor L portsensor port_num BELOWMIN 0 ABOVEMIN 1 ABOVEMAX 2 BELOWMAX 3 port set port_num set LEGACY sets pow er port for sensor values action L portse...

Page 95: ...num RMS 0 DC 1 maxval show show s 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 show s 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 show s hysterese value for sensor rcmb mod_num RMS 0 DC 1 publish mode set NONE 0 INTERVAL 1 DELT...

Page 96: ...y passw ord snmp snmpv3 authpassw d hash set passw d sets SNMP v3 authentication hashed passw ord snmp snmpv3 privpassw d hash set passw d sets SNMP v3 privacy hashed passw ord 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_...

Page 97: ...show show s if rule is enabled timer rule_num name set name sets name of rule timer rule_num name show show s name of rule timer rule_num FROM 0 UNTIL 1 set yyyy mm dd sets date range of rule timer rule_num FROM 0 UNTIL 1 show show s 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...

Page 98: ...A 8 Power Reactive VAR 9 Forward Active Energy Resettable Wh 10 Forward Reactive Energy VARh 11 Forward Reactive Energy Resettable VARh 12 Reset Time sec since last Energy Counter Reset s 13 Reverse Active Energy Wh 14 Reverse Reactive Energy VARh 15 Reverse Active Energy Resettable Wh 16 Reverse Reactive Energy Resettable VARh 17 Absolute Active Energy Wh 18 Absolute Reactive Energy VARh 19 Absol...

Page 99: ...st not be activated In the device configuration on the other hand Activ ate echo should be set to yes and Raw mode to no Start your terminal program and select the COM port to which the RS232 cable is connected Use the following set tings for the serial port Baudrate 115200 Databits 8 Parity No Stoppbits 1 Flow Control No KVM Protocol For compatibility reasons the KVM protocol can also be activate...

Page 100: ... active 0x801 0x801 Discrete Inputs Status Power Sources 0x1000 0x100f Discrete Inputs OVP active Line Ins 0x1010 0x101f Discrete Inputs eFuse Errors 0x1100 0x11ff Discrete Inputs Info Area 0x000 0x005 Input Registers CPU Sensor values 0x080 0x083 Input Registers External Sensors 0x100 0x1ff Input Registers Fan Level 0x200 0x20f Input Registers Line Energy Sensors 0x400 0x39ff Input Registers Port...

Page 101: ... active Status Power Sources 0x1000 0x100f Power Source active OVP active Line Ins 0x1010 0x101f OVP active eFuse Error 0x1100 0x11ff eFuse Error Status Power Sources Offset EPC 8221 8226 0 Bank A 1 Bank B ENC 2111 2191 0 Pwr1 1 Pwr2 ESB 7213 7214 0 Pwr1 1 Pwr2 only 7214 Input Registers Device Resource Start End Function Info Bereich 0x000 0x005 see table CPU Sensor values 0x080 0x083 see table Ex...

Page 102: ...set Sensor Field Unit 0 Vsystem 0 01 V 1 Vaux 0 01 V 2 Vmain 0 01 V 3 CPU Temperature 0 1 C External Sensors The measured value of the external sensors are coded as fixed point arithmetic For a factor of e g 0 1 in the unit the value must be divided by 10 in order to reach the real measured value A value of 0x8000 means that no sensor is plugged into the corres ponding port or the corresponding fi...

Page 103: ... 0x120 2 0x60 1 2 0x4C2 Voltage for 2nd line sensor and single phase device 0x400 1 0x120 2 2 0x524 Power Angle for 4th port sensor and single phase device 0x3a00 3 0x120 6 2 0x3d6c Offset Sensor Field Unit 0 Absolute Active Energy Wh 1 Power Active W 2 Voltage V 3 Current mA 4 Frequency 0 01 hz 5 Power Factor 0 001 6 Power Angle 0 1 degree 7 Power Apparent VA 8 Power Reactive VAR 9 Absolute Activ...

Page 104: ...Current at first PowerSrc 0x8240 0 2 1 0x8241 Offset Sensor Field Unit 0 Voltage 0 01 V 1 Current mA Residual Current Monitor Type B RCMB Devices with a Residual Current Monitor Type B RCMB module separately measure the RMS and DC fault current components of the input supply The values are returned as signed 16 bit integers The following formulas are used for the address the module num ber starts ...

Page 105: ... Objects 1 Byte 0x03 Object ID 1 Byte 0x00 Object Length 1 Byte n1 Object Value n1 Bytes Company Id Object ID 1 Byte 0x00 Object Length 1 Byte n2 Object Value n2 Bytes Product Id Object ID 1 Byte 0x00 Object Length 1 Byte n3 Object Value n3 Bytes Product Version 4 9 1 Sensor Tables Important All calculations in this chapter are based on addresses starting at 0 With some Modbus TCP utilities the ad...

Page 106: ... 0x424 19 Reverse Active Energy Resettable 0x426 20 Reverse Reactive Energy Resettable 0x428 21 Residual Current Type A 0x42a 22 Neutral Current 0x42c The measured values of the energy sensors are returned as signed 32 bit integers On the even address are first the high order 16 bit then follow on the odd address the low order 16 bit Outlet Ports Energy Addresses Input Register The offsets corresp...

Page 107: ...0x40d2 0x41f2 0x4312 0x4432 0x4552 0x4672 10 0x40d4 0x41f4 0x4314 0x4434 0x4554 0x4674 11 0x40d6 0x41f6 0x4316 0x4436 0x4556 0x4675 12 0x40d8 0x41f8 0x4318 0x4438 0x4558 0x4678 13 0x40da 0x41fa 0x431a 0x443a 0x455a 0x467a 14 0x40dc 0x41fc 0x431c 0x443c 0x455c 0x467c 15 0x40de 0x41fe 0x431e 0x443e 0x455e 0x467e 16 0x40e0 0x4200 0x4320 0x4440 0x4560 0x4680 17 0x40e2 0x4202 0x4322 0x4442 0x4562 0x468...

Page 108: ...he device another possible placeholder is host which contains the host name An example topic for a switching message of the second port would then be de gudesystems epc 00 19 32 01 16 41 switch 2 Executing console commands The device can be controlled remotely via MQTT using console commands A list of all commands can be found in the Console chapter Depending on the topic the com mands are accepte...

Page 109: ...e 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 de pends 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 type telemetry portstates port 1 name Power Port state 1 port...

Page 110: ...ield 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 In the Manage Clusters section go to Access Management and add an MQTT user with name and password ...

Page 111: ...rol 8041 8045 2022 GUDESystems GmbH Specifications 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 112: ...Support ...

Page 113: ...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 114: ...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 115: ... 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 116: ...ical Measurement 11 E Mail 52 Ethernet connnector 8 F Factory Reset 17 FAQ 114 Feature Matrix 6 Firmware Upload 17 Firmware Update 20 G GBL_Conf exe 17 H HTTP 32 HTTPS 32 I Installation 8 IP ACL 31 58 IP Address 29 IPv6 58 L load Configuration 20 M Maintenance 17 messages 55 Modbus TCP 100 MQTT 40 107 N NTP 41 O Ok button 8 Operating the device directly 15 Overvoltage Protection 9 P Power Ports 26...

Page 117: ...117 Expert Power Control 8041 8045 2022 GUDESystems GmbH Index Status LED 15 syslog 35 T Technical Specifications 10 Timer 42 Timer Configuration 42 TLS 68 W Watchdog 27 ...

Page 118: ...118 Expert Power Control 8041 8045 2022 GUDESystems GmbH Expert Pow er Control 8041 8045 2022 GUDE Systems GmbH 3 16 2022 ...

Reviews: