Changes in sysfs-class-power

df998c22 - power: supply: add undervoltage health status property

Wed, 08 Jan 2025 14:13:45 +0000

power: supply: add undervoltage health status propertyAdd POWER_SUPPLY_HEALTH_UNDERVOLTAGE status for power supplyto report under voltage lockout failures.Signed-off-by: Dzmitry Sankouski Link: https://lore.kernel.org/r/20250108-starqltechn_integration_upstream-v14-1-f6e84ec20d96@gmail.comSigned-off-by: Sebastian Reichel List of files: /linux-6.15/Documentation/ABI/testing/sysfs-class-power

288a2cab - power: supply: core: add UAPI to discover currently used extensions

Wed, 11 Dec 2024 19:57:58 +0000

power: supply: core: add UAPI to discover currently used extensionsUserspace wants to now about the used power supply extensions,for example to handle a device extended by a certain extensiondifferently or to discover information about the extending device.Add a sysfs directory to the power supply device.This directory contains links which are named after the used extensionand point to the device implementing that extension.Signed-off-by: Thomas Weißschuh Reviewed-by: Armin Wolf Link: https://lore.kernel.org/r/20241211-power-supply-extensions-v6-4-9d9dc3f3d387@weissschuh.netSigned-off-by: Sebastian Reichel List of files: /linux-6.15/Documentation/ABI/testing/sysfs-class-power

d24bf992 - power: supply: core: Add new "charge_types" property

Wed, 11 Dec 2024 17:44:49 +0000

power: supply: core: Add new "charge_types" propertyAdd a new "charge_types" property, this is identical to "charge_type" butreading returns a list of supported charge-types with the currently activetype surrounded by square brackets, e.g.:Fast [Standard] "Long_Life"This has the advantage over the existing "charge_type" property that thisallows userspace to find out which charge-types are supported for writablecharge_type properties.Drivers which already support "charge_type" can easily add support forthis by setting power_supply_desc.charge_types to a bitmask representingvalid charge_type values. The existing "charge_type" get_property() andset_property() code paths can be re-used for "charge_types".Signed-off-by: Hans de Goede Reviewed-by: Thomas Weißschuh Link: https://lore.kernel.org/r/20241211174451.355421-3-hdegoede@redhat.comSigned-off-by: Sebastian Reichel List of files: /linux-6.15/Documentation/ABI/testing/sysfs-class-power

0d9af1e1 - power: supply: "usb_type" property may be written to

Sat, 31 Aug 2024 14:20:34 +0000

power: supply: "usb_type" property may be written toAccording to Documentation/ABI/testing/sysfs-class-power the "usb_type"property is Read-Only.For power-supplies which consume USB power such as battery charger chips,this is correct.But the UCS1002 USB Port Power Controller driver which is a driverfor a chip which is a power-source for USB-A charging ports "usb_type"is actually writable to configure the type of USB charger emulatedby the USB-A port.Adjust the docs and the power_supply_sysfs.c code to adjust for thisnew writeable use of "usb_type":1. Update Documentation/ABI/testing/sysfs-class-power to document that"usb_type" may be writable2. Change the power_supply_attr type in power_supply_sysfs.c fromPOWER_SUPPLY_ATTR() into POWER_SUPPLY_ENUM_ATTR() so that the varioususb_type string values from POWER_SUPPLY_TYPE_TEXT[] such as e.g."SDP" and "USB_PD" can be written to the "usb_type" attribute insteadof only accepting integer values.Cc: Enric Balletbo Serra Cc: Andrey Smirnov Signed-off-by: Hans de Goede Reviewed-by: Greg Kroah-Hartman Link: https://lore.kernel.org/r/20240831142039.28830-2-hdegoede@redhat.comSigned-off-by: Sebastian Reichel List of files: /linux-6.15/Documentation/ABI/testing/sysfs-class-power

919a4719 - ABI: testing: sysfs-class-power: clarify charge_type documentation

Tue, 20 Aug 2024 08:19:42 +0000

ABI: testing: sysfs-class-power: clarify charge_type documentationThe existing docs here are a bit vague. This reformats and rewords it,and is based upon the wording originally used by the dell-laptop driverbattery documentation and also sysfs-class-power-wilco.The wording for "Long Life" and "Bypass" remain the same, because I'munfamiliar with hardware that use them.Signed-off-by: Andres Salomon Reviewed-by: Hans de Goede Link: https://lore.kernel.org/r/20240820041942.30ed42f3@5400Signed-off-by: Sebastian Reichel List of files: /linux-6.15/Documentation/ABI/testing/sysfs-class-power

