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