apcupsd-ups man page

apcupsd-ups ā€” Driver for apcupsd client access

Note

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

Description

This driver is a client to apcupsd.

apcupsd-ups acts as an apcupsd client, simply forwarding data. This can be useful in cases where both protocols are required in a network, or in case apcupsd has a required UPS access mode missing from NUT.

Extra Arguments

This driver supports the following optional settings in nut.conf(5):

port=<hostname>[:<port>]

This is the name of a remote host running apcupsd (plus an optional port).

For instance:

[apcupsd]
            driver = apcupsd-ups
            port = localhost
            desc = "apcupsd client"

Background

This driver was originally written in one evening to allow interworking with apcupsd.

Supported Variables

The following variables are translated from apcupsd to NUT. All times should be converted to seconds (please file a bug if you notice a mismatch in units).

apcupsd variable NUT variable(s)
BCHARGE battery.charge
MBATTCHG battery.charge.low
RETPCT battery.charge.restart
BATTDATE battery.date
TIMELEFT battery.runtime
MINTIMEL battery.runtime.low
BATTV battery.voltage
NOMBATTV battery.voltage.nominal
LINEFREQ input.frequency
SENSE input.sensitivity
HITRANS input.transfer.high
LOTRANS input.transfer.low
LASTXFER input.transfer.reason
LINEV input.voltage
MAXLINEV input.voltage.maximum
MINLINEV input.voltage.minimum
NOMINV input.voltage.nominal
LINEFREQ output.frequency
OUTPUTV output.voltage
NOMOUTV output.voltage.nominal
DATE ups.date, ups.time
DSHUTD ups.delay.shutdown
DWAKE ups.delay.start
FIRMWARE ups.firmware, ups.firmware.aux
UPSNAME ups.id
LOADPCT ups.load
MANDATE ups.mfr.date
NOMPOWER ups.realpower.nominal
SERIALNO ups.serial
STATUS ups.status
ITEMP ups.temperature
STESTI ups.test.interval
SELFTEST ups.test.result

Limitations

Access to apcupsd is strictly read only: no commands can be issued. This stems from the design of apcupsd, where the settings are changed in apctest. In order to run apctest, apcupsd must be stopped (and apcupsd exposes the UPS to the network).

Author

Andreas Steinmetz

See Also

ups.conf(5), nutupsdrv(8)

Internet Resources

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

The apcupsd home page: http://www.apcupsd.org/

Info

12/29/2015 Network UPS Tools 2.7.3. NUT Manual