newapc

NEWAPC(8)                   Network UPS Tools (NUT)                  NEWAPC(8)

NAME

       newapc - Driver for American Power Conversion Smart Protocol UPS equip-
       ment

NOTE

       This man page only documents  the  hardware-specific  features  of  the
       newapc  driver.   For  information  about  the core driver, see nutups-
       drv(8).

SUPPORTED HARDWARE

       newapc should recognize all recent APC models that use a serial  proto-
       col at 2400 bps.  This is primarily the Smart-UPS, Matrix-UPS and Back-
       UPS Pro lines.  Older APC models may  work  better  with  the  apcsmart
       driver.

       The  driver  attempts  to  support  every  bell  and whistle of the APC
       reporting interface, whether or not this is strictly sensible.

       Some older hardware may only report a handful of  variables.   This  is
       usually not a bug - they just don't support anything else.

CABLING

       This  driver  expects  to  see a 940-0024C cable or a clone by default.
       You can switch to the 940-0095B dual-mode cable support with the cable=
       definition described below.

       If your 940-0024C cable is broken or missing, use this diagram to build
       a clone:

       http://www.exploits.org/nut/library/940-0024C.jpg

EXTRA ARGUMENTS

       This driver supports the following optional values for -x  and  in  the
       ups.conf(5):


       cable=940-0095B
              Configure the serial port for the APC 940-0095B dual-mode cable.


       sdtype=num
              Use shutdown type num, according to this table:

              0: soft shutdown or powerdown, depending on battery status

              1: soft shutdown followed by powerdown

              2: instant power off

              3: power off with grace period

              Modes 0 and 1 will power up the load when power returns.   Modes
              2 and 3 will keep the load turned off when the power returns.

BUGS

       Some older APC UPS models return bogus data in the status register dur-
       ing a front panel test.  This is usually detected  and  discarded,  but
       some other unexpected values have occasionally slipped through.

AUTHOR

       Nigel   Metheringham  <Nigel.Metheringham@Intechnology.co.uk>  (drawing
       heavily on the apcsmart driver by Russell Kroll).

SEE ALSO

   The core driver:
       nutupsdrv(8)


   The apcsmart driver:
       apcsmart(8)


   Internet resources:
       The NUT (Network UPS Tools) home page: http://www.exploits.org/nut/

       NUT mailing list archives and information: http://lists.exploits.org/




                                Sun Feb 10 2002                      NEWAPC(8)