MUST_EP2000PRO(8)                 NUT Manual                 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:

       o   Original EP200Pro

       o   Energy Smart.2

       o   Luxeon UPS-500ZR

       o   Bineos EP20-1000 PRO

       o   any other work with original program from MUST

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

       o   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:
       o   The NUT (Network UPS Tools) home page:
           https://www.networkupstools.org/historic/v2.8.5/

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

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

Network UPS Tools 2.8.5           04/07/2026                 MUST_EP2000PRO(8)