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

.SH SUPPORTED HARDWARE
apcsmart should recognize all APC models that use a serial protocol at 
2400 bps.  This is primarily the Smart-UPS and Matrix-UPS lines, but some
Back-UPS Pro models are also supported.  

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
Russell Kroll

.SH SEE ALSO

.SS The core driver:
\fBnutupsdrv\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/