1 # SPDX-License-Identifier: GPL-2.0 1 # SPDX-License-Identifier: GPL-2.0
2 %YAML 1.2 2 %YAML 1.2
3 --- 3 ---
4 $id: http://devicetree.org/schemas/power/suppl 4 $id: http://devicetree.org/schemas/power/supply/charger-manager.yaml#
5 $schema: http://devicetree.org/meta-schemas/co 5 $schema: http://devicetree.org/meta-schemas/core.yaml#
6 6
7 title: Charger Manager 7 title: Charger Manager
8 8
9 maintainers: 9 maintainers:
10 - Sebastian Reichel <sre@kernel.org> 10 - Sebastian Reichel <sre@kernel.org>
11 11
12 description: | 12 description: |
13 Binding for the legacy charger manager drive 13 Binding for the legacy charger manager driver.
14 Please do not use for new products. 14 Please do not use for new products.
15 15
16 properties: 16 properties:
17 compatible: 17 compatible:
18 const: charger-manager 18 const: charger-manager
19 19
20 cm-chargers: 20 cm-chargers:
21 description: name of chargers 21 description: name of chargers
22 $ref: /schemas/types.yaml#/definitions/str 22 $ref: /schemas/types.yaml#/definitions/string-array
23 23
24 cm-num-chargers: 24 cm-num-chargers:
25 $ref: /schemas/types.yaml#/definitions/uin 25 $ref: /schemas/types.yaml#/definitions/uint32
26 deprecated: true 26 deprecated: true
27 27
28 cm-fuel-gauge: 28 cm-fuel-gauge:
29 description: name of battery fuel gauge 29 description: name of battery fuel gauge
30 $ref: /schemas/types.yaml#/definitions/str 30 $ref: /schemas/types.yaml#/definitions/string
31 31
32 cm-name: 32 cm-name:
33 description: name of the charger manager 33 description: name of the charger manager
34 default: battery 34 default: battery
35 $ref: /schemas/types.yaml#/definitions/str 35 $ref: /schemas/types.yaml#/definitions/string
36 36
37 cm-poll-mode: 37 cm-poll-mode:
38 description: polling mode 38 description: polling mode
39 $ref: /schemas/types.yaml#/definitions/uin 39 $ref: /schemas/types.yaml#/definitions/uint32
40 default: 0 40 default: 0
41 enum: 41 enum:
42 - 0 # disabled 42 - 0 # disabled
43 - 1 # always 43 - 1 # always
44 - 2 # when external power is connected 44 - 2 # when external power is connected
45 - 3 # when charging 45 - 3 # when charging
46 46
47 cm-poll-interval: 47 cm-poll-interval:
48 description: polling interval (in ms) 48 description: polling interval (in ms)
49 $ref: /schemas/types.yaml#/definitions/uin 49 $ref: /schemas/types.yaml#/definitions/uint32
50 50
51 cm-battery-stat: 51 cm-battery-stat:
52 description: battery status 52 description: battery status
53 $ref: /schemas/types.yaml#/definitions/uin 53 $ref: /schemas/types.yaml#/definitions/uint32
54 enum: 54 enum:
55 - 0 # battery always present 55 - 0 # battery always present
56 - 1 # no battery 56 - 1 # no battery
57 - 2 # check presence via fuel gauge 57 - 2 # check presence via fuel gauge
58 - 3 # check presence via charger 58 - 3 # check presence via charger
59 59
60 cm-fullbatt-vchkdrop-volt: 60 cm-fullbatt-vchkdrop-volt:
61 description: voltage drop before restartin 61 description: voltage drop before restarting charging in uV
62 $ref: /schemas/types.yaml#/definitions/uin 62 $ref: /schemas/types.yaml#/definitions/uint32
63 63
64 cm-fullbatt-vchkdrop-ms: 64 cm-fullbatt-vchkdrop-ms:
65 deprecated: true 65 deprecated: true
66 66
67 cm-fullbatt-voltage: 67 cm-fullbatt-voltage:
68 description: voltage of full battery in uV 68 description: voltage of full battery in uV
69 $ref: /schemas/types.yaml#/definitions/uin 69 $ref: /schemas/types.yaml#/definitions/uint32
70 70
71 cm-fullbatt-soc: 71 cm-fullbatt-soc:
72 description: state of charge to consider a 72 description: state of charge to consider as full battery in %
73 $ref: /schemas/types.yaml#/definitions/uin 73 $ref: /schemas/types.yaml#/definitions/uint32
74 74
75 cm-fullbatt-capacity: 75 cm-fullbatt-capacity:
76 description: capcity to consider as full b 76 description: capcity to consider as full battery in uAh
77 $ref: /schemas/types.yaml#/definitions/uin 77 $ref: /schemas/types.yaml#/definitions/uint32
78 78
79 cm-thermal-zone: 79 cm-thermal-zone:
80 description: name of external thermometer' 80 description: name of external thermometer's thermal zone
81 $ref: /schemas/types.yaml#/definitions/str 81 $ref: /schemas/types.yaml#/definitions/string
82 82
83 cm-discharging-max: 83 cm-discharging-max:
84 description: limits of discharging duratio 84 description: limits of discharging duration in ms
85 $ref: /schemas/types.yaml#/definitions/uin 85 $ref: /schemas/types.yaml#/definitions/uint32
86 86
87 cm-charging-max: 87 cm-charging-max:
88 description: limits of charging duration i 88 description: limits of charging duration in ms
89 $ref: /schemas/types.yaml#/definitions/uin 89 $ref: /schemas/types.yaml#/definitions/uint32
90 90
91 cm-battery-cold: 91 cm-battery-cold:
92 description: critical cold temperature of 92 description: critical cold temperature of battery for charging in deci-degree celsius
93 $ref: /schemas/types.yaml#/definitions/uin 93 $ref: /schemas/types.yaml#/definitions/uint32
94 94
95 cm-battery-cold-in-minus: 95 cm-battery-cold-in-minus:
96 description: if set cm-battery-cold temper 96 description: if set cm-battery-cold temperature is in minus degrees
97 type: boolean 97 type: boolean
98 98
99 cm-battery-hot: 99 cm-battery-hot:
100 description: critical hot temperature of b 100 description: critical hot temperature of battery for charging in deci-degree celsius
101 $ref: /schemas/types.yaml#/definitions/uin 101 $ref: /schemas/types.yaml#/definitions/uint32
102 102
103 cm-battery-temp-diff: 103 cm-battery-temp-diff:
104 description: temperature difference to all 104 description: temperature difference to allow recharging in deci-degree celsius
105 $ref: /schemas/types.yaml#/definitions/uin 105 $ref: /schemas/types.yaml#/definitions/uint32
106 106
107 patternProperties: 107 patternProperties:
108 "-supply$": 108 "-supply$":
109 description: regulator consumer, named acc 109 description: regulator consumer, named according to cm-regulator-name
110 $ref: /schemas/types.yaml#/definitions/pha 110 $ref: /schemas/types.yaml#/definitions/phandle
111 111
112 "^regulator[@-][0-9]$": 112 "^regulator[@-][0-9]$":
113 type: object 113 type: object
114 properties: 114 properties:
115 cm-regulator-name: 115 cm-regulator-name:
116 description: name of charger regulator 116 description: name of charger regulator
117 $ref: /schemas/types.yaml#/definitions 117 $ref: /schemas/types.yaml#/definitions/string
118 118
119 required: 119 required:
120 - cm-regulator-name 120 - cm-regulator-name
121 121
122 additionalProperties: false 122 additionalProperties: false
123 123
124 patternProperties: 124 patternProperties:
125 "^cable[@-][0-9]$": 125 "^cable[@-][0-9]$":
126 type: object 126 type: object
127 properties: 127 properties:
128 cm-cable-name: 128 cm-cable-name:
129 description: name of charger cable 129 description: name of charger cable
130 enum: 130 enum:
131 - USB 131 - USB
132 - USB-HOST 132 - USB-HOST
133 - SDP 133 - SDP
134 - DCP 134 - DCP
135 - CDP 135 - CDP
136 - ACA 136 - ACA
137 - FAST-CHARGER 137 - FAST-CHARGER
138 - SLOW-CHARGER 138 - SLOW-CHARGER
139 - WPT 139 - WPT
140 - PD 140 - PD
141 - DOCK 141 - DOCK
142 - JIG 142 - JIG
143 - MECHANICAL 143 - MECHANICAL
144 144
145 cm-cable-extcon: 145 cm-cable-extcon:
146 description: name of extcon dev 146 description: name of extcon dev
147 $ref: /schemas/types.yaml#/definit 147 $ref: /schemas/types.yaml#/definitions/string
148 148
149 cm-cable-min: 149 cm-cable-min:
150 description: minimum current of ca 150 description: minimum current of cable in uA
151 $ref: /schemas/types.yaml#/definit 151 $ref: /schemas/types.yaml#/definitions/uint32
152 152
153 cm-cable-max: 153 cm-cable-max:
154 description: maximum current of ca 154 description: maximum current of cable in uA
155 $ref: /schemas/types.yaml#/definit 155 $ref: /schemas/types.yaml#/definitions/uint32
156 156
157 required: 157 required:
158 - cm-cable-name 158 - cm-cable-name
159 - cm-cable-extcon 159 - cm-cable-extcon
160 160
161 additionalProperties: false 161 additionalProperties: false
162 162
163 required: 163 required:
164 - compatible 164 - compatible
165 - cm-chargers 165 - cm-chargers
166 - cm-fuel-gauge 166 - cm-fuel-gauge
167 167
168 additionalProperties: false 168 additionalProperties: false
169 169
170 examples: 170 examples:
171 - | 171 - |
172 charger-manager { 172 charger-manager {
173 compatible = "charger-manager"; 173 compatible = "charger-manager";
174 chg-reg-supply = <&charger_regulator>; 174 chg-reg-supply = <&charger_regulator>;
175 175
176 cm-name = "battery"; 176 cm-name = "battery";
177 /* Always polling ON : 30s */ 177 /* Always polling ON : 30s */
178 cm-poll-mode = <1>; 178 cm-poll-mode = <1>;
179 cm-poll-interval = <30000>; 179 cm-poll-interval = <30000>;
180 180
181 cm-fullbatt-vchkdrop-volt = <150000>; 181 cm-fullbatt-vchkdrop-volt = <150000>;
182 cm-fullbatt-soc = <100>; 182 cm-fullbatt-soc = <100>;
183 183
184 cm-battery-stat = <3>; 184 cm-battery-stat = <3>;
185 185
186 cm-chargers = "charger0", "charger1", 186 cm-chargers = "charger0", "charger1", "charger2";
187 187
188 cm-fuel-gauge = "fuelgauge0"; 188 cm-fuel-gauge = "fuelgauge0";
189 189
190 cm-thermal-zone = "thermal_zone.1"; 190 cm-thermal-zone = "thermal_zone.1";
191 /* in deci centigrade */ 191 /* in deci centigrade */
192 cm-battery-cold = <50>; 192 cm-battery-cold = <50>;
193 cm-battery-cold-in-minus; 193 cm-battery-cold-in-minus;
194 cm-battery-hot = <800>; 194 cm-battery-hot = <800>;
195 cm-battery-temp-diff = <100>; 195 cm-battery-temp-diff = <100>;
196 196
197 /* Allow charging for 5hr */ 197 /* Allow charging for 5hr */
198 cm-charging-max = <18000000>; 198 cm-charging-max = <18000000>;
199 /* Allow discharging for 2hr */ 199 /* Allow discharging for 2hr */
200 cm-discharging-max = <7200000>; 200 cm-discharging-max = <7200000>;
201 201
202 regulator-0 { 202 regulator-0 {
203 cm-regulator-name = "chg-reg"; 203 cm-regulator-name = "chg-reg";
204 cable-0 { 204 cable-0 {
205 cm-cable-name = "USB"; 205 cm-cable-name = "USB";
206 cm-cable-extcon = "extcon-dev. 206 cm-cable-extcon = "extcon-dev.0";
207 cm-cable-min = <475000>; 207 cm-cable-min = <475000>;
208 cm-cable-max = <500000>; 208 cm-cable-max = <500000>;
209 }; 209 };
210 cable-1 { 210 cable-1 {
211 cm-cable-name = "SDP"; 211 cm-cable-name = "SDP";
212 cm-cable-extcon = "extcon-dev. 212 cm-cable-extcon = "extcon-dev.0";
213 cm-cable-min = <650000>; 213 cm-cable-min = <650000>;
214 cm-cable-max = <675000>; 214 cm-cable-max = <675000>;
215 }; 215 };
216 }; 216 };
217 }; 217 };
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.