background image

64

Expert Power Control 8021/8025 

 

                                                                                                                                                                          © 2021 GUDE Systems GmbH

Specifications

Numerical parameters can be entered with different bases. Here is an example of the
decimal value 11:

  Base

  Input

  decimal (10)

  11

  hexadecimal (16)

  0xb

  octal (8)

  013

  binary (2)

  0b1011

Bit Field Parameter

Some parameters can take several values at the same time. In the following example,
all values between 0 and 5 can be set. In the help, this can be recognized by the fact
that the values are not separated by the "|" character, but by commas.

"{EVT_SYSLOG=0,EVT_SNMP=1,EVT_EMAIL=2,EVT_SMS=3,EVT_GSMEMAIL=4,EVT_BEEPER=5}"

To set EVT_SYSLOG and EVT_EMAIL in a command, you can use the following syn-
tax:

>extsensor 1 2 0 events type set "EVT_SYSLOG,EVT_EMAIL"
OK.

or numeric

>extsensor 1 2 0 events type set "0,2"
OK.

Additionally you can set all values with "ALLSET" or encode any bit pattern as hexa-
decimal with a syntax like "#7f1a". 

Return Values

If a command is unknown or a parameter is incorrect, the output "ERR." is given at the
beginning of the line, followed by a description of the fault. Successful 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
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 with numerical re-
turns. The command "

vt100 numeric set ON

" enables that only numerical values

appear.

Comments

If you use a tool to send an entire file of commands via Telnet, it is helpful, if you can
place comments in there. Beginning with the comment character "#", the remaining

Summary of Contents for Expert Power Control 8021 Series

Page 1: ...Expert Power Control 8021 Series Expert Power Control 8025 Series 2021 GUDE Systems GmbH Manual Ver 1 1 0 from Firmware Ver 1 1 Manual...

Page 2: ...2 Expert Power Control 8021 8025 2021 GUDE Systems GmbH...

Page 3: ...directly 15 2 2 Control Panel 15 2 3 Maintenance 17 2 3 1 Maintenance Page 19 2 3 2 Configuration Management 20 2 3 3 Bootloader Activation 21 3 Configuration 24 3 1 Power Ports 25 3 1 1 Watchdog 26...

Page 4: ...4 5 SNMP 54 4 5 1 Device MIB 8021 56 4 5 2 Device MIB 8025 58 4 6 SSL 61 4 7 Console 63 4 7 1 SSH 66 4 7 2 Push Messages 67 4 7 3 Console Cmd 8021 68 4 7 4 Console Cmd 8025 76 4 7 5 Serial Console 85...

Page 5: ...Device Description...

Page 6: ...t 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...

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

Page 8: ...wer consumption 7 segment display In the Revision 2 model variant with new display 1 2x 7 segment displays partly with unit LEDs 2 4 plain text indicators on off for the status of the outputs 3 Status...

Page 9: ...vervoltage Protection The device contains an overvoltage protection The protection is based on input side varistors with thermal fuse between phase L and neutral N to protect the internal electronics...

Page 10: ...D SUB RS232 2 x RJ45 for external sensor Load Outputs 8021 1 8025 1 4 x Load Outputs IEC C13 max 10 A Load Outputs 8021 2 8025 2 4 x Load Outputs IEC C13 Lock max 10 A Network connectivity 10 100 MBit...

Page 11: ...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 temporary 9 999 999 999 kWh 0 001 1 5 1 7 Sensor Two exter...

Page 12: ...imum 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...

Page 13: ...ated 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 M...

Page 14: ...Operating...

Page 15: ...LED for the first output starts blinking i e the output is selected Press Select again to select the next output If you keep the Ok but ton pressed for one second the state of the selected output wil...

Page 16: ...8021 8025 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...

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

Page 18: ...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 ACL on and off...

Page 19: ...tloader mode see chapter Bootloader activation All TCP IP settings are reset in this operation If a unit is set to factory defaults an uploaded certificate or updated firmware will be preserved 2 3 1...

Page 20: ...f the Telnet console If the configuration of a device is to be restored from a text file load the file with Upload and restart the device with Restart Device Saving the configuration should only be ca...

