POWERPANEL(8)                     NUT Manual                     POWERPANEL(8)



NAME
       powerpanel - Driver for PowerPanel Plus compatible UPS equipment

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

SUPPORTED HARDWARE
       This driver supports CyberPower BC1200, PR2200 and many other similar
       devices, both for the text and binary protocols. The driver will
       autodetect which protocol is used.

EXTRA ARGUMENTS
       This driver supports the following optional settings in ups.conf(5):

       protocol=[text,binary]
           Override the default autodetection of the protocol.

       manufacturer=value
           If you don't like the autodetected value, you can override this by
           setting it here.

       model=value
           Like manufacturer above.

       serial=value
           Like manufacturer above.

       ondelay=value
           Time to wait before switching on the UPS (1 - 9999 minutes,
           0=indefinite). Only available with the text protocol driver (see
           Support Status).

       offdelay=value
           Time to wait before shutting down the UPS (6 - 600 seconds). Values
           below 60 seconds will be truncated to 6 seconds intervals, values
           above 60 seconds to 60 seconds intervals. Only available with the
           text protocol driver (see Support Status).

VARIABLES
       Depending on the type of your UPS unit, some of the following variables
       may be changed with upsrw(8). If the driver can't read a variable from
       the UPS, it will not be made available.

       input.transfer.high
           writable: high transfer voltage point in V

       input.transfer.low
           writable: low transfer voltage point in V

       battery.charge.low
           writable: remaining battery charge percentage for low battery
           warning

       output.voltage.nominal
           writable: nominal output voltage in V

       ups.start.battery
           writable: allow cold start from battery

COMMANDS
       Depending on the type of your UPS unit, some of the following commands
       may be available.

       o   test.battery.start.quick, test.battery.stop

       o   beeper.enable, beeper.disable, beeper.toggle

       o   shutdown.return, shutdown.reboot, shutdown.stayoff

       On many devices, these commands are unreliable, so before using them
       you must verify that these work as expected (see Shutdown Issues).

       o   shutdown.stop

SUPPORT STATUS
       Vendor support is absent for this driver, so if you need some features
       that are currently not available, provide ample documentation on what
       the driver should sent to the UPS in order to make this work. If more
       information would be available on the binary protocol, it would
       probably be possible to make ondelay and offdelay configurable. So far,
       nobody has taken the time to investigate what we should tell the UPS to
       make this work, and CyberPower isn't willing to share this with us.

SHUTDOWN ISSUES
       If the shutdown.return command on your UPS doesn't seem to work,
       chances are that your UPS is an older model. Try a couple of different
       settings for offdelay. If no value in the range 6..600 works, your UPS
       likely doesn't support this. In order to get the expected behaviour, it
       requires shutdown.stayoff (when on battery) and shutdown.reboot (when
       on mains). The driver will automatically fallback to these commands if
       shutdown.return fails, and tries to detect which one should be used
       when called with the -k option (or through upsdrvctl shutdown).

       This isn't bullet-proof, however, and you should be prepared that the
       power will either not be shutdown or that it doesn't return when the
       power comes back. All models supported by the binary protocol and many
       supported through the text protocol are affected by this.

KNOWN PROBLEMS
       The CyberPower OP series don't offer direct voltage, charge, frequency
       and temperature readings. Instead, they will return a binary value that
       needs conversion to the actual value.

       The exact conversion needed is unknown at the time of this writing,
       hence an estimation was made based om readings from actual devices.
       This may (probably will) be off, possibly a lot. Unless you can tell us
       the exact mapping between values from the UPS and actual readings,
       don't bother to complain. We've done the best we can based on the
       limited information available. Remember, a UPS isn't a measuring
       instrument.

AUTHORS
       Arjen de Korte <arjen@de-korte.org>, Doug Reynolds <mav@wastegate.net>

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                     POWERPANEL(8)
