1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35#ifndef __LINUX_REGULATOR_CONSUMER_H_
36#define __LINUX_REGULATOR_CONSUMER_H_
37
38#include <linux/err.h>
39
40struct device;
41struct notifier_block;
42struct regmap;
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83#define REGULATOR_MODE_FAST 0x1
84#define REGULATOR_MODE_NORMAL 0x2
85#define REGULATOR_MODE_IDLE 0x4
86#define REGULATOR_MODE_STANDBY 0x8
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110#define REGULATOR_EVENT_UNDER_VOLTAGE 0x01
111#define REGULATOR_EVENT_OVER_CURRENT 0x02
112#define REGULATOR_EVENT_REGULATION_OUT 0x04
113#define REGULATOR_EVENT_FAIL 0x08
114#define REGULATOR_EVENT_OVER_TEMP 0x10
115#define REGULATOR_EVENT_FORCE_DISABLE 0x20
116#define REGULATOR_EVENT_VOLTAGE_CHANGE 0x40
117#define REGULATOR_EVENT_DISABLE 0x80
118#define REGULATOR_EVENT_PRE_VOLTAGE_CHANGE 0x100
119#define REGULATOR_EVENT_ABORT_VOLTAGE_CHANGE 0x200
120#define REGULATOR_EVENT_PRE_DISABLE 0x400
121#define REGULATOR_EVENT_ABORT_DISABLE 0x800
122
123
124
125
126
127
128
129
130struct pre_voltage_change_data {
131 unsigned long old_uV;
132 unsigned long min_uV;
133 unsigned long max_uV;
134};
135
136struct regulator;
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152struct regulator_bulk_data {
153 const char *supply;
154 bool optional;
155 struct regulator *consumer;
156
157
158 int ret;
159};
160
161#if defined(CONFIG_REGULATOR)
162
163
164struct regulator *__must_check regulator_get(struct device *dev,
165 const char *id);
166struct regulator *__must_check devm_regulator_get(struct device *dev,
167 const char *id);
168struct regulator *__must_check regulator_get_exclusive(struct device *dev,
169 const char *id);
170struct regulator *__must_check devm_regulator_get_exclusive(struct device *dev,
171 const char *id);
172struct regulator *__must_check regulator_get_optional(struct device *dev,
173 const char *id);
174struct regulator *__must_check devm_regulator_get_optional(struct device *dev,
175 const char *id);
176void regulator_put(struct regulator *regulator);
177void devm_regulator_put(struct regulator *regulator);
178
179int regulator_register_supply_alias(struct device *dev, const char *id,
180 struct device *alias_dev,
181 const char *alias_id);
182void regulator_unregister_supply_alias(struct device *dev, const char *id);
183
184int regulator_bulk_register_supply_alias(struct device *dev,
185 const char *const *id,
186 struct device *alias_dev,
187 const char *const *alias_id,
188 int num_id);
189void regulator_bulk_unregister_supply_alias(struct device *dev,
190 const char * const *id, int num_id);
191
192int devm_regulator_register_supply_alias(struct device *dev, const char *id,
193 struct device *alias_dev,
194 const char *alias_id);
195void devm_regulator_unregister_supply_alias(struct device *dev,
196 const char *id);
197
198int devm_regulator_bulk_register_supply_alias(struct device *dev,
199 const char *const *id,
200 struct device *alias_dev,
201 const char *const *alias_id,
202 int num_id);
203void devm_regulator_bulk_unregister_supply_alias(struct device *dev,
204 const char *const *id,
205 int num_id);
206
207
208int __must_check regulator_enable(struct regulator *regulator);
209int regulator_disable(struct regulator *regulator);
210int regulator_force_disable(struct regulator *regulator);
211int regulator_is_enabled(struct regulator *regulator);
212int regulator_disable_deferred(struct regulator *regulator, int ms);
213
214int __must_check regulator_bulk_get(struct device *dev, int num_consumers,
215 struct regulator_bulk_data *consumers);
216int __must_check devm_regulator_bulk_get(struct device *dev, int num_consumers,
217 struct regulator_bulk_data *consumers);
218int __must_check regulator_bulk_enable(int num_consumers,
219 struct regulator_bulk_data *consumers);
220int regulator_bulk_disable(int num_consumers,
221 struct regulator_bulk_data *consumers);
222int regulator_bulk_force_disable(int num_consumers,
223 struct regulator_bulk_data *consumers);
224void regulator_bulk_free(int num_consumers,
225 struct regulator_bulk_data *consumers);
226
227int regulator_can_change_voltage(struct regulator *regulator);
228int regulator_count_voltages(struct regulator *regulator);
229int regulator_list_voltage(struct regulator *regulator, unsigned selector);
230int regulator_is_supported_voltage(struct regulator *regulator,
231 int min_uV, int max_uV);
232unsigned int regulator_get_linear_step(struct regulator *regulator);
233int regulator_set_voltage(struct regulator *regulator, int min_uV, int max_uV);
234int regulator_set_voltage_time(struct regulator *regulator,
235 int old_uV, int new_uV);
236int regulator_get_voltage(struct regulator *regulator);
237int regulator_sync_voltage(struct regulator *regulator);
238int regulator_set_current_limit(struct regulator *regulator,
239 int min_uA, int max_uA);
240int regulator_get_current_limit(struct regulator *regulator);
241
242int regulator_set_mode(struct regulator *regulator, unsigned int mode);
243unsigned int regulator_get_mode(struct regulator *regulator);
244int regulator_set_load(struct regulator *regulator, int load_uA);
245
246int regulator_allow_bypass(struct regulator *regulator, bool allow);
247
248struct regmap *regulator_get_regmap(struct regulator *regulator);
249int regulator_get_hardware_vsel_register(struct regulator *regulator,
250 unsigned *vsel_reg,
251 unsigned *vsel_mask);
252int regulator_list_hardware_vsel(struct regulator *regulator,
253 unsigned selector);
254
255
256int regulator_register_notifier(struct regulator *regulator,
257 struct notifier_block *nb);
258int devm_regulator_register_notifier(struct regulator *regulator,
259 struct notifier_block *nb);
260int regulator_unregister_notifier(struct regulator *regulator,
261 struct notifier_block *nb);
262void devm_regulator_unregister_notifier(struct regulator *regulator,
263 struct notifier_block *nb);
264
265
266void *regulator_get_drvdata(struct regulator *regulator);
267void regulator_set_drvdata(struct regulator *regulator, void *data);
268
269#else
270
271
272
273
274
275static inline struct regulator *__must_check regulator_get(struct device *dev,
276 const char *id)
277{
278
279
280
281
282
283
284
285
286 return NULL;
287}
288
289static inline struct regulator *__must_check
290devm_regulator_get(struct device *dev, const char *id)
291{
292 return NULL;
293}
294
295static inline struct regulator *__must_check
296regulator_get_exclusive(struct device *dev, const char *id)
297{
298 return ERR_PTR(-ENODEV);
299}
300
301static inline struct regulator *__must_check
302regulator_get_optional(struct device *dev, const char *id)
303{
304 return ERR_PTR(-ENODEV);
305}
306
307
308static inline struct regulator *__must_check
309devm_regulator_get_optional(struct device *dev, const char *id)
310{
311 return ERR_PTR(-ENODEV);
312}
313
314static inline void regulator_put(struct regulator *regulator)
315{
316}
317
318static inline void devm_regulator_put(struct regulator *regulator)
319{
320}
321
322static inline int regulator_register_supply_alias(struct device *dev,
323 const char *id,
324 struct device *alias_dev,
325 const char *alias_id)
326{
327 return 0;
328}
329
330static inline void regulator_unregister_supply_alias(struct device *dev,
331 const char *id)
332{
333}
334
335static inline int regulator_bulk_register_supply_alias(struct device *dev,
336 const char *const *id,
337 struct device *alias_dev,
338 const char * const *alias_id,
339 int num_id)
340{
341 return 0;
342}
343
344static inline void regulator_bulk_unregister_supply_alias(struct device *dev,
345 const char * const *id,
346 int num_id)
347{
348}
349
350static inline int devm_regulator_register_supply_alias(struct device *dev,
351 const char *id,
352 struct device *alias_dev,
353 const char *alias_id)
354{
355 return 0;
356}
357
358static inline void devm_regulator_unregister_supply_alias(struct device *dev,
359 const char *id)
360{
361}
362
363static inline int devm_regulator_bulk_register_supply_alias(struct device *dev,
364 const char *const *id,
365 struct device *alias_dev,
366 const char *const *alias_id,
367 int num_id)
368{
369 return 0;
370}
371
372static inline void devm_regulator_bulk_unregister_supply_alias(
373 struct device *dev, const char *const *id, int num_id)
374{
375}
376
377static inline int regulator_enable(struct regulator *regulator)
378{
379 return 0;
380}
381
382static inline int regulator_disable(struct regulator *regulator)
383{
384 return 0;
385}
386
387static inline int regulator_force_disable(struct regulator *regulator)
388{
389 return 0;
390}
391
392static inline int regulator_disable_deferred(struct regulator *regulator,
393 int ms)
394{
395 return 0;
396}
397
398static inline int regulator_is_enabled(struct regulator *regulator)
399{
400 return 1;
401}
402
403static inline int regulator_bulk_get(struct device *dev,
404 int num_consumers,
405 struct regulator_bulk_data *consumers)
406{
407 return 0;
408}
409
410static inline int devm_regulator_bulk_get(struct device *dev, int num_consumers,
411 struct regulator_bulk_data *consumers)
412{
413 return 0;
414}
415
416static inline int regulator_bulk_enable(int num_consumers,
417 struct regulator_bulk_data *consumers)
418{
419 return 0;
420}
421
422static inline int regulator_bulk_disable(int num_consumers,
423 struct regulator_bulk_data *consumers)
424{
425 return 0;
426}
427
428static inline int regulator_bulk_force_disable(int num_consumers,
429 struct regulator_bulk_data *consumers)
430{
431 return 0;
432}
433
434static inline void regulator_bulk_free(int num_consumers,
435 struct regulator_bulk_data *consumers)
436{
437}
438
439static inline int regulator_can_change_voltage(struct regulator *regulator)
440{
441 return 0;
442}
443
444static inline int regulator_set_voltage(struct regulator *regulator,
445 int min_uV, int max_uV)
446{
447 return 0;
448}
449
450static inline int regulator_set_voltage_time(struct regulator *regulator,
451 int old_uV, int new_uV)
452{
453 return 0;
454}
455
456static inline int regulator_get_voltage(struct regulator *regulator)
457{
458 return -EINVAL;
459}
460
461static inline int regulator_is_supported_voltage(struct regulator *regulator,
462 int min_uV, int max_uV)
463{
464 return 0;
465}
466
467static inline int regulator_set_current_limit(struct regulator *regulator,
468 int min_uA, int max_uA)
469{
470 return 0;
471}
472
473static inline int regulator_get_current_limit(struct regulator *regulator)
474{
475 return 0;
476}
477
478static inline int regulator_set_mode(struct regulator *regulator,
479 unsigned int mode)
480{
481 return 0;
482}
483
484static inline unsigned int regulator_get_mode(struct regulator *regulator)
485{
486 return REGULATOR_MODE_NORMAL;
487}
488
489static inline int regulator_set_load(struct regulator *regulator, int load_uA)
490{
491 return REGULATOR_MODE_NORMAL;
492}
493
494static inline int regulator_allow_bypass(struct regulator *regulator,
495 bool allow)
496{
497 return 0;
498}
499
500static inline struct regmap *regulator_get_regmap(struct regulator *regulator)
501{
502 return ERR_PTR(-EOPNOTSUPP);
503}
504
505static inline int regulator_get_hardware_vsel_register(struct regulator *regulator,
506 unsigned *vsel_reg,
507 unsigned *vsel_mask)
508{
509 return -EOPNOTSUPP;
510}
511
512static inline int regulator_list_hardware_vsel(struct regulator *regulator,
513 unsigned selector)
514{
515 return -EOPNOTSUPP;
516}
517
518static inline int regulator_register_notifier(struct regulator *regulator,
519 struct notifier_block *nb)
520{
521 return 0;
522}
523
524static inline int devm_regulator_register_notifier(struct regulator *regulator,
525 struct notifier_block *nb)
526{
527 return 0;
528}
529
530static inline int regulator_unregister_notifier(struct regulator *regulator,
531 struct notifier_block *nb)
532{
533 return 0;
534}
535
536static inline int devm_regulator_unregister_notifier(struct regulator *regulator,
537 struct notifier_block *nb)
538{
539 return 0;
540}
541
542static inline void *regulator_get_drvdata(struct regulator *regulator)
543{
544 return NULL;
545}
546
547static inline void regulator_set_drvdata(struct regulator *regulator,
548 void *data)
549{
550}
551
552static inline int regulator_count_voltages(struct regulator *regulator)
553{
554 return 0;
555}
556
557static inline int regulator_list_voltage(struct regulator *regulator, unsigned selector)
558{
559 return -EINVAL;
560}
561
562#endif
563
564static inline int regulator_set_voltage_triplet(struct regulator *regulator,
565 int min_uV, int target_uV,
566 int max_uV)
567{
568 if (regulator_set_voltage(regulator, target_uV, max_uV) == 0)
569 return 0;
570
571 return regulator_set_voltage(regulator, min_uV, max_uV);
572}
573
574static inline int regulator_set_voltage_tol(struct regulator *regulator,
575 int new_uV, int tol_uV)
576{
577 if (regulator_set_voltage(regulator, new_uV, new_uV + tol_uV) == 0)
578 return 0;
579 else
580 return regulator_set_voltage(regulator,
581 new_uV - tol_uV, new_uV + tol_uV);
582}
583
584static inline int regulator_is_supported_voltage_tol(struct regulator *regulator,
585 int target_uV, int tol_uV)
586{
587 return regulator_is_supported_voltage(regulator,
588 target_uV - tol_uV,
589 target_uV + tol_uV);
590}
591
592#endif
593