APCSMART(8) Network UPS Tools (NUT) APCSMART(8)NAME
apcsmart - Driver for American Power Conversion Smart Protocol UPS equipment
NOTE
This man page only documents the hardware-specific features of the apcsmart driver. For information about the core driver, see nutups-
drv(8).
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.
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
EXTRA ARGUMENTS
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
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
Russell Kroll
SEE ALSO
The core driver:
nutupsdrv(8)
Internet resources:
The NUT (Network UPS Tools) home page: http://www.exploits.org/nut/
NUT mailing list archives and information: http://lists.exploits.org/
Tue Oct 22 2002 APCSMART(8)
Check Out this Related Man Page
OPTIUPS(8) NUT Manual OPTIUPS(8)NAME
optiups - Driver for Opti-UPS (Viewsonic) UPS and Zinto D (ONLINE-USV) equipment
NOTE
This man page only documents the hardware-specific features of the optiups driver. For information about the core driver, see nutupsdrv(8).
SUPPORTED HARDWARE
optiups was originally written against a PowerES 280es in nut-0.45. It was revised for nut-2.0.1 and tested against a PowerES 420E. It is
expected to work with at least the PowerES, PowerPS, and PowerVS models.
This driver additionally supports a Zinto D from ONLINE USV-Systeme AG because of their very similar commands, but it is unknown if it also
works with other UPS from them.
This driver will not work with the PowerES stock serial cable. You will need to construct your own three conductor cable:
UPS 6 -> PC 3
UPS 9 -> PC 2
UPS 4 -> PC 5
The cable for Online-USV uses pin UPS 7 (not UPS 4) -> PC 5.
EXTRA ARGUMENTS
This driver supports the following optional settings in the ups.conf(5) file:
status_only
Only poll for critical status information. Without this, optiups (and all NUT drivers) poll all sorts of information from the UPS
fairly often. It is probably not often enough to hurt anything, so this option probably is not very useful, unless you have a flaky
serial connection or a highly loaded machine.
nowarn_noimp
Does not print warnings when the UPS reports that a variable is not implemented or not pollable. Without the option you will get a
message sent to your system logs each time NUT polls the UPS. If you specify nowarn_noimp, this message will only be logged once.
fake_lowbatt
This forces the low battery flag true. Without it, if you want to test your UPS, you will have to unplug it and wait until the battery
drops to a low/critical voltage level before NUT will respond and power down your system. With the flag, NUT should power down the
system soon after you pull the plug. When you are done testing, you should remove this flag.
For basic shutdown configuration testing, the command upsmon -c fsd is preferred.
powerup
Zinto D from ONLINE-USV cannot be identified when switched to standby. Set this flag to allow the driver to power-up your Zinto UPS.
This will also power-up your equipment connected to the UPS!
BUGS
On the 420E, ups.serial and ups.temperature are unsupported features. This is not a bug in NUT or the NUT driver, just the way things are
with this UPS.
AUTHOR
Russell Kroll, Scott Heavner, Matthias Goebl
SEE ALSO
The core driver:
nutupsdrv(8)
Internet resources:
The NUT (Network UPS Tools) home page: http://www.networkupstools.org/
Network UPS Tools 05/21/2012 OPTIUPS(8)