background image

72

Expert Power Control 8316 

 

                                                                                                                                                                                                                    © 2022 GUDE Systems GmbH

Specifications

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 KVM cmds enabled

console serial utf8 set {OFF=0|ON=1}

enables UTF8 support

console serial utf8 show

show s if UTF8 enabled

console serial login set {OFF=0|ON=1}

enables login on/off

console serial login show

show 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 show

show 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

show s login user name

console serial passw d set "{passw d}"

sets login passw ord

console serial passw d hash set "{passw d}"

sets login hashed passw ord

email

enters cmd group "email"

email enabled set {OFF=0|ON=1}

enables email on/off

email enabled show

show s if email is enabled

email sender set "{email_addr}"

sets email sender address

email sender show

show s email sender address

email recipient set "{email_addr}"

sets email recipient address

email recipient show

show s email recipient address

email server set "{dns_name}"

sets email SMTP server 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 "{username}"

sets SMTP username

email user show

show s SMTP username

email passw d set "{passw d}"

sets SMTP passw ord

email passw d hash set "{passw d}"

sets crypted SMTP passw ord

email testmail

send test email

ethernet

enters cmd group "ethernet"

ethernet mac show

show s MAC address

ethernet link show

show s ethernet link state

ethernet phyprefer set {10MBIT_HD=0|
10MBIT_FD=1|100MBIT_HD=2|100MBIT_FD=3}

sets preferred speed for PHY Auto Negotiation

ethernet phyprefer show

show s preferred speed for PHY Auto Negotiation

extsensor

enters cmd group "extsensor"

extsensor all show

show s all values from connected external
sensors

extsensor all show

show s all plugged sensors and fields

extsensor {port_num} {sen_field} value show

show s sensor value

6

extsensor {port_num} {sen_type} label set
"{name}"

sets sensor name to label

6

extsensor {port_num} {sen_type} label show

show s label of sensor

6

extsensor {port_num} type show

show s type of sensor

