Gentest
monitors the serial port connected to a UPS and allows DTR and/or RTS
lines to be stet to simulate the
genpowerd
UPS monitoring software.
The
gentest
program will show the state of the control lines in the serial connection.
Its primary purpose is to help discover the settings for UPS monitoring cables.
ARGUMENTS
Serial-Device
Some serial port that is not being used by some other device, and does not
share an interrupt with any other serial port.
OPTIONS
gentest
has the following command line options:
-d
Causes
gentest
to assert DTR on the serial line.
-r
Causes
gentest
to assert RTS on the serial line.
EXAMPLE
If we were to start
gentest
with the command line
genpower -r /dev/ttyS1
while /dev/ttyS1 was connected to a LAN Manager cable and a TrippLite
BC750/LAN, gentest would display:
If the line power to the UPS were shut off,
gentest
would update the screen with:
---------------
DTR = Cleared
RTS = Set
CAR = Low ( )
CTS = High (*)
DSR = Low ( )
RNG = Low ( )
indicating that the CTS line had changed status and that the new
status of the CTS line is HIGH.
Gentest
is valuable in determining the parameters to use in genpowerd.h with
unfamiliar cables and UPSs. In the example above, it could be determined
that RTS probably provides power to the cable and that CTS is the line that
shows changes in the line power's status (with LOW being the normal status
of the line).
WARNING
If your UPS supports an inverter shutdown, either RTS or DTR could be used to
kill the inverter. Tests should not be performed if your system is using the
UPS. Specifically, the use of the
-r
and
-d
options together is not recomended.