APCSMART(8) Network UPS Tools (NUT) APCSMART(8)
apcsmart - Driver for American Power Conversion Smart Protocol UPS
This man page only documents the hardware-specific features of the apc-
smart driver. For information about the core driver, see nutupsdrv(8).
apcsmart should recognize all recent APC models that use a serial pro-
tocol at 2400 bps. This is primarily the Smart-UPS, Matrix-UPS and
Back-UPS Pro lines.
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.
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
This driver supports the following optional settings in the
Configure the serial port for the APC 940-0095B dual-mode cable.
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
4: ’force OB’ hack method for CS 350
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.
Mode 4 exploits an oddity in the CS 350 models since they only
seem to support the S command, but then only when running on
battery. As a result, the driver will force the UPS to go on
battery if necessary before sending the shutdown command. This
ensures that the load gets reset.
Some older APC UPS models return bogus data in the status register dur-
ing a front panel test. This is usually detected and discarded, but
some other unexpected values have occasionally slipped through.
Nigel Metheringham <Nigel.Metheringham@Intechnology.co.uk> (drawing
heavily on the original apcsmart driver by Russell Kroll). This driver
was called newapc for a time and was renamed in the 1.5 series.
The core driver:
The apcsmart driver:
The NUT (Network UPS Tools) home page: http://www.networkupstools.org/
Mon Sep 29 2003 APCSMART(8)
Man(1) output converted with