extsensor {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

enables different event types

6

Summary of Contents for Expert Power Control 8314

Page 1: ...Manual 2022 GUDE Systems GmbH Manual Ver 1 5 1 from Firmware Ver 1 5 Expert Power Control 8314 Expert Power Control 8316 ...

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

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

Page 4: ... 56 4 6 1 Device MIB 8314 59 4 6 2 Device MIB 8316 61 4 7 SSL 63 4 8 Console 65 4 8 1 SSH 69 4 8 2 Console Cmd 8314 70 4 8 3 Console Cmd 8316 81 4 8 4 Serial Console 92 4 9 Modbus TCP 93 4 9 1 Sensor Tables 99 4 10 MQTT 100 4 10 1 Example HiveMQ 103 5 Support 105 5 1 Data Security 106 5 2 Contact 106 5 3 Declaration of Conformity 107 5 4 FAQ 107 109 Index ...

Page 5: ...Device Description ...

Page 6: ...wed to modify the device without our permission The device is NOT a toy It has to be used or stored out or 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 ask...

Page 7: ...epending 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 traps MQTT 3 1 1 Support Modbus TCP support Radius support Generation of messages e mai...

Page 8: ...consumers with the load outputs 1 5 Technical Specifications Interfaces EPC 8314 1 8316 1 EPC 8314 2 8316 2 1 x Ethernet port RJ45 1 x Serial connector D SUB RS232 1 x Mains cable IEC C20 max 16A 2 x RJ45 for external sensor 8 x Load outputs CEE 7 3 type F max 16A 8 x Load outputs IEC C13 max 10A Network connectivity 10 100 MBit s 10baseT Ethernet Power Supply internal power supply 90 265V AC 15 1...

Page 9: ...ltage 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 6 Sensor Two external sensors can be connected to the Expert Power Cont...

Page 10: ...ensing 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 condens...

Page 11: ...ems 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 12: ...Operating ...

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

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

Page 15: ...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 Maintenance Page Maintenance in the web interfa...

Page 16: ...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 longer accessible the device can be put in...

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

Page 18: ...nfiguration 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 upda...

Page 19: ...ncrypted 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 large ...

Page 20: ...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 email ...

Page 21: ...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 applicati...

Page 22: ...d 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 23: ...Configuration ...

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

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

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

Page 27: ... 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 until it is aborted During this time the IP address is not accessibl...

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

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

Page 30: ...ns 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 admin p...

Page 31: ...word 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 bootloade...

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

Page 33: ...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 Username a...

Page 34: ...he 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 35: ...elf 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 512 ...

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

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

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

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

Page 40: ...el Sets the verbosity level for timer syslog output New Rule simple Timer Shows a dialog for a simple timer rule New Rule advanced Timer Brings up the dialog for 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 time...

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

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

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

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

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

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

Page 47: ... channel from a sensor Enable Messages Enables the generation of sensor messages Maximum Minimum value Adjustable limits for current levels high and low which sends alerts 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 channels Enables the generation of messages on different channels W...

Page 48: ...t 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 measured sensor values switching actions can be triggered During operation the actions configured for crossing the limits are ex ecuted For example when a value ...

Page 49: ...trix 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 P1 On P1 On P1 On P2 Off from below max P1 Off P2 Off from above min P1 Off P2 Off from below min P1 Off P2 On P2 On P2 On Only the switching operations for which actions have been defined are triggered If no On or Off action is defined for a port the port can n...

Page 50: ... 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 Mail server Repeat password Enter the password again to confirm it If the password mask is redisplayed only four bullets are shown as a symbolic placeholder since for security...

Page 51: ...Specifications ...

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

Page 53: ...ssages Syslog messages 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...

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

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

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

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

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

Page 59: ...state a Relay Port epc8314PortSw itchCount 97 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 epc8314PortStartupMode 97 1 3 1 2 1 5 x INTEGER RW set Mode of startup sequence off on remember last state epc8314PortStartupDelay 97 1 3 1 2 1 6 ...

Page 60: ...tive Energy counter epc8314RevEnergyReactive 97 1 5 1 2 1 21 x Unsigned32 RO Reverse Reactive Energy counter epc8314RevEnergyActiveResetta ble 97 1 5 1 2 1 22 x Unsigned32 RO Resettable Reverse Active Energy counter epc8314RevEnergyReactiveResett able 97 1 5 1 2 1 23 x Unsigned32 RO Resettable Reverse Reactive Energy counter epc8314LineSensorName 97 1 5 1 2 1 100 x OCTETS RW A textual string conta...

Page 61: ...tSw itchCount 64 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 epc8316PortStartupMode 64 1 3 1 2 1 5 x INTEGER RW set Mode of startup sequence off on remember last state epc8316PortStartupDelay 64 1 3 1 2 1 6 x Integer32 RW Delay in sec f...

Page 62: ...ive Energy counter epc8316RevEnergyReactiveResett able 64 1 5 1 2 1 23 x Unsigned32 RO Resettable Reverse Reactive Energy counter epc8316LineSensorName 64 1 5 1 2 1 100 x OCTETS RW A textual string containing name of a Line Sensor epc8316spActivePow erChan 64 1 5 5 1 0 Unsigned32 RO Number of Single Port Pow er Channels epc8316spPow erIndex 64 1 5 5 2 1 1 x Integer32 RO Index of Single Port Pow er...

Page 63: ...activeRes ettable 64 1 5 5 2 1 23 x Unsigned32 RO Resettable Reverse Reactive Energy counter epc8316NTPTimeValid 64 1 5 15 1 0 INTEGER RO Show if valid Time is received epc8316NTPUnixTime 64 1 5 15 2 0 Unsigned32 RO show received NTP time as unixtime secs since 1 January 1970 epc8316NTPLastValidTimestamp 64 1 5 15 3 0 Unsigned32 RO show seconds since last valid NTP timestamp received epc8316Sensor...

Page 64: ... an SSL certificate For Windows for example there is the light version of Shining Light Productions There you open a command prompt change to the directory C OpenSSL Win32 bin and set these environment variables set openssl_conf C OpenSSL Win32 bin openssl cfg set RANDFILE C OpenSSL Win32 bin rnd Here are some examples for the generation with OpenSSL Creation of a self signed RSA 2048 bit certific...

Page 65: ...dded CPU is highly demanded After that the parameters are in the SSL session cache so all other requests are just as fast as with other certificate lengths For a quick response even on the first access we recom mend RSA 2048 bit certificates that offer adequate security too 4 8 Console For the configuration and control of the device there is a set of commands with paramet ers that can be entered t...

Page 66: ...ay be passed as numeric or constant If e g you get the following line as help http server set http_both 0 https_only 1 http_only 2 the following instruction pairs are equivalent http server set https_only http server set 1 or http server set https_both http server set 0 Numerical parameters can be entered with different bases Here is an example of the decimal value 11 Base Input decimal 10 11 hexa...

Page 67: ...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 con tents of a line is ignored Telnet If the configuration Raw Mode is turned off it is tried to n...

Page 68: ...ual measured values are separated by commas after the label name The digit before the equal sign corresponds to the Index field in the External Sensor Table extsensor 1 0 value show Displays temperature of the sensor at Port 1 b Line Sensors linesensor all 0 1 2 3 12 show L 1 L Power Port 0 13000Wh 1 0W 2 225V 3 0A 12 998218s L 2 L Power Port 0 13000Wh 1 0W 2 223V 3 0A 12 996199s This command outp...

Page 69: ...ist 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 o...

Page 70: ... 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 field Upload SSH public key 4 8 2 Console Cmd 8314 Command Description Note ...

Page 71: ...lnet login local show show s if local login enabled console telnet login radius set OFF 0 ON 1 enables login for RADIUS on off console telnet login radius show show s if RADIUS login enabled console telnet login delay set OFF 0 ON 1 enables delay after 3 login fails on off console telnet login delay show show s if login delay enabled console telnet pushmsgs config set OFF 0 ON 1 enables persistent...

Page 72: ...ail sender show show s email sender address email recipient set email_addr sets email recipient address email recipient show show s email recipient address email server set dns_name sets email SMTP server 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 ...

Page 73: ...sh 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 extsensor port_num sen_type sen_field BELOWMIN 0 ABOVEMIN 1 ABOVE...

Page 74: ...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 0 ON 1 enables manual IPv6 addresses ip6 manual enabled show show s if manual IPv6 addresses are enabled 3 ip6 manual address 1 4 set ip_address sets manua...

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

Page 76: ... broker_idx client show show s client name mqtt broker_idx qos set QOS0 0 QOS1 1 sets QoS level mqtt broker_idx qos show show s QoS level mqtt broker_idx keepalive set num_secs sets keep alive time mqtt broker_idx keepalive show show s keep alive time mqtt broker_idx topic set name sets topic prefix mqtt broker_idx topic show shw os topic prefix mqtt broker_idx console enabled set OFF 0 ON 1 permi...

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

Page 78: ... 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_num show show address and port of SNMP trap receiver trap_num ...

Page 79: ...OM 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 set 0 100 sets probability for rule timer rule_num trigger random show show s rule probability timer rule_num trigger HOUR 0 MIN 1 SEC 2 DAY 3 MON 4 DOW 5 set time_date_list sets time date list timer rule_num...

Page 80: ... 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 Absolute Active Energy Resettable Wh 20 Absolute Reactive Energy Resettable VARh 21 Residual...

Page 81: ...ho 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 local...

Page 82: ...stent 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 show s login user name console serial passw d set passw d sets login passw ord console s...

Page 83: ...sterese 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 sen_field publish mode show show s publish mode extsensor port_num sen_type sen_field publish mqtt retain set OFF 0 ON 1 sets mqtt retain extsensor port_num sen_type sen_field publish mqtt retain show show s if mqtt retain set exts...

Page 84: ...atew ay set ip_address sets IPv4 gatew ay address ip4 gatew ay show show s IPv4 gatew ay address 3 ip4 dns set ip_address sets IPv4 DNS server address ip4 dns show show s IPv4 DNS server address 3 ip4 dhcp enabled set OFF 0 ON 1 enables IPv4 DHCP on off ip4 dhcp enabled show show s IPv4 DHCP state 3 ip6 enters cmd group ip6 ip6 enabled set OFF 0 ON 1 enables IPv6 on off ip6 enabled show show s if ...

Page 85: ...ter linesensor line_num energy_sensor hyst show show s hysterese value for line meter linesensor line_num energy_sensor publish mode set NONE 0 INTERVAL 1 DELTA 2 INTERV_DELTA 3 sets publish mode linesensor line_num energy_sensor publish mode show 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...

Page 86: ...mqtt broker_idx enabled 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...

Page 87: ...rt 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 atchdog TCP port port port_num w atchdog pinginterval set num sets port w atchdog ping interval port port_num w atchdog pinginterval show show...

Page 88: ...sensor port_num energy_sensor BELOWMIN 0 ABOVEMIN 1 ABOVEMAX 2 BELOWMAX 3 port show show s port for sensor values action portsensor port_num energy_sensor BELOWMIN 0 ABOVEMIN 1 ABOVEMAX 2 BELOWMAX 3 state show show s state for sensor values action portsensor port_num events set OFF 0 ON 1 LEGACY enables sensor events on off L portsensor port_num events show LEGACY show s if sensor events are enabl...

Page 89: ...ds on off snmp snmpget enabled show show if SNMP GET cmds are enabled snmp snmpset enabled set OFF 0 ON 1 enables SNMP SET cmds on off snmp snmpset enabled show show if SNMP SET cmds are enabled snmp snmpv2 enabled set OFF 0 ON 1 enables SNMP v2 on off snmp snmpv2 enabled show show if SNMP v2 is enabled snmp snmpv2 public set text enables SNMP v3 on off snmp snmpv2 public show show if SNMP v3 isen...

Page 90: ...ents set OFF 0 ON 1 enable global events system SWITCH_PORT 0 events show show s if global events enabled system SWITCH_PORT 0 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 system SWITCH_PORT 0 events type show show s w hat event types are enabled system SWITCH_PORT 0 events mqtt reta...

Page 91: ...d string timer rule_num action hash set data sets action binary form timer rule_num action hash show show s action binary form timer rule_num delete delete one timer timer delete all delete all timer vt100 enters cmd group vt100 vt100 echo set OFF 0 ON 1 sets console echo state vt100 echo show show s console echo state vt100 numeric set OFF 0 ON 1 sets numeric mode vt100 numeric show show s numeri...

Page 92: ...ure Humidity 7005 7105 7205 2 Temperature Humidity Air Pressure 7006 7106 7206 External Sensor Field Table sen_field Index Description Unit 0 Temperature C 1 Humidity 2 Digital Input bool 3 Air Pressure hPa 4 Dew Point C 5 Dew Point Temperature Difference C 4 8 4 Serial Console If the device has a serial port the entire Telnet command set is also available at the serial console Connect your PC to ...

Page 93: ... to the addresses in this chapter Please try both possibilities for tests If Modbus TCP is activated in the configuration the ports relays outputs eFuses can be switched and the following data is callable Address range overview Device Resource Start End Modbus Data Type Power Output eFuse Ports 0x000 0x3ff Coils DC Inputs 0x400 0x7ff Discrete Inputs Stop Condition active 0x800 0x800 Discrete Input...

Page 94: ... Write Multiple Coils 0x0f Read Input Registers 0x04 Read Holding Registers 0x03 Write Holding Register 0x06 Write Multiple Holding Registers 0x10 Read Device Identification 0x2B 0x0E Coils Device Resource Start End Device Function Power Output eFuse 0x000 0x3ff Coil represens Port State Discrete Inputs Device Resource Start End Function when set DC Inputs 0x400 0x7ff Input logically 1 Stop Condit...

Page 95: ...Sensor Type Description Address Width Information 0x080 to 0x083 16 bit signed CPU Sensor values 0x100 to 0x1ff 16 bit signed external Sensors 0x400 to 0x39ff 32 bit signed Line Energy Sensors 0x3a00 to 0x81ff 32 bit signed Port Energy Sensors 0x8200 to 0x823f 16 bit signed Bank Energy Sensors 0x8240 to 0x827f 16 bit signed Power Source Energy Sensors 0x8280 to 0x82cf 16 bit signed Residual Curren...

Page 96: ...y sensors are returned as signed 32 bit integers The high order 16 bits are starting on the even address followed by the low order 16 bits on the odd ad dress To calculate the address there are the following formulas the values for line port and phase start at zero Line 0x0400 Line 0x120 Phase 0x60 Offset 2 Port 0x3a00 Port 0x120 Phase 0x60 Offset 2 For devices with only one phase the phase is set...

Page 97: ... independent of the phase the same value is returned for all phases DC Energy Sensors With the EPC 8291 8290 devices the voltage and current of the individual banks and voltage sources can be read out The measured values of the energy sensors are re turned as signed 16 bit integers The following formulas are available for the address the values for Bank and PowerSrc start at zero Bank 0x8200 Bank ...

Page 98: ... End Function Bank Power Source 0x000 0x00f Sets Power Source for Bank Fan Mode 0x010 0x01f 0 Automatic 1 Maximum Device Identification Returns manufacturer name and device identification Request Code 1 Byte 0x2b MEI 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 Follo...

Page 99: ...ster Offset Sensor Field Line 1 0 Absolute Active Energy 0x400 1 Power Active 0x402 2 Voltage 0x404 3 Current 0x406 4 Frequency 0x408 5 Power Factor 0x40a 6 Power Angle 0x40c 7 Power Apparent 0x40e 8 Power Reactive 0x410 9 Absolute Active Energy Resettable 0x412 10 Absolute Reactive Energy 0x414 11 Absolute Reactive Energy Resettable 0x416 12 Reset Time sec since Reset 0x418 13 Forward Active Ener...

Page 100: ...0x40de 0x41fe 16 0x3a20 0x3b40 0x3c60 0x3d80 0x3ea0 0x3fc0 0x40e0 0x4200 17 0x3a22 0x3b42 0x3c62 0x3d82 0x3ea2 0x3fc2 0x40e2 0x4202 18 0x3a24 0x3b44 0x3c64 0x3d84 0x3ea4 0x3fc4 0x40e4 0x4204 19 0x3a26 0x3b46 0x3c66 0x3d86 0x3ea6 0x3fc6 0x40e6 0x4206 20 0x3a28 0x3b48 0x3c68 0x3d88 0x3ea8 0x3fc8 0x40e8 0x4208 21 0x3a2a 0x3b4a 0x3c6a 0x3d8a 0x3eaa 0x3fca 0x40ea 0x420a 22 0x3a2c 0x3b4c 0x3c6c 0x3d8c 0...

Page 101: ...g console commands A list of all commands can be found in the Console chapter Depending on the topic the com mands are accepted in different formats As default the execution of commands is not allowed but must be enabled in the MQTT configuration Permit CLI commands Format 1 Command in JSON Syntax Publish Topic de gudesystems epc 00 19 32 01 16 41 cmd Publish Message type cli cmd port 2 state set ...

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

Page 103: ...mple 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 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 104: ...104 Expert Power Control 8316 2022 GUDESystems GmbH Specifications ...

Page 105: ...Support ...

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

Page 107: ...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 DHC...

Page 108: ...he 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 Duri...

Page 109: ... 59 61 E Electrical Measurement 9 E Mail 49 Ethernet connnector 7 F Factory Reset 15 FAQ 107 Firmware Upload 15 Firmware Update 18 G GBL_Conf exe 15 H HTTP 29 HTTPS 29 I Installation 7 IP ACL 28 54 IP Address 27 IPv6 55 L load Configuration 18 M Maintenance 15 messages 52 Modbus TCP 93 MQTT 38 100 N NTP 39 O Ok button 7 Operating the device directly 13 P Power Ports 24 R Radius 55 Restart 18 RS232...

Page 110: ...110 Expert Power Control 8316 2022 GUDESystems GmbH Index syslog 33 T Technical Specifications 8 Timer 40 Timer Configuration 40 TLS 63 W Watchdog 25 ...

Page 111: ...111 Expert Power Control 8316 2022 GUDESystems GmbH Expert Pow er Control 8316 2022 GUDE Systems GmbH 3 16 2022 ...

Reviews: