kdeconnect-kde/plugins/battery
Alexander Lohnau f740a8bda8 Use target-centric CMake approach for declaring debug category
This makes it easier to read, because we do not have to handle a list of
files that get added to the targets. In other KDE projects, we also
prefer the target centric approach.

In case one wants to reuse the same category in multiple places, it
would be best to create a small static lib. But for now, this is not
needed.
2023-07-22 20:51:19 +00:00
..
batteryplugin.cpp Remove request packets from Battery and Connectivity Report plugins 2023-07-17 14:58:59 +00:00
batteryplugin.h Remove request packets from Battery and Connectivity Report plugins 2023-07-17 14:58:59 +00:00
CMakeLists.txt Use target-centric CMake approach for declaring debug category 2023-07-22 20:51:19 +00:00
kdeconnect_battery.json Remove explicit plugin Id 2023-07-22 20:51:19 +00:00
README Finally, we have support for sending out Battery information. 2020-04-13 05:54:11 +00:00

This plugins receives packages with type "kdeconnect.battery" and reads the
following fields:

isCharging (boolean): If the battery of the peer device is charging
currentCharge (int): The charge % of the peer device
thresholdEvent (int) [optional when = 0, see below]:
    means that a battery threshold event were fired on the remote device:
        0 := no event. generally not transmitted.
        1 := battery entered in low state
    This is an int so in the future we'll be able to subscribe to more events.
    (see BatteryPlugin.ThresholdBatteryEvent)

Symmetrically, it sends its own battery information in packages with the same
format. We only look for the 'primary' battery of the system, if one is present.

<TODO>
Support for devices with multiple batteries isn't there yet.
</TODO>

It also sends packages with type kdeconnect.battery and a field "request": true,
to ask the peer device to send a package like the mentioned above, and should
also answer this same kind of packages with its own information.

If the battery is low and discharging, it will notify the user.