egctl - EnerGenie EG-PMS-LAN control utility
[S1 S2 S3 S4
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.
- 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.
- The action to perform on n-th socket. Possible
values are: on, off, toggle and left.
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
- 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
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
and switch the state of the AC power sockets with a command like
- egctl eg1 on left left off
- user's configuration file
- system-wide configuration file
This program cannot modify the internal schedule of the device.
Written by Vitaly Sinilin <firstname.lastname@example.org>
EnerGenie is a registered trademark of Gembird Holding B.V.