f0cf0575 - ABI: testing: sysfs-class-power: Document absence of "present" property

Mon, 20 Feb 2023 13:10:18 +0000

ABI: testing: sysfs-class-power: Document absence of "present" propertyDocument how the absence of the "present" property in the sysfspower_supply class should be handled.Link: https://gitlab.freedesktop.org/upower/upower/-/merge_requests/173Cc: Mario Limonciello Signed-off-by: Bastien Nocera Signed-off-by: Sebastian Reichel List of files: /linux-6.15/Documentation/ABI/testing/sysfs-class-power

18ef1bb0 - docs: ABI: charge_control_end_threshold may not support all values

Fri, 02 Sep 2022 18:00:37 +0000

docs: ABI: charge_control_end_threshold may not support all valuesSome laptops (for example Toshiba Satellite Z830) only supports some fixedvalues. Allow for this and document the expected behaviour in such cases.Acked-by: Sebastian Reichel Signed-off-by: Arvid Norlander Link: https://lore.kernel.org/r/20220902180037.1728546-4-lkml@vorpal.seSigned-off-by: Hans de Goede List of files: /linux-6.15/Documentation/ABI/testing/sysfs-class-power

1ff8cc2c - ABI: testing: sysfs-class-power: Adds "Long Life" entry

Tue, 15 Feb 2022 00:07:58 +0000

ABI: testing: sysfs-class-power: Adds "Long Life" entryAdds a brief desciption of the "Long Life" charge type and adds "Long Life"to the list of valid values.Signed-off-by: Ricardo Rivera-Matos Signed-off-by: Sebastian Reichel List of files: /linux-6.15/Documentation/ABI/testing/sysfs-class-power

05f2281b - power: supply: Introduces bypass charging property

Tue, 15 Feb 2022 00:07:56 +0000

power: supply: Introduces bypass charging propertyAdds a POWER_SUPPLY_CHARGE_TYPE_BYPASS option to the POWER_SUPPLY_PROP_CHARGE_TYPEproperty to facilitate bypass charging operation.In bypass charging operation, the charger bypasses the charging path around theintegrated converter allowing for a "smart" wall adaptor to perform the powerconversion externally.This operational mode is critical for the USB PPS standard of power adaptors and isbecoming a common feature in modern charging ICs such as:- BQ25980- BQ25975- BQ25960- LN8000- LN8410Signed-off-by: Ricardo Rivera-Matos Signed-off-by: Sebastian Reichel List of files: /linux-6.15/Documentation/ABI/testing/sysfs-class-power

da5462a4 - power: supply: fix table problem in sysfs-class-power

Tue, 18 Jan 2022 02:15:22 +0000

power: supply: fix table problem in sysfs-class-powerAdd a bottom table border to complete the table format and preventa documentation build warning.Documentation/ABI/testing/sysfs-class-power:459: WARNING: Malformed table.No bottom table border found.Fixes: 1b0b6cc8030d0 ("power: supply: add charge_behaviour attributes")Signed-off-by: Randy Dunlap Cc: Thomas Weißschuh Cc: Hans de Goede Cc: Sebastian Reichel Cc: linux-pm@vger.kernel.orgCc: Stephen Rothwell Signed-off-by: Sebastian Reichel List of files: /linux-6.15/Documentation/ABI/testing/sysfs-class-power

1b0b6cc8 - power: supply: add charge_behaviour attributes

Tue, 23 Nov 2021 23:27:01 +0000

power: supply: add charge_behaviour attributesThis a revised version of"[RFC] add standardized attributes for force_discharge and inhibit_charge" [0],incorporating discussion results.The biggest change is the switch from two boolean attributes to a singleenum attribute.[0] https://lore.kernel.org/platform-driver-x86/21569a89-8303-8573-05fb-c2fec29983d1@gmail.com/Signed-off-by: Thomas Weißschuh Acked-by: Sebastian Reichel Link: https://lore.kernel.org/r/20211123232704.25394-2-linux@weissschuh.netSigned-off-by: Hans de Goede List of files: /linux-6.15/Documentation/ABI/testing/sysfs-class-power

77d641ba - power: supply: core: add POWER_SUPPLY_HEALTH_NO_BATTERY

