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