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