apcsmart-old(8)

1APCSMART-OLD(8)                   NUT Manual                   APCSMART-OLD(8)
2
3
4

NAME

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

SYNOPSIS

10       apcsmart-old -h
11
12       apcsmart-old -a UPS_NAME [OPTIONS]
13
14           Note
15           This man page only documents the hardware-specific features of the
16           apcsmart-old driver. For information about the core driver, see
17           nutupsdrv(8).
18

SUPPORTED HARDWARE

20       apcsmart-old should recognize all recent APC models that use a serial
21       protocol at 2400 bps. This is primarily the Smart-UPS, Matrix-UPS and
22       Back-UPS Pro lines.
23
24       The driver attempts to support every bell and whistle of the APC
25       reporting interface, whether or not this is strictly sensible.
26
27       Some older hardware may only report a handful of variables. This is
28       usually not a bug—they just don’t support anything else.
29

CABLING

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

EXTRA ARGUMENTS

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

BUGS

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

AUTHORS AND HISTORY

84       Nigel Metheringham <Nigel.Metheringham@Intechnology.co.uk> (drawing
85       heavily on the original apcsmart driver by Russell Kroll).
86
87       This driver was called newapc for a time and was renamed in the 1.5
88       series.
89
90       In 2.6.2 the driver was renamed to apcsmart-old, being superseded by
91       updated version with new features.
92