1 **General Properties**
2
3 What: /sys/class/power_supply/<suppl
4 Date: May 2007
5 Contact: linux-pm@vger.kernel.org
6 Description:
7 Reports the name of the device
8
9 Access: Read
10 Valid values: Represented as s
11
12 What: /sys/class/power_supply/<suppl
13 Date: May 2007
14 Contact: linux-pm@vger.kernel.org
15 Description:
16 Reports the name of the device
17
18 Access: Read
19 Valid values: Represented as s
20
21 What: /sys/class/power_supply/<suppl
22 Date: January 2008
23 Contact: linux-pm@vger.kernel.org
24 Description:
25 Reports the serial number of t
26
27 Access: Read
28 Valid values: Represented as s
29
30 What: /sys/class/power_supply/<suppl
31 Date: May 2010
32 Contact: linux-pm@vger.kernel.org
33 Description:
34 Describes the main type of the
35
36 Access: Read
37 Valid values: "Battery", "UPS"
38
39 **Battery and USB properties**
40
41 What: /sys/class/power_supply/<suppl
42 Date: May 2007
43 Contact: linux-pm@vger.kernel.org
44 Description:
45 Battery:
46
47 Reports an average IBAT curr
48 a fixed period. Normally dev
49 in which they average readin
50 value.
51
52 USB:
53
54 Reports an average IBUS curr
55 Normally devices will provid
56 average readings to smooth o
57
58 Access: Read
59
60 Valid values: Represented in m
61 used for discharging batteries
62 batteries and for USB IBUS cur
63
64 What: /sys/class/power_supply/<suppl
65 Date: October 2010
66 Contact: linux-pm@vger.kernel.org
67 Description:
68 Battery:
69
70 Reports the maximum IBAT cur
71
72 USB:
73
74 Reports the maximum IBUS cur
75
76 Access: Read
77 Valid values: Represented in m
78
79 What: /sys/class/power_supply/<suppl
80 Date: May 2007
81 Contact: linux-pm@vger.kernel.org
82 Description:
83
84 Battery:
85
86 Reports an instant, single I
87 battery. This value is not a
88
89 Access: Read
90
91 USB:
92
93 Reports the IBUS current sup
94 read-only reporting, unless
95 is set to be programmable, i
96 within the reported min/max
97
98 Access: Read, Write
99
100 Valid values: Represented in m
101 used for discharging batteries
102 batteries and for USB IBUS cur
103
104 What: /sys/class/power_supply/<suppl
105 Date: May 2007
106 Contact: linux-pm@vger.kernel.org
107 Description:
108 Battery:
109
110 Reports the current TBAT bat
111
112 USB:
113
114 Reports the current supply t
115 normally be the internal tem
116 (e.g TJUNC temperature of an
117
118 Access: Read
119
120 Valid values: Represented in 1
121
122 What: /sys/class/power_supply/<suppl
123 Date: July 2012
124 Contact: linux-pm@vger.kernel.org
125 Description:
126 Battery:
127
128 Maximum TBAT temperature tri
129 notify user-space of the eve
130
131 USB:
132
133 Maximum supply temperature t
134 will notify user-space of th
135
136 This is normally used for the
137 user-space needs to know if th
138 upper threshold so it can take
139 user that the temperature is c
140 stopped).
141
142 Access: Read
143
144 Valid values: Represented in 1
145
146 What: /sys/class/power_supply/<suppl
147 Date: July 2012
148 Contact: linux-pm@vger.kernel.org
149 Description:
150
151 Battery:
152
153 Minimum TBAT temperature tri
154 notify user-space of the eve
155
156 USB:
157
158 Minimum supply temperature t
159 will notify user-space of th
160
161 This is normally used for the
162 needs to know if the temperatu
163 so it can take appropriate act
164 temperature level is high, and
165 reduced accordingly to remedy
166
167 Access: Read
168
169 Valid values: Represented in 1
170
171 What: /sys/class/power_supply/<suppl
172 Date: July 2014
173 Contact: linux-pm@vger.kernel.org
174 Description:
175 Battery:
176
177 Reports the maximum allowed
178 charging.
179
180 USB:
181
182 Reports the maximum allowed
183
184 Access: Read
185
186 Valid values: Represented in 1
187
188 What: /sys/class/power_supply/<suppl
189 Date: July 2014
190 Contact: linux-pm@vger.kernel.org
191 Description:
192 Battery:
193
194 Reports the minimum allowed
195 charging.
196
197 USB:
198
199 Reports the minimum allowed
200
201 Access: Read
202
203 Valid values: Represented in 1
204
205 What: /sys/class/power_supply/<suppl
206 Date: January 2008
207 Contact: linux-pm@vger.kernel.org
208 Description:
209 Battery:
210
211 Reports the maximum safe VBA
212 battery, during charging.
213
214 USB:
215
216 Reports the maximum VBUS vol
217
218 Access: Read
219
220 Valid values: Represented in m
221
222 What: /sys/class/power_supply/<suppl
223 Date: January 2008
224 Contact: linux-pm@vger.kernel.org
225 Description:
226 Battery:
227
228 Reports the minimum safe VBA
229 battery, during discharging.
230
231 USB:
232
233 Reports the minimum VBUS vol
234
235 Access: Read
236
237 Valid values: Represented in m
238
239 What: /sys/class/power_supply/<suppl
240 Date: May 2007
241 Contact: linux-pm@vger.kernel.org
242 Description:
243 Battery:
244
245 Reports an instant, single V
246 battery. This value is not a
247
248 Access: Read
249
250 USB:
251
252 Reports the VBUS voltage sup
253 read-only reporting, unless
254 is set to be programmable, i
255 within the reported min/max
256
257 Access: Read, Write
258
259 Valid values: Represented in m
260
261 **Battery Properties**
262
263 What: /sys/class/power_supply/<suppl
264 Date: May 2007
265 Contact: linux-pm@vger.kernel.org
266 Description:
267 Fine grain representation of b
268
269 Access: Read
270
271 Valid values: 0 - 100 (percent
272
273 What: /sys/class/power_supply/<suppl
274 Date: July 2012
275 Contact: linux-pm@vger.kernel.org
276 Description:
277 Maximum battery capacity trip-
278 notify user-space of the event
279 battery discharging scenario w
280 battery has dropped to an uppe
281 appropriate action (e.g. warni
282 low).
283
284 Access: Read, Write
285
286 Valid values: 0 - 100 (percent
287
288 What: /sys/class/power_supply/<suppl
289 Date: July 2012
290 Contact: linux-pm@vger.kernel.org
291 Description:
292 Minimum battery capacity trip-
293 notify user-space of the event
294 battery discharging scenario w
295 battery has dropped to a lower
296 appropriate action (e.g. warni
297 critically low).
298
299 Access: Read, Write
300
301 Valid values: 0 - 100 (percent
302
303 What: /sys/class/power_supply/<suppl
304 Date: April 2019
305 Contact: linux-pm@vger.kernel.org
306 Description:
307 Battery capacity measurement b
308 recalibration. This values pro
309 margin expected to exist by th
310 Values close to 0% will be ret
311 has happened. Over time the er
312 100% means, that the capacity
313 completely useless.
314
315 Access: Read
316
317 Valid values: 0 - 100 (percent
318
319 What: /sys/class/power_supply/<suppl
320 Date: June 2009
321 Contact: linux-pm@vger.kernel.org
322 Description:
323 Coarse representation of batte
324
325 Access: Read
326
327 Valid values:
328 "Unknown", "Crit
329 "Full"
330
331 What: /sys/class/power_supply/<suppl
332 Date: Oct 2012
333 Contact: linux-pm@vger.kernel.org
334 Description:
335 Maximum allowable charging cur
336 throttling for thermal cooling
337
338 Access: Read, Write
339
340 Valid values: Represented in m
341
342 What: /sys/class/power_supply/<suppl
343 Date: Oct 2012
344 Contact: linux-pm@vger.kernel.org
345 Description:
346 Maximum legal value for the ch
347
348 Access: Read
349
350 Valid values: Represented in m
351
352 What: /sys/class/power_supply/<suppl
353 Date: April 2019
354 Contact: linux-pm@vger.kernel.org
355 Description:
356 Represents a battery percentag
357 begin.
358
359 Access: Read, Write
360 Valid values: 0 - 100 (percent
361
362 What: /sys/class/power_supply/<suppl
363 Date: April 2019
364 Contact: linux-pm@vger.kernel.org
365 Description:
366 Represents a battery percentag
367 stop. Not all hardware is capa
368 percentage. Drivers will round
369 supported value. Reading back
370 threshold set by the driver.
371
372 Access: Read, Write
373
374 Valid values: 0 - 100 (percent
375
376 What: /sys/class/power_supply/<suppl
377 Date: July 2009
378 Contact: linux-pm@vger.kernel.org
379 Description:
380 Select the charging algorithm
381
382 Standard:
383 Fully charge the batte
384 Fast:
385 Quickly charge the bat
386 technology. This is ty
387 than standard charging
388 Trickle:
389 Users who primarily op
390 plugged into an extern
391 battery life with this
392 call this "Primarily A
393 Adaptive:
394 Automatically optimize
395 on typical usage patte
396 Custom:
397 Use the charge_control
398 when to start and stop
399 can use this to drasti
400 Long Life:
401 The charger reduces it
402 prolong the battery he
403 Bypass:
404 The charger bypasses t
405 integrated converter a
406 adaptor to perform the
407
408 Access: Read, Write
409
410 Valid values:
411 "Unknown", "N/A"
412 "Adaptive", "Cus
413
414 What: /sys/class/power_supply/<suppl
415 Date: July 2014
416 Contact: linux-pm@vger.kernel.org
417 Description:
418 Reports the charging current v
419 when the battery is considered
420
421 Access: Read
422
423 Valid values: Represented in m
424
425 What: /sys/class/power_supply/<suppl
426 Date: May 2007
427 Contact: linux-pm@vger.kernel.org
428 Description:
429 Reports the health of the batt
430 functionality.
431
432 Access: Read
433
434 Valid values:
435 "Unknown", "Good
436 "Over voltage",
437 "Watchdog timer
438 "Over current",
439 "Cool", "Hot", "
440
441 What: /sys/class/power_supply/<suppl
442 Date: June 2017
443 Contact: linux-pm@vger.kernel.org
444 Description:
445 Reports the charging current a
446 for a battery charge cycle.
447
448 Access: Read
449
450 Valid values: Represented in m
451
452 What: /sys/class/power_supply/<suppl
453 Date: May 2007
454 Contact: linux-pm@vger.kernel.org
455 Description:
456 Reports whether a battery is p
457 property does not exist, the b
458
459 Access: Read
460
461 Valid values:
462
463 == =======
464 0: Absent
465 1: Present
466 == =======
467
468 What: /sys/class/power_supply/<suppl
469 Date: May 2007
470 Contact: linux-pm@vger.kernel.org
471 Description:
472 Represents the charging status
473 is read-only reporting althoug
474 used to enable/disable chargin
475
476 Access: Read, Write
477
478 Valid values:
479 "Unknown", "Char
480 "Not charging",
481
482 What: /sys/class/power_supply/<suppl
483 Date: November 2021
484 Contact: linux-pm@vger.kernel.org
485 Description:
486 Represents the charging behavi
487
488 Access: Read, Write
489
490 Valid values:
491 ================ =====
492 auto: Charg
493 inhibit-charge: Do no
494 force-discharge: Force
495 ================ =====
496
497 What: /sys/class/power_supply/<suppl
498 Date: May 2007
499 Contact: linux-pm@vger.kernel.org
500 Description:
501 Describes the battery technolo
502
503 Access: Read
504
505 Valid values:
506 "Unknown", "NiMH
507 "NiCd", "LiMn"
508
509
510 What: /sys/class/power_supply/<suppl
511 Date: May 2007
512 Contact: linux-pm@vger.kernel.org
513 Description:
514 Reports an average VBAT voltag
515 fixed period. Normally devices
516 which they average readings to
517
518 Access: Read
519
520 Valid values: Represented in m
521
522 What: /sys/class/power_supply/<suppl
523 Date: January 2010
524 Contact: linux-pm@vger.kernel.org
525 Description:
526 Reports the number of full cha
527 battery has undergone.
528
529 Access: Read
530
531 Valid values:
532 Integer > 0: represent
533 Integer = 0: cycle_cou
534
535 **USB Properties**
536
537 What: /sys/class/power_supply/<suppl
538 Date: July 2014
539 Contact: linux-pm@vger.kernel.org
540 Description:
541 Details the incoming IBUS curr
542 supply. Normally this is confi
543 connection made (e.g. A config
544 of 500mA so the input current
545 Use preferably input_power_lim
546 solved using power limit use i
547
548 Access: Read, Write
549
550 Valid values: Represented in m
551
552 What: /sys/class/power_supply/<suppl
553 Date: May 2019
554 Contact: linux-pm@vger.kernel.org
555 Description:
556 This entry configures the inco
557 set in the supply. Normally th
558 system-level knowledge or user
559 Pixel C's thermal management s
560 input power to 5V when the scr
561 temperature targets). Note tha
562 used for safety critical thing
563 Use preferably input_power_lim
564 solved using power limit use i
565
566 Access: Read, Write
567
568 Valid values: Represented in m
569
570 What: /sys/class/power_supply/<suppl
571 Date: May 2019
572 Contact: linux-pm@vger.kernel.org
573 Description:
574 This entry configures the inco
575 in the supply. Normally this i
576 system-level knowledge or user
577 feature to limit the incoming
578 limit only for problems that c
579
580 Access: Read, Write
581
582 Valid values: Represented in m
583
584 What: /sys/class/power_supply/<suppl
585 Date: May 2007
586 Contact: linux-pm@vger.kernel.org
587 Description:
588 Indicates if VBUS is present f
589 online, and the supply allows
590 between online states (e.g. Fi
591 USB supply so voltage and curr
592
593 Access: Read, Write
594
595 Valid values:
596
597 == ===================
598 0: Offline
599 1: Online Fixed - Fixe
600 2: Online Programmable
601 == ===================
602
603 What: /sys/class/power_supply/<suppl
604 Date: March 2018
605 Contact: linux-pm@vger.kernel.org
606 Description:
607 Reports what type of USB conne
608 the supply, for example it can
609 is attached.
610
611 Access: For power-supplies whi
612 as battery charger chips, this
613 the connected USB power source
614
615 For power-supplies which act a
616 e.g. the UCS1002 USB Port Powe
617
618 Valid values:
619 "Unknown", "SDP"
620 "PD_DRP", "PD_PP
621
622 **Device Specific Properties**
623
624 What: /sys/class/power/ds2760-batter
625 Date: May 2010
626 KernelVersion: 2.6.35
627 Contact: Daniel Mack <daniel@caiaq.de>
628 Description:
629 This file is writeable and can
630 coloumb counter value inside t
631 is needed for unavoidable corr
632 A userspace daemon can monitor
633 and once the counter drops out
634 appropriate action.
635
636 What: /sys/class/power/ds2760-batter
637 Date: May 2010
638 KernelVersion: 2.6.35
639 Contact: Daniel Mack <daniel@caiaq.de>
640 Description:
641 This file is writeable and can
642 battery 'full level'. As batte
643 amended over time.
644
645 What: /sys/class/power_supply/max145
646 Date: October 2014
647 KernelVersion: 3.18.0
648 Contact: Krzysztof Kozlowski <krzk@kerne
649 Description:
650 This entry shows and sets the
651 charger operates in fast-charg
652 the device will terminate fast
653 will drop to 0 A) and will tri
654
655 Valid values:
656
657 - 5, 6 or 7 (hours),
658 - 0: disabled.
659
660 What: /sys/class/power_supply/max776
661 Date: January 2015
662 KernelVersion: 3.19.0
663 Contact: Krzysztof Kozlowski <krzk@kerne
664 Description:
665 This entry shows and sets the
666 charger operates in fast-charg
667 the device will terminate fast
668 will drop to 0 A) and will tri
669
670 Valid values:
671
672 - 4 - 16 (hours), step by 2 (r
673 - 0: disabled.
674
675 What: /sys/class/power_supply/max776
676 Date: January 2015
677 KernelVersion: 3.19.0
678 Contact: Krzysztof Kozlowski <krzk@kerne
679 Description:
680 This entry shows and sets the
681 entering top-off charging mode
682 charge mode drops below this v
683 interrupt and start top-off ch
684
685 Valid values:
686
687 - 100000 - 200000 (microamps),
688 - 200000 - 350000 (microamps),
689 - 0: disabled.
690
691 What: /sys/class/power_supply/max776
692 Date: January 2015
693 KernelVersion: 3.19.0
694 Contact: Krzysztof Kozlowski <krzk@kerne
695 Description:
696 This entry shows and sets the
697 charger operates in top-off ch
698 the device will terminate top-
699 will drop to 0 A) and will tri
700
701 Valid values:
702
703 - 0 - 70 (minutes), step by 10
704
705 What: /sys/class/power_supply/bq2425
706 Date: October 2015
707 KernelVersion: 4.4.0
708 Contact: Andreas Dannenberg <dannenberg@
709 Description:
710 This entry configures the over
711 type charger devices. This fea
712 components against damage from
713 device datasheet for details.
714
715 Valid values:
716
717 - 6000000, 6500000, 7000000, 8
718 10500000 (all uV)
719
720 What: /sys/class/power_supply/bq2425
721 Date: October 2015
722 KernelVersion: 4.4.0
723 Contact: Andreas Dannenberg <dannenberg@
724 Description:
725 This entry configures the inpu
726 bq24257-type charger devices.
727 voltage, the input current lim
728 drop of the supply. When the I
729 lower than the set value. See
730
731 Valid values:
732
733 - 4200000, 4280000, 4360000, 4
734 4760000 (all uV)
735
736 What: /sys/class/power_supply/bq2425
737 Date: October 2015
738 KernelVersion: 4.4.0
739 Contact: Andreas Dannenberg <dannenberg@
740 Description:
741 This entry allows enabling the
742 charger devices. If enabled, i
743 standby mode with the switch m
744 the charger operates normally.
745
746 Valid values:
747
748 - 1: enabled
749 - 0: disabled
750
751 What: /sys/class/power_supply/bq2425
752 Date: October 2015
753 KernelVersion: 4.4.0
754 Contact: Andreas Dannenberg <dannenberg@
755 Description:
756 This entry allows enabling the
757 devices. If enabled and the in
758 is turned off in order to redu
759 than 1uA. Note that on some de
760 from the system. See device da
761
762 Valid values:
763
764 - 1: enabled
765 - 0: disabled
766
767 What: /sys/class/power_supply/<suppl
768 Date: January 2020
769 Contact: linux-pm@vger.kernel.org
770 Description:
771 Reports the year (following Gr
772 manufactured.
773
774 Access: Read
775
776 Valid values: Reported as inte
777
778 What: /sys/class/power_supply/<suppl
779 Date: January 2020
780 Contact: linux-pm@vger.kernel.org
781 Description:
782 Reports the month when the dev
783
784 Access: Read
785
786 Valid values: 1-12
787
788 What: /sys/class/power_supply/<suppl
789 Date: January 2020
790 Contact: linux-pm@vger.kernel.org
791 Description:
792 Reports the day of month when
793
794 Access: Read
795 Valid values: 1-31
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.