FreeBSD Manual Pages
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: • 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/ • libmodbus home page: http://libmodbus.org • Simple data reader for similar device: https://github.com/reverieline/ep2000pro Network UPS Tools 2.8.4. 06/12/2026 MUST_EP2000PRO(8)
NAME | SYNOPSIS | SUPPORTED HARDWARE | INSTALLATION | EXTRA ARGUMENTS | INSTANT COMMANDS | KNOWN PROBLEMS | AUTHOR | SEE ALSO
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=must_ep2000pro&sektion=8&manpath=FreeBSD+Ports+15.1.quarterly>