Mon, 08 Nov 2021 16:27:05 +0000

power: supply: core: add POWER_SUPPLY_HEALTH_NO_BATTERYSome chargers can keep the system powered from the mains even when nobattery is present. It this case none of the currently defined healthstatuses applies. Add a new status to report that no battery is present.Suggested-by: Sebastian Reichel Signed-off-by: Luca Ceresoli Signed-off-by: Sebastian Reichel List of files: /linux-6.15/Documentation/ABI/testing/sysfs-class-power

5d1f642a - docs: ABI: sysfs-class-power: Documented cycle_count property

Thu, 16 Sep 2021 12:53:21 +0000

docs: ABI: sysfs-class-power: Documented cycle_count propertyCommit c955fe8e0bdd ("POWER: Add support for cycle_count") added aPOWER_SUPPLY_PROP_CYCLE_COUNT "cycle_count" property to the set ofstandard power-supply properties, but this was never documented,document it now.Link: https://gitlab.freedesktop.org/upower/upower/-/issues/152Reported-by: Bastien Nocera Signed-off-by: Hans de Goede Signed-off-by: Sebastian Reichel List of files: /linux-6.15/Documentation/ABI/testing/sysfs-class-power

9e0b29ad - docs: ABI: sysfs-class-power: unify duplicated properties

Fri, 30 Oct 2020 07:40:54 +0000

docs: ABI: sysfs-class-power: unify duplicated propertiesThe ABI is not supposed to have duplicated entries, as warnedby get_abi.pl: $ ./scripts/get_abi.pl validate 2>&1|grep sysfs-class-power Warning: /sys/class/power_supply//current_avg is defined 2 times: Documentation/ABI/testing/sysfs-class-power:108 Documentation/ABI/testing/sysfs-class-power:391 Warning: /sys/class/power_supply//current_max is defined 2 times: Documentation/ABI/testing/sysfs-class-power:121 Documentation/ABI/testing/sysfs-class-power:404 Warning: /sys/class/power_supply//current_now is defined 2 times: Documentation/ABI/testing/sysfs-class-power:130 Documentation/ABI/testing/sysfs-class-power:414 Warning: /sys/class/power_supply//temp is defined 2 times: Documentation/ABI/testing/sysfs-class-power:281 Documentation/ABI/testing/sysfs-class-power:493 Warning: /sys/class/power_supply//temp_alert_max is defined 2 times: Documentation/ABI/testing/sysfs-class-power:291 Documentation/ABI/testing/sysfs-class-power:505 Warning: /sys/class/power_supply//temp_alert_min is defined 2 times: Documentation/ABI/testing/sysfs-class-power:306 Documentation/ABI/testing/sysfs-class-power:521 Warning: /sys/class/power_supply//temp_max is defined 2 times: Documentation/ABI/testing/sysfs-class-power:322 Documentation/ABI/testing/sysfs-class-power:537 Warning: /sys/class/power_supply//temp_min is defined 2 times: Documentation/ABI/testing/sysfs-class-power:333 Documentation/ABI/testing/sysfs-class-power:547 Warning: /sys/class/power_supply//voltage_max is defined 2 times: Documentation/ABI/testing/sysfs-class-power:356 Documentation/ABI/testing/sysfs-class-power:571 Warning: /sys/class/power_supply//voltage_min is defined 2 times: Documentation/ABI/testing/sysfs-class-power:367 Documentation/ABI/testing/sysfs-class-power:581 Warning: /sys/class/power_supply//voltage_now is defined 2 times: Documentation/ABI/testing/sysfs-class-power:378 Documentation/ABI/testing/sysfs-class-power:591Yet, both USB and Battery share a common set of charging-relatedproperties.Unify the entries for such properties in order to avoidduplication, while preserving the battery and USB-specificdata properly documented.Acked-by: Jonathan Corbet Signed-off-by: Mauro Carvalho Chehab Link: https://lore.kernel.org/r/bcdf5f76326ea48a990a7cac612af216c387537d.1604042072.git.mchehab+huawei@kernel.orgSigned-off-by: Greg Kroah-Hartman List of files: /linux-6.15/Documentation/ABI/testing/sysfs-class-power

54a19b4d - docs: ABI: cleanup several ABI documents

Fri, 30 Oct 2020 07:40:50 +0000

