xref: /linux/Documentation/ABI/testing/sysfs-class-power (revision a43dd4f6f91ed1a1d16595cb0c550b283e9b2298)
1**General Properties**
2
3What:		/sys/class/power_supply/<supply_name>/manufacturer
4Date:		May 2007
5Contact:	linux-pm@vger.kernel.org
6Description:
7		Reports the name of the device manufacturer.
8
9		Access: Read
10		Valid values: Represented as string
11
12What:		/sys/class/power_supply/<supply_name>/model_name
13Date:		May 2007
14Contact:	linux-pm@vger.kernel.org
15Description:
16		Reports the name of the device model.
17
18		Access: Read
19		Valid values: Represented as string
20
21What:		/sys/class/power_supply/<supply_name>/serial_number
22Date:		January 2008
23Contact:	linux-pm@vger.kernel.org
24Description:
25		Reports the serial number of the device.
26
27		Access: Read
28		Valid values: Represented as string
29
30What:		/sys/class/power_supply/<supply_name>/type
31Date:		May 2010
32Contact:	linux-pm@vger.kernel.org
33Description:
34		Describes the main type of the supply.
35
36		Access: Read
37		Valid values: "Battery", "UPS", "Mains", "USB", "Wireless"
38
39**Battery and USB properties**
40
41What:		/sys/class/power_supply/<supply_name>/current_avg
42Date:		May 2007
43Contact:	linux-pm@vger.kernel.org
44Description:
45		Battery:
46
47		  Reports an average IBAT current reading for the battery, over
48		  a fixed period. Normally devices will provide a fixed interval
49		  in which they average readings to smooth out the reported
50		  value.
51
52		USB:
53
54		  Reports an average IBUS current reading over a fixed period.
55		  Normally devices will provide a fixed interval in which they
56		  average readings to smooth out the reported value.
57
58		Access: Read
59
60		Valid values: Represented in microamps. Negative values are
61		used for discharging batteries, positive values for charging
62		batteries and for USB IBUS current.
63
64What:		/sys/class/power_supply/<supply_name>/current_max
65Date:		October 2010
66Contact:	linux-pm@vger.kernel.org
67Description:
68		Battery:
69
70		  Reports the maximum IBAT current allowed into the battery.
71
72		USB:
73
74		  Reports the maximum IBUS current the supply can support.
75
76		Access: Read
77		Valid values: Represented in microamps
78
79What: 		/sys/class/power_supply/<supply_name>/current_now
80Date:		May 2007
81Contact:	linux-pm@vger.kernel.org
82Description:
83
84		Battery:
85
86		  Reports an instant, single IBAT current reading for the
87		  battery. This value is not averaged/smoothed.
88
89		  Access: Read
90
91		USB:
92
93		  Reports the IBUS current supplied now. This value is generally
94		  read-only reporting, unless the 'online' state of the supply
95		  is set to be programmable, in which case this value can be set
96		  within the reported min/max range.
97
98		  Access: Read, Write
99
100		Valid values: Represented in microamps. Negative values are
101		used for discharging batteries, positive values for charging
102		batteries and for USB IBUS current.
103
104What:		/sys/class/power_supply/<supply_name>/temp
105Date:		May 2007
106Contact:	linux-pm@vger.kernel.org
107Description:
108		Battery:
109
110		  Reports the current TBAT battery temperature reading.
111
112		USB:
113
114		  Reports the current supply temperature reading. This would
115		  normally be the internal temperature of the device itself
116		  (e.g TJUNC temperature of an IC)
117
118		Access: Read
119
120		Valid values: Represented in 1/10 Degrees Celsius
121
122What:		/sys/class/power_supply/<supply_name>/temp_alert_max
123Date:		July 2012
124Contact:	linux-pm@vger.kernel.org
125Description:
126		Battery:
127
128		  Maximum TBAT temperature trip-wire value where the supply will
129		  notify user-space of the event.
130
131		USB:
132
133		  Maximum supply temperature trip-wire value where the supply
134		  will notify user-space of the event.
135
136		This is normally used for the charging scenario where
137		user-space needs to know if the temperature has crossed an
138		upper threshold so it can take appropriate action (e.g. warning
139		user that the temperature is critically high, and charging has
140		stopped).
141
142		Access: Read
143
144		Valid values: Represented in 1/10 Degrees Celsius
145
146What:		/sys/class/power_supply/<supply_name>/temp_alert_min
147Date:		July 2012
148Contact:	linux-pm@vger.kernel.org
149Description:
150
151		Battery:
152
153		  Minimum TBAT temperature trip-wire value where the supply will
154		  notify user-space of the event.
155
156		USB:
157
158		  Minimum supply temperature trip-wire value where the supply
159		  will notify user-space of the event.
160
161		This is normally used for the charging scenario where user-space
162		needs to know if the temperature has crossed a lower threshold
163		so it can take appropriate action (e.g. warning user that
164		temperature level is high, and charging current has been
165		reduced accordingly to remedy the situation).
166
167		Access: Read
168
169		Valid values: Represented in 1/10 Degrees Celsius
170
171What:		/sys/class/power_supply/<supply_name>/temp_max
172Date:		July 2014
173Contact:	linux-pm@vger.kernel.org
174Description:
175		Battery:
176
177		  Reports the maximum allowed TBAT battery temperature for
178		  charging.
179
180		USB:
181
182		  Reports the maximum allowed supply temperature for operation.
183
184		Access: Read
185
186		Valid values: Represented in 1/10 Degrees Celsius
187
188What:		/sys/class/power_supply/<supply_name>/temp_min
189Date:		July 2014
190Contact:	linux-pm@vger.kernel.org
191Description:
192		Battery:
193
194		  Reports the minimum allowed TBAT battery temperature for
195		  charging.
196
197		USB:
198
199		  Reports the minimum allowed supply temperature for operation.
200
201		Access: Read
202
203		Valid values: Represented in 1/10 Degrees Celsius
204
205What:		/sys/class/power_supply/<supply_name>/voltage_max,
206Date:		January 2008
207Contact:	linux-pm@vger.kernel.org
208Description:
209		Battery:
210
211		  Reports the maximum safe VBAT voltage permitted for the
212		  battery, during charging.
213
214		USB:
215
216		  Reports the maximum VBUS voltage the supply can support.
217
218		Access: Read
219
220		Valid values: Represented in microvolts
221
222What:		/sys/class/power_supply/<supply_name>/voltage_min,
223Date:		January 2008
224Contact:	linux-pm@vger.kernel.org
225Description:
226		Battery:
227
228		  Reports the minimum safe VBAT voltage permitted for the
229		  battery, during discharging.
230
231		USB:
232
233		  Reports the minimum VBUS voltage the supply can support.
234
235		Access: Read
236
237		Valid values: Represented in microvolts
238
239What:		/sys/class/power_supply/<supply_name>/voltage_now,
240Date:		May 2007
241Contact:	linux-pm@vger.kernel.org
242Description:
243		Battery:
244
245		  Reports an instant, single VBAT voltage reading for the
246		  battery. This value is not averaged/smoothed.
247
248		  Access: Read
249
250		USB:
251
252		  Reports the VBUS voltage supplied now. This value is generally
253		  read-only reporting, unless the 'online' state of the supply
254		  is set to be programmable, in which case this value can be set
255		  within the reported min/max range.
256
257		  Access: Read, Write
258
259		Valid values: Represented in microvolts
260
261**Battery Properties**
262
263What:		/sys/class/power_supply/<supply_name>/capacity
264Date:		May 2007
265Contact:	linux-pm@vger.kernel.org
266Description:
267		Fine grain representation of battery capacity.
268
269		Access: Read
270
271		Valid values: 0 - 100 (percent)
272
273What:		/sys/class/power_supply/<supply_name>/capacity_alert_max
274Date:		July 2012
275Contact:	linux-pm@vger.kernel.org
276Description:
277		Maximum battery capacity trip-wire value where the supply will
278		notify user-space of the event. This is normally used for the
279		battery discharging scenario where user-space needs to know the
280		battery has dropped to an upper level so it can take
281		appropriate action (e.g. warning user that battery level is
282		low).
283
284		Access: Read, Write
285
286		Valid values: 0 - 100 (percent)
287
288What:		/sys/class/power_supply/<supply_name>/capacity_alert_min
289Date:		July 2012
290Contact:	linux-pm@vger.kernel.org
291Description:
292		Minimum battery capacity trip-wire value where the supply will
293		notify user-space of the event. This is normally used for the
294		battery discharging scenario where user-space needs to know the
295		battery has dropped to a lower level so it can take
296		appropriate action (e.g. warning user that battery level is
297		critically low).
298
299		Access: Read, Write
300
301		Valid values: 0 - 100 (percent)
302
303What:		/sys/class/power_supply/<supply_name>/capacity_error_margin
304Date:		April 2019
305Contact:	linux-pm@vger.kernel.org
306Description:
307		Battery capacity measurement becomes unreliable without
308		recalibration. This values provides the maximum error
309		margin expected to exist by the fuel gauge in percent.
310		Values close to 0% will be returned after (re-)calibration
311		has happened. Over time the error margin will increase.
312		100% means, that the capacity related values are basically
313		completely useless.
314
315		Access: Read
316
317		Valid values: 0 - 100 (percent)
318
319What:		/sys/class/power_supply/<supply_name>/capacity_level
320Date:		June 2009
321Contact:	linux-pm@vger.kernel.org
322Description:
323		Coarse representation of battery capacity.
324
325		Access: Read
326
327		Valid values:
328			      "Unknown", "Critical", "Low", "Normal", "High",
329			      "Full"
330
331What:		/sys/class/power_supply/<supply_name>/charge_control_limit
332Date:		Oct 2012
333Contact:	linux-pm@vger.kernel.org
334Description:
335		Maximum allowable charging current. Used for charge rate
336		throttling for thermal cooling or improving battery health.
337
338		Access: Read, Write
339
340		Valid values: Represented in microamps
341
342What:		/sys/class/power_supply/<supply_name>/charge_control_limit_max
343Date:		Oct 2012
344Contact:	linux-pm@vger.kernel.org
345Description:
346		Maximum legal value for the charge_control_limit property.
347
348		Access: Read
349
350		Valid values: Represented in microamps
351
352What:		/sys/class/power_supply/<supply_name>/charge_control_start_threshold
353Date:		April 2019
354Contact:	linux-pm@vger.kernel.org
355Description:
356		Represents a battery percentage level, below which charging will
357		begin.
358
359		Access: Read, Write
360		Valid values: 0 - 100 (percent)
361
362What:		/sys/class/power_supply/<supply_name>/charge_control_end_threshold
363Date:		April 2019
364Contact:	linux-pm@vger.kernel.org
365Description:
366		Represents a battery percentage level, above which charging will
367		stop. Not all hardware is capable of setting this to an arbitrary
368		percentage. Drivers will round written values to the nearest
369		supported value. Reading back the value will show the actual
370		threshold set by the driver.
371
372		Access: Read, Write
373
374		Valid values: 0 - 100 (percent)
375
376What:		/sys/class/power_supply/<supply_name>/charge_type
377Date:		July 2009
378Contact:	linux-pm@vger.kernel.org
379Description:
380		Select the charging algorithm to use for a battery.
381
382		Standard:
383			Fully charge the battery at a moderate rate.
384		Fast:
385			Quickly charge the battery using fast-charge
386			technology. This is typically harder on the battery
387			than standard charging and may lower its lifespan.
388		Trickle:
389			Users who primarily operate the system while
390			plugged into an external power source can extend
391			battery life with this mode. Vendor tooling may
392			call this "Primarily AC Use".
393		Adaptive:
394			Automatically optimize battery charge rate based
395			on typical usage pattern.
396		Custom:
397			Use the charge_control_* properties to determine
398			when to start and stop charging. Advanced users
399			can use this to drastically extend battery life.
400		Long Life:
401			The charger reduces its charging rate in order to
402			prolong the battery health.
403		Bypass:
404			The charger bypasses the charging path around the
405			integrated converter allowing for a "smart" wall
406			adaptor to perform the power conversion externally.
407
408		Access: Read, Write
409
410		Reading this returns the current active value, e.g. 'Standard'.
411		Check charge_types to get the values supported by the battery.
412
413		Valid values:
414			      "Unknown", "N/A", "Trickle", "Fast", "Standard",
415			      "Adaptive", "Custom", "Long Life", "Bypass"
416
417What:		/sys/class/power_supply/<supply_name>/charge_types
418Date:		December 2024
419Contact:	linux-pm@vger.kernel.org
420Description:
421		Identical to charge_type but reading returns a list of supported
422		charge-types with the currently active type surrounded by square
423		brackets, e.g.: "Fast [Standard] Long_Life".
424
425		power_supply class devices may support both charge_type and
426		charge_types for backward compatibility. In this case both will
427		always have the same active value and the active value can be
428		changed by writing either property.
429
430		Note charge-types which contain a space such as "Long Life" will
431		have the space replaced by a '_' resulting in e.g. "Long_Life".
432		When writing charge-types both variants are accepted.
433
434What:		/sys/class/power_supply/<supply_name>/charge_term_current
435Date:		July 2014
436Contact:	linux-pm@vger.kernel.org
437Description:
438		Reports the charging current value which is used to determine
439		when the battery is considered full and charging should end.
440
441		Access: Read
442
443		Valid values: Represented in microamps
444
445What:		/sys/class/power_supply/<supply_name>/health
446Date:		May 2007
447Contact:	linux-pm@vger.kernel.org
448Description:
449		Reports the health of the battery or battery side of charger
450		functionality.
451
452		Access: Read
453
454		Valid values:
455			      "Unknown", "Good", "Overheat", "Dead",
456			      "Over voltage", "Under voltage", "Unspecified failure", "Cold",
457			      "Watchdog timer expire", "Safety timer expire",
458			      "Over current", "Calibration required", "Warm",
459			      "Cool", "Hot", "No battery", "Blown fuse", "Cell imbalance"
460
461What:		/sys/class/power_supply/<supply_name>/precharge_current
462Date:		June 2017
463Contact:	linux-pm@vger.kernel.org
464Description:
465		Reports the charging current applied during pre-charging phase
466		for a battery charge cycle.
467
468		Access: Read
469
470		Valid values: Represented in microamps
471
472What:		/sys/class/power_supply/<supply_name>/present
473Date:		May 2007
474Contact:	linux-pm@vger.kernel.org
475Description:
476		Reports whether a battery is present or not in the system. If the
477		property does not exist, the battery is considered to be present.
478
479		Access: Read
480
481		Valid values:
482
483			== =======
484			0: Absent
485			1: Present
486			== =======
487
488What:		/sys/class/power_supply/<supply_name>/status
489Date:		May 2007
490Contact:	linux-pm@vger.kernel.org
491Description:
492		Represents the charging status of the battery. Normally this
493		is read-only reporting although for some supplies this can be
494		used to enable/disable charging to the battery.
495
496		Access: Read, Write
497
498		Valid values:
499			      "Unknown", "Charging", "Discharging",
500			      "Not charging", "Full"
501
502What:		/sys/class/power_supply/<supply_name>/charge_behaviour
503Date:		November 2021
504Contact:	linux-pm@vger.kernel.org
505Description:
506		Represents the charging behaviour.
507
508		Access: Read, Write
509
510		Valid values:
511			===================== ========================================
512			auto:                 Charge normally, respect thresholds
513			inhibit-charge:       Do not charge while AC is attached
514			inhibit-charge-awake: inhibit-charge only when device is awake
515			force-discharge:      Force discharge while AC is attached
516			===================== ========================================
517
518What:		/sys/class/power_supply/<supply_name>/technology
519Date:		May 2007
520Contact:	linux-pm@vger.kernel.org
521Description:
522		Describes the battery technology supported by the supply.
523
524		Access: Read
525
526		Valid values:
527			      "Unknown", "NiMH", "Li-ion", "Li-poly", "LiFe",
528			      "NiCd", "LiMn"
529
530
531What:		/sys/class/power_supply/<supply_name>/voltage_avg,
532Date:		May 2007
533Contact:	linux-pm@vger.kernel.org
534Description:
535		Reports an average VBAT voltage reading for the battery, over a
536		fixed period. Normally devices will provide a fixed interval in
537		which they average readings to smooth out the reported value.
538
539		Access: Read
540
541		Valid values: Represented in microvolts
542
543What:		/sys/class/power_supply/<supply_name>/cycle_count
544Date:		January 2010
545Contact:	linux-pm@vger.kernel.org
546Description:
547		Reports the number of full charge + discharge cycles the
548		battery has undergone.
549
550		Access: Read
551
552		Valid values:
553			Integer > 0: representing full cycles
554			Integer = 0: cycle_count info is not available
555
556What:		/sys/class/power_supply/<supply_name>/internal_resistance
557Date:		August 2025
558Contact:	linux-arm-msm@vger.kernel.org
559Description:
560		Represent the battery's internal resistance, often referred
561		to as Equivalent Series Resistance (ESR). It is a dynamic
562		parameter that reflects the opposition to current flow within
563		the cell. It is not a fixed value but varies significantly
564		based on several operational conditions, including battery
565		state of charge (SoC), temperature, and whether the battery
566		is in a charging or discharging state.
567
568		Access: Read
569
570		Valid values: Represented in microohms
571
572What:		/sys/class/power_supply/<supply_name>/state_of_health
573Date:		August 2025
574Contact:	linux-arm-msm@vger.kernel.org
575Description:
576		The state_of_health parameter quantifies the overall condition
577		of a battery as a percentage, reflecting its ability to deliver
578		rated performance relative to its original specifications. It is
579		dynamically computed using a combination of learned capacity
580		and impedance-based degradation indicators, both of which evolve
581		over the battery's lifecycle.
582		Note that the exact algorithms are kept secret by most battery
583		vendors and the value from different battery vendors cannot be
584		compared with each other as there is no vendor-agnostic definition
585		of "performance". Also this usually cannot be used for any
586		calculations (i.e. this is not the factor between charge_full and
587		charge_full_design).
588
589		Access: Read
590
591		Valid values: 0 - 100 (percent)
592
593**USB Properties**
594
595What:		/sys/class/power_supply/<supply_name>/input_current_limit
596Date:		July 2014
597Contact:	linux-pm@vger.kernel.org
598Description:
599		Details the incoming IBUS current limit currently set in the
600		supply. Normally this is configured based on the type of
601		connection made (e.g. A configured SDP should output a maximum
602		of 500mA so the input current limit is set to the same value).
603		Use preferably input_power_limit, and for problems that can be
604		solved using power limit use input_current_limit.
605
606		Access: Read, Write
607
608		Valid values: Represented in microamps
609
610What:		/sys/class/power_supply/<supply_name>/input_voltage_limit
611Date:		May 2019
612Contact:	linux-pm@vger.kernel.org
613Description:
614		This entry configures the incoming VBUS voltage limit currently
615		set in the supply. Normally this is configured based on
616		system-level knowledge or user input (e.g. This is part of the
617		Pixel C's thermal management strategy to effectively limit the
618		input power to 5V when the screen is on to meet Google's skin
619		temperature targets). Note that this feature should not be
620		used for safety critical things.
621		Use preferably input_power_limit, and for problems that can be
622		solved using power limit use input_voltage_limit.
623
624		Access: Read, Write
625
626		Valid values: Represented in microvolts
627
628What:		/sys/class/power_supply/<supply_name>/input_power_limit
629Date:		May 2019
630Contact:	linux-pm@vger.kernel.org
631Description:
632		This entry configures the incoming power limit currently set
633		in the supply. Normally this is configured based on
634		system-level knowledge or user input. Use preferably this
635		feature to limit the incoming power and use current/voltage
636		limit only for problems that can be solved using power limit.
637
638		Access: Read, Write
639
640		Valid values: Represented in microwatts
641
642What:		/sys/class/power_supply/<supply_name>/online,
643Date:		May 2007
644Contact:	linux-pm@vger.kernel.org
645Description:
646		Indicates if VBUS is present for the supply. When the supply is
647		online, and the supply allows it, then it's possible to switch
648		between online states (e.g. Fixed -> Programmable for a PD_PPS
649		USB supply so voltage and current can be controlled).
650
651		Access: Read, Write
652
653		Valid values:
654
655			== ==================================================
656			0: Offline
657			1: Online Fixed - Fixed Voltage Supply
658			2: Online Programmable - Programmable Voltage Supply
659			== ==================================================
660
661What: 		/sys/class/power_supply/<supply_name>/usb_type
662Date:		March 2018
663Contact:	linux-pm@vger.kernel.org
664Description:
665		Reports what type of USB connection is currently active for
666		the supply, for example it can show if USB-PD capable source
667		is attached.
668
669		Access: For power-supplies which consume USB power such
670		as battery charger chips, this indicates the type of
671		the connected USB power source and is Read-Only.
672
673		For power-supplies which act as a USB power-source such as
674		e.g. the UCS1002 USB Port Power Controller this is writable.
675
676		Valid values:
677			      "Unknown", "SDP", "DCP", "CDP", "ACA", "C", "PD",
678			      "PD_DRP", "PD_PPS", "BrickID", "PD_SPR_AVS",
679			      "PD_PPS_SPR_AVS"
680
681**Device Specific Properties**
682
683What:		/sys/class/power/ds2760-battery.*/charge_now
684Date:		May 2010
685KernelVersion:	2.6.35
686Contact:	Daniel Mack <daniel@caiaq.de>
687Description:
688		This file is writeable and can be used to set the current
689		coloumb counter value inside the battery monitor chip. This
690		is needed for unavoidable corrections of aging batteries.
691		A userspace daemon can monitor the battery charging logic
692		and once the counter drops out of considerable bounds, take
693		appropriate action.
694
695What:		/sys/class/power/ds2760-battery.*/charge_full
696Date:		May 2010
697KernelVersion:	2.6.35
698Contact:	Daniel Mack <daniel@caiaq.de>
699Description:
700		This file is writeable and can be used to set the assumed
701		battery 'full level'. As batteries age, this value has to be
702		amended over time.
703
704What:		/sys/class/power_supply/max14577-charger/device/fast_charge_timer
705Date:		October 2014
706KernelVersion:	3.18.0
707Contact:	Krzysztof Kozlowski <krzk@kernel.org>
708Description:
709		This entry shows and sets the maximum time the max14577
710		charger operates in fast-charge mode. When the timer expires
711		the device will terminate fast-charge mode (charging current
712		will drop to 0 A) and will trigger interrupt.
713
714		Valid values:
715
716		- 5, 6 or 7 (hours),
717		- 0: disabled.
718
719What:		/sys/class/power_supply/max77693-charger/device/fast_charge_timer
720Date:		January 2015
721KernelVersion:	3.19.0
722Contact:	Krzysztof Kozlowski <krzk@kernel.org>
723Description:
724		This entry shows and sets the maximum time the max77693
725		charger operates in fast-charge mode. When the timer expires
726		the device will terminate fast-charge mode (charging current
727		will drop to 0 A) and will trigger interrupt.
728
729		Valid values:
730
731		- 4 - 16 (hours), step by 2 (rounded down)
732		- 0: disabled.
733
734What:		/sys/class/power_supply/max77693-charger/device/top_off_threshold_current
735Date:		January 2015
736KernelVersion:	3.19.0
737Contact:	Krzysztof Kozlowski <krzk@kernel.org>
738Description:
739		This entry shows and sets the charging current threshold for
740		entering top-off charging mode. When charging current in fast
741		charge mode drops below this value, the charger will trigger
742		interrupt and start top-off charging mode.
743
744		Valid values:
745
746		- 100000 - 200000 (microamps), step by 25000 (rounded down)
747		- 200000 - 350000 (microamps), step by 50000 (rounded down)
748		- 0: disabled.
749
750What:		/sys/class/power_supply/max77693-charger/device/top_off_timer
751Date:		January 2015
752KernelVersion:	3.19.0
753Contact:	Krzysztof Kozlowski <krzk@kernel.org>
754Description:
755		This entry shows and sets the maximum time the max77693
756		charger operates in top-off charge mode. When the timer expires
757		the device will terminate top-off charge mode (charging current
758		will drop to 0 A) and will trigger interrupt.
759
760		Valid values:
761
762		- 0 - 70 (minutes), step by 10 (rounded down)
763
764What:		/sys/class/power_supply/bq24257-charger/ovp_voltage
765Date:		October 2015
766KernelVersion:	4.4.0
767Contact:	Andreas Dannenberg <dannenberg@ti.com>
768Description:
769		This entry configures the overvoltage protection feature of bq24257-
770		type charger devices. This feature protects the device and other
771		components against damage from overvoltage on the input supply. See
772		device datasheet for details.
773
774		Valid values:
775
776		- 6000000, 6500000, 7000000, 8000000, 9000000, 9500000, 10000000,
777		  10500000 (all uV)
778
779What:		/sys/class/power_supply/bq24257-charger/in_dpm_voltage
780Date:		October 2015
781KernelVersion:	4.4.0
782Contact:	Andreas Dannenberg <dannenberg@ti.com>
783Description:
784		This entry configures the input dynamic power path management voltage of
785		bq24257-type charger devices. Once the supply drops to the configured
786		voltage, the input current limit is reduced down to prevent the further
787		drop of the supply. When the IC enters this mode, the charge current is
788		lower than the set value. See device datasheet for details.
789
790		Valid values:
791
792		- 4200000, 4280000, 4360000, 4440000, 4520000, 4600000, 4680000,
793		  4760000 (all uV)
794
795What:		/sys/class/power_supply/bq24257-charger/high_impedance_enable
796Date:		October 2015
797KernelVersion:	4.4.0
798Contact:	Andreas Dannenberg <dannenberg@ti.com>
799Description:
800		This entry allows enabling the high-impedance mode of bq24257-type
801		charger devices. If enabled, it places the charger IC into low power
802		standby mode with the switch mode controller disabled. When disabled,
803		the charger operates normally. See device datasheet for details.
804
805		Valid values:
806
807		- 1: enabled
808		- 0: disabled
809
810What:		/sys/class/power_supply/bq24257-charger/sysoff_enable
811Date:		October 2015
812KernelVersion:	4.4.0
813Contact:	Andreas Dannenberg <dannenberg@ti.com>
814Description:
815		This entry allows enabling the sysoff mode of bq24257-type charger
816		devices. If enabled and the input is removed, the internal battery FET
817		is turned off in order to reduce the leakage from the BAT pin to less
818		than 1uA. Note that on some devices/systems this disconnects the battery
819		from the system. See device datasheet for details.
820
821		Valid values:
822
823		- 1: enabled
824		- 0: disabled
825
826What:		/sys/class/power_supply/<supply_name>/manufacture_year
827Date:		January 2020
828Contact:	linux-pm@vger.kernel.org
829Description:
830		Reports the year (following Gregorian calendar) when the device has been
831		manufactured.
832
833		Access: Read
834
835		Valid values: Reported as integer
836
837What:		/sys/class/power_supply/<supply_name>/manufacture_month
838Date:		January 2020
839Contact:	linux-pm@vger.kernel.org
840Description:
841		Reports the month when the device has been manufactured.
842
843		Access: Read
844
845		Valid values: 1-12
846
847What:		/sys/class/power_supply/<supply_name>/manufacture_day
848Date:		January 2020
849Contact:	linux-pm@vger.kernel.org
850Description:
851		Reports the day of month when the device has been manufactured.
852
853		Access: Read
854		Valid values: 1-31
855
856What:		/sys/class/power_supply/<supply_name>/extensions/<extension_name>
857Date:		March 2025
858Contact:	linux-pm@vger.kernel.org
859Description:
860		Reports the extensions registered to the power supply.
861		Each entry is a link to the device which registered the extension.
862
863		Access: Read
864
865What:		/sys/class/power_supply/max8971-charger/fast_charge_timer
866Date:		May 2025
867KernelVersion:	6.15.0
868Contact:	Svyatoslav Ryhel <clamor95@gmail.com>
869Description:
870		This entry shows and sets the maximum time the max8971
871		charger operates in fast-charge mode. When the timer expires
872		the device will terminate fast-charge mode (charging current
873		will drop to 0 A) and will trigger interrupt.
874
875		Valid values:
876
877		- 4 - 10 (hours), step by 1
878		- 0: disabled.
879
880What:		/sys/class/power_supply/max8971-charger/top_off_threshold_current
881Date:		May 2025
882KernelVersion:	6.15.0
883Contact:	Svyatoslav Ryhel <clamor95@gmail.com>
884Description:
885		This entry shows and sets the charging current threshold for
886		entering top-off charging mode. When charging current in fast
887		charge mode drops below this value, the charger will trigger
888		interrupt and start top-off charging mode.
889
890		Valid values:
891
892		- 50000 - 200000 (microamps), step by 50000 (rounded down)
893
894What:		/sys/class/power_supply/max8971-charger/top_off_timer
895Date:		May 2025
896KernelVersion:	6.15.0
897Contact:	Svyatoslav Ryhel <clamor95@gmail.com>
898Description:
899		This entry shows and sets the maximum time the max8971
900		charger operates in top-off charge mode. When the timer expires
901		the device will terminate top-off charge mode (charging current
902		will drop to 0 A) and will trigger interrupt.
903
904		Valid values:
905
906		- 0 - 70 (minutes), step by 10 (rounded down)
907