UPower (org.freedesktop.UPower) battery and power-supply readouts for Phosphor-based desktop shells.
Exposes the system bus org.freedesktop.UPower surface (the aggregate display device, the per-device list, the OnBattery flag) as Qt + QML types. There is no UI. The shell decides how a battery percentage, charging icon, or low-power warning is rendered.
The library is a pure D-Bus client. It does not write to UPower (UPower has no writable surface for the kinds of facts it reports), it only observes.
| Type | Role |
|---|---|
| UPowerDevice | One physical power source. percentage, state, type, timeToEmpty, timeToFull, iconName, isLaptopBattery, healthPercentage. |
| UPowerHost | Owns the device set. onBattery, displayDevice (the UPower-aggregate battery), deviceCount, signals on add/remove. |
| UPowerDeviceModel | QAbstractListModel over the host's devices. Roles: device, percentage, deviceState, deviceType, iconName, isLaptopBattery. |
C++ shell composition root:
#include <PhosphorServiceUPower/QmlRegistration.h>
int main(int argc, char** argv)
{
QGuiApplication app(argc, argv);
PhosphorServiceUPower::registerQmlTypes();
// ... load shell.qml
}QML consumer (single-battery indicator):
import Phosphor.Service.UPower 1.0
UPowerHost { id: battery }
Label {
visible: battery.displayDevice !== null
text: battery.displayDevice
? Math.round(battery.displayDevice.percentage) + "%"
: ""
}QML consumer (per-device list):
import Phosphor.Service.UPower 1.0
UPowerHost { id: battery }
UPowerDeviceModel { id: devices; host: battery }
Repeater {
model: devices
delegate: Label { text: iconName + " " + Math.round(percentage) + "%" }
}Shipped. Extracted from the original phosphor-services umbrella as one of four per-domain siblings. The umbrella is gone, no backwards-compat shim (per feedback_no_legacy_shims). The C++ namespace and QML module URI moved (PhosphorServices::UPower* → PhosphorServiceUPower::UPower*, Phosphor.Services → Phosphor.Service.UPower). The DeviceType enum was extended additively from MediaPlayer=9 to BluetoothGeneric=28 to cover the full UPower 1.0 range, and existing enumerators kept their original values. The internal propertiesRefreshed() signal was removed because UPowerDeviceModel now subscribes to per-property NOTIFYs (percentage, state, type, iconName, isLaptopBattery). External consumers should bind the specific signal they care about.