MUST_EP2000PRO(8)

NAME
must_ep2000pro - Driver for MUST EP2000Pro UPS with RS-232 serial Modbus connection.

SYNOPSIS

must_ep2000pro -h

must_ep2000pro -a DEVICE_NAME [OPTIONS]

    Note

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

SUPPORTED HARDWARE

This driver supports MUST EP2000Pro compatible, line-interactive UPS with the following characteristics:

    1. 12V or 24V external battery

    2. Connection: RS-232 or USB (via RS232-to-USB converter dongle)

Some models that may be covered by this driver:

    • Original EP200Pro

    • Energy Smart.2

    • Luxeon UPS-500ZR

    • Bineos EP20-1000 PRO

    • any other work with original program from MUST

Currently, it has only been tested on the following model:

    • Energy Smart.2 600W

Generally, these device do not serve any identification data, so autodetection is not possible. Only one documented piece of info is "software version" with unknown meaning.

The must_ep2000pro driver uses the libmodbus project, for Modbus implementation.

INSTALLATION

This driver should be built by default if libmodbus and development headers are available. You can force the configure script to build it with the following arguments:

    :; ./configure --with-serial=yes --with-modbus=yes

You also need to give proper (R/W) permissions on the local serial device file to allow the NUT driver run-time user to access it. This may need additional setup for start-up scripting, udev or upower rules, to apply the rights on every boot — especially if your device nodes are tracked by a virtual filesystem.

For example, a USB-to-serial converter can be identified as /dev/ttyACM0 or /dev/ttyUSB0 on Linux, or /dev/ttyU0 on FreeBSD (note the capital "U"). A built-in serial port can be identified as /dev/ttyS0 on Linux or one of /dev/cua* names on FreeBSD.

EXTRA ARGUMENTS

This driver also supports the following optional settings:

lowbatt=num
    Set the value of battery.charge.low to num. Device itself has only switch-off on low battery voltage.

INSTANT COMMANDS

This driver supports some instant commands (see upscmd(8)):

beeper.enable
    Enable the UPS beeper

beeper.disable
    Disable the UPS beeper

shutdown.return
    Turn off the load and wait for the power to return

KNOWN PROBLEMS

If you run the shutdown.return command with mains present it does nothing.

If you run the shutdown.return command without mains present it immediately powers off the device.

There is no setting in device documentation to specify a shutdown delay.

On development side: to write even a single register, you must use the "write multiple registers" command.

AUTHOR

Mikhail Mironov <mike@darkmike.ru>

SEE ALSO

  The core driver:

nutupsdrv(8)

  Internet resources:

    • The NUT (Network UPS Tools) home page: https://www.networkupstools.org/historic/v2.8.5/

    • libmodbus home page: http://libmodbus.org

    • Simple data reader for similar device: https://github.com/reverieline/ep2000pro