1
2
3
4
5
6
7
8
9
10
11
12
13#ifndef __LINUX_POWER_SUPPLY_H__
14#define __LINUX_POWER_SUPPLY_H__
15
16#include <linux/device.h>
17#include <linux/workqueue.h>
18#include <linux/leds.h>
19#include <linux/spinlock.h>
20#include <linux/notifier.h>
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35enum {
36 POWER_SUPPLY_STATUS_UNKNOWN = 0,
37 POWER_SUPPLY_STATUS_CHARGING,
38 POWER_SUPPLY_STATUS_DISCHARGING,
39 POWER_SUPPLY_STATUS_NOT_CHARGING,
40 POWER_SUPPLY_STATUS_FULL,
41};
42
43enum {
44 POWER_SUPPLY_CHARGE_TYPE_UNKNOWN = 0,
45 POWER_SUPPLY_CHARGE_TYPE_NONE,
46 POWER_SUPPLY_CHARGE_TYPE_TRICKLE,
47 POWER_SUPPLY_CHARGE_TYPE_FAST,
48};
49
50enum {
51 POWER_SUPPLY_HEALTH_UNKNOWN = 0,
52 POWER_SUPPLY_HEALTH_GOOD,
53 POWER_SUPPLY_HEALTH_OVERHEAT,
54 POWER_SUPPLY_HEALTH_DEAD,
55 POWER_SUPPLY_HEALTH_OVERVOLTAGE,
56 POWER_SUPPLY_HEALTH_UNSPEC_FAILURE,
57 POWER_SUPPLY_HEALTH_COLD,
58 POWER_SUPPLY_HEALTH_WATCHDOG_TIMER_EXPIRE,
59 POWER_SUPPLY_HEALTH_SAFETY_TIMER_EXPIRE,
60};
61
62enum {
63 POWER_SUPPLY_TECHNOLOGY_UNKNOWN = 0,
64 POWER_SUPPLY_TECHNOLOGY_NiMH,
65 POWER_SUPPLY_TECHNOLOGY_LION,
66 POWER_SUPPLY_TECHNOLOGY_LIPO,
67 POWER_SUPPLY_TECHNOLOGY_LiFe,
68 POWER_SUPPLY_TECHNOLOGY_NiCd,
69 POWER_SUPPLY_TECHNOLOGY_LiMn,
70};
71
72enum {
73 POWER_SUPPLY_CAPACITY_LEVEL_UNKNOWN = 0,
74 POWER_SUPPLY_CAPACITY_LEVEL_CRITICAL,
75 POWER_SUPPLY_CAPACITY_LEVEL_LOW,
76 POWER_SUPPLY_CAPACITY_LEVEL_NORMAL,
77 POWER_SUPPLY_CAPACITY_LEVEL_HIGH,
78 POWER_SUPPLY_CAPACITY_LEVEL_FULL,
79};
80
81enum {
82 POWER_SUPPLY_SCOPE_UNKNOWN = 0,
83 POWER_SUPPLY_SCOPE_SYSTEM,
84 POWER_SUPPLY_SCOPE_DEVICE,
85};
86
87enum power_supply_property {
88
89 POWER_SUPPLY_PROP_STATUS = 0,
90 POWER_SUPPLY_PROP_CHARGE_TYPE,
91 POWER_SUPPLY_PROP_HEALTH,
92 POWER_SUPPLY_PROP_PRESENT,
93 POWER_SUPPLY_PROP_ONLINE,
94 POWER_SUPPLY_PROP_AUTHENTIC,
95 POWER_SUPPLY_PROP_TECHNOLOGY,
96 POWER_SUPPLY_PROP_CYCLE_COUNT,
97 POWER_SUPPLY_PROP_VOLTAGE_MAX,
98 POWER_SUPPLY_PROP_VOLTAGE_MIN,
99 POWER_SUPPLY_PROP_VOLTAGE_MAX_DESIGN,
100 POWER_SUPPLY_PROP_VOLTAGE_MIN_DESIGN,
101 POWER_SUPPLY_PROP_VOLTAGE_NOW,
102 POWER_SUPPLY_PROP_VOLTAGE_AVG,
103 POWER_SUPPLY_PROP_VOLTAGE_OCV,
104 POWER_SUPPLY_PROP_VOLTAGE_BOOT,
105 POWER_SUPPLY_PROP_CURRENT_MAX,
106 POWER_SUPPLY_PROP_CURRENT_NOW,
107 POWER_SUPPLY_PROP_CURRENT_AVG,
108 POWER_SUPPLY_PROP_CURRENT_BOOT,
109 POWER_SUPPLY_PROP_POWER_NOW,
110 POWER_SUPPLY_PROP_POWER_AVG,
111 POWER_SUPPLY_PROP_CHARGE_FULL_DESIGN,
112 POWER_SUPPLY_PROP_CHARGE_EMPTY_DESIGN,
113 POWER_SUPPLY_PROP_CHARGE_FULL,
114 POWER_SUPPLY_PROP_CHARGE_EMPTY,
115 POWER_SUPPLY_PROP_CHARGE_NOW,
116 POWER_SUPPLY_PROP_CHARGE_AVG,
117 POWER_SUPPLY_PROP_CHARGE_COUNTER,
118 POWER_SUPPLY_PROP_CONSTANT_CHARGE_CURRENT,
119 POWER_SUPPLY_PROP_CONSTANT_CHARGE_CURRENT_MAX,
120 POWER_SUPPLY_PROP_CONSTANT_CHARGE_VOLTAGE,
121 POWER_SUPPLY_PROP_CONSTANT_CHARGE_VOLTAGE_MAX,
122 POWER_SUPPLY_PROP_CHARGE_CONTROL_LIMIT,
123 POWER_SUPPLY_PROP_CHARGE_CONTROL_LIMIT_MAX,
124 POWER_SUPPLY_PROP_INPUT_CURRENT_LIMIT,
125 POWER_SUPPLY_PROP_ENERGY_FULL_DESIGN,
126 POWER_SUPPLY_PROP_ENERGY_EMPTY_DESIGN,
127 POWER_SUPPLY_PROP_ENERGY_FULL,
128 POWER_SUPPLY_PROP_ENERGY_EMPTY,
129 POWER_SUPPLY_PROP_ENERGY_NOW,
130 POWER_SUPPLY_PROP_ENERGY_AVG,
131 POWER_SUPPLY_PROP_CAPACITY,
132 POWER_SUPPLY_PROP_CAPACITY_ALERT_MIN,
133 POWER_SUPPLY_PROP_CAPACITY_ALERT_MAX,
134 POWER_SUPPLY_PROP_CAPACITY_LEVEL,
135 POWER_SUPPLY_PROP_TEMP,
136 POWER_SUPPLY_PROP_TEMP_MAX,
137 POWER_SUPPLY_PROP_TEMP_MIN,
138 POWER_SUPPLY_PROP_TEMP_ALERT_MIN,
139 POWER_SUPPLY_PROP_TEMP_ALERT_MAX,
140 POWER_SUPPLY_PROP_TEMP_AMBIENT,
141 POWER_SUPPLY_PROP_TEMP_AMBIENT_ALERT_MIN,
142 POWER_SUPPLY_PROP_TEMP_AMBIENT_ALERT_MAX,
143 POWER_SUPPLY_PROP_TIME_TO_EMPTY_NOW,
144 POWER_SUPPLY_PROP_TIME_TO_EMPTY_AVG,
145 POWER_SUPPLY_PROP_TIME_TO_FULL_NOW,
146 POWER_SUPPLY_PROP_TIME_TO_FULL_AVG,
147 POWER_SUPPLY_PROP_TYPE,
148 POWER_SUPPLY_PROP_SCOPE,
149 POWER_SUPPLY_PROP_PRECHARGE_CURRENT,
150 POWER_SUPPLY_PROP_CHARGE_TERM_CURRENT,
151 POWER_SUPPLY_PROP_CALIBRATE,
152
153 POWER_SUPPLY_PROP_MODEL_NAME,
154 POWER_SUPPLY_PROP_MANUFACTURER,
155 POWER_SUPPLY_PROP_SERIAL_NUMBER,
156};
157
158enum power_supply_type {
159 POWER_SUPPLY_TYPE_UNKNOWN = 0,
160 POWER_SUPPLY_TYPE_BATTERY,
161 POWER_SUPPLY_TYPE_UPS,
162 POWER_SUPPLY_TYPE_MAINS,
163 POWER_SUPPLY_TYPE_USB,
164 POWER_SUPPLY_TYPE_USB_DCP,
165 POWER_SUPPLY_TYPE_USB_CDP,
166 POWER_SUPPLY_TYPE_USB_ACA,
167 POWER_SUPPLY_TYPE_USB_TYPE_C,
168 POWER_SUPPLY_TYPE_USB_PD,
169 POWER_SUPPLY_TYPE_USB_PD_DRP,
170 POWER_SUPPLY_TYPE_APPLE_BRICK_ID,
171};
172
173enum power_supply_notifier_events {
174 PSY_EVENT_PROP_CHANGED,
175};
176
177union power_supply_propval {
178 int intval;
179 const char *strval;
180};
181
182struct device_node;
183struct power_supply;
184
185
186struct power_supply_config {
187 struct device_node *of_node;
188
189 void *drv_data;
190
191 char **supplied_to;
192 size_t num_supplicants;
193};
194
195
196struct power_supply_desc {
197 const char *name;
198 enum power_supply_type type;
199 enum power_supply_property *properties;
200 size_t num_properties;
201
202
203
204
205
206
207
208 int (*get_property)(struct power_supply *psy,
209 enum power_supply_property psp,
210 union power_supply_propval *val);
211 int (*set_property)(struct power_supply *psy,
212 enum power_supply_property psp,
213 const union power_supply_propval *val);
214
215
216
217
218
219 int (*property_is_writeable)(struct power_supply *psy,
220 enum power_supply_property psp);
221 void (*external_power_changed)(struct power_supply *psy);
222 void (*set_charged)(struct power_supply *psy);
223
224
225
226
227
228
229 bool no_thermal;
230
231 int use_for_apm;
232};
233
234struct power_supply {
235 const struct power_supply_desc *desc;
236
237 char **supplied_to;
238 size_t num_supplicants;
239
240 char **supplied_from;
241 size_t num_supplies;
242 struct device_node *of_node;
243
244
245 void *drv_data;
246
247
248 struct device dev;
249 struct work_struct changed_work;
250 struct delayed_work deferred_register_work;
251 spinlock_t changed_lock;
252 bool changed;
253 bool initialized;
254 atomic_t use_cnt;
255#ifdef CONFIG_THERMAL
256 struct thermal_zone_device *tzd;
257 struct thermal_cooling_device *tcd;
258#endif
259
260#ifdef CONFIG_LEDS_TRIGGERS
261 struct led_trigger *charging_full_trig;
262 char *charging_full_trig_name;
263 struct led_trigger *charging_trig;
264 char *charging_trig_name;
265 struct led_trigger *full_trig;
266 char *full_trig_name;
267 struct led_trigger *online_trig;
268 char *online_trig_name;
269 struct led_trigger *charging_blink_full_solid_trig;
270 char *charging_blink_full_solid_trig_name;
271#endif
272};
273
274
275
276
277
278
279
280
281struct power_supply_info {
282 const char *name;
283 int technology;
284 int voltage_max_design;
285 int voltage_min_design;
286 int charge_full_design;
287 int charge_empty_design;
288 int energy_full_design;
289 int energy_empty_design;
290 int use_for_apm;
291};
292
293
294
295
296
297
298
299
300
301
302struct power_supply_battery_info {
303 int energy_full_design_uwh;
304 int charge_full_design_uah;
305 int voltage_min_design_uv;
306 int precharge_current_ua;
307 int charge_term_current_ua;
308 int constant_charge_current_max_ua;
309 int constant_charge_voltage_max_uv;
310};
311
312extern struct atomic_notifier_head power_supply_notifier;
313extern int power_supply_reg_notifier(struct notifier_block *nb);
314extern void power_supply_unreg_notifier(struct notifier_block *nb);
315extern struct power_supply *power_supply_get_by_name(const char *name);
316extern void power_supply_put(struct power_supply *psy);
317#ifdef CONFIG_OF
318extern struct power_supply *power_supply_get_by_phandle(struct device_node *np,
319 const char *property);
320extern struct power_supply *devm_power_supply_get_by_phandle(
321 struct device *dev, const char *property);
322#else
323static inline struct power_supply *
324power_supply_get_by_phandle(struct device_node *np, const char *property)
325{ return NULL; }
326static inline struct power_supply *
327devm_power_supply_get_by_phandle(struct device *dev, const char *property)
328{ return NULL; }
329#endif
330
331extern int power_supply_get_battery_info(struct power_supply *psy,
332 struct power_supply_battery_info *info);
333extern void power_supply_changed(struct power_supply *psy);
334extern int power_supply_am_i_supplied(struct power_supply *psy);
335extern int power_supply_set_battery_charged(struct power_supply *psy);
336
337#ifdef CONFIG_POWER_SUPPLY
338extern int power_supply_is_system_supplied(void);
339#else
340static inline int power_supply_is_system_supplied(void) { return -ENOSYS; }
341#endif
342
343extern int power_supply_get_property(struct power_supply *psy,
344 enum power_supply_property psp,
345 union power_supply_propval *val);
346extern int power_supply_set_property(struct power_supply *psy,
347 enum power_supply_property psp,
348 const union power_supply_propval *val);
349extern int power_supply_property_is_writeable(struct power_supply *psy,
350 enum power_supply_property psp);
351extern void power_supply_external_power_changed(struct power_supply *psy);
352
353extern struct power_supply *__must_check
354power_supply_register(struct device *parent,
355 const struct power_supply_desc *desc,
356 const struct power_supply_config *cfg);
357extern struct power_supply *__must_check
358power_supply_register_no_ws(struct device *parent,
359 const struct power_supply_desc *desc,
360 const struct power_supply_config *cfg);
361extern struct power_supply *__must_check
362devm_power_supply_register(struct device *parent,
363 const struct power_supply_desc *desc,
364 const struct power_supply_config *cfg);
365extern struct power_supply *__must_check
366devm_power_supply_register_no_ws(struct device *parent,
367 const struct power_supply_desc *desc,
368 const struct power_supply_config *cfg);
369extern void power_supply_unregister(struct power_supply *psy);
370extern int power_supply_powers(struct power_supply *psy, struct device *dev);
371
372extern void *power_supply_get_drvdata(struct power_supply *psy);
373
374extern struct class *power_supply_class;
375
376static inline bool power_supply_is_amp_property(enum power_supply_property psp)
377{
378 switch (psp) {
379 case POWER_SUPPLY_PROP_CHARGE_FULL_DESIGN:
380 case POWER_SUPPLY_PROP_CHARGE_EMPTY_DESIGN:
381 case POWER_SUPPLY_PROP_CHARGE_FULL:
382 case POWER_SUPPLY_PROP_CHARGE_EMPTY:
383 case POWER_SUPPLY_PROP_CHARGE_NOW:
384 case POWER_SUPPLY_PROP_CHARGE_AVG:
385 case POWER_SUPPLY_PROP_CHARGE_COUNTER:
386 case POWER_SUPPLY_PROP_PRECHARGE_CURRENT:
387 case POWER_SUPPLY_PROP_CHARGE_TERM_CURRENT:
388 case POWER_SUPPLY_PROP_CONSTANT_CHARGE_CURRENT:
389 case POWER_SUPPLY_PROP_CONSTANT_CHARGE_CURRENT_MAX:
390 case POWER_SUPPLY_PROP_CURRENT_MAX:
391 case POWER_SUPPLY_PROP_CURRENT_NOW:
392 case POWER_SUPPLY_PROP_CURRENT_AVG:
393 case POWER_SUPPLY_PROP_CURRENT_BOOT:
394 return 1;
395 default:
396 break;
397 }
398
399 return 0;
400}
401
402static inline bool power_supply_is_watt_property(enum power_supply_property psp)
403{
404 switch (psp) {
405 case POWER_SUPPLY_PROP_ENERGY_FULL_DESIGN:
406 case POWER_SUPPLY_PROP_ENERGY_EMPTY_DESIGN:
407 case POWER_SUPPLY_PROP_ENERGY_FULL:
408 case POWER_SUPPLY_PROP_ENERGY_EMPTY:
409 case POWER_SUPPLY_PROP_ENERGY_NOW:
410 case POWER_SUPPLY_PROP_ENERGY_AVG:
411 case POWER_SUPPLY_PROP_VOLTAGE_MAX:
412 case POWER_SUPPLY_PROP_VOLTAGE_MIN:
413 case POWER_SUPPLY_PROP_VOLTAGE_MAX_DESIGN:
414 case POWER_SUPPLY_PROP_VOLTAGE_MIN_DESIGN:
415 case POWER_SUPPLY_PROP_VOLTAGE_NOW:
416 case POWER_SUPPLY_PROP_VOLTAGE_AVG:
417 case POWER_SUPPLY_PROP_VOLTAGE_OCV:
418 case POWER_SUPPLY_PROP_VOLTAGE_BOOT:
419 case POWER_SUPPLY_PROP_CONSTANT_CHARGE_VOLTAGE:
420 case POWER_SUPPLY_PROP_CONSTANT_CHARGE_VOLTAGE_MAX:
421 case POWER_SUPPLY_PROP_POWER_NOW:
422 return 1;
423 default:
424 break;
425 }
426
427 return 0;
428}
429
430#endif
431