요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
Battery and USB current
sysfs-class-power:39-102Battery IBAT와 USB IBUS의 average·maximum·instant current, sign와 read/write 차이를 설명합니다.
Temperature and voltage bounds
sysfs-class-power:104-259TBAT·supply temperature, alert·operation threshold와 VBAT·VBUS minimum·maximum·instant voltage를 제공합니다.
Battery capacity
sysfs-class-power:261-329Fine-grained percentage, alert threshold, fuel-gauge error margin과 coarse capacity level을 구분합니다.
Charge control and algorithms
sysfs-class-power:331-443Charge current limit·start/end threshold, algorithm 선택·지원 목록과 full 판정 termination current를 설명합니다.
Battery health and state
sysfs-class-power:445-528Health, precharge current, present·status, charge behaviour와 battery chemistry를 제공합니다.
Battery lifecycle metrics
sysfs-class-power:531-591Average voltage, full cycle count, dynamic ESR과 vendor-specific state of health percentage를 설명합니다.
USB input limits and type
sysfs-class-power:593-678IBUS·VBUS·power limit, fixed·programmable online state와 active USB source type을 제공합니다.
DS2760 and MAX charger controls
sysfs-class-power:680-761DS2760 aging correction과 MAX14577·MAX77693 fast-charge·top-off timer 및 current threshold를 설명합니다.
BQ24257 charger controls
sysfs-class-power:763-823Input overvoltage protection, dynamic power path voltage, high-impedance와 system-off mode를 제어합니다.
Manufacture date and extensions
sysfs-class-power:825-862Gregorian manufacture date와 power supply에 등록된 extension device link를 제공합니다.
MAX8971 charger controls
sysfs-class-power:864-905MAX8971 fast-charge timer, top-off 진입 current와 top-off timer를 구성합니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
1
**General Properties**
3
What: /sys/class/power_supply/<supply_name>/manufacturer
4
Date: May 2007
5
Contact: linux-pm@vger.kernel.org
6
Description:
7
Reports the name of the device manufacturer.
9
Access: Read
10
Valid values: Represented as string
12
What: /sys/class/power_supply/<supply_name>/model_name
13
Date: May 2007
14
Contact: linux-pm@vger.kernel.org
15
Description:
16
Reports the name of the device model.
18
Access: Read
19
Valid values: Represented as string
21
What: /sys/class/power_supply/<supply_name>/serial_number
22
Date: January 2008
23
Contact: linux-pm@vger.kernel.org
24
Description:
25
Reports the serial number of the device.
27
Access: Read
28
Valid values: Represented as string
30
What: /sys/class/power_supply/<supply_name>/type
31
Date: May 2010
32
Contact: linux-pm@vger.kernel.org
33
Description:
34
Describes the main type of the supply.
36
Access: Read
37
Valid values: "Battery", "UPS", "Mains", "USB", "Wireless"
39
**Battery and USB properties**
41
What: /sys/class/power_supply/<supply_name>/current_avg
42
Date: May 2007
43
Contact: linux-pm@vger.kernel.org
44
Description:
45
Battery:
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.
52
USB:
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.
58
Access: Read
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.
64
What: /sys/class/power_supply/<supply_name>/current_max
65
Date: October 2010
66
Contact: linux-pm@vger.kernel.org
67
Description:
68
Battery:
70
Reports the maximum IBAT current allowed into the battery.
72
USB:
74
Reports the maximum IBUS current the supply can support.
76
Access: Read
77
Valid values: Represented in microamps
79
What: /sys/class/power_supply/<supply_name>/current_now
80
Date: May 2007
81
Contact: linux-pm@vger.kernel.org
82
Description:
84
Battery:
86
Reports an instant, single IBAT current reading for the
87
battery. This value is not averaged/smoothed.
89
Access: Read
91
USB:
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.
98
Access: Read, Write
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.
104
What: /sys/class/power_supply/<supply_name>/temp
105
Date: May 2007
106
Contact: linux-pm@vger.kernel.org
107
Description:
108
Battery:
110
Reports the current TBAT battery temperature reading.
112
USB:
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)
118
Access: Read
120
Valid values: Represented in 1/10 Degrees Celsius
122
What: /sys/class/power_supply/<supply_name>/temp_alert_max
123
Date: July 2012
124
Contact: linux-pm@vger.kernel.org
125
Description:
126
Battery:
128
Maximum TBAT temperature trip-wire value where the supply will
129
notify user-space of the event.
131
USB:
133
Maximum supply temperature trip-wire value where the supply
134
will notify user-space of the event.
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).
142
Access: Read
144
Valid values: Represented in 1/10 Degrees Celsius
146
What: /sys/class/power_supply/<supply_name>/temp_alert_min
147
Date: July 2012
148
Contact: linux-pm@vger.kernel.org
149
Description:
151
Battery:
153
Minimum TBAT temperature trip-wire value where the supply will
154
notify user-space of the event.
156
USB:
158
Minimum supply temperature trip-wire value where the supply
159
will notify user-space of the event.
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).
167
Access: Read
169
Valid values: Represented in 1/10 Degrees Celsius
171
What: /sys/class/power_supply/<supply_name>/temp_max
172
Date: July 2014
173
Contact: linux-pm@vger.kernel.org
174
Description:
175
Battery:
177
Reports the maximum allowed TBAT battery temperature for
178
charging.
180
USB:
182
Reports the maximum allowed supply temperature for operation.
184
Access: Read
186
Valid values: Represented in 1/10 Degrees Celsius
188
What: /sys/class/power_supply/<supply_name>/temp_min
189
Date: July 2014
190
Contact: linux-pm@vger.kernel.org
191
Description:
192
Battery:
194
Reports the minimum allowed TBAT battery temperature for
195
charging.
197
USB:
199
Reports the minimum allowed supply temperature for operation.
201
Access: Read
203
Valid values: Represented in 1/10 Degrees Celsius
205
What: /sys/class/power_supply/<supply_name>/voltage_max,
206
Date: January 2008
207
Contact: linux-pm@vger.kernel.org
208
Description:
209
Battery:
211
Reports the maximum safe VBAT voltage permitted for the
212
battery, during charging.
214
USB:
216
Reports the maximum VBUS voltage the supply can support.
218
Access: Read
220
Valid values: Represented in microvolts
222
What: /sys/class/power_supply/<supply_name>/voltage_min,
223
Date: January 2008
224
Contact: linux-pm@vger.kernel.org
225
Description:
226
Battery:
228
Reports the minimum safe VBAT voltage permitted for the
229
battery, during discharging.
231
USB:
233
Reports the minimum VBUS voltage the supply can support.
235
Access: Read
237
Valid values: Represented in microvolts
239
What: /sys/class/power_supply/<supply_name>/voltage_now,
240
Date: May 2007
241
Contact: linux-pm@vger.kernel.org
242
Description:
243
Battery:
245
Reports an instant, single VBAT voltage reading for the
246
battery. This value is not averaged/smoothed.
248
Access: Read
250
USB:
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.
257
Access: Read, Write
259
Valid values: Represented in microvolts
261
**Battery Properties**
263
What: /sys/class/power_supply/<supply_name>/capacity
264
Date: May 2007
265
Contact: linux-pm@vger.kernel.org
266
Description:
267
Fine grain representation of battery capacity.
269
Access: Read
271
Valid values: 0 - 100 (percent)
273
What: /sys/class/power_supply/<supply_name>/capacity_alert_max
274
Date: July 2012
275
Contact: linux-pm@vger.kernel.org
276
Description:
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).
284
Access: Read, Write
286
Valid values: 0 - 100 (percent)
288
What: /sys/class/power_supply/<supply_name>/capacity_alert_min
289
Date: July 2012
290
Contact: linux-pm@vger.kernel.org
291
Description:
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).
299
Access: Read, Write
301
Valid values: 0 - 100 (percent)
303
What: /sys/class/power_supply/<supply_name>/capacity_error_margin
304
Date: April 2019
305
Contact: linux-pm@vger.kernel.org
306
Description:
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.
315
Access: Read
317
Valid values: 0 - 100 (percent)
319
What: /sys/class/power_supply/<supply_name>/capacity_level
320
Date: June 2009
321
Contact: linux-pm@vger.kernel.org
322
Description:
323
Coarse representation of battery capacity.
325
Access: Read
327
Valid values:
328
"Unknown", "Critical", "Low", "Normal", "High",
329
"Full"
331
What: /sys/class/power_supply/<supply_name>/charge_control_limit
332
Date: Oct 2012
333
Contact: linux-pm@vger.kernel.org
334
Description:
335
Maximum allowable charging current. Used for charge rate
336
throttling for thermal cooling or improving battery health.
338
Access: Read, Write
340
Valid values: Represented in microamps
342
What: /sys/class/power_supply/<supply_name>/charge_control_limit_max
343
Date: Oct 2012
344
Contact: linux-pm@vger.kernel.org
345
Description:
346
Maximum legal value for the charge_control_limit property.
348
Access: Read
350
Valid values: Represented in microamps
352
What: /sys/class/power_supply/<supply_name>/charge_control_start_threshold
353
Date: April 2019
354
Contact: linux-pm@vger.kernel.org
355
Description:
356
Represents a battery percentage level, below which charging will
357
begin.
359
Access: Read, Write
360
Valid values: 0 - 100 (percent)
362
What: /sys/class/power_supply/<supply_name>/charge_control_end_threshold
363
Date: April 2019
364
Contact: linux-pm@vger.kernel.org
365
Description:
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.
372
Access: Read, Write
374
Valid values: 0 - 100 (percent)
376
What: /sys/class/power_supply/<supply_name>/charge_type
377
Date: July 2009
378
Contact: linux-pm@vger.kernel.org
379
Description:
380
Select the charging algorithm to use for a battery.
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.
408
Access: Read, Write
410
Reading this returns the current active value, e.g. 'Standard'.
411
Check charge_types to get the values supported by the battery.
413
Valid values:
414
"Unknown", "N/A", "Trickle", "Fast", "Standard",
415
"Adaptive", "Custom", "Long Life", "Bypass"
417
What: /sys/class/power_supply/<supply_name>/charge_types
418
Date: December 2024
419
Contact: linux-pm@vger.kernel.org
420
Description:
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".
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.
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.
434
What: /sys/class/power_supply/<supply_name>/charge_term_current
435
Date: July 2014
436
Contact: linux-pm@vger.kernel.org
437
Description:
438
Reports the charging current value which is used to determine
439
when the battery is considered full and charging should end.
441
Access: Read
443
Valid values: Represented in microamps
445
What: /sys/class/power_supply/<supply_name>/health
446
Date: May 2007
447
Contact: linux-pm@vger.kernel.org
448
Description:
449
Reports the health of the battery or battery side of charger
450
functionality.
452
Access: Read
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"
461
What: /sys/class/power_supply/<supply_name>/precharge_current
462
Date: June 2017
463
Contact: linux-pm@vger.kernel.org
464
Description:
465
Reports the charging current applied during pre-charging phase
466
for a battery charge cycle.
468
Access: Read
470
Valid values: Represented in microamps
472
What: /sys/class/power_supply/<supply_name>/present
473
Date: May 2007
474
Contact: linux-pm@vger.kernel.org
475
Description:
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.
479
Access: Read
481
Valid values:
483
== =======
484
0: Absent
485
1: Present
486
== =======
488
What: /sys/class/power_supply/<supply_name>/status
489
Date: May 2007
490
Contact: linux-pm@vger.kernel.org
491
Description:
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.
496
Access: Read, Write
498
Valid values:
499
"Unknown", "Charging", "Discharging",
500
"Not charging", "Full"
502
What: /sys/class/power_supply/<supply_name>/charge_behaviour
503
Date: November 2021
504
Contact: linux-pm@vger.kernel.org
505
Description:
506
Represents the charging behaviour.
508
Access: Read, Write
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
===================== ========================================
518
What: /sys/class/power_supply/<supply_name>/technology
519
Date: May 2007
520
Contact: linux-pm@vger.kernel.org
521
Description:
522
Describes the battery technology supported by the supply.
524
Access: Read
526
Valid values:
527
"Unknown", "NiMH", "Li-ion", "Li-poly", "LiFe",
528
"NiCd", "LiMn"
531
What: /sys/class/power_supply/<supply_name>/voltage_avg,
532
Date: May 2007
533
Contact: linux-pm@vger.kernel.org
534
Description:
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.
539
Access: Read
541
Valid values: Represented in microvolts
543
What: /sys/class/power_supply/<supply_name>/cycle_count
544
Date: January 2010
545
Contact: linux-pm@vger.kernel.org
546
Description:
547
Reports the number of full charge + discharge cycles the
548
battery has undergone.
550
Access: Read
552
Valid values:
553
Integer > 0: representing full cycles
554
Integer = 0: cycle_count info is not available
556
What: /sys/class/power_supply/<supply_name>/internal_resistance
557
Date: August 2025
558
Contact: linux-arm-msm@vger.kernel.org
559
Description:
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.
568
Access: Read
570
Valid values: Represented in microohms
572
What: /sys/class/power_supply/<supply_name>/state_of_health
573
Date: August 2025
574
Contact: linux-arm-msm@vger.kernel.org
575
Description:
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).
589
Access: Read
591
Valid values: 0 - 100 (percent)
593
**USB Properties**
595
What: /sys/class/power_supply/<supply_name>/input_current_limit
596
Date: July 2014
597
Contact: linux-pm@vger.kernel.org
598
Description:
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.
606
Access: Read, Write
608
Valid values: Represented in microamps
610
What: /sys/class/power_supply/<supply_name>/input_voltage_limit
611
Date: May 2019
612
Contact: linux-pm@vger.kernel.org
613
Description:
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.
624
Access: Read, Write
626
Valid values: Represented in microvolts
628
What: /sys/class/power_supply/<supply_name>/input_power_limit
629
Date: May 2019
630
Contact: linux-pm@vger.kernel.org
631
Description:
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.
638
Access: Read, Write
640
Valid values: Represented in microwatts
642
What: /sys/class/power_supply/<supply_name>/online,
643
Date: May 2007
644
Contact: linux-pm@vger.kernel.org
645
Description:
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).
651
Access: Read, Write
653
Valid values:
655
== ==================================================
656
0: Offline
657
1: Online Fixed - Fixed Voltage Supply
658
2: Online Programmable - Programmable Voltage Supply
659
== ==================================================
661
What: /sys/class/power_supply/<supply_name>/usb_type
662
Date: March 2018
663
Contact: linux-pm@vger.kernel.org
664
Description:
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.
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.
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.
676
Valid values:
677
"Unknown", "SDP", "DCP", "CDP", "ACA", "C", "PD",
678
"PD_DRP", "PD_PPS", "BrickID"
680
**Device Specific Properties**
682
What: /sys/class/power/ds2760-battery.*/charge_now
683
Date: May 2010
684
KernelVersion: 2.6.35
685
Contact: Daniel Mack <daniel@caiaq.de>
686
Description:
687
This file is writeable and can be used to set the current
688
coloumb counter value inside the battery monitor chip. This
689
is needed for unavoidable corrections of aging batteries.
690
A userspace daemon can monitor the battery charging logic
691
and once the counter drops out of considerable bounds, take
692
appropriate action.
694
What: /sys/class/power/ds2760-battery.*/charge_full
695
Date: May 2010
696
KernelVersion: 2.6.35
697
Contact: Daniel Mack <daniel@caiaq.de>
698
Description:
699
This file is writeable and can be used to set the assumed
700
battery 'full level'. As batteries age, this value has to be
701
amended over time.
703
What: /sys/class/power_supply/max14577-charger/device/fast_charge_timer
704
Date: October 2014
705
KernelVersion: 3.18.0
706
Contact: Krzysztof Kozlowski <krzk@kernel.org>
707
Description:
708
This entry shows and sets the maximum time the max14577
709
charger operates in fast-charge mode. When the timer expires
710
the device will terminate fast-charge mode (charging current
711
will drop to 0 A) and will trigger interrupt.
713
Valid values:
715
- 5, 6 or 7 (hours),
716
- 0: disabled.
718
What: /sys/class/power_supply/max77693-charger/device/fast_charge_timer
719
Date: January 2015
720
KernelVersion: 3.19.0
721
Contact: Krzysztof Kozlowski <krzk@kernel.org>
722
Description:
723
This entry shows and sets the maximum time the max77693
724
charger operates in fast-charge mode. When the timer expires
725
the device will terminate fast-charge mode (charging current
726
will drop to 0 A) and will trigger interrupt.
728
Valid values:
730
- 4 - 16 (hours), step by 2 (rounded down)
731
- 0: disabled.
733
What: /sys/class/power_supply/max77693-charger/device/top_off_threshold_current
734
Date: January 2015
735
KernelVersion: 3.19.0
736
Contact: Krzysztof Kozlowski <krzk@kernel.org>
737
Description:
738
This entry shows and sets the charging current threshold for
739
entering top-off charging mode. When charging current in fast
740
charge mode drops below this value, the charger will trigger
741
interrupt and start top-off charging mode.
743
Valid values:
745
- 100000 - 200000 (microamps), step by 25000 (rounded down)
746
- 200000 - 350000 (microamps), step by 50000 (rounded down)
747
- 0: disabled.
749
What: /sys/class/power_supply/max77693-charger/device/top_off_timer
750
Date: January 2015
751
KernelVersion: 3.19.0
752
Contact: Krzysztof Kozlowski <krzk@kernel.org>
753
Description:
754
This entry shows and sets the maximum time the max77693
755
charger operates in top-off charge mode. When the timer expires
756
the device will terminate top-off charge mode (charging current
757
will drop to 0 A) and will trigger interrupt.
759
Valid values:
761
- 0 - 70 (minutes), step by 10 (rounded down)
763
What: /sys/class/power_supply/bq24257-charger/ovp_voltage
764
Date: October 2015
765
KernelVersion: 4.4.0
766
Contact: Andreas Dannenberg <dannenberg@ti.com>
767
Description:
768
This entry configures the overvoltage protection feature of bq24257-
769
type charger devices. This feature protects the device and other
770
components against damage from overvoltage on the input supply. See
771
device datasheet for details.
773
Valid values:
775
- 6000000, 6500000, 7000000, 8000000, 9000000, 9500000, 10000000,
776
10500000 (all uV)
778
What: /sys/class/power_supply/bq24257-charger/in_dpm_voltage
779
Date: October 2015
780
KernelVersion: 4.4.0
781
Contact: Andreas Dannenberg <dannenberg@ti.com>
782
Description:
783
This entry configures the input dynamic power path management voltage of
784
bq24257-type charger devices. Once the supply drops to the configured
785
voltage, the input current limit is reduced down to prevent the further
786
drop of the supply. When the IC enters this mode, the charge current is
787
lower than the set value. See device datasheet for details.
789
Valid values:
791
- 4200000, 4280000, 4360000, 4440000, 4520000, 4600000, 4680000,
792
4760000 (all uV)
794
What: /sys/class/power_supply/bq24257-charger/high_impedance_enable
795
Date: October 2015
796
KernelVersion: 4.4.0
797
Contact: Andreas Dannenberg <dannenberg@ti.com>
798
Description:
799
This entry allows enabling the high-impedance mode of bq24257-type
800
charger devices. If enabled, it places the charger IC into low power
801
standby mode with the switch mode controller disabled. When disabled,
802
the charger operates normally. See device datasheet for details.
804
Valid values:
806
- 1: enabled
807
- 0: disabled
809
What: /sys/class/power_supply/bq24257-charger/sysoff_enable
810
Date: October 2015
811
KernelVersion: 4.4.0
812
Contact: Andreas Dannenberg <dannenberg@ti.com>
813
Description:
814
This entry allows enabling the sysoff mode of bq24257-type charger
815
devices. If enabled and the input is removed, the internal battery FET
816
is turned off in order to reduce the leakage from the BAT pin to less
817
than 1uA. Note that on some devices/systems this disconnects the battery
818
from the system. See device datasheet for details.
820
Valid values:
822
- 1: enabled
823
- 0: disabled
825
What: /sys/class/power_supply/<supply_name>/manufacture_year
826
Date: January 2020
827
Contact: linux-pm@vger.kernel.org
828
Description:
829
Reports the year (following Gregorian calendar) when the device has been
830
manufactured.
832
Access: Read
834
Valid values: Reported as integer
836
What: /sys/class/power_supply/<supply_name>/manufacture_month
837
Date: January 2020
838
Contact: linux-pm@vger.kernel.org
839
Description:
840
Reports the month when the device has been manufactured.
842
Access: Read
844
Valid values: 1-12
846
What: /sys/class/power_supply/<supply_name>/manufacture_day
847
Date: January 2020
848
Contact: linux-pm@vger.kernel.org
849
Description:
850
Reports the day of month when the device has been manufactured.
852
Access: Read
853
Valid values: 1-31
855
What: /sys/class/power_supply/<supply_name>/extensions/<extension_name>
856
Date: March 2025
857
Contact: linux-pm@vger.kernel.org
858
Description:
859
Reports the extensions registered to the power supply.
860
Each entry is a link to the device which registered the extension.
862
Access: Read
864
What: /sys/class/power_supply/max8971-charger/fast_charge_timer
865
Date: May 2025
866
KernelVersion: 6.15.0
867
Contact: Svyatoslav Ryhel <clamor95@gmail.com>
868
Description:
869
This entry shows and sets the maximum time the max8971
870
charger operates in fast-charge mode. When the timer expires
871
the device will terminate fast-charge mode (charging current
872
will drop to 0 A) and will trigger interrupt.
874
Valid values:
876
- 4 - 10 (hours), step by 1
877
- 0: disabled.
879
What: /sys/class/power_supply/max8971-charger/top_off_threshold_current
880
Date: May 2025
881
KernelVersion: 6.15.0
882
Contact: Svyatoslav Ryhel <clamor95@gmail.com>
883
Description:
884
This entry shows and sets the charging current threshold for
885
entering top-off charging mode. When charging current in fast
886
charge mode drops below this value, the charger will trigger
887
interrupt and start top-off charging mode.
889
Valid values:
891
- 50000 - 200000 (microamps), step by 50000 (rounded down)
893
What: /sys/class/power_supply/max8971-charger/top_off_timer
894
Date: May 2025
895
KernelVersion: 6.15.0
896
Contact: Svyatoslav Ryhel <clamor95@gmail.com>
897
Description:
898
This entry shows and sets the maximum time the max8971
899
charger operates in top-off charge mode. When the timer expires
900
the device will terminate top-off charge mode (charging current
901
will drop to 0 A) and will trigger interrupt.
903
Valid values:
905
- 0 - 70 (minutes), step by 10 (rounded down)
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
Power supply manufacturer
3-10| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/power_supply/<supply_name>/manufacturer |
| Date | 2007년 5월 |
| Contact | linux-pm@vger.kernel.org |
| Description | Device manufacturer의 이름을 보고합니다. |
| Access | Read |
| Valid values | 문자열로 표현 |
Power supply model name
12-19| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/power_supply/<supply_name>/model_name |
| Date | 2007년 5월 |
| Contact | linux-pm@vger.kernel.org |
| Description | Device model의 이름을 보고합니다. |
| Access | Read |
| Valid values | 문자열로 표현 |
Power supply serial number
21-28| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/power_supply/<supply_name>/serial_number |
| Date | 2008년 1월 |
| Contact | linux-pm@vger.kernel.org |
| Description | Device의 serial number를 보고합니다. |
| Access | Read |
| Valid values | 문자열로 표현 |
Main supply type
30-37| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/power_supply/<supply_name>/type |
| Date | 2010년 5월 |
| Contact | linux-pm@vger.kernel.org |
| Description | Supply의 main type을 설명합니다. |
| Access | Read |
| Valid values | "Battery", "UPS", "Mains", "USB", "Wireless" |
Type대표 대상
BatteryBattery power supply
UPSUninterruptible power supply
Mains유선 external mains supply
USBUSB power supply
WirelessWireless power supply
원문에 열거된 main supply type 문자열입니다.
Average battery or USB current
41-62| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/power_supply/<supply_name>/current_avg |
| Date | 2007년 5월 |
| Contact | linux-pm@vger.kernel.org |
| Description | Battery에서는 고정 기간에 걸친 average IBAT current를 보고합니다. 일반적으로 device는 보고값을 smooth하기 위해 reading을 평균내는 고정 interval을 제공합니다. USB에서는 고정 기간에 걸친 average IBUS current를 같은 방식으로 보고합니다. |
| Access | Read |
| Valid values | Microamp. Battery discharge는 음수, battery charge와 USB IBUS current는 양수 |
Maximum battery or USB current
64-77| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/power_supply/<supply_name>/current_max |
| Date | 2010년 10월 |
| Contact | linux-pm@vger.kernel.org |
| Description | Battery에서는 battery로 들어갈 수 있는 maximum IBAT current를 보고합니다. USB에서는 supply가 지원할 수 있는 maximum IBUS current를 보고합니다. |
| Access | Read |
| Valid values | Microamp로 표현 |
Instant battery or USB current
79-102| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/power_supply/<supply_name>/current_now |
| Date | 2007년 5월 |
| Contact | linux-pm@vger.kernel.org |
| Description | Battery에서는 average 또는 smoothing하지 않은 instant single IBAT current reading을 보고하며 read-only입니다. USB에서는 현재 공급하는 IBUS current를 보고합니다. 일반적으로 read-only이지만 supply의 'online' state가 programmable이면 보고된 minimum/maximum 범위 안에서 설정할 수 있어 read/write입니다. |
| Access | Battery: Read. USB: Read, 조건부 Write |
| Valid values | Microamp. Battery discharge는 음수, battery charge와 USB IBUS current는 양수 |
속성BatteryUSB단위
current_avg고정 기간 average IBAT고정 기간 average IBUSµA
current_max허용 maximum IBAT input지원 maximum IBUSµA
current_nowInstant IBAT, Read현재 IBUS, 조건부 Read/WriteµA
Average·maximum·instant current의 대상과 access를 비교합니다.
Current battery or supply temperature
104-120| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/power_supply/<supply_name>/temp |
| Date | 2007년 5월 |
| Contact | linux-pm@vger.kernel.org |
| Description | Battery에서는 현재 TBAT battery temperature reading을 보고합니다. USB에서는 현재 supply temperature reading, 일반적으로 IC의 TJUNC temperature 같은 device 자체의 internal temperature를 보고합니다. |
| Access | Read |
| Valid values | 섭씨 1/10 degree 단위 |
Maximum temperature alert threshold
122-144| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/power_supply/<supply_name>/temp_alert_max |
| Date | 2012년 7월 |
| Contact | linux-pm@vger.kernel.org |
| Description | Battery에서는 supply가 event를 userspace에 알리는 maximum TBAT temperature trip-wire 값이고, USB에서는 maximum supply temperature trip-wire 값입니다. 보통 charging 중 upper threshold를 넘었을 때 userspace가 온도가 심각하게 높고 charging이 중단되었다는 경고 같은 적절한 조치를 취하도록 사용합니다. |
| Access | Read |
| Valid values | 섭씨 1/10 degree 단위 |
Minimum temperature alert threshold
146-169| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/power_supply/<supply_name>/temp_alert_min |
| Date | 2012년 7월 |
| Contact | linux-pm@vger.kernel.org |
| Description | Battery에서는 supply가 event를 userspace에 알리는 minimum TBAT temperature trip-wire 값이고, USB에서는 minimum supply temperature trip-wire 값입니다. 보통 charging 중 lower threshold를 넘었을 때 userspace가 temperature level과 이에 따른 charging current 감소를 알리는 등 적절한 조치를 취하도록 사용합니다. |
| Access | Read |
| Valid values | 섭씨 1/10 degree 단위 |
Maximum allowed temperature
171-186| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/power_supply/<supply_name>/temp_max |
| Date | 2014년 7월 |
| Contact | linux-pm@vger.kernel.org |
| Description | Battery에서는 charging에 허용되는 maximum TBAT battery temperature를 보고합니다. USB에서는 operation에 허용되는 maximum supply temperature를 보고합니다. |
| Access | Read |
| Valid values | 섭씨 1/10 degree 단위 |
Minimum allowed temperature
188-203| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/power_supply/<supply_name>/temp_min |
| Date | 2014년 7월 |
| Contact | linux-pm@vger.kernel.org |
| Description | Battery에서는 charging에 허용되는 minimum TBAT battery temperature를 보고합니다. USB에서는 operation에 허용되는 minimum supply temperature를 보고합니다. |
| Access | Read |
| Valid values | 섭씨 1/10 degree 단위 |
속성BatteryUSB supply
temp현재 TBAT현재 internal supply temperature
temp_alert_max/minUserspace notification trip-wireUserspace notification trip-wire
temp_max/minCharging allowed boundOperation allowed bound
Current reading, userspace notification threshold와 allowed operating bound를 구분합니다.
Maximum safe battery or USB voltage
205-220| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/power_supply/<supply_name>/voltage_max, |
| Date | 2008년 1월 |
| Contact | linux-pm@vger.kernel.org |
| Description | Battery에서는 charging 중 battery에 허용되는 maximum safe VBAT voltage를 보고합니다. USB에서는 supply가 지원할 수 있는 maximum VBUS voltage를 보고합니다. |
| Access | Read |
| Valid values | Microvolt로 표현 |
Minimum safe battery or USB voltage
222-237| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/power_supply/<supply_name>/voltage_min, |
| Date | 2008년 1월 |
| Contact | linux-pm@vger.kernel.org |
| Description | Battery에서는 discharging 중 battery에 허용되는 minimum safe VBAT voltage를 보고합니다. USB에서는 supply가 지원할 수 있는 minimum VBUS voltage를 보고합니다. |
| Access | Read |
| Valid values | Microvolt로 표현 |
Instant battery or USB voltage
239-259| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/power_supply/<supply_name>/voltage_now, |
| Date | 2007년 5월 |
| Contact | linux-pm@vger.kernel.org |
| Description | Battery에서는 average 또는 smoothing하지 않은 instant single VBAT voltage reading을 보고하며 read-only입니다. USB에서는 현재 공급하는 VBUS voltage를 보고합니다. 일반적으로 read-only이지만 supply의 'online' state가 programmable이면 보고된 minimum/maximum 범위 안에서 설정할 수 있어 read/write입니다. |
| Access | Battery: Read. USB: Read, 조건부 Write |
| Valid values | Microvolt로 표현 |
속성BatteryUSB
voltage_maxCharging 중 maximum safe VBAT지원 maximum VBUS
voltage_minDischarging 중 minimum safe VBAT지원 minimum VBUS
voltage_nowInstant VBAT, Read현재 VBUS, 조건부 Read/Write
VBAT와 VBUS의 safe bounds 및 instant reading을 비교합니다.
Fine-grained battery capacity
263-271| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/power_supply/<supply_name>/capacity |
| Date | 2007년 5월 |
| Contact | linux-pm@vger.kernel.org |
| Description | Battery capacity를 fine-grained 값으로 표현합니다. |
| Access | Read |
| Valid values | 0~100 percent |
Upper capacity alert threshold
273-286| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/power_supply/<supply_name>/capacity_alert_max |
| Date | 2012년 7월 |
| Contact | linux-pm@vger.kernel.org |
| Description | Supply가 event를 userspace에 알리는 maximum battery capacity trip-wire 값입니다. 보통 battery discharging 중 battery가 upper level까지 떨어졌음을 userspace가 알고 battery level이 낮다는 경고 같은 적절한 조치를 취하도록 사용합니다. |
| Access | Read, Write |
| Valid values | 0~100 percent |
Lower capacity alert threshold
288-301| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/power_supply/<supply_name>/capacity_alert_min |
| Date | 2012년 7월 |
| Contact | linux-pm@vger.kernel.org |
| Description | Supply가 event를 userspace에 알리는 minimum battery capacity trip-wire 값입니다. 보통 battery discharging 중 battery가 lower level까지 떨어졌음을 userspace가 알고 battery level이 심각하게 낮다는 경고 같은 적절한 조치를 취하도록 사용합니다. |
| Access | Read, Write |
| Valid values | 0~100 percent |
Fuel-gauge capacity error margin
303-317| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/power_supply/<supply_name>/capacity_error_margin |
| Date | 2019년 4월 |
| Contact | linux-pm@vger.kernel.org |
| Description | Recalibration이 없으면 battery capacity measurement는 신뢰성이 떨어집니다. 이 값은 fuel gauge에 존재할 것으로 예상되는 maximum error margin을 percent로 제공합니다. Recalibration 직후에는 0%에 가까운 값이 반환되고 시간이 지나면 error margin이 증가합니다. 100%는 capacity 관련 값이 사실상 완전히 쓸모없음을 뜻합니다. |
| Access | Read |
| Valid values | 0~100 percent |
Coarse battery capacity level
319-329| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/power_supply/<supply_name>/capacity_level |
| Date | 2009년 6월 |
| Contact | linux-pm@vger.kernel.org |
| Description | Battery capacity를 coarse-grained 상태로 표현합니다. |
| Access | Read |
| Valid values | "Unknown", "Critical", "Low", "Normal", "High", "Full" |
속성표현Access
capacity0~100% fine-grained capacityRead
capacity_alert_max/min0~100% userspace notification thresholdRead/Write
capacity_error_margin0~100% fuel-gauge uncertaintyRead
capacity_levelUnknown, Critical, Low, Normal, High, FullRead
Fine percentage, alert trip-wire, uncertainty와 coarse state를 구분합니다.
Charging current throttle
331-340| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/power_supply/<supply_name>/charge_control_limit |
| Date | 2012년 10월 |
| Contact | linux-pm@vger.kernel.org |
| Description | 허용 가능한 maximum charging current입니다. Thermal cooling을 위한 charge-rate throttling 또는 battery health 개선에 사용합니다. |
| Access | Read, Write |
| Valid values | Microamp로 표현 |
Maximum legal charge control limit
342-350| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/power_supply/<supply_name>/charge_control_limit_max |
| Date | 2012년 10월 |
| Contact | linux-pm@vger.kernel.org |
| Description | charge_control_limit property에 허용되는 maximum legal value입니다. |
| Access | Read |
| Valid values | Microamp로 표현 |
Charge start threshold
352-360| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/power_supply/<supply_name>/charge_control_start_threshold |
| Date | 2019년 4월 |
| Contact | linux-pm@vger.kernel.org |
| Description | 이 값보다 battery percentage가 낮아지면 charging을 시작합니다. |
| Access | Read, Write |
| Valid values | 0~100 percent |
Charge end threshold
362-374| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/power_supply/<supply_name>/charge_control_end_threshold |
| Date | 2019년 4월 |
| Contact | linux-pm@vger.kernel.org |
| Description | 이 값보다 battery percentage가 높아지면 charging을 중단합니다. 모든 hardware가 임의의 percentage를 설정할 수 있는 것은 아닙니다. Driver는 쓴 값을 가장 가까운 supported value로 round하며, 값을 다시 읽으면 driver가 실제 설정한 threshold가 표시됩니다. |
| Access | Read, Write |
| Valid values | 0~100 percent |
속성동작단위
charge_control_limitMaximum charging current throttleµA
charge_control_limit_maxlimit의 maximum legal valueµA
charge_control_start_threshold이 percentage 아래에서 charging 시작%
charge_control_end_threshold이 percentage 위에서 charging 중단, 지원값으로 rounding 가능%
Current throttling과 percentage-based start·stop policy를 구분합니다.
Active charging algorithm
376-415| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/power_supply/<supply_name>/charge_type |
| Date | 2009년 7월 |
| Contact | linux-pm@vger.kernel.org |
| Description | Battery에 사용할 charging algorithm을 선택합니다. Standard는 moderate rate로 완전히 충전합니다. Fast는 fast-charge technology로 빠르게 충전하지만 battery 부담과 수명 저하 가능성이 큽니다. Trickle은 external power에 주로 연결해 쓰는 사용자가 battery life를 늘리는 mode이며 vendor tool에서는 "Primarily AC Use"라고 부를 수 있습니다. Adaptive는 일반적인 usage pattern에 따라 charge rate를 자동 최적화합니다. Custom은 charge_control_* property로 charging 시작·중단 시점을 정해 advanced user가 battery life를 크게 늘릴 수 있게 합니다. Long Life는 battery health를 연장하도록 charge rate를 낮춥니다. Bypass는 integrated converter 주위의 charging path를 우회해 "smart" wall adaptor가 외부에서 power conversion을 수행하게 합니다. 읽으면 'Standard' 같은 현재 active value를 반환하며 battery 지원값은 charge_types에서 확인합니다. |
| Access | Read, Write |
| Valid values | "Unknown", "N/A", "Trickle", "Fast", "Standard", "Adaptive", "Custom", "Long Life", "Bypass" |
Charge type동작
StandardModerate rate로 full charge
Fast빠른 충전, battery 부담과 수명 저하 가능
Trickle주로 AC 연결 사용 시 battery life 연장
AdaptiveUsage pattern 기반 charge rate 자동 최적화
Customcharge_control_*로 start·stop 결정
Long LifeBattery health를 위해 charge rate 감소
BypassIntegrated converter를 우회해 external smart adaptor가 conversion
Unknown / N/A알 수 없거나 적용되지 않음
원문이 정의한 charging algorithm의 목적과 tradeoff입니다.
Supported charging algorithms
417-432| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/power_supply/<supply_name>/charge_types |
| Date | 2024년 12월 |
| Contact | linux-pm@vger.kernel.org |
| Description | charge_type과 동일하지만 읽으면 지원하는 charge type 목록을 반환하고 현재 active type을 square bracket으로 둘러쌉니다. 예는 "Fast [Standard] Long_Life"입니다. Power_supply class device는 backward compatibility를 위해 charge_type과 charge_types를 모두 지원할 수 있습니다. 이 경우 두 속성의 active value는 항상 같고 어느 property에 써도 변경할 수 있습니다. "Long Life"처럼 space가 있는 charge type은 "Long_Life"처럼 '_'로 바뀌어 표시되며, 쓸 때는 두 variant를 모두 허용합니다. |
속성ReadWrite
charge_type현재 active valueActive value 변경
charge_types지원 목록, active value는 [bracket]Active value 변경
Space-containing typeLong_Life 형태Long Life와 Long_Life 모두 허용
단일 active value와 지원 목록 표현 및 쓰기 호환성을 비교합니다.
Charge termination current
434-443| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/power_supply/<supply_name>/charge_term_current |
| Date | 2014년 7월 |
| Contact | linux-pm@vger.kernel.org |
| Description | Battery가 full인 것으로 간주하고 charging을 끝낼 시점을 결정하는 charging current 값을 보고합니다. |
| Access | Read |
| Valid values | Microamp로 표현 |
Battery health
445-459| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/power_supply/<supply_name>/health |
| Date | 2007년 5월 |
| Contact | linux-pm@vger.kernel.org |
| Description | Battery 또는 charger 기능의 battery 측 health를 보고합니다. |
| Access | Read |
| Valid values | "Unknown", "Good", "Overheat", "Dead", "Over voltage", "Under voltage", "Unspecified failure", "Cold", "Watchdog timer expire", "Safety timer expire", "Over current", "Calibration required", "Warm", "Cool", "Hot", "No battery", "Blown fuse", "Cell imbalance" |
분류값
GeneralUnknown, Good, Dead, Unspecified failure
ThermalOverheat, Cold, Warm, Cool, Hot
ElectricalOver voltage, Under voltage, Over current, Cell imbalance
Timer/calibrationWatchdog timer expire, Safety timer expire, Calibration required
Hardware presenceNo battery, Blown fuse
Health 문자열을 정상, thermal, electrical, timer와 hardware 상태로 정리합니다.
Battery precharge current
461-470| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/power_supply/<supply_name>/precharge_current |
| Date | 2017년 6월 |
| Contact | linux-pm@vger.kernel.org |
| Description | Battery charge cycle의 pre-charging phase에서 적용하는 charging current를 보고합니다. |
| Access | Read |
| Valid values | Microamp로 표현 |
Battery presence
472-486| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/power_supply/<supply_name>/present |
| Date | 2007년 5월 |
| Contact | linux-pm@vger.kernel.org |
| Description | System에 battery가 있는지 보고합니다. 이 property가 없으면 battery가 present한 것으로 간주합니다. |
| Access | Read |
| Valid values | 0: Absent, 1: Present |
조건 또는 값의미
0Absent
1Present
Property 없음Present로 간주
원문 ASCII 표와 property 부재 시 default interpretation입니다.
Battery charging status
488-500| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/power_supply/<supply_name>/status |
| Date | 2007년 5월 |
| Contact | linux-pm@vger.kernel.org |
| Description | Battery charging status를 나타냅니다. 일반적으로 read-only 보고이지만 일부 supply에서는 battery charging을 enable 또는 disable하는 데 사용할 수 있습니다. |
| Access | Read, Write |
| Valid values | "Unknown", "Charging", "Discharging", "Not charging", "Full" |
Charging behaviour
502-516| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/power_supply/<supply_name>/charge_behaviour |
| Date | 2021년 11월 |
| Contact | linux-pm@vger.kernel.org |
| Description | Charging behaviour를 나타냅니다. auto는 threshold를 지키며 정상 charging, inhibit-charge는 AC가 연결된 동안 charging 금지, inhibit-charge-awake는 device가 awake일 때만 inhibit-charge, force-discharge는 AC가 연결된 동안 강제 discharging을 뜻합니다. |
| Access | Read, Write |
| Valid values | auto, inhibit-charge, inhibit-charge-awake, force-discharge |
값동작
autoThreshold를 지키며 정상 charging
inhibit-chargeAC 연결 중 charging 금지
inhibit-charge-awakeDevice가 awake일 때만 charging 금지
force-dischargeAC 연결 중 강제 discharge
원문 ASCII 표의 AC 연결 상태별 charging policy입니다.
Battery technology
518-528| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/power_supply/<supply_name>/technology |
| Date | 2007년 5월 |
| Contact | linux-pm@vger.kernel.org |
| Description | Supply가 지원하는 battery technology를 설명합니다. |
| Access | Read |
| Valid values | "Unknown", "NiMH", "Li-ion", "Li-poly", "LiFe", "NiCd", "LiMn" |
Average battery voltage
531-541| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/power_supply/<supply_name>/voltage_avg, |
| Date | 2007년 5월 |
| Contact | linux-pm@vger.kernel.org |
| Description | 고정 기간에 걸친 average VBAT voltage reading을 보고합니다. 일반적으로 device는 보고값을 smooth하기 위해 reading을 평균내는 고정 interval을 제공합니다. |
| Access | Read |
| Valid values | Microvolt로 표현 |
Full battery cycle count
543-554| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/power_supply/<supply_name>/cycle_count |
| Date | 2010년 1월 |
| Contact | linux-pm@vger.kernel.org |
| Description | Battery가 거친 full charge와 discharge cycle 수를 보고합니다. |
| Access | Read |
| Valid values | 0보다 큰 integer는 full cycle 수, 0은 cycle_count 정보를 사용할 수 없음 |
Battery internal resistance
556-570| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/power_supply/<supply_name>/internal_resistance |
| Date | 2025년 8월 |
| Contact | linux-arm-msm@vger.kernel.org |
| Description | Equivalent Series Resistance(ESR)라고도 하는 battery internal resistance를 나타냅니다. Cell 내부 current flow에 대한 opposition을 반영하는 dynamic parameter입니다. 고정값이 아니며 battery state of charge(SoC), temperature, charging 또는 discharging 상태를 포함한 여러 operating condition에 따라 크게 달라집니다. |
| Access | Read |
| Valid values | Microohm으로 표현 |
Battery state of health
572-591| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/power_supply/<supply_name>/state_of_health |
| Date | 2025년 8월 |
| Contact | linux-arm-msm@vger.kernel.org |
| Description | Battery의 original specification 대비 rated performance 제공 능력을 반영해 전체 상태를 percentage로 정량화합니다. Learned capacity와 impedance-based degradation indicator를 조합해 동적으로 계산하며 두 지표는 battery lifecycle 동안 변합니다. 정확한 algorithm은 대부분 battery vendor가 비공개로 유지하고 vendor-independent한 "performance" 정의가 없으므로 서로 다른 vendor의 값을 비교할 수 없습니다. 또한 일반적으로 계산에 사용할 수 없으며, 예를 들어 charge_full과 charge_full_design 사이의 factor가 아닙니다. |
| Access | Read |
| Valid values | 0~100 percent |
속성값해석
cycle_countFull charge+discharge cycle0은 정보 없음
internal_resistanceµΩ ESRSoC, temperature, charge state에 따라 동적
state_of_health0~100%Vendor 간 비교·계산 factor로 사용 불가
Cycle, ESR과 state-of-health의 단위와 해석 제한입니다.
USB input current limit
595-608| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/power_supply/<supply_name>/input_current_limit |
| Date | 2014년 7월 |
| Contact | linux-pm@vger.kernel.org |
| Description | Supply에 현재 설정된 incoming IBUS current limit를 설명합니다. 보통 connection type에 따라 구성합니다. 예를 들어 configured SDP는 maximum 500 mA를 출력해야 하므로 input current limit도 같은 값으로 설정합니다. input_power_limit를 우선 사용하고, power limit을 사용해 해결할 수 있는 문제에는 input_current_limit을 사용합니다. |
| Access | Read, Write |
| Valid values | Microamp로 표현 |
USB input voltage limit
610-626| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/power_supply/<supply_name>/input_voltage_limit |
| Date | 2019년 5월 |
| Contact | linux-pm@vger.kernel.org |
| Description | Supply에 현재 설정된 incoming VBUS voltage limit를 구성합니다. 보통 system-level knowledge 또는 user input에 따라 설정합니다. 예를 들어 Pixel C thermal management strategy에서는 화면이 켜졌을 때 input power를 5 V로 효과적으로 제한해 Google skin temperature target을 맞추는 데 사용합니다. 이 기능을 safety-critical 용도로 사용하면 안 됩니다. input_power_limit를 우선 사용하고, power limit을 사용해 해결할 수 있는 문제에는 input_voltage_limit를 사용합니다. |
| Access | Read, Write |
| Valid values | Microvolt로 표현 |
USB input power limit
628-640| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/power_supply/<supply_name>/input_power_limit |
| Date | 2019년 5월 |
| Contact | linux-pm@vger.kernel.org |
| Description | Supply에 현재 설정된 incoming power limit를 구성합니다. 보통 system-level knowledge 또는 user input에 따라 설정합니다. Incoming power를 제한할 때는 이 기능을 우선 사용하고, current 또는 voltage limit는 power limit로 해결할 수 있는 문제에만 사용합니다. |
| Access | Read, Write |
| Valid values | Microwatt로 표현 |
속성제한 대상단위
input_current_limitIncoming IBUS currentµA
input_voltage_limitIncoming VBUS voltageµV
input_power_limitIncoming powerµW
Current, voltage와 direct power limit의 단위와 구성 목적입니다.
Supply online state
642-659| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/power_supply/<supply_name>/online, |
| Date | 2007년 5월 |
| Contact | linux-pm@vger.kernel.org |
| Description | Supply에 VBUS가 존재하는지 나타냅니다. Supply가 online이고 이를 허용하면 online state 사이를 전환할 수 있습니다. 예를 들어 PD_PPS USB supply를 Fixed에서 Programmable로 바꾸면 voltage와 current를 제어할 수 있습니다. |
| Access | Read, Write |
| Valid values | 0: Offline, 1: Online Fixed - Fixed Voltage Supply, 2: Online Programmable - Programmable Voltage Supply |
값상태Voltage 제어
0Offline없음
1Online FixedFixed Voltage Supply
2Online ProgrammableProgrammable Voltage Supply
원문 ASCII 표의 VBUS presence와 programmable state입니다.
Active USB connection type
661-678| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/power_supply/<supply_name>/usb_type |
| Date | 2018년 3월 |
| Contact | linux-pm@vger.kernel.org |
| Description | Supply에 현재 active한 USB connection type을 보고합니다. 예를 들어 USB-PD capable source가 연결되었는지 표시할 수 있습니다. Battery charger chip처럼 USB power를 소비하는 power supply에서는 연결된 USB power source type을 나타내며 read-only입니다. UCS1002 USB Port Power Controller처럼 USB power source로 동작하는 power supply에서는 쓸 수 있습니다. |
| Access | USB power consumer: Read-only. USB power source: Write 가능 |
| Valid values | "Unknown", "SDP", "DCP", "CDP", "ACA", "C", "PD", "PD_DRP", "PD_PPS", "BrickID" |
Power supply 역할usb_type access예
USB power consumerRead-onlyBattery charger chip
USB power sourceWritableUCS1002 USB Port Power Controller
가능한 typeUnknown, SDP, DCP, CDP, ACA, C, PD, PD_DRP, PD_PPS, BrickIDActive source type
Active connection type의 보고 목적과 consumer/source별 access입니다.
DS2760 coulomb counter correction
682-692| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/power/ds2760-battery.*/charge_now |
| Date | 2010년 5월 |
| KernelVersion | 2.6.35 |
| Contact | Daniel Mack <daniel@caiaq.de> |
| Description | Writable file로 battery monitor chip 내부의 현재 coulomb counter 값을 설정할 수 있습니다. Aging battery의 불가피한 correction에 필요합니다. Userspace daemon은 battery charging logic을 monitor하고 counter가 합리적인 범위를 벗어나면 적절한 조치를 취할 수 있습니다. |
| Access | Write 가능 |
DS2760 assumed full level
694-701| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/power/ds2760-battery.*/charge_full |
| Date | 2010년 5월 |
| KernelVersion | 2.6.35 |
| Contact | Daniel Mack <daniel@caiaq.de> |
| Description | Writable file로 가정한 battery 'full level'을 설정할 수 있습니다. Battery가 aging함에 따라 이 값은 시간이 지나며 수정해야 합니다. |
| Access | Write 가능 |
속성보정 대상
charge_nowBattery monitor의 현재 coulomb counter
charge_full가정한 battery full level
Aging에 따라 userspace가 보정할 수 있는 두 battery monitor 값입니다.
MAX14577 fast-charge timer
703-716| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/power_supply/max14577-charger/device/fast_charge_timer |
| Date | 2014년 10월 |
| KernelVersion | 3.18.0 |
| Contact | Krzysztof Kozlowski <krzk@kernel.org> |
| Description | MAX14577 charger가 fast-charge mode로 동작하는 maximum time을 표시하고 설정합니다. Timer가 expire하면 device는 fast-charge mode를 끝내고 charging current를 0 A로 낮춘 뒤 interrupt를 trigger합니다. |
| Valid values | 5, 6, 7 hours. 0은 disabled |
MAX77693 fast-charge timer
718-731| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/power_supply/max77693-charger/device/fast_charge_timer |
| Date | 2015년 1월 |
| KernelVersion | 3.19.0 |
| Contact | Krzysztof Kozlowski <krzk@kernel.org> |
| Description | MAX77693 charger가 fast-charge mode로 동작하는 maximum time을 표시하고 설정합니다. Timer가 expire하면 device는 fast-charge mode를 끝내고 charging current를 0 A로 낮춘 뒤 interrupt를 trigger합니다. |
| Valid values | 4~16 hours, step 2, round down. 0은 disabled |
MAX77693 top-off current threshold
733-747| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/power_supply/max77693-charger/device/top_off_threshold_current |
| Date | 2015년 1월 |
| KernelVersion | 3.19.0 |
| Contact | Krzysztof Kozlowski <krzk@kernel.org> |
| Description | Top-off charging mode에 들어가기 위한 charging current threshold를 표시하고 설정합니다. Fast-charge mode의 charging current가 이 값 아래로 떨어지면 charger가 interrupt를 trigger하고 top-off charging mode를 시작합니다. |
| Valid values | 100000~200000 µA는 step 25000, 200000~350000 µA는 step 50000, 모두 round down. 0은 disabled |
MAX77693 top-off timer
749-761| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/power_supply/max77693-charger/device/top_off_timer |
| Date | 2015년 1월 |
| KernelVersion | 3.19.0 |
| Contact | Krzysztof Kozlowski <krzk@kernel.org> |
| Description | MAX77693 charger가 top-off charge mode로 동작하는 maximum time을 표시하고 설정합니다. Timer가 expire하면 device는 top-off charge mode를 끝내고 charging current를 0 A로 낮춘 뒤 interrupt를 trigger합니다. |
| Valid values | 0~70 minutes, step 10, round down |
Device/속성범위Expire 또는 threshold 동작
MAX14577 fast_charge_timer5, 6, 7 h; 0 disabledFast charge 종료, 0 A, interrupt
MAX77693 fast_charge_timer4~16 h, step 2 down; 0 disabledFast charge 종료, 0 A, interrupt
MAX77693 top_off_threshold_current100000~350000 µA, 구간별 step down; 0 disabled아래로 떨어지면 top-off 시작
MAX77693 top_off_timer0~70 min, step 10 downTop-off 종료, 0 A, interrupt
MAX14577·MAX77693의 fast-charge와 top-off 전환 조건입니다.
BQ24257 overvoltage protection
763-776| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/power_supply/bq24257-charger/ovp_voltage |
| Date | 2015년 10월 |
| KernelVersion | 4.4.0 |
| Contact | Andreas Dannenberg <dannenberg@ti.com> |
| Description | BQ24257-type charger device의 overvoltage protection 기능을 구성합니다. Input supply의 overvoltage로 인한 device와 다른 component의 damage를 막습니다. 자세한 내용은 device datasheet를 참조하십시오. |
| Valid values | 6000000, 6500000, 7000000, 8000000, 9000000, 9500000, 10000000, 10500000 µV |
BQ24257 dynamic power path voltage
778-792| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/power_supply/bq24257-charger/in_dpm_voltage |
| Date | 2015년 10월 |
| KernelVersion | 4.4.0 |
| Contact | Andreas Dannenberg <dannenberg@ti.com> |
| Description | BQ24257-type charger device의 input dynamic power path management voltage를 구성합니다. Supply가 configured voltage까지 떨어지면 input current limit를 낮춰 supply가 더 떨어지는 것을 막습니다. IC가 이 mode에 들어가면 charge current는 설정값보다 낮아집니다. 자세한 내용은 device datasheet를 참조하십시오. |
| Valid values | 4200000, 4280000, 4360000, 4440000, 4520000, 4600000, 4680000, 4760000 µV |
BQ24257 high-impedance mode
794-807| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/power_supply/bq24257-charger/high_impedance_enable |
| Date | 2015년 10월 |
| KernelVersion | 4.4.0 |
| Contact | Andreas Dannenberg <dannenberg@ti.com> |
| Description | BQ24257-type charger device의 high-impedance mode를 enable할 수 있습니다. Enable하면 switch mode controller가 disabled된 low-power standby mode에 charger IC를 둡니다. Disable하면 charger가 정상 동작합니다. 자세한 내용은 device datasheet를 참조하십시오. |
| Valid values | 1: enabled, 0: disabled |
BQ24257 system-off mode
809-823| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/power_supply/bq24257-charger/sysoff_enable |
| Date | 2015년 10월 |
| KernelVersion | 4.4.0 |
| Contact | Andreas Dannenberg <dannenberg@ti.com> |
| Description | BQ24257-type charger device의 sysoff mode를 enable할 수 있습니다. Enable한 상태에서 input을 제거하면 internal battery FET를 꺼 BAT pin의 leakage를 1 µA 미만으로 줄입니다. 일부 device 또는 system에서는 battery가 system에서 분리될 수 있습니다. 자세한 내용은 device datasheet를 참조하십시오. |
| Valid values | 1: enabled, 0: disabled |
속성구성 또는 동작
ovp_voltage정해진 6.0~10.5 V input overvoltage protection
in_dpm_voltage정해진 4.20~4.76 V에서 input current limit 감소
high_impedance_enableLow-power standby, switch mode controller disabled
sysoff_enableInput 제거 시 battery FET off, BAT leakage < 1 µA
Protection voltage와 low-power mode의 목적을 정리합니다.
Manufacture year
825-834| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/power_supply/<supply_name>/manufacture_year |
| Date | 2020년 1월 |
| Contact | linux-pm@vger.kernel.org |
| Description | Device가 제조된 Gregorian calendar 기준 year를 보고합니다. |
| Access | Read |
| Valid values | Integer로 보고 |
Manufacture month
836-844| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/power_supply/<supply_name>/manufacture_month |
| Date | 2020년 1월 |
| Contact | linux-pm@vger.kernel.org |
| Description | Device가 제조된 month를 보고합니다. |
| Access | Read |
| Valid values | 1~12 |
Manufacture day
846-853| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/power_supply/<supply_name>/manufacture_day |
| Date | 2020년 1월 |
| Contact | linux-pm@vger.kernel.org |
| Description | Device가 제조된 month 내 day를 보고합니다. |
| Access | Read |
| Valid values | 1~31 |
Registered power supply extensions
855-862| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/power_supply/<supply_name>/extensions/<extension_name> |
| Date | 2025년 3월 |
| Contact | linux-pm@vger.kernel.org |
| Description | Power supply에 등록된 extension을 보고합니다. 각 entry는 extension을 등록한 device로 연결되는 link입니다. |
| Access | Read |
속성값
manufacture_yearGregorian year integer
manufacture_month1~12
manufacture_day1~31
extensions/<extension_name>등록 device를 가리키는 link
Read-only manufacture date component와 extension device link입니다.
MAX8971 fast-charge timer
864-877| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/power_supply/max8971-charger/fast_charge_timer |
| Date | 2025년 5월 |
| KernelVersion | 6.15.0 |
| Contact | Svyatoslav Ryhel <clamor95@gmail.com> |
| Description | MAX8971 charger가 fast-charge mode로 동작하는 maximum time을 표시하고 설정합니다. Timer가 expire하면 device는 fast-charge mode를 끝내고 charging current를 0 A로 낮춘 뒤 interrupt를 trigger합니다. |
| Valid values | 4~10 hours, step 1. 0은 disabled |
MAX8971 top-off current threshold
879-891| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/power_supply/max8971-charger/top_off_threshold_current |
| Date | 2025년 5월 |
| KernelVersion | 6.15.0 |
| Contact | Svyatoslav Ryhel <clamor95@gmail.com> |
| Description | Top-off charging mode에 들어가기 위한 charging current threshold를 표시하고 설정합니다. Fast-charge mode의 charging current가 이 값 아래로 떨어지면 charger가 interrupt를 trigger하고 top-off charging mode를 시작합니다. |
| Valid values | 50000~200000 µA, step 50000, round down |
MAX8971 top-off timer
893-905| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/power_supply/max8971-charger/top_off_timer |
| Date | 2025년 5월 |
| KernelVersion | 6.15.0 |
| Contact | Svyatoslav Ryhel <clamor95@gmail.com> |
| Description | MAX8971 charger가 top-off charge mode로 동작하는 maximum time을 표시하고 설정합니다. Timer가 expire하면 device는 top-off charge mode를 끝내고 charging current를 0 A로 낮춘 뒤 interrupt를 trigger합니다. |
| Valid values | 0~70 minutes, step 10, round down |
속성범위동작
fast_charge_timer4~10 h, step 1; 0 disabledExpire 시 fast charge 종료, 0 A, interrupt
top_off_threshold_current50000~200000 µA, step 50000 downCurrent가 아래로 떨어지면 top-off 시작
top_off_timer0~70 min, step 10 downExpire 시 top-off 종료, 0 A, interrupt
Fast-charge timeout과 top-off 진입·종료 조건입니다.
General supply identity
sysfs-class-power:1-37Manufacturer·model·serial number와 Battery·UPS·Mains·USB·Wireless supply type을 제공합니다.