egctl - EnerGenie EG-PMS-LAN control utility
Contents
Bugs
This program cannot modify the internal schedule of the device.
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.
Thefirstfield
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 Servername in the web interface.
Thesecondfield
Protocol. Supported protocols are: pms20 and pms21.Thethirdfield
IP address of device.
Thefourthfield
TCP port of device. (PowerManagerclientport in the web interface).
Thefifthfield
Password.
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.
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
egctleg1egctleg2
and switch the state of the AC power sockets with a command like
egctleg1onleftleftoffFiles
~/.egtab
user's configuration file
/etc/egtab
system-wide configuration file
Name
egctl - EnerGenie EG-PMS-LAN control utility
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.
Supported Devices
DeviceProtocol
───────────────────────
EG-PMS-LAN pms20
EG-PMS2-LAN pms21
Synopsis
egctlNAME [S1S2S3S4]
Trademarks
EnerGenie is a registered trademark of Gembird Holding B.V.
egctl 19 August 2014 egctl(1)
