NAME

       egctl - EnerGenie EG-PMS-LAN control utility

SYNOPSIS

       egctl NAME [S1 S2 S3 S4]

DESCRIPTION

       egctl  is a program to control the state of EnerGenie Programmable surge protector with LAN interface. It
       uses native EG-PMS-LAN data exchange protocol version 2.0 or 2.1, not HTTP. When executed with  the  only
       argument  it dumps the state of the specified device. If all five arguments are specified, it changes the
       state of the device and dumps the new state.

OPTIONS

       NAME   The name of the device to control (as it is specified in the configuration file). This name has no
              relation to the IP address or the domain name.

       Sn     The action to perform on n-th socket. Possible values are: on, off, toggle and left.

CONFIGURATION

       Configuration file is a table of devices. Each device is described on a separate  line;  fields  on  each
       line are separated by tabs or spaces.  Lines starting with '#' are comments, blank lines are ignored.

       The first field
              Name of device. It is a string that will be used to address the device in the utility commands. It
              is not necessary to be the same as Server name in the web interface.

       The second field
              Protocol. Supported protocols are: pms20 and pms21.

       The third field
              IP address of device.

       The fourth field
              TCP port of device.  (Power Manager client port in the web interface).

       The fifth field
              Password.

SUPPORTED DEVICES

       Device        Protocol
       ───────────────────────
       EG-PMS-LAN    pms20
       EG-PMS2-LAN   pms21

EXAMPLES

       Suppose a user has two EG-PMS-LAN devices configured as follows:

              1. 192.168.0.10, port 5000, password hackme
              2. 192.168.10.10, port 5001, password hackmesoftly

       In  order  to  control  them  using  the  utility  the user needs to create a configuration file like the
       following:

              eg1 pms20 192.168.0.10  5000 hackme
              eg2 pms20 192.168.10.10 5001 hackmesoftly

       Now she can get the status of the devices with commands

              egctl eg1
              egctl eg2

       and switch the state of the AC power sockets with a command like

              egctl eg1 on left left off

FILES

       ~/.egtab
              user's configuration file

       /etc/egtab
              system-wide configuration file

BUGS

       This program cannot modify the internal schedule of the device.

AUTHOR

       Written by Vitaly Sinilin <vs@kp4.ru>

TRADEMARKS

       EnerGenie is a registered trademark of Gembird Holding B.V.

egctl                                            19 August 2014                                         egctl(1)