docs: ABI: cleanup several ABI documentsThere are some ABI documents that, while they don't generateany warnings, they have issues when parsed by get_abi.pl scripton its output result.Address them, in order to provide a clean output.Reviewed-by: Tom Rix # for fpga-managerReviewed-By: Kajol Jain # for sysfs-bus-event_source-devices-hv_gpci and sysfs-bus-event_source-devices-hv_24x7Acked-by: Jonathan Cameron #for IIOAcked-by: Oded Gabbay # for HabanalabsAcked-by: Vaibhav Jain # for sysfs-bus-papr-pmemAcked-by: Cezary Rojewski # for catptAcked-by: Suzuki K Poulose Acked-by: Ilya Dryomov # for rbdAcked-by: Jonathan Corbet Signed-off-by: Mauro Carvalho Chehab Link: https://lore.kernel.org/r/5bc78e5b68ed1e9e39135173857cb2e753be868f.1604042072.git.mchehab+huawei@kernel.orgSigned-off-by: Greg Kroah-Hartman List of files: /linux-6.15/Documentation/ABI/testing/sysfs-class-power

34433332 - docs: ABI: testing: make the files compatible with ReST output

Fri, 30 Oct 2020 07:40:39 +0000

docs: ABI: testing: make the files compatible with ReST outputSome files over there won't parse well by Sphinx.Fix them.Acked-by: Jonathan Cameron # for IIOAcked-by: Fabrice Gasnier Acked-by: Jonathan Corbet Signed-off-by: Mauro Carvalho Chehab Link: https://lore.kernel.org/r/58cf3c2d611e0197fb215652719ebd82ca2658db.1604042072.git.mchehab+huawei@kernel.orgSigned-off-by: Greg Kroah-Hartman List of files: /linux-6.15/Documentation/ABI/testing/sysfs-class-power

05f94eb9 - power: supply: document current direction

Thu, 27 Aug 2020 14:02:48 +0000

power: supply: document current directionCurrently the sign for CURRENT_NOW and CURRENT_AVG is a bitof a mess. There are basically 3 different ways battery fuelgauges report the current:1. uses negative values for discharging and positive values for charging2. uses positive values for discharging and negative values for discharging (opposit of 1)3. only uses positive valuesAs a result userspace currently cannot use the sign at all ina generic way. Let's solve the issue by documenting a canonicalway for reporting the data and ensure new drivers follow thisway. Then existing drivers can be fixed on a case-by-case basis.The 'negative value = battery discharging' has been choosen,since there are only very few drivers doing it the other wayaround.Signed-off-by: Sebastian Reichel List of files: /linux-6.15/Documentation/ABI/testing/sysfs-class-power

5ca937fb - power: supply: add wireless type

Thu, 13 Aug 2020 18:34:08 +0000

power: supply: add wireless typeCurrently, power_supply framework supports only Battery, UPS,Mains and USB power_supply_type. Add wireless power_supply_typeso that the drivers which supports wireless can register a powersupply class device with POWER_SUPPLY_TYPE_WIRELESS.Signed-off-by: Subbaraman Narayanamurthy Signed-off-by: Guru Das Srinagesh Signed-off-by: Sebastian Reichel List of files: /linux-6.15/Documentation/ABI/testing/sysfs-class-power

98cc1b93 - power_supply: Add additional health properties to the header

Mon, 20 Jul 2020 20:43:57 +0000

power_supply: Add additional health properties to the headerAdd HEALTH_WARM, HEALTH_COOL and HEALTH_HOT to the health enum.HEALTH_WARM, HEALTH_COOL, and HEALTH_HOT properties are takenfrom JEITA specification JISC8712:2015Acked-by: Andrew F. Davis Tested-by: Guru Das Srinagesh Signed-off-by: Dan Murphy Signed-off-by: Sebastian Reichel List of files: /linux-6.15/Documentation/ABI/testing/sysfs-class-power

601c2a54 - power: supply: core: add POWER_SUPPLY_HEALTH_CALIBRATION_REQUIRED

Wed, 13 May 2020 18:56:00 +0000

power: supply: core: add POWER_SUPPLY_HEALTH_CALIBRATION_REQUIREDSome battery fuel gauges know when the battery needs tobe recalibrated before providing usable values. Thisshould be reported via the health property.Signed-off-by: Sebastian Reichel List of files: /linux-6.15/Documentation/ABI/testing/sysfs-class-power