MEGATEC(8)

NAME
megatec - Driver for Megatec protocol based UPS equipment

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

SUPPORTED HARDWARE
The megatec driver is known to work with various UPSes from Blazer, Energy Sistem, Fenton Technologies, Mustek and many others. The NUT compatibility table lists all the known supported models. Keep in mind, however, that other models not listed there may also be supported but haven't been tested. On models with both a serial port (RS-232) and an USB port, only the serial port is supported.

EXTRA ARGUMENTS

mfr=string
    Optional. Specify the UPS manufacturer name.

model=string
    Optional. Specify the UPS model name.

serial=string
    Optional. Specify the UPS serial number.

offdelay=int
    Optional. After receiving a shutdown command, the UPS will wait this many minutes before turning off the load. Specify this if the UPS must remain online for a short period of time after the computer has powered down. The default is 0 (turn off immediately).

ondelay=int
    Optional. After turning off the load (see offdelay), the UPS will wait at least this many minutes before coming back online. If line power gets restored before this delay expires, the UPS will wait until it does. If line power gets restored after this delay expires, the UPS will power on the load immediately. The default is 2 minutes.

lowbatt=float
    Optional. Low battery level (%). Overrides the hardware default level.

battvolts=float:float
    Optional. The battery voltage interval (see KNOWN PROBLEMS).

UPS COMMANDS
This driver supports some extra commands (see upscmd(8)):

beeper.toggle
    Toggle the UPS beeper. (Not available on some hardware.)

load.on
    Turn on the load immediately.

load.off
    Turn off the load immediately.

reset.input.minmax
    Reset minimum and maximum input voltage status.

reset.watchdog
    Restarts the UPS watchdog timeout. The watchdog is started if it isn't running, which means the UPS shuts down one minute after this command is executed for the last time, restarting one minute afterwards. To cancel the watchdog, run the "shutdown.stop" command.

shutdown.return
    Turn off the load and return when power is back.

shutdown.stayoff
    Turn off the load and remain off.

shutdown.stop
    Stop a shutdown in progress.

test.battery.start.deep
    Perform a long battery test (Not available on some hardware.)

test.battery.start
    Perform a (10 second) battery test.

test.battery.stop
    Stop a running battery test. (Not available on some hardware.)

KNOWN PROBLEMS
The battery charge (%) value is only a best-effort calculation and may be incorrect, or non-existant, for some UPS models. In any case, you can always resort to finding the voltages at which the battery becomes fully discharged and fully charged, and specify them manually using the "battvolts" option. If you do this, please notify the author of this driver. Some UPS commands aren't supported by all models. In most cases, the driver will send a message to the system log when the user tries to execute an unsupported command. Unfortunately, some models don't even provide a way for the driver to check for this, so the unsupported commands will silently fail. Some models report a bogus value for the beeper status (will always be "enabled" or "disabled"). So, the "beeper.toggle" command may appear to have no effect in the status reported by the driver when, in fact, it is working fine. The temperature value is also known to be bogus in some models.

AUTHOR
Carlos Rodrigues <carlos.efr at mail.telepac.pt>

SEE ALSO
nutupsdrv(8), upsc(8), upscmd(8), upsrw(8)

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