apcsmart(8)

1APCSMART(8)                 Network UPS Tools (NUT)                APCSMART(8)
2
3
4

NAME

6       apcsmart  -  Driver  for  American  Power Conversion Smart Protocol UPS
7       equipment
8

NOTE

10       This man page only documents the hardware‐specific features of the apc‐
11       smart driver.  For information about the core driver, see nutupsdrv(8).
12
13

SUPPORTED HARDWARE

15       apcsmart  should recognize all recent APC models that use a serial pro‐
16       tocol at 2400 bps.  This is primarily  the  Smart‐UPS,  Matrix‐UPS  and
17       Back‐UPS Pro lines.
18
19       The  driver  attempts  to  support  every  bell  and whistle of the APC
20       reporting interface, whether or not this is strictly sensible.
21
22       Some older hardware may only report a handful of  variables.   This  is
23       usually not a bug ‐ they just don't support anything else.
24
25

CABLING

27       This  driver  expects  to  see a 940‐0024C cable or a clone by default.
28       You can switch to the 940‐0095B dual‐mode cable support with the cable=
29       definition described below.
30
31       If your 940‐0024C cable is broken or missing, use this diagram to build
32       a clone:
33
34       http://random.networkupstools.org/cables/940‐0024C.jpg
35
36

EXTRA ARGUMENTS

38       This  driver  supports  the  following   optional   settings   in   the
39       ups.conf(5):
40
41
42       cable=940‐0095B
43              Configure the serial port for the APC 940‐0095B dual‐mode cable.
44
45
46       sdtype=num
47              Use shutdown type num, according to this table:
48
49              0: soft shutdown or powerdown, depending on battery status
50
51              1: soft shutdown followed by powerdown
52
53              2: instant power off
54
55              3: power off with grace period
56
57              4: 'force OB' hack method for CS 350
58
59              Modes  0 and 1 will power up the load when power returns.  Modes
60              2 and 3 will keep the load turned off when the power returns.
61
62              Mode 4 exploits an oddity in the CS 350 models since  they  only
63              seem  to  support  the  S command, but then only when running on
64              battery.  As a result, the driver will force the UPS  to  go  on
65              battery  if necessary before sending the shutdown command.  This
66              ensures that the load gets reset.
67
68

BUGS

70       Some older APC UPS models return bogus data in the status register dur‐
71       ing  a  front  panel test.  This is usually detected and discarded, but
72       some other unexpected values have occasionally slipped through.
73
74       APC UPS models with both USB and serial ports  require  a  power  cycle
75       when  switching  from  USB  communication  to  serial, and perhaps vice
76       versa.
77
78

AUTHOR

80       Nigel  Metheringham  <Nigel.Metheringham@Intechnology.co.uk>   (drawing
81       heavily on the original apcsmart driver by Russell Kroll).  This driver
82       was called newapc for a time and was renamed in the 1.5 series.
83
84