Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit 813cab8f authored by Nick Crews's avatar Nick Crews Committed by Sebastian Reichel
Browse files

power: supply: core: Add CHARGE_CONTROL_{START_THRESHOLD,END_THRESHOLD} properties 



Add POWER_SUPPLY_PROP_CHARGE_CONTROL_START_THRESHOLD
and POWER_SUPPLY_PROP_CHARGE_CONTROL_END_THRESHOLD properties, to expand
the existing CHARGE_CONTROL_* properties. I am adding them in order
to support a new Chrome OS device, but these properties should be
general enough that they can be used on other devices.

When the charge_type is "Custom", the charge controller uses the
POWER_SUPPLY_PROP_CHARGE_CONTROL_* properties as configuration for some
other algorithm. For example, in the use case that I am supporting,
this means the battery begins charging when the percentage
level drops below POWER_SUPPLY_PROP_CHARGE_CONTROL_START_THRESHOLD and
charging ceases when the percentage level goes above
POWER_SUPPLY_PROP_CHARGE_CONTROL_END_THRESHOLD.

v5 changes:
- Add the other missing CHARGE_CONTROL_* properties documentation in
  a separate commit
- Split up adding the charge types and adding the
  POWER_SUPPLY_PROP_CHARGE_CONTROL_START_THRESHOLD and
  POWER_SUPPLY_PROP_CHARGE_CONTROL_END_THRESHOLD properties into
  two different commits.
v4 changes:
- Add documentation for the new properties, and add documentation for
  the the previously missing charge_control_limit and
  charge_control_limit_max properties.

Signed-off-by: default avatarNick Crews <ncrews@chromium.org>
Reviewed-by: default avatarEnric Balletbo i Serra <enric.balletbo@collabora.com>
Signed-off-by: default avatarSebastian Reichel <sebastian.reichel@collabora.com>
parent ba6cc850

Documentation/ABI/testing/sysfs-class-power

+20 −0
Original line number Diff line number Diff line
@@ -114,6 +114,26 @@ Description: 
		Access: Read

		Valid values: Represented in microamps



What:		/sys/class/power_supply/<supply_name>/charge_control_start_threshold

Date:		April 2019

Contact:	linux-pm@vger.kernel.org

Description:

		Represents a battery percentage level, below which charging will

		begin.



		Access: Read, Write

		Valid values: 0 - 100 (percent)



What:		/sys/class/power_supply/<supply_name>/charge_control_end_threshold

Date:		April 2019

Contact:	linux-pm@vger.kernel.org

Description:

		Represents a battery percentage level, above which charging will

		stop.



		Access: Read, Write

		Valid values: 0 - 100 (percent)



What:		/sys/class/power_supply/<supply_name>/charge_type

Date:		July 2009

Contact:	linux-pm@vger.kernel.org

drivers/power/supply/power_supply_sysfs.c

+2 −0
Original line number Diff line number Diff line
@@ -274,6 +274,8 @@ static struct device_attribute power_supply_attrs[] = { 
	POWER_SUPPLY_ATTR(constant_charge_voltage_max),

	POWER_SUPPLY_ATTR(charge_control_limit),

	POWER_SUPPLY_ATTR(charge_control_limit_max),

	POWER_SUPPLY_ATTR(charge_control_start_threshold),

	POWER_SUPPLY_ATTR(charge_control_end_threshold),

	POWER_SUPPLY_ATTR(input_current_limit),

	POWER_SUPPLY_ATTR(energy_full_design),

	POWER_SUPPLY_ATTR(energy_empty_design),

include/linux/power_supply.h

+2 −0
Original line number Diff line number Diff line
@@ -125,6 +125,8 @@ enum power_supply_property { 
	POWER_SUPPLY_PROP_CONSTANT_CHARGE_VOLTAGE_MAX,

	POWER_SUPPLY_PROP_CHARGE_CONTROL_LIMIT,

	POWER_SUPPLY_PROP_CHARGE_CONTROL_LIMIT_MAX,

	POWER_SUPPLY_PROP_CHARGE_CONTROL_START_THRESHOLD, /* in percents! */

	POWER_SUPPLY_PROP_CHARGE_CONTROL_END_THRESHOLD, /* in percents! */

	POWER_SUPPLY_PROP_INPUT_CURRENT_LIMIT,

	POWER_SUPPLY_PROP_ENERGY_FULL_DESIGN,

	POWER_SUPPLY_PROP_ENERGY_EMPTY_DESIGN,