.TH NEWAPC 8 "Tue Oct 22 2002" "" "Network UPS Tools (NUT)" 
.SH NAME  
newapc \- Driver for American Power Conversion Smart Protocol UPS equipment
.SH NOTE
This man page only documents the hardware-specific features of the
newapc driver.  For information about the core driver, see  
\fBnutupsdrv\fR(8).

.SH SUPPORTED HARDWARE
newapc 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.  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.

.SH 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/cables/940-0024C.jpg

.SH EXTRA ARGUMENTS
This driver supports the following optional settings in the
\fBups.conf\fR(5):

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

.IP "sdtype=\fInum\fR"
Use shutdown type \fInum\fR, 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.

.SH BUGS
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.

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

.SH SEE ALSO

.SS The core driver:
\fBnutupsdrv\fR(8)

.SS The apcsmart driver:
\fBapcsmart\fR(8)

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

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