Merge tag 'for-linus-4.4-rc5-tag' of git://git.kernel.org/pub/scm/linux/kernel/git...
[sfrench/cifs-2.6.git] / Documentation / ABI / testing / sysfs-class-power
1 What:           /sys/class/power/ds2760-battery.*/charge_now
2 Date:           May 2010
3 KernelVersion:  2.6.35
4 Contact:        Daniel Mack <daniel@caiaq.de>
5 Description:
6                 This file is writeable and can be used to set the current
7                 coloumb counter value inside the battery monitor chip. This
8                 is needed for unavoidable corrections of aging batteries.
9                 A userspace daemon can monitor the battery charging logic
10                 and once the counter drops out of considerable bounds, take
11                 appropriate action.
12
13 What:           /sys/class/power/ds2760-battery.*/charge_full
14 Date:           May 2010
15 KernelVersion:  2.6.35
16 Contact:        Daniel Mack <daniel@caiaq.de>
17 Description:
18                 This file is writeable and can be used to set the assumed
19                 battery 'full level'. As batteries age, this value has to be
20                 amended over time.
21
22 What:           /sys/class/power_supply/max14577-charger/device/fast_charge_timer
23 Date:           October 2014
24 KernelVersion:  3.18.0
25 Contact:        Krzysztof Kozlowski <k.kozlowski@samsung.com>
26 Description:
27                 This entry shows and sets the maximum time the max14577
28                 charger operates in fast-charge mode. When the timer expires
29                 the device will terminate fast-charge mode (charging current
30                 will drop to 0 A) and will trigger interrupt.
31
32                 Valid values:
33                 - 5, 6 or 7 (hours),
34                 - 0: disabled.
35
36 What:           /sys/class/power_supply/max77693-charger/device/fast_charge_timer
37 Date:           January 2015
38 KernelVersion:  3.19.0
39 Contact:        Krzysztof Kozlowski <k.kozlowski@samsung.com>
40 Description:
41                 This entry shows and sets the maximum time the max77693
42                 charger operates in fast-charge mode. When the timer expires
43                 the device will terminate fast-charge mode (charging current
44                 will drop to 0 A) and will trigger interrupt.
45
46                 Valid values:
47                 - 4 - 16 (hours), step by 2 (rounded down)
48                 - 0: disabled.
49
50 What:           /sys/class/power_supply/max77693-charger/device/top_off_threshold_current
51 Date:           January 2015
52 KernelVersion:  3.19.0
53 Contact:        Krzysztof Kozlowski <k.kozlowski@samsung.com>
54 Description:
55                 This entry shows and sets the charging current threshold for
56                 entering top-off charging mode. When charging current in fast
57                 charge mode drops below this value, the charger will trigger
58                 interrupt and start top-off charging mode.
59
60                 Valid values:
61                 - 100000 - 200000 (microamps), step by 25000 (rounded down)
62                 - 200000 - 350000 (microamps), step by 50000 (rounded down)
63                 - 0: disabled.
64
65 What:           /sys/class/power_supply/max77693-charger/device/top_off_timer
66 Date:           January 2015
67 KernelVersion:  3.19.0
68 Contact:        Krzysztof Kozlowski <k.kozlowski@samsung.com>
69 Description:
70                 This entry shows and sets the maximum time the max77693
71                 charger operates in top-off charge mode. When the timer expires
72                 the device will terminate top-off charge mode (charging current
73                 will drop to 0 A) and will trigger interrupt.
74
75                 Valid values:
76                 - 0 - 70 (minutes), step by 10 (rounded down)
77
78 What:           /sys/class/power_supply/bq24257-charger/ovp_voltage
79 Date:           October 2015
80 KernelVersion:  4.4.0
81 Contact:        Andreas Dannenberg <dannenberg@ti.com>
82 Description:
83                 This entry configures the overvoltage protection feature of bq24257-
84                 type charger devices. This feature protects the device and other
85                 components against damage from overvoltage on the input supply. See
86                 device datasheet for details.
87
88                 Valid values:
89                 - 6000000, 6500000, 7000000, 8000000, 9000000, 9500000, 10000000,
90                   10500000 (all uV)
91
92 What:           /sys/class/power_supply/bq24257-charger/in_dpm_voltage
93 Date:           October 2015
94 KernelVersion:  4.4.0
95 Contact:        Andreas Dannenberg <dannenberg@ti.com>
96 Description:
97                 This entry configures the input dynamic power path management voltage of
98                 bq24257-type charger devices. Once the supply drops to the configured
99                 voltage, the input current limit is reduced down to prevent the further
100                 drop of the supply. When the IC enters this mode, the charge current is
101                 lower than the set value. See device datasheet for details.
102
103                 Valid values:
104                 - 4200000, 4280000, 4360000, 4440000, 4520000, 4600000, 4680000,
105                   4760000 (all uV)
106
107 What:           /sys/class/power_supply/bq24257-charger/high_impedance_enable
108 Date:           October 2015
109 KernelVersion:  4.4.0
110 Contact:        Andreas Dannenberg <dannenberg@ti.com>
111 Description:
112                 This entry allows enabling the high-impedance mode of bq24257-type
113                 charger devices. If enabled, it places the charger IC into low power
114                 standby mode with the switch mode controller disabled. When disabled,
115                 the charger operates normally. See device datasheet for details.
116
117                 Valid values:
118                 - 1: enabled
119                 - 0: disabled
120
121 What:           /sys/class/power_supply/bq24257-charger/sysoff_enable
122 Date:           October 2015
123 KernelVersion:  4.4.0
124 Contact:        Andreas Dannenberg <dannenberg@ti.com>
125 Description:
126                 This entry allows enabling the sysoff mode of bq24257-type charger
127                 devices. If enabled and the input is removed, the internal battery FET
128                 is turned off in order to reduce the leakage from the BAT pin to less
129                 than 1uA. Note that on some devices/systems this disconnects the battery
130                 from the system. See device datasheet for details.
131
132                 Valid values:
133                 - 1: enabled
134                 - 0: disabled