Page 21: ...principle also be transferred in a Telnet session but then the settings are changed during operation and not completely when restarting as it would have been the case with an upload It can happen that...

Page 22: ...ge 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 butt...

Page 23: ...23 Expert Power Control 8021 8025 2021 GUDE Systems GmbH Operating The status LED will blink in a fast rhythm please wait until the LED blinks slowly about 5 seconds...

Page 24: ...Configuration...

Page 25: ...sed 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...

Page 26: ...AS 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...

Page 27: ...longer a reply after a set time the watchdog performs 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 ta...

Page 28: ...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 not the las...

Page 29: ...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 four additional IPv6...

Page 30: ...on Selects whether access is possible only with HTTP HTTPS or both Server port HTTP Here can be set the port number of the internal HTTP Possible val ues are from 1 to 65534 default 80 If you do not u...

Page 31: ...stored locally In this case an admin password and a user password must be assigned The password can have a maximum of 31 characters The name admin and user are provided for the user name in the passwo...

Page 32: ...s port Raw mode The VT100 editing and the IAC protocol are disabled Active negotiation The IAC negotiation is initiated by the server Activate echo The Telnet echo setting if not changed by IAC Push m...

Page 33: ...y Delete public key Setting this at Apply deletes the public key Enable serial console Enables the serial console Raw mode The VT100 editing is disabled Activate echo The echo setting Enable binary KV...

Page 34: ...n 3 3 2 Syslog Enable Syslog Enables the usage of Syslog Messages Syslog Server If you have enabled Syslog Messages enter the IP address of the server to which the syslog information should be transmi...

Page 35: ...aceholder since for security reasons the device never stores the password itself but only the key formed using the Authorization Algorithm If you want to change a pass word the complete password must...

Page 36: ...compatibility reasons only use ASCII char acters Timeout How long in seconds will be waited for a response from an Authentication Request Retries How often an authentication request is repeated after...

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

Page 38: ...the second NTP server Used when the first NTP server does not respond Timezone The set time zone for the local time Daylight Saving Time If enabled the local time is converted to Central European Sum...

Page 39: ...the dialog for advanced timer settings 3 4 3 Timer Configuration There are three possibilities in the timer configuration Create a simple timer add an advanced timer or change an existing configurati...

Page 40: ...9 30 a m and switched off after 1 5 hours A click on Save saves this rule For example using only one timer rule to turn on a port at 9 00 and turn it off at 20 00 If at 9 00 the timer is triggered a b...

Page 41: ...o changes by one This also applies to the index in the console commands A simple timer is directly enabled on a new complex timer the enable trigger option must be switched on manually You can set a p...

Page 42: ...s only active between October and December also the action does not take place on the first day of a month Since all fields in the mask are always taken into account it is not possible to define the t...

Page 43: ...a random trigger probability of 90 In addition to port 1 port 5 is activated here and deactivated again after 90 minutes A popup at the mouse pointer shows the port number of the corresponding field...

Page 44: ...r time you cannot do it directly with a simple timer Therefore it can be useful to first cre ate the timer as a simple timer and then adjust it in the extended dialog Switches port 3 on every day at 9...

Page 45: ...in order to confuse potential burglars you do not always want to raise and lower the blinds at the same times A jitter of 1800 seconds means that the action is performed randomly between 30 minutes b...

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

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

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

Page 49: ...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 Security SMTP Connection Security Transmission via SSL or no encrypti...

Page 50: ...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 de...

Page 51: ...Specifications...

Page 52: ...tting 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 2 IPv6 IPv6 Addresses IPv6 a...

Page 53: ...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 limi...

Page 54: ...MP software The device supports SNMP protocols v1 v2c and v3 If traps are enabled in the configura tion the device messages are sent as notifications traps SNMP Informs are not sup ported SNMP Request...

Page 55: ...also used in the 3DES configuration draft reeder snmpv3 usm 3desede 00 If one is not an SNMP expert it is recom mended to try in each case the settings with and without 3DESKey Passwords The password...

Page 56: ...NET SNMP NET SNMP provides a very widespread collection of SNMP command line tools snm pget snmpset snmpwalk etc NET SNMP is among others available for Linux and Windows After installing NET SNMP you...

