Network UPS Tools
Power Devices support
Table of Contents

Click here to see reports of other supported models from Eaton.

Note

When a user reports that a variable/command is not right then it will be highlighted by a red underline.

Bad values/ranges/etc… will get a red dashed outline or red solid left border.

The accompanying explaining comment - if provided - will be emphasized through a red dotted border on the left.

2.8.4.787-787+gf8ecd520a

Report #1 with driver usbhid-ups (detailed comments available)

This device is known to work with driver usbhid-ups.

You can grab a dummy-ups compliant .dev file to simulate this device clicking here.

Some more detailed comments are available after the "Known supported…" sections.

Known supported variables

This device is known to support the following variables (values are just examples):

battery.capacity

7.00

battery.charge

100

battery.charge.low

20

battery.charge.restart

0

battery.charger.type

Constant Charge (CC)

battery.protection

yes

battery.runtime

3353

battery.runtime.low

180

battery.type

PbAc

battery.voltage

83.0

battery.voltage.nominal

72

device.mfr

EATON

device.model

9E2000i

device.serial

GE16F43216

device.type

ups

device.usb.version

01.29

driver.debug

0

driver.flag.allow_killpower

0

driver.name

usbhid-ups

driver.parameter.interrupt_pipe_no_events_tolerance

-1

driver.parameter.pollfreq

30

driver.parameter.pollinterval

2

driver.parameter.port

auto

driver.parameter.synchronous

auto

driver.state

quiet

driver.version

2.8.4.787-787+gf8ecd520a

driver.version.data

MGE HID 1.57

driver.version.internal

0.71

driver.version.usb

libusb-1.0.29 (API: 0x0100010A)

experimental.ups.mode.buzzwords

vendor:mge-hid:ECO vendor:default:ECO

input.bypass.frequency

49.9

input.bypass.switch.off

disabled

input.bypass.switch.on

disabled

input.bypass.switchable

enabled

input.bypass.voltage

235.0

input.eco.switchable

ECO

input.frequency

49.9

input.frequency.nominal

50

input.transfer.bypass.forced

enabled

input.transfer.bypass.high

264

input.transfer.bypass.low

184

input.transfer.bypass.overload

enabled

input.transfer.eco.high

243

input.transfer.eco.low

218

input.transfer.frequency.bypass.range

10

input.transfer.frequency.eco.range

5

input.transfer.high

300

input.transfer.hysteresis

10

input.transfer.low

100

input.voltage

235.0

input.voltage.nominal

235

outlet.1.designator

AC OUTPUT

outlet.1.protect.status

protected

outlet.1.status

on

outlet.desc

Main Outlet

outlet.id

0

outlet.switchable

no

output.current

1.40

output.frequency

49.9

output.frequency.nominal

50

output.voltage

236.0

output.voltage.nominal

230

ups.beeper.status

enabled

ups.delay.shutdown

20

ups.delay.start

30

ups.firmware

00.02.000

ups.load

17

ups.load.high

105

ups.mfr

EATON

ups.model

9E2000i

ups.power

340

ups.power.nominal

2000

ups.productid

ffff

ups.realpower

296

ups.realpower.nominal

1600

ups.serial

GE16F43216

ups.shutdown

enabled

ups.start.auto

yes

ups.start.battery

yes

ups.start.reboot

yes

ups.status

OL

ups.temperature

24.9

ups.test.interval

604800

ups.test.result

Done and passed

ups.timer.shutdown

-1

ups.timer.start

-1

ups.type

online

ups.vendorid

0463

Device dump generated by ./nut-ddl-dump.sh on Wed, 26 Nov 2025 21:26:38 +0200

Further system data or configuration examples:

Variables per upsrw Eaton9E2000i@127.0.0.1 listing
# TODO: Convert to RW:... and RO:... markup
:; upsrw Eaton9E2000i@127.0.0.1
[battery.charge.low]
Remaining battery level when UPS switches to LB (percent)
Type: STRING
Maximum length: 5
Value: 20

[battery.charge.restart]
Minimum battery level for restart after power off (percent)
Type: STRING
Maximum length: 3
Value: 0

[battery.protection]
Prevent deep discharge of battery
Type: STRING
Maximum length: 5
Value: yes

[battery.runtime.low]
Remaining battery runtime when UPS switches to LB (seconds)
Type: STRING
Maximum length: 10
Value: 180

[driver.debug]
Current debug verbosity level of the driver program
Type: NUMBER
Value: 0

[driver.flag.allow_killpower]
Safety flip-switch to allow the driver daemon to send UPS shutdown command (accessible via driver.killpower)
Type: NUMBER
Value: 0

[input.bypass.switch.off]
Take the UPS out of Bypass mode
Type: STRING
Maximum length: 12
Value: disabled

[input.bypass.switch.on]
Put the UPS in Bypass mode
Type: STRING
Maximum length: 8
Value: disabled

[input.bypass.switchable]
Input auto transfer on Bypass when overload or out of tolerance (enabled or disabled)
Type: STRING
Maximum length: 8
Value: enabled

[input.eco.switchable]
Input High Efficiency (aka ECO) mode switch
Type: STRING
Maximum length: 8
Value: ECO

