GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages
APCSMART-OLD(8) NUT Manual APCSMART-OLD(8)

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

apcsmart-old -h

apcsmart-old -a UPS_NAME [OPTIONS]


Note

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

apcsmart-old 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.

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 a clone:

http://www.networkupstools.org/cables/940-0024C.jpg

This driver supports the following optional settings 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

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 during a front panel test. This is usually detected and discarded, but some other unexpected values have occasionally slipped through.

APC UPS models with both USB and serial ports require a power cycle when switching from USB communication to serial, and perhaps vice versa.

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. In 2.6.2 the driver was renamed to apcsmart-old, being superseded by updated version with new features.

nutupsdrv(8)

The NUT (Network UPS Tools) home page: http://www.networkupstools.org/
12/29/2015 Network UPS Tools 2.7.3.

Search for    or go to Top of page |  Section 8 |  Main Index

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with ManDoc.