must_ep2000pro - Man Page

must_ep2000pro -h

must_ep2000pro -a DEVICE_NAME [OPTIONS]

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​.

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​.

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​.

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

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​.

Mikhail Mironov <mike@darkmike​.ru>