Documentation/admin-guide/laptops/thinkpad-acpi: add section for battery charge control

Commit Message

Barnabás Pőcze July 27, 2020, 4:30 p.m. UTC

Signed-off-by: Barnabás Pőcze <[e-mail]>
---
 .../admin-guide/laptops/thinkpad-acpi.rst       | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

--
2.27.0

Comments

Andy Shevchenko July 27, 2020, 7:04 p.m. UTC | #1

On Mon, Jul 27, 2020 at 7:30 PM Barnabás Pőcze <[e-mail]> wrote:

Thanks!
The content looks good, though please add a commit message for v2.

> Signed-off-by: Barnabás Pőcze <[e-mail]>

Patch

diff --git a/Documentation/admin-guide/laptops/thinkpad-acpi.rst b/Documentation/admin-guide/laptops/thinkpad-acpi.rst
index 822907dcc845..46217d0c3dd1 100644
--- a/Documentation/admin-guide/laptops/thinkpad-acpi.rst
+++ b/Documentation/admin-guide/laptops/thinkpad-acpi.rst
@@ -1470,6 +1470,23 @@  For more details about which buttons will appear depending on the mode, please
 review the laptop's user guide:
 http://www.lenovo.com/shop/americas/content/user_guides/x1carbon_2_ug_en.pdf

+Battery charge control
+----------------------
+
+sysfs attributes:
+/sys/class/power_supply/BAT*/charge_control_{start,end}_threshold
+
+These two attributes are created for those batteries that are supported by the
+driver. They enable the user to control the battery charge thresholds of the
+given battery. Both values may be read and set. `charge_control_start_threshold`
+accepts an integer between 0 and 99 (inclusive); this value represents a battery
+percentage level, below which charging will begin. `charge_control_end_threshold`
+accepts an integer between 1 and 100 (inclusive); this value represents a battery
+percentage level, above which charging will stop.
+
+The exact semantics of the attributes may be found in
+Documentation/ABI/testing/sysfs-class-power.
+
 Multiple Commands, Module Parameters
 ------------------------------------