fdo-mirrors/upower
1
0
Fork 0
mirror of https://gitlab.freedesktop.org/upower/upower.git synced 2025-12-20 04:20:04 +01:00
Code Issues Projects Releases Packages Wiki Activity Actions

bus: org.freedesktop.UPower.Device: introduce ChargeStrategies to select the charging algorithm

Browse source 
This property and API are used to show the current charging strategy
reported by the system firmware and set the strategy to the firmware.
This gives the upper-layer apps and the user can choose a charging
algorithm.
This commit is contained in:
Kate Hsuan 2025-11-17 14:08:45 +08:00
parent 391e3323f0
commit 97d2ea6197
1 changed files with 38 additions and 0 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

38
dbus/org.freedesktop.UPower.Device.xml
View file

@ -914,6 +914,44 @@ method return sender=:1.386 -> dest=:1.477 reply_serial=2
</doc:description>
</doc:doc>
</property>
<property name="ChargeStrategy" type="u" access="read">
<doc:doc>
<doc:description>
<doc:para>Select the charging algorithm to use for a battery.</doc:para>
<doc:list>
<doc:item>
<doc:term>1</doc:term><doc:definition>Unknown. The battery charging behavior is unknown or not supported.</doc:definition>
</doc:item>
<doc:item>
<doc:term>2</doc:term><doc:definition>N/A. The battery charging behavior is not supported.</doc:definition>
</doc:item>
<doc:item>
<doc:term>4</doc:term><doc:definition>Trickle. The battery charges slowly.</doc:definition>
</doc:item>
<doc:item>
<doc:term>8</doc:term><doc:definition>Fast. Quickly charge the battery using fast-charge technology</doc:definition>
</doc:item>
<doc:item>
<doc:term>16</doc:term><doc:definition>Standard. Fully charge the battery with a moderate rate.</doc:definition>
</doc:item>
<doc:item>
<doc:term>32</doc:term><doc:definition>Adaptive. The battery charges at a rate that adapts to the battery's capacity which the system firmware controls.</doc:definition>
</doc:item>
<doc:item>
<doc:term>64</doc:term><doc:definition>Custom. The battery charges at a rate that is set by the user.</doc:definition>
</doc:item>
<doc:item>
<doc:term>128</doc:term><doc:definition>Long-life. The charger reduces its charging rate in order to prolong the battery health</doc:definition>
</doc:item>
<doc:item>
<doc:term>256</doc:term><doc:definition>Bypass. Bypass the charge path around the integrated charger. A external charger is used instead to manage the charging</doc:definition>
</doc:item>
</doc:list>
<doc:para>Examples:</doc:para>
<doc:para>If the system supports charge start threshold and charge end threshold, the value is 3. If the system supports charge end threshold and the battery charging behavior is controlled by the system firmware, the value is 6.</doc:para>
</doc:description>
</doc:doc>
</property>
<property name="VoltageMinDesign" type="d" access="read">
<doc:doc>
<doc:description>