Struct i3status_rs::blocks::battery::UpowerDevice

pub struct UpowerDevice {
    device_path: String,
    con: Connection,
}

Represents a battery known to UPower.

Fields

device_path: String

con: Connection

Implementations

impl UpowerDevice

pub fn from_device(device: &str) -> Result<Self, Error>

Create the UPower device from the device string, which is converted to the path "/org/freedesktop/UPower/devices/battery_<device>", except if device equals "DisplayDevice", in which case it is converted to the path "/org/freedesktop/UPower/devices/DisplayDevice". Raises an error if D-Bus cannot connect to this device, or if the device is not a battery.

pub fn monitor(&self, id: usize, update_request: Sender<Task>)

Monitor UPower property changes in a separate thread and send updates via the update_request channel.

Trait Implementations

impl BatteryDevice for UpowerDevice

fn is_available(&self) -> bool

Query whether the device is available. Batteries can be hot-swappable and configurations may be used for multiple devices (desktop AND laptop).

fn refresh_device_info(&mut self) -> Result<(), Error>

Logic for getting some static battery specs. An error may be thrown when these specs cannot be found or if the device is unexpectedly missing.

fn status(&self) -> Result<String, Error>

Query the device status. One of "Full", "Charging", "Discharging", or "Unknown". Thinkpad batteries also report "Not charging", which for our purposes should be treated as equivalent to full.

fn capacity(&self) -> Result<u64, Error>

Query the device's current capacity, as a percent.

fn time_remaining(&self) -> Result<u64, Error>

Query the estimated time remaining, in minutes, before (dis)charging is complete.

fn power_consumption(&self) -> Result<u64, Error>

Query the current power consumption, in uW.