newapc(8) - Waikato Linux Users Group

NEWAPC

NAME NOTE SUPPORTED HARDWARE CABLING EXTRA ARGUMENTS BUGS AUTHOR SEE ALSO

NAME

newapc - Driver for American Power Conversion Smart Protocol UPS equipment

NOTE

This man page only documents the hardware-specific features of the newapc driver. For information about the core driver, see nutupsdrv(8).

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.

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

EXTRA ARGUMENTS

This driver supports the following optional values for -x and in the ups.conf(5):

cable=940-0095B

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

sdtype=num

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

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.

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.

AUTHOR

Nigel Metheringham