Page 57: ...7 1 5 1 1 0 Unsigned32 RO Number of suppported Power Channels epc8021PowerIndex 77 1 5 1 2 1 1 x Integer32 RO Index of Power Channel entries epc8021ChanStatus 77 1 5 1 2 1 2 x Integer32 RO 0 data not...

Page 58: ...ltage on CPU Board epc8021CPUSensorVmain 77 1 5 14 3 0 Gauge32 RO Main Voltage on CPU Board epc8021CPUSensorTcpu 77 1 5 14 4 0 Integer32 RO Temperature on CPU Board epc8021NTPTimeValid 77 1 5 15 1 0 I...

Page 59: ...el entries epc8025ChanStatus 79 1 5 1 2 1 2 x Integer32 RO 0 data not active 1 data valid epc8025AbsEnergyActive 79 1 5 1 2 1 3 x Gauge32 RO Absolute Active Energy counter epc8025PowerActive 79 1 5 1...

Page 60: ...5 5 2 1 4 x Integer32 RO Active Power epc8025spCurrent 79 1 5 5 2 1 5 x Gauge32 RO Actual Curent on Power Channel epc8025spVoltage 79 1 5 5 2 1 6 x Gauge32 RO Actual Voltage on Power Channel epc8025s...

Page 61: ...emp DewPoint epc8025ExtSensorName 79 1 6 1 1 32 x OCTETS RW A textual string containing name of a external Sensor 4 6 SSL TLS Standard The device is compatible with TLS v1 1 to TLS v1 3 standards but...

Page 62: ...recognized by the fact that the generated key file starts with BEGIN RSA PRIVATE KEY If the file starts with BEGIN PRIVATE KEY the file is in PKCS 8 format and the key is not re cognized If you have o...

Page 63: ...e several command levels The following commands are usable from each level back go back one level help all commands of the actual level help all show all commands logout logout only when login require...

Page 64: ...ect the output ERR is given at the beginning of the line followed by a description of the fault Successful instructions without special return value will be acknowledged by OK All other return values...

Page 65: ...is activated but not 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...

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

Page 67: ...or value threshold on this channel The generated mes sage always starts with a and ends with a CR LF This also applies to sensor limit value messages if Console is selected as message channel in Senso...

Page 68: ...RADIUS login enabled console telnet login delay set OFF 0 ON 1 enables delay after 3 login fails on off console telnet login delay show shows if login delay enabled console telnet pushmsgs config set...

Page 69: ...email authentication email user set username sets SMTP username email user show shows SMTP username email passwd set passwd sets SMTP password email passwd hash set passwd sets crypted SMTP password...

Page 70: ...s http port http port show shows http port http portssl set ip_port sets https port http portssl show shows https port http tls mode set TLS12 0 TLS13_12 1 TLS13 2 TLS13_12_11 3 restricts TLS mode htt...

Page 71: ...1 enables events on off linesensor line_num energy_sensor events show shows if events are enabled linesensor line_num energy_sensor events type set EVT_SYSLOG 0 EVT_SNMP 1 EVT_EMAIL 2 EVT_SMS 3 EVT_G...

Page 72: ...rt port_num state set OFF 0 ON 1 sets port to new state port port_num state show shows port state port all state set port_list OFF 0 ON 1 sets several ports in one cmd e g port all state set 1 3 5 1 p...

Page 73: ...d group snmp snmp port set ip_port sets SNMP UDP port snmp port show shows SNMP UDP port snmp snmpget enabled set OFF 0 ON 1 enables SNMP GET cmds on off snmp snmpget enabled show show if SNMP GET cmd...

Page 74: ...mer rule_num enabled set OFF 0 ON 1 enables rule timer rule_num enabled show shows if rule is enabled timer rule_num name set name sets name of rule timer rule_num name show shows name of rule timer r...

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

Page 76: ...console telnet login show shows if login enabled console telnet login local set OFF 0 ON 1 enables local login on off console telnet login local show shows if local login enabled console telnet login...

Page 77: ...ow shows email recipient address email server set dns_name sets email SMTP server address email server show shows email SMTP server address email port set ip_port sets email SMTP port email port show...

Page 78: ...riod show shows sensor Min Max measurement period extsensor beeper set OFF 0 ON 1 enables beeper sensor alarms extsensor beeper show shows if beeper sensor alarms are enabled http enters cmd group htt...

