Network UPS Tools Binding v1


This 1.x binding is obsolete; it has been replaced by the 2.x networkupstools binding which you should use instead.

The primary goal of the Network UPS Tools (NUT) project is to provide support for power devices, such as uninterruptible power supplies (UPS), Power Distribution Units and Solar Controllers.

Network UPS Tools (NUT) provides many control and monitoring features, with a uniform control and management interface. More than 100 different manufacturers, and several thousands of models are compatible.

This binding lets you integrate NUT servers with openHAB.

Binding Configuration

This binding can be configured in the file services/networkupstools.cfg.

Property Default Required Description
<instance name>.<parameter> Yes X
refresh No refresh interval for state updates in milliseconds
<name>.device Yes UPS device name, ups for example
<name>.host No UPS server hostname
<name>.port No UPS server port, 3493 for example
<name>.login No UPS server login
<name>.pass No UPS server password

where <name> is a name you choose to identify a specific UPS device that is managed by NUT servers, ups1 for instance. You can configure any number of UPS devices managed by NUT servers. Every UPS is identified by instance name ("ups1" in the example above). You use instance name in the item definitions.

Thing Configuration

No .things file configuration required

Item Configuration

The syntax for the binding configuration string is explained here:

networkupstools="<name>:<property name>"

Here are some examples of valid binding configuration strings:


As a result, your lines in the items file might look like the following:

Number Ups_Output_Voltage "UPS output voltage [%.1f V]" (Ups) {networkupstools="ups1:output.voltage"}
String Ups_Status "UPS status [%s]" (Ups) {networkupstools="ups1:ups.status"}

Supported item types are Number and String.

Supported property names differs between UPSes. You can use upsc command to get a list of properties for your ups:

$ upsc ups1
battery.charge: 100
battery.voltage: 13.40
battery.voltage.high: 13.00
battery.voltage.low: 10.40
battery.voltage.nominal: 12.0
device.model: 750VA
device.type: ups blazer_usb
driver.parameter.pollinterval: 2
driver.parameter.port: auto
driver.version: 2.7.1
driver.version.internal: 0.10
input.current.nominal: 3.0
input.frequency: 50.0
input.frequency.nominal: 50
input.voltage: 240.3
input.voltage.fault: 168.4
input.voltage.nominal: 230
output.voltage: 238.0
ups.beeper.status: enabled
ups.delay.shutdown: 30
ups.delay.start: 180
ups.load: 8
ups.model: 750VA
ups.productid: 5161
ups.status: OL
ups.type: offline / line interactive
ups.vendorid: 0665