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#ifndef __LINUX_REGULATOR_CONSUMER_H_
32#define __LINUX_REGULATOR_CONSUMER_H_
33
34#include <linux/err.h>
35#include <linux/suspend.h>
36
37struct device;
38struct notifier_block;
39struct regmap;
40struct regulator_dev;
41
42
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#define REGULATOR_MODE_INVALID 0x0
82#define REGULATOR_MODE_FAST 0x1
83#define REGULATOR_MODE_NORMAL 0x2
84#define REGULATOR_MODE_IDLE 0x4
85#define REGULATOR_MODE_STANDBY 0x8
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109#define REGULATOR_EVENT_UNDER_VOLTAGE 0x01
110#define REGULATOR_EVENT_OVER_CURRENT 0x02
111#define REGULATOR_EVENT_REGULATION_OUT 0x04
112#define REGULATOR_EVENT_FAIL 0x08
113#define REGULATOR_EVENT_OVER_TEMP 0x10
114#define REGULATOR_EVENT_FORCE_DISABLE 0x20
115#define REGULATOR_EVENT_VOLTAGE_CHANGE 0x40
116#define REGULATOR_EVENT_DISABLE 0x80
117#define REGULATOR_EVENT_PRE_VOLTAGE_CHANGE 0x100
118#define REGULATOR_EVENT_ABORT_VOLTAGE_CHANGE 0x200
119#define REGULATOR_EVENT_PRE_DISABLE 0x400
120#define REGULATOR_EVENT_ABORT_DISABLE 0x800
121#define REGULATOR_EVENT_ENABLE 0x1000
122
123
124
125
126
127#define REGULATOR_EVENT_UNDER_VOLTAGE_WARN 0x2000
128#define REGULATOR_EVENT_OVER_CURRENT_WARN 0x4000
129#define REGULATOR_EVENT_OVER_VOLTAGE_WARN 0x8000
130#define REGULATOR_EVENT_OVER_TEMP_WARN 0x10000
131#define REGULATOR_EVENT_WARN_MASK 0x1E000
132
133
134
135
136
137
138
139
140
141
142
143
144
145#define REGULATOR_ERROR_UNDER_VOLTAGE BIT(1)
146#define REGULATOR_ERROR_OVER_CURRENT BIT(2)
147#define REGULATOR_ERROR_REGULATION_OUT BIT(3)
148#define REGULATOR_ERROR_FAIL BIT(4)
149#define REGULATOR_ERROR_OVER_TEMP BIT(5)
150
151#define REGULATOR_ERROR_UNDER_VOLTAGE_WARN BIT(6)
152#define REGULATOR_ERROR_OVER_CURRENT_WARN BIT(7)
153#define REGULATOR_ERROR_OVER_VOLTAGE_WARN BIT(8)
154#define REGULATOR_ERROR_OVER_TEMP_WARN BIT(9)
155
156
157
158
159
160
161
162
163struct pre_voltage_change_data {
164 unsigned long old_uV;
165 unsigned long min_uV;
166 unsigned long max_uV;
167};
168
169struct regulator;
170
171
172
173
174
175
176
177
178
179
180
181
182
183struct regulator_bulk_data {
184 const char *supply;
185 struct regulator *consumer;
186
187
188 int ret;
189};
190
191#if defined(CONFIG_REGULATOR)
192
193
194struct regulator *__must_check regulator_get(struct device *dev,
195 const char *id);
196struct regulator *__must_check devm_regulator_get(struct device *dev,
197 const char *id);
198struct regulator *__must_check regulator_get_exclusive(struct device *dev,
199 const char *id);
200struct regulator *__must_check devm_regulator_get_exclusive(struct device *dev,
201 const char *id);
202struct regulator *__must_check regulator_get_optional(struct device *dev,
203 const char *id);
204struct regulator *__must_check devm_regulator_get_optional(struct device *dev,
205 const char *id);
206void regulator_put(struct regulator *regulator);
207void devm_regulator_put(struct regulator *regulator);
208
209int regulator_register_supply_alias(struct device *dev, const char *id,
210 struct device *alias_dev,
211 const char *alias_id);
212void regulator_unregister_supply_alias(struct device *dev, const char *id);
213
214int regulator_bulk_register_supply_alias(struct device *dev,
215 const char *const *id,
216 struct device *alias_dev,
217 const char *const *alias_id,
218 int num_id);
219void regulator_bulk_unregister_supply_alias(struct device *dev,
220 const char * const *id, int num_id);
221
222int devm_regulator_register_supply_alias(struct device *dev, const char *id,
223 struct device *alias_dev,
224 const char *alias_id);
225
226int devm_regulator_bulk_register_supply_alias(struct device *dev,
227 const char *const *id,
228 struct device *alias_dev,
229 const char *const *alias_id,
230 int num_id);
231
232
233int __must_check regulator_enable(struct regulator *regulator);
234int regulator_disable(struct regulator *regulator);
235int regulator_force_disable(struct regulator *regulator);
236int regulator_is_enabled(struct regulator *regulator);
237int regulator_disable_deferred(struct regulator *regulator, int ms);
238
239int __must_check regulator_bulk_get(struct device *dev, int num_consumers,
240 struct regulator_bulk_data *consumers);
241int __must_check devm_regulator_bulk_get(struct device *dev, int num_consumers,
242 struct regulator_bulk_data *consumers);
243int __must_check regulator_bulk_enable(int num_consumers,
244 struct regulator_bulk_data *consumers);
245int regulator_bulk_disable(int num_consumers,
246 struct regulator_bulk_data *consumers);
247int regulator_bulk_force_disable(int num_consumers,
248 struct regulator_bulk_data *consumers);
249void regulator_bulk_free(int num_consumers,
250 struct regulator_bulk_data *consumers);
251
252int regulator_count_voltages(struct regulator *regulator);
253int regulator_list_voltage(struct regulator *regulator, unsigned selector);
254int regulator_is_supported_voltage(struct regulator *regulator,
255 int min_uV, int max_uV);
256unsigned int regulator_get_linear_step(struct regulator *regulator);
257int regulator_set_voltage(struct regulator *regulator, int min_uV, int max_uV);
258int regulator_set_voltage_time(struct regulator *regulator,
259 int old_uV, int new_uV);
260int regulator_get_voltage(struct regulator *regulator);
261int regulator_sync_voltage(struct regulator *regulator);
262int regulator_set_current_limit(struct regulator *regulator,
263 int min_uA, int max_uA);
264int regulator_get_current_limit(struct regulator *regulator);
265
266int regulator_set_mode(struct regulator *regulator, unsigned int mode);
267unsigned int regulator_get_mode(struct regulator *regulator);
268int regulator_get_error_flags(struct regulator *regulator,
269 unsigned int *flags);
270int regulator_set_load(struct regulator *regulator, int load_uA);
271
272int regulator_allow_bypass(struct regulator *regulator, bool allow);
273
274struct regmap *regulator_get_regmap(struct regulator *regulator);
275int regulator_get_hardware_vsel_register(struct regulator *regulator,
276 unsigned *vsel_reg,
277 unsigned *vsel_mask);
278int regulator_list_hardware_vsel(struct regulator *regulator,
279 unsigned selector);
280
281
282int regulator_register_notifier(struct regulator *regulator,
283 struct notifier_block *nb);
284int devm_regulator_register_notifier(struct regulator *regulator,
285 struct notifier_block *nb);
286int regulator_unregister_notifier(struct regulator *regulator,
287 struct notifier_block *nb);
288void devm_regulator_unregister_notifier(struct regulator *regulator,
289 struct notifier_block *nb);
290
291
292int regulator_suspend_enable(struct regulator_dev *rdev,
293 suspend_state_t state);
294int regulator_suspend_disable(struct regulator_dev *rdev,
295 suspend_state_t state);
296int regulator_set_suspend_voltage(struct regulator *regulator, int min_uV,
297 int max_uV, suspend_state_t state);
298
299
300void *regulator_get_drvdata(struct regulator *regulator);
301void regulator_set_drvdata(struct regulator *regulator, void *data);
302
303
304
305void regulator_bulk_set_supply_names(struct regulator_bulk_data *consumers,
306 const char *const *supply_names,
307 unsigned int num_supplies);
308
309bool regulator_is_equal(struct regulator *reg1, struct regulator *reg2);
310
311#else
312
313
314
315
316
317static inline struct regulator *__must_check regulator_get(struct device *dev,
318 const char *id)
319{
320
321
322
323
324
325
326
327
328 return NULL;
329}
330
331static inline struct regulator *__must_check
332devm_regulator_get(struct device *dev, const char *id)
333{
334 return NULL;
335}
336
337static inline struct regulator *__must_check
338regulator_get_exclusive(struct device *dev, const char *id)
339{
340 return ERR_PTR(-ENODEV);
341}
342
343static inline struct regulator *__must_check
344devm_regulator_get_exclusive(struct device *dev, const char *id)
345{
346 return ERR_PTR(-ENODEV);
347}
348
349static inline struct regulator *__must_check
350regulator_get_optional(struct device *dev, const char *id)
351{
352 return ERR_PTR(-ENODEV);
353}
354
355
356static inline struct regulator *__must_check
357devm_regulator_get_optional(struct device *dev, const char *id)
358{
359 return ERR_PTR(-ENODEV);
360}
361
362static inline void regulator_put(struct regulator *regulator)
363{
364}
365
366static inline void devm_regulator_put(struct regulator *regulator)
367{
368}
369
370static inline int regulator_register_supply_alias(struct device *dev,
371 const char *id,
372 struct device *alias_dev,
373 const char *alias_id)
374{
375 return 0;
376}
377
378static inline void regulator_unregister_supply_alias(struct device *dev,
379 const char *id)
380{
381}
382
383static inline int regulator_bulk_register_supply_alias(struct device *dev,
384 const char *const *id,
385 struct device *alias_dev,
386 const char * const *alias_id,
387 int num_id)
388{
389 return 0;
390}
391
392static inline void regulator_bulk_unregister_supply_alias(struct device *dev,
393 const char * const *id,
394 int num_id)
395{
396}
397
398static inline int devm_regulator_register_supply_alias(struct device *dev,
399 const char *id,
400 struct device *alias_dev,
401 const char *alias_id)
402{
403 return 0;
404}
405
406static inline int devm_regulator_bulk_register_supply_alias(struct device *dev,
407 const char *const *id,
408 struct device *alias_dev,
409 const char *const *alias_id,
410 int num_id)
411{
412 return 0;
413}
414
415static inline int regulator_enable(struct regulator *regulator)
416{
417 return 0;
418}
419
420static inline int regulator_disable(struct regulator *regulator)
421{
422 return 0;
423}
424
425static inline int regulator_force_disable(struct regulator *regulator)
426{
427 return 0;
428}
429
430static inline int regulator_disable_deferred(struct regulator *regulator,
431 int ms)
432{
433 return 0;
434}
435
436static inline int regulator_is_enabled(struct regulator *regulator)
437{
438 return 1;
439}
440
441static inline int regulator_bulk_get(struct device *dev,
442 int num_consumers,
443 struct regulator_bulk_data *consumers)
444{
445 return 0;
446}
447
448static inline int devm_regulator_bulk_get(struct device *dev, int num_consumers,
449 struct regulator_bulk_data *consumers)
450{
451 return 0;
452}
453
454static inline int regulator_bulk_enable(int num_consumers,
455 struct regulator_bulk_data *consumers)
456{
457 return 0;
458}
459
460static inline int regulator_bulk_disable(int num_consumers,
461 struct regulator_bulk_data *consumers)
462{
463 return 0;
464}
465
466static inline int regulator_bulk_force_disable(int num_consumers,
467 struct regulator_bulk_data *consumers)
468{
469 return 0;
470}
471
472static inline void regulator_bulk_free(int num_consumers,
473 struct regulator_bulk_data *consumers)
474{
475}
476
477static inline int regulator_set_voltage(struct regulator *regulator,
478 int min_uV, int max_uV)
479{
480 return 0;
481}
482
483static inline int regulator_set_voltage_time(struct regulator *regulator,
484 int old_uV, int new_uV)
485{
486 return 0;
487}
488
489static inline int regulator_get_voltage(struct regulator *regulator)
490{
491 return -EINVAL;
492}
493
494static inline int regulator_sync_voltage(struct regulator *regulator)
495{
496 return -EINVAL;
497}
498
499static inline int regulator_is_supported_voltage(struct regulator *regulator,
500 int min_uV, int max_uV)
501{
502 return 0;
503}
504
505static inline unsigned int regulator_get_linear_step(struct regulator *regulator)
506{
507 return 0;
508}
509
510static inline int regulator_set_current_limit(struct regulator *regulator,
511 int min_uA, int max_uA)
512{
513 return 0;
514}
515
516static inline int regulator_get_current_limit(struct regulator *regulator)
517{
518 return 0;
519}
520
521static inline int regulator_set_mode(struct regulator *regulator,
522 unsigned int mode)
523{
524 return 0;
525}
526
527static inline unsigned int regulator_get_mode(struct regulator *regulator)
528{
529 return REGULATOR_MODE_NORMAL;
530}
531
532static inline int regulator_get_error_flags(struct regulator *regulator,
533 unsigned int *flags)
534{
535 return -EINVAL;
536}
537
538static inline int regulator_set_load(struct regulator *regulator, int load_uA)
539{
540 return 0;
541}
542
543static inline int regulator_allow_bypass(struct regulator *regulator,
544 bool allow)
545{
546 return 0;
547}
548
549static inline struct regmap *regulator_get_regmap(struct regulator *regulator)
550{
551 return ERR_PTR(-EOPNOTSUPP);
552}
553
554static inline int regulator_get_hardware_vsel_register(struct regulator *regulator,
555 unsigned *vsel_reg,
556 unsigned *vsel_mask)
557{
558 return -EOPNOTSUPP;
559}
560
561static inline int regulator_list_hardware_vsel(struct regulator *regulator,
562 unsigned selector)
563{
564 return -EOPNOTSUPP;
565}
566
567static inline int regulator_register_notifier(struct regulator *regulator,
568 struct notifier_block *nb)
569{
570 return 0;
571}
572
573static inline int devm_regulator_register_notifier(struct regulator *regulator,
574 struct notifier_block *nb)
575{
576 return 0;
577}
578
579static inline int regulator_unregister_notifier(struct regulator *regulator,
580 struct notifier_block *nb)
581{
582 return 0;
583}
584
585static inline int devm_regulator_unregister_notifier(struct regulator *regulator,
586 struct notifier_block *nb)
587{
588 return 0;
589}
590
591static inline int regulator_suspend_enable(struct regulator_dev *rdev,
592 suspend_state_t state)
593{
594 return -EINVAL;
595}
596
597static inline int regulator_suspend_disable(struct regulator_dev *rdev,
598 suspend_state_t state)
599{
600 return -EINVAL;
601}
602
603static inline int regulator_set_suspend_voltage(struct regulator *regulator,
604 int min_uV, int max_uV,
605 suspend_state_t state)
606{
607 return -EINVAL;
608}
609
610static inline void *regulator_get_drvdata(struct regulator *regulator)
611{
612 return NULL;
613}
614
615static inline void regulator_set_drvdata(struct regulator *regulator,
616 void *data)
617{
618}
619
620static inline int regulator_count_voltages(struct regulator *regulator)
621{
622 return 0;
623}
624
625static inline int regulator_list_voltage(struct regulator *regulator, unsigned selector)
626{
627 return -EINVAL;
628}
629
630static inline void
631regulator_bulk_set_supply_names(struct regulator_bulk_data *consumers,
632 const char *const *supply_names,
633 unsigned int num_supplies)
634{
635}
636
637static inline bool
638regulator_is_equal(struct regulator *reg1, struct regulator *reg2)
639{
640 return false;
641}
642#endif
643
644static inline int regulator_set_voltage_triplet(struct regulator *regulator,
645 int min_uV, int target_uV,
646 int max_uV)
647{
648 if (regulator_set_voltage(regulator, target_uV, max_uV) == 0)
649 return 0;
650
651 return regulator_set_voltage(regulator, min_uV, max_uV);
652}
653
654static inline int regulator_set_voltage_tol(struct regulator *regulator,
655 int new_uV, int tol_uV)
656{
657 if (regulator_set_voltage(regulator, new_uV, new_uV + tol_uV) == 0)
658 return 0;
659 else
660 return regulator_set_voltage(regulator,
661 new_uV - tol_uV, new_uV + tol_uV);
662}
663
664static inline int regulator_is_supported_voltage_tol(struct regulator *regulator,
665 int target_uV, int tol_uV)
666{
667 return regulator_is_supported_voltage(regulator,
668 target_uV - tol_uV,
669 target_uV + tol_uV);
670}
671
672#endif
673