Page 79: ...st of one line sensor 5 linesensor line_num energy_sensor value showshows energy sensor of given line 5 linesensor line_num ovp show show state of Overvoltage Protection linesensor line_num counter re...

Page 80: ...IN 0 ABOVEMIN 1 ABOVEMAX 2 BELOWMAX 3 state show LEGACY shows Port state for Power Port Switching actions L linesensor beeper set OFF 0 ON 1 enables beeper for line meter alarms linesensor beeper show...

Page 81: ...MP 1 EVT_EMAIL 2 EVT_SMS 3 EVT_GSMEMAIL 4 EVT_BEEPER 5 EVT_DISPLAY 6 EVT_CONSOLE 7 enables different event types portsensor port_num energy_sensor events type show shows what event types are enabled p...

Page 82: ...1 auth timeout set num_secs sets server request timeout radius PRIMARY 0 SECONDARY 1 auth timeout show shows server request timeout radius PRIMARY 0 SECONDARY 1 retries set num sets server number of r...

Page 83: ...ttons when not enabled system panel enabled show shows if panel buttons are enabled system panel port all set OFF 0 ON 1 enable siwtch all relays from panel buttons system panel port all show shows if...

Page 84: ...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 85: ...ctions the serial terminal must support VT100 emu lation and echo must not be activated In the device configuration on the other hand Activate echo should be set to yes and Raw mode to no Start your t...

Page 86: ...l Sensors 0x100 0x1ff Input Registers Fan Level 0x200 0x20f Input Registers Line Energy Sensors 0x400 0x39ff Input Registers Port Energy Sensors 0x3a00 0x81ff Input Registers Bank Energy Sensors 0x820...

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

Page 88: ...the address is the port numbers start at zero 0x100 Port 8 Offset In the Expert Sensor Box 7213 7214 the internal sensor corresponds to the value Port 0 and is coded Port 1 for Sensor 2 and Port 2 fo...

Page 89: ...e Energy Resettable Wh 16 Forward Reactive Energy Resettable VARh 17 Reverse Active Energy Wh 18 Reverse Reactive Energy VARh 19 Reverse Active Energy Resettable Wh 20 Reverse Reactive Energy Resettab...

Page 90: ...Type 1 Byte 0x0e Read Dev ID code 1 Byte 0x01 Object Id 1 Byte 0x00 Response Code 1 Byte 0x2b MEI Type 1 Byte 0x0e Read Dev ID code 1 Byte 0x01 Conformity Level 1 Byte 0x01 More Follows 1 Byte 0x00 Ne...

Page 91: ...the max min values of attached sensors State change of digital sensor input ports Exceeding of max min values of the measured power consumption Condition change of overvoltage protection Syslog messag...

Page 92: ...Support...

Page 93: ...ryption in SNMPv3 Disable SNMP v2 access Enable STARTTLS or SSL in the e mail configuration Archive configuration files securely In the IP ACL enter only the devices that require access to HTTP or SNM...

Page 94: ...ader mode and search for it with GBL_Conf exe Then check the TCP IP parameters and change them if neces sary If the device is not found by GBL_Conf exe in bootloader mode you can reset the settings to...

Page 95: ...rol 8021 8025 2021 GUDE Systems GmbH Support 6 Disable switching events You can set the sending of syslog emails etc when switching ports only concerns Gude devices with relays under System in the sen...

Page 96: ...l Measurement 10 E Mail 49 Ethernet connnector 7 F Factory Reset 17 FAQ 94 Feature Matrix 6 Firmware Upload 17 Firmware Update 19 G GBL_Conf exe 17 H HTTP 30 HTTPS 30 I Installation 7 IP ACL 29 52 IP...

Page 97: ...97 Expert Power Control 8021 8025 2021 GUDE Systems GmbH Index Status LED 15 syslog 34 T Technical Specifications 10 Timer 39 Timer Configuration 39 TLS 61 W Watchdog 26...

Page 98: ...98 Expert Power Control 8021 8025 2021 GUDE Systems GmbH Expert Power Control 8021 8025 2021 GUDE Systems GmbH 3 3 2021...

Reviews: