NUT-UPOWER(8)

NAME
nut-upower - Driver for UPower devices via D-Bus

SYNOPSIS

nut-upower -h

nut-upower -a UPS_NAME [OPTIONS]

    Note

    This man page only documents the specific features of the nut-upower driver. For information about the core driver, see nutupsdrv(8).

DESCRIPTION

This driver allows the monitoring of power devices (UPS, batteries) that are managed by the UPower daemon via the D-Bus system bus.

It maps UPower properties (state, percentage, voltage, etc.) to standard NUT variables, allowing NUT clients to monitor devices that are natively supported by the OS desktop environment but not directly by other NUT drivers.

EXTRA ARGUMENTS

This driver supports the following optional settings in ups.conf(5):

port
    The UPower Object Path of the device to monitor.

If set to auto (the default), the driver will scan for the first UPower device whose object path contains the string "ups_".

If set to a specific path (e.g., /org/freedesktop/UPower/devices/ups_hiddev0), the driver will attempt to monitor that specific device.

lowbatt
    The battery percentage threshold below which the LB (Low Battery) status flag is set. The default value is 20.0.

INSTALLATION

To use this driver, add a section to your ups.conf:

    [myups]
        driver = nut-upower
        port = auto
        lowbatt = 20
        desc = "Laptop Battery or generic UPS via UPower"

REQUIREMENTS

This driver requires the upower daemon to be running and accessible via the D-Bus system bus. It also requires GLib 2.0 and GIO libraries.

AUTHOR

Tim Niemueller <tim@niemueller.de>

SEE ALSO

ups.conf(5), nutupsdrv(8), upsc(8)

  Internet Resources:

The NUT (Network UPS Tools) home page: https://www.networkupstools.org/historic/v2.8.5/