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