Man Linux: Main Page and Category List


       apcsmart  -  Driver  for  American  Power Conversion Smart Protocol UPS


       This man page only documents  the  hardware-specific  features  of  the
       apcsmart   driver.    For   information  about  the  core  driver,  see


       apcsmart should recognize all recent  APC  models  that  use  a  serial
       protocol  at 2400 bps.  This is primarily the Smart-UPS, Matrix-UPS and
       Back-UPS Pro lines.

       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.


       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:


       This   driver   supports   the   following  optional  settings  in  the

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

              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

              4: 'force OB' hack method for CS 350

              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.

              Mode 4 exploits an oddity in the CS 350 models since  they  only
              seem  to  support  the  S command, but then only when running on
              battery.  As a result, the driver will force the UPS  to  go  on
              battery  if necessary before sending the shutdown command.  This
              ensures that the load gets reset.


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

       APC UPS models with both USB and serial ports  require  a  power  cycle
       when  switching  from  USB  communication  to  serial, and perhaps vice


       Nigel  Metheringham  <>   (drawing
       heavily on the original apcsmart driver by Russell Kroll).  This driver
       was called newapc for a time and was renamed in the 1.5 series.


   The core driver:

   Internet resources:
       The NUT (Network UPS Tools) home page:

                                Mon Sep 29 2003