[input.transfer.bypass.forced]
Rule for allow auto Bypass switch (on/off) transfer modes (enabled or disabled)
Type: STRING
Maximum length: 8
Value: enabled

[input.transfer.bypass.high]
High voltage Bypass transfer point (V)
Type: STRING
Maximum length: 5
Value: 264

[input.transfer.bypass.low]
Low voltage Bypass transfer point (V)
Type: STRING
Maximum length: 5
Value: 184

[input.transfer.bypass.overload]
Rule for auto transfer on Bypass when overload (enabled or disabled)
Type: STRING
Maximum length: 8
Value: enabled

[input.transfer.eco.high]
High voltage ECO transfer point (V)
Type: STRING
Maximum length: 5
Value: 243

[input.transfer.eco.low]
Low voltage ECO transfer point (V)
Type: STRING
Maximum length: 5
Value: 218

[input.transfer.frequency.bypass.range]
Frequency range Bypass transfer point (percent of nominal Hz)
Type: STRING
Maximum length: 5
Value: 10

[input.transfer.frequency.eco.range]
Frequency range ECO transfer point (percent of nominal Hz)
Type: STRING
Maximum length: 5
Value: 5

[input.transfer.high]
High voltage transfer point (V)
Type: STRING
Maximum length: 5
Value: 300

[input.transfer.hysteresis]
Threshold of switching protection modes, voltage transfer point (V)
Type: STRING
Maximum length: 5
Value: 10

[input.transfer.low]
Low voltage transfer point (V)
Type: STRING
Maximum length: 5
Value: 100

[outlet.desc]
Outlet description
Type: STRING
Maximum length: 20
Value: Main Outlet

[output.voltage.nominal]
Nominal output voltage (V)
Type: ENUM STRING
Maximum length: 3
Option: "200"
Option: "208"
Option: "220"
Option: "230" SELECTED
Option: "240"

[ups.delay.shutdown]
Interval to wait after shutdown with delay command (seconds)
Type: STRING
Maximum length: 10
Value: 20

[ups.delay.start]
Interval to wait before (re)starting the load (seconds)
Type: STRING
Maximum length: 10
Value: 30

[ups.load.high]
Load when UPS switches to overload condition (percent)
Type: STRING
Maximum length: 5
Value: 105

[ups.shutdown]
Enable or disable UPS shutdown ability (poweroff)
Type: ENUM STRING
Maximum length: 10
Option: "disabled"
Option: "enabled" SELECTED

[ups.start.auto]
UPS starts when mains is (re)applied
Type: STRING
Maximum length: 5
Value: yes

[ups.start.battery]
Allow to start UPS from battery
Type: STRING
Maximum length: 5
Value: yes

[ups.start.reboot]
UPS reboots when power returns during shutdown delay
Type: STRING
Maximum length: 5
Value: yes

[ups.test.interval]
Interval between self tests (seconds)
Type: STRING
Maximum length: 8
Value: 604800
Commands per upscmd -l Eaton9E2000i@127.0.0.1 listing
# TODO: Convert to CMD:... markup
:; upscmd -l Eaton9E2000i@127.0.0.1
Instant commands supported on UPS [Eaton9E2000i]:

beeper.disable - Disable the UPS beeper
beeper.enable - Enable the UPS beeper
beeper.mute - Temporarily mute the UPS beeper
beeper.off - Obsolete (use beeper.disable or beeper.mute)
beeper.on - Obsolete (use beeper.enable)
bypass.start - Put the UPS in Bypass mode
bypass.stop - Take the UPS out of Bypass mode
driver.killpower - Tell the driver daemon to initiate UPS shutdown; should be unlocked with driver.flag.allow_killpower option or variable setting
driver.reload - Reload running driver configuration from the file system (only works for changes in some options)
driver.reload-or-error - Reload running driver configuration from the file system (only works for changes in some options); return an error if something changed and could not be applied live (so the caller can restart it with new options)
driver.reload-or-exit - Reload running driver configuration from the file system (only works for changes in some options); exit the running driver if something changed and could not be applied live (so service management framework can restart it with new options)
experimental.bypass.ecomode.start - Put UPS in Bypass mode then High Efficiency (aka ECO) mode
experimental.bypass.ecomode.stop - Take the UPS out of High Efficiency (aka ECO) mode after exiting Bypass mode
experimental.ecomode.start - Put UPS in High Efficiency (aka ECO) mode
experimental.ecomode.stop - Take the UPS out of High Efficiency (aka ECO) mode
experimental.essmode.start - Put UPS in Energy Saver System (aka ESS) mode
experimental.essmode.stop - Take the UPS out of Energy Saver System (aka ESS) mode
load.off - Turn off the load immediately
load.off.delay - Turn off the load with a delay (seconds)
load.on - Turn on the load immediately
load.on.delay - Turn on the load with a delay (seconds)
shutdown.default - Run the driver-defined UPS shutdown sequence (as opposed to user-configured 'sdcommands')
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 - Start a deep battery test
test.battery.start.quick - Start a quick battery test
test.battery.stop - Stop the battery test