Man Linux: Main Page and Category List

NAME

       gentest - tests communication with UPS

SYNOPSIS

       /usr/sbin/gentest [ -d ] [ -r ] serial-device

DESCRIPTION

       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:

            ---------------
            DTR = Cleared
            RTS = Set

            CAR = Low   ( )
            CTS = Low   ( )
            DSR = Low   ( )
            RNG = Low   ( )

       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.

ENVIRONMENT VARIABLES

       Gentest does not use environment variables.

FILES

       None used.

BUGS

       None known.

SEE ALSO

       genpowerd(8), genwrite(8).

AUTHORS

       Tom Webster <webster@kaiwan.com>
            (for the program)
       Raphael Manfredi <Raphael_Manfredi@pobox.com>
            (manpage only)