xref: /openbmc/linux/drivers/regulator/core.c (revision 973e9a27)
1414c70cbSLiam Girdwood /*
2414c70cbSLiam Girdwood  * core.c  --  Voltage/Current Regulator framework.
3414c70cbSLiam Girdwood  *
4414c70cbSLiam Girdwood  * Copyright 2007, 2008 Wolfson Microelectronics PLC.
5a5766f11SLiam Girdwood  * Copyright 2008 SlimLogic Ltd.
6414c70cbSLiam Girdwood  *
7a5766f11SLiam Girdwood  * Author: Liam Girdwood <lrg@slimlogic.co.uk>
8414c70cbSLiam Girdwood  *
9414c70cbSLiam Girdwood  *  This program is free software; you can redistribute  it and/or modify it
10414c70cbSLiam Girdwood  *  under  the terms of  the GNU General  Public License as published by the
11414c70cbSLiam Girdwood  *  Free Software Foundation;  either version 2 of the  License, or (at your
12414c70cbSLiam Girdwood  *  option) any later version.
13414c70cbSLiam Girdwood  *
14414c70cbSLiam Girdwood  */
15414c70cbSLiam Girdwood 
16414c70cbSLiam Girdwood #include <linux/kernel.h>
17414c70cbSLiam Girdwood #include <linux/init.h>
18414c70cbSLiam Girdwood #include <linux/device.h>
19414c70cbSLiam Girdwood #include <linux/err.h>
20414c70cbSLiam Girdwood #include <linux/mutex.h>
21414c70cbSLiam Girdwood #include <linux/suspend.h>
22414c70cbSLiam Girdwood #include <linux/regulator/consumer.h>
23414c70cbSLiam Girdwood #include <linux/regulator/driver.h>
24414c70cbSLiam Girdwood #include <linux/regulator/machine.h>
25414c70cbSLiam Girdwood 
26414c70cbSLiam Girdwood #define REGULATOR_VERSION "0.5"
27414c70cbSLiam Girdwood 
28414c70cbSLiam Girdwood static DEFINE_MUTEX(regulator_list_mutex);
29414c70cbSLiam Girdwood static LIST_HEAD(regulator_list);
30414c70cbSLiam Girdwood static LIST_HEAD(regulator_map_list);
31ca725561SMark Brown static int has_full_constraints;
32414c70cbSLiam Girdwood 
338dc5390dSMark Brown /*
34414c70cbSLiam Girdwood  * struct regulator_map
35414c70cbSLiam Girdwood  *
36414c70cbSLiam Girdwood  * Used to provide symbolic supply names to devices.
37414c70cbSLiam Girdwood  */
38414c70cbSLiam Girdwood struct regulator_map {
39414c70cbSLiam Girdwood 	struct list_head list;
4040f9244fSMark Brown 	const char *dev_name;   /* The dev_name() for the consumer */
41414c70cbSLiam Girdwood 	const char *supply;
42a5766f11SLiam Girdwood 	struct regulator_dev *regulator;
43414c70cbSLiam Girdwood };
44414c70cbSLiam Girdwood 
45414c70cbSLiam Girdwood /*
46414c70cbSLiam Girdwood  * struct regulator
47414c70cbSLiam Girdwood  *
48414c70cbSLiam Girdwood  * One for each consumer device.
49414c70cbSLiam Girdwood  */
50414c70cbSLiam Girdwood struct regulator {
51414c70cbSLiam Girdwood 	struct device *dev;
52414c70cbSLiam Girdwood 	struct list_head list;
53414c70cbSLiam Girdwood 	int uA_load;
54414c70cbSLiam Girdwood 	int min_uV;
55414c70cbSLiam Girdwood 	int max_uV;
56414c70cbSLiam Girdwood 	char *supply_name;
57414c70cbSLiam Girdwood 	struct device_attribute dev_attr;
58414c70cbSLiam Girdwood 	struct regulator_dev *rdev;
59414c70cbSLiam Girdwood };
60414c70cbSLiam Girdwood 
61414c70cbSLiam Girdwood static int _regulator_is_enabled(struct regulator_dev *rdev);
62414c70cbSLiam Girdwood static int _regulator_disable(struct regulator_dev *rdev);
63414c70cbSLiam Girdwood static int _regulator_get_voltage(struct regulator_dev *rdev);
64414c70cbSLiam Girdwood static int _regulator_get_current_limit(struct regulator_dev *rdev);
65414c70cbSLiam Girdwood static unsigned int _regulator_get_mode(struct regulator_dev *rdev);
66414c70cbSLiam Girdwood static void _notifier_call_chain(struct regulator_dev *rdev,
67414c70cbSLiam Girdwood 				  unsigned long event, void *data);
68414c70cbSLiam Girdwood 
691083c393SMark Brown static const char *rdev_get_name(struct regulator_dev *rdev)
701083c393SMark Brown {
711083c393SMark Brown 	if (rdev->constraints && rdev->constraints->name)
721083c393SMark Brown 		return rdev->constraints->name;
731083c393SMark Brown 	else if (rdev->desc->name)
741083c393SMark Brown 		return rdev->desc->name;
751083c393SMark Brown 	else
761083c393SMark Brown 		return "";
771083c393SMark Brown }
781083c393SMark Brown 
79414c70cbSLiam Girdwood /* gets the regulator for a given consumer device */
80414c70cbSLiam Girdwood static struct regulator *get_device_regulator(struct device *dev)
81414c70cbSLiam Girdwood {
82414c70cbSLiam Girdwood 	struct regulator *regulator = NULL;
83414c70cbSLiam Girdwood 	struct regulator_dev *rdev;
84414c70cbSLiam Girdwood 
85414c70cbSLiam Girdwood 	mutex_lock(&regulator_list_mutex);
86414c70cbSLiam Girdwood 	list_for_each_entry(rdev, &regulator_list, list) {
87414c70cbSLiam Girdwood 		mutex_lock(&rdev->mutex);
88414c70cbSLiam Girdwood 		list_for_each_entry(regulator, &rdev->consumer_list, list) {
89414c70cbSLiam Girdwood 			if (regulator->dev == dev) {
90414c70cbSLiam Girdwood 				mutex_unlock(&rdev->mutex);
91414c70cbSLiam Girdwood 				mutex_unlock(&regulator_list_mutex);
92414c70cbSLiam Girdwood 				return regulator;
93414c70cbSLiam Girdwood 			}
94414c70cbSLiam Girdwood 		}
95414c70cbSLiam Girdwood 		mutex_unlock(&rdev->mutex);
96414c70cbSLiam Girdwood 	}
97414c70cbSLiam Girdwood 	mutex_unlock(&regulator_list_mutex);
98414c70cbSLiam Girdwood 	return NULL;
99414c70cbSLiam Girdwood }
100414c70cbSLiam Girdwood 
101414c70cbSLiam Girdwood /* Platform voltage constraint check */
102414c70cbSLiam Girdwood static int regulator_check_voltage(struct regulator_dev *rdev,
103414c70cbSLiam Girdwood 				   int *min_uV, int *max_uV)
104414c70cbSLiam Girdwood {
105414c70cbSLiam Girdwood 	BUG_ON(*min_uV > *max_uV);
106414c70cbSLiam Girdwood 
107414c70cbSLiam Girdwood 	if (!rdev->constraints) {
108414c70cbSLiam Girdwood 		printk(KERN_ERR "%s: no constraints for %s\n", __func__,
1091083c393SMark Brown 		       rdev_get_name(rdev));
110414c70cbSLiam Girdwood 		return -ENODEV;
111414c70cbSLiam Girdwood 	}
112414c70cbSLiam Girdwood 	if (!(rdev->constraints->valid_ops_mask & REGULATOR_CHANGE_VOLTAGE)) {
113414c70cbSLiam Girdwood 		printk(KERN_ERR "%s: operation not allowed for %s\n",
1141083c393SMark Brown 		       __func__, rdev_get_name(rdev));
115414c70cbSLiam Girdwood 		return -EPERM;
116414c70cbSLiam Girdwood 	}
117414c70cbSLiam Girdwood 
118414c70cbSLiam Girdwood 	if (*max_uV > rdev->constraints->max_uV)
119414c70cbSLiam Girdwood 		*max_uV = rdev->constraints->max_uV;
120414c70cbSLiam Girdwood 	if (*min_uV < rdev->constraints->min_uV)
121414c70cbSLiam Girdwood 		*min_uV = rdev->constraints->min_uV;
122414c70cbSLiam Girdwood 
123414c70cbSLiam Girdwood 	if (*min_uV > *max_uV)
124414c70cbSLiam Girdwood 		return -EINVAL;
125414c70cbSLiam Girdwood 
126414c70cbSLiam Girdwood 	return 0;
127414c70cbSLiam Girdwood }
128414c70cbSLiam Girdwood 
129414c70cbSLiam Girdwood /* current constraint check */
130414c70cbSLiam Girdwood static int regulator_check_current_limit(struct regulator_dev *rdev,
131414c70cbSLiam Girdwood 					int *min_uA, int *max_uA)
132414c70cbSLiam Girdwood {
133414c70cbSLiam Girdwood 	BUG_ON(*min_uA > *max_uA);
134414c70cbSLiam Girdwood 
135414c70cbSLiam Girdwood 	if (!rdev->constraints) {
136414c70cbSLiam Girdwood 		printk(KERN_ERR "%s: no constraints for %s\n", __func__,
1371083c393SMark Brown 		       rdev_get_name(rdev));
138414c70cbSLiam Girdwood 		return -ENODEV;
139414c70cbSLiam Girdwood 	}
140414c70cbSLiam Girdwood 	if (!(rdev->constraints->valid_ops_mask & REGULATOR_CHANGE_CURRENT)) {
141414c70cbSLiam Girdwood 		printk(KERN_ERR "%s: operation not allowed for %s\n",
1421083c393SMark Brown 		       __func__, rdev_get_name(rdev));
143414c70cbSLiam Girdwood 		return -EPERM;
144414c70cbSLiam Girdwood 	}
145414c70cbSLiam Girdwood 
146414c70cbSLiam Girdwood 	if (*max_uA > rdev->constraints->max_uA)
147414c70cbSLiam Girdwood 		*max_uA = rdev->constraints->max_uA;
148414c70cbSLiam Girdwood 	if (*min_uA < rdev->constraints->min_uA)
149414c70cbSLiam Girdwood 		*min_uA = rdev->constraints->min_uA;
150414c70cbSLiam Girdwood 
151414c70cbSLiam Girdwood 	if (*min_uA > *max_uA)
152414c70cbSLiam Girdwood 		return -EINVAL;
153414c70cbSLiam Girdwood 
154414c70cbSLiam Girdwood 	return 0;
155414c70cbSLiam Girdwood }
156414c70cbSLiam Girdwood 
157414c70cbSLiam Girdwood /* operating mode constraint check */
158414c70cbSLiam Girdwood static int regulator_check_mode(struct regulator_dev *rdev, int mode)
159414c70cbSLiam Girdwood {
160e573520bSDavid Brownell 	switch (mode) {
161e573520bSDavid Brownell 	case REGULATOR_MODE_FAST:
162e573520bSDavid Brownell 	case REGULATOR_MODE_NORMAL:
163e573520bSDavid Brownell 	case REGULATOR_MODE_IDLE:
164e573520bSDavid Brownell 	case REGULATOR_MODE_STANDBY:
165e573520bSDavid Brownell 		break;
166e573520bSDavid Brownell 	default:
167e573520bSDavid Brownell 		return -EINVAL;
168e573520bSDavid Brownell 	}
169e573520bSDavid Brownell 
170414c70cbSLiam Girdwood 	if (!rdev->constraints) {
171414c70cbSLiam Girdwood 		printk(KERN_ERR "%s: no constraints for %s\n", __func__,
1721083c393SMark Brown 		       rdev_get_name(rdev));
173414c70cbSLiam Girdwood 		return -ENODEV;
174414c70cbSLiam Girdwood 	}
175414c70cbSLiam Girdwood 	if (!(rdev->constraints->valid_ops_mask & REGULATOR_CHANGE_MODE)) {
176414c70cbSLiam Girdwood 		printk(KERN_ERR "%s: operation not allowed for %s\n",
1771083c393SMark Brown 		       __func__, rdev_get_name(rdev));
178414c70cbSLiam Girdwood 		return -EPERM;
179414c70cbSLiam Girdwood 	}
180414c70cbSLiam Girdwood 	if (!(rdev->constraints->valid_modes_mask & mode)) {
181414c70cbSLiam Girdwood 		printk(KERN_ERR "%s: invalid mode %x for %s\n",
1821083c393SMark Brown 		       __func__, mode, rdev_get_name(rdev));
183414c70cbSLiam Girdwood 		return -EINVAL;
184414c70cbSLiam Girdwood 	}
185414c70cbSLiam Girdwood 	return 0;
186414c70cbSLiam Girdwood }
187414c70cbSLiam Girdwood 
188414c70cbSLiam Girdwood /* dynamic regulator mode switching constraint check */
189414c70cbSLiam Girdwood static int regulator_check_drms(struct regulator_dev *rdev)
190414c70cbSLiam Girdwood {
191414c70cbSLiam Girdwood 	if (!rdev->constraints) {
192414c70cbSLiam Girdwood 		printk(KERN_ERR "%s: no constraints for %s\n", __func__,
1931083c393SMark Brown 		       rdev_get_name(rdev));
194414c70cbSLiam Girdwood 		return -ENODEV;
195414c70cbSLiam Girdwood 	}
196414c70cbSLiam Girdwood 	if (!(rdev->constraints->valid_ops_mask & REGULATOR_CHANGE_DRMS)) {
197414c70cbSLiam Girdwood 		printk(KERN_ERR "%s: operation not allowed for %s\n",
1981083c393SMark Brown 		       __func__, rdev_get_name(rdev));
199414c70cbSLiam Girdwood 		return -EPERM;
200414c70cbSLiam Girdwood 	}
201414c70cbSLiam Girdwood 	return 0;
202414c70cbSLiam Girdwood }
203414c70cbSLiam Girdwood 
204414c70cbSLiam Girdwood static ssize_t device_requested_uA_show(struct device *dev,
205414c70cbSLiam Girdwood 			     struct device_attribute *attr, char *buf)
206414c70cbSLiam Girdwood {
207414c70cbSLiam Girdwood 	struct regulator *regulator;
208414c70cbSLiam Girdwood 
209414c70cbSLiam Girdwood 	regulator = get_device_regulator(dev);
210414c70cbSLiam Girdwood 	if (regulator == NULL)
211414c70cbSLiam Girdwood 		return 0;
212414c70cbSLiam Girdwood 
213414c70cbSLiam Girdwood 	return sprintf(buf, "%d\n", regulator->uA_load);
214414c70cbSLiam Girdwood }
215414c70cbSLiam Girdwood 
216414c70cbSLiam Girdwood static ssize_t regulator_uV_show(struct device *dev,
217414c70cbSLiam Girdwood 				struct device_attribute *attr, char *buf)
218414c70cbSLiam Girdwood {
219a5766f11SLiam Girdwood 	struct regulator_dev *rdev = dev_get_drvdata(dev);
220414c70cbSLiam Girdwood 	ssize_t ret;
221414c70cbSLiam Girdwood 
222414c70cbSLiam Girdwood 	mutex_lock(&rdev->mutex);
223414c70cbSLiam Girdwood 	ret = sprintf(buf, "%d\n", _regulator_get_voltage(rdev));
224414c70cbSLiam Girdwood 	mutex_unlock(&rdev->mutex);
225414c70cbSLiam Girdwood 
226414c70cbSLiam Girdwood 	return ret;
227414c70cbSLiam Girdwood }
2287ad68e2fSDavid Brownell static DEVICE_ATTR(microvolts, 0444, regulator_uV_show, NULL);
229414c70cbSLiam Girdwood 
230414c70cbSLiam Girdwood static ssize_t regulator_uA_show(struct device *dev,
231414c70cbSLiam Girdwood 				struct device_attribute *attr, char *buf)
232414c70cbSLiam Girdwood {
233a5766f11SLiam Girdwood 	struct regulator_dev *rdev = dev_get_drvdata(dev);
234414c70cbSLiam Girdwood 
235414c70cbSLiam Girdwood 	return sprintf(buf, "%d\n", _regulator_get_current_limit(rdev));
236414c70cbSLiam Girdwood }
2377ad68e2fSDavid Brownell static DEVICE_ATTR(microamps, 0444, regulator_uA_show, NULL);
238414c70cbSLiam Girdwood 
239bc558a60SMark Brown static ssize_t regulator_name_show(struct device *dev,
240bc558a60SMark Brown 			     struct device_attribute *attr, char *buf)
241bc558a60SMark Brown {
242bc558a60SMark Brown 	struct regulator_dev *rdev = dev_get_drvdata(dev);
243bc558a60SMark Brown 
2441083c393SMark Brown 	return sprintf(buf, "%s\n", rdev_get_name(rdev));
245bc558a60SMark Brown }
246bc558a60SMark Brown 
2474fca9545SDavid Brownell static ssize_t regulator_print_opmode(char *buf, int mode)
248414c70cbSLiam Girdwood {
249414c70cbSLiam Girdwood 	switch (mode) {
250414c70cbSLiam Girdwood 	case REGULATOR_MODE_FAST:
251414c70cbSLiam Girdwood 		return sprintf(buf, "fast\n");
252414c70cbSLiam Girdwood 	case REGULATOR_MODE_NORMAL:
253414c70cbSLiam Girdwood 		return sprintf(buf, "normal\n");
254414c70cbSLiam Girdwood 	case REGULATOR_MODE_IDLE:
255414c70cbSLiam Girdwood 		return sprintf(buf, "idle\n");
256414c70cbSLiam Girdwood 	case REGULATOR_MODE_STANDBY:
257414c70cbSLiam Girdwood 		return sprintf(buf, "standby\n");
258414c70cbSLiam Girdwood 	}
259414c70cbSLiam Girdwood 	return sprintf(buf, "unknown\n");
260414c70cbSLiam Girdwood }
261414c70cbSLiam Girdwood 
2624fca9545SDavid Brownell static ssize_t regulator_opmode_show(struct device *dev,
263414c70cbSLiam Girdwood 				    struct device_attribute *attr, char *buf)
264414c70cbSLiam Girdwood {
265a5766f11SLiam Girdwood 	struct regulator_dev *rdev = dev_get_drvdata(dev);
266414c70cbSLiam Girdwood 
2674fca9545SDavid Brownell 	return regulator_print_opmode(buf, _regulator_get_mode(rdev));
2684fca9545SDavid Brownell }
2697ad68e2fSDavid Brownell static DEVICE_ATTR(opmode, 0444, regulator_opmode_show, NULL);
2704fca9545SDavid Brownell 
2714fca9545SDavid Brownell static ssize_t regulator_print_state(char *buf, int state)
2724fca9545SDavid Brownell {
273414c70cbSLiam Girdwood 	if (state > 0)
274414c70cbSLiam Girdwood 		return sprintf(buf, "enabled\n");
275414c70cbSLiam Girdwood 	else if (state == 0)
276414c70cbSLiam Girdwood 		return sprintf(buf, "disabled\n");
277414c70cbSLiam Girdwood 	else
278414c70cbSLiam Girdwood 		return sprintf(buf, "unknown\n");
279414c70cbSLiam Girdwood }
280414c70cbSLiam Girdwood 
2814fca9545SDavid Brownell static ssize_t regulator_state_show(struct device *dev,
2824fca9545SDavid Brownell 				   struct device_attribute *attr, char *buf)
2834fca9545SDavid Brownell {
2844fca9545SDavid Brownell 	struct regulator_dev *rdev = dev_get_drvdata(dev);
2859332546fSMark Brown 	ssize_t ret;
2864fca9545SDavid Brownell 
2879332546fSMark Brown 	mutex_lock(&rdev->mutex);
2889332546fSMark Brown 	ret = regulator_print_state(buf, _regulator_is_enabled(rdev));
2899332546fSMark Brown 	mutex_unlock(&rdev->mutex);
2909332546fSMark Brown 
2919332546fSMark Brown 	return ret;
2924fca9545SDavid Brownell }
2937ad68e2fSDavid Brownell static DEVICE_ATTR(state, 0444, regulator_state_show, NULL);
2944fca9545SDavid Brownell 
295853116a1SDavid Brownell static ssize_t regulator_status_show(struct device *dev,
296853116a1SDavid Brownell 				   struct device_attribute *attr, char *buf)
297853116a1SDavid Brownell {
298853116a1SDavid Brownell 	struct regulator_dev *rdev = dev_get_drvdata(dev);
299853116a1SDavid Brownell 	int status;
300853116a1SDavid Brownell 	char *label;
301853116a1SDavid Brownell 
302853116a1SDavid Brownell 	status = rdev->desc->ops->get_status(rdev);
303853116a1SDavid Brownell 	if (status < 0)
304853116a1SDavid Brownell 		return status;
305853116a1SDavid Brownell 
306853116a1SDavid Brownell 	switch (status) {
307853116a1SDavid Brownell 	case REGULATOR_STATUS_OFF:
308853116a1SDavid Brownell 		label = "off";
309853116a1SDavid Brownell 		break;
310853116a1SDavid Brownell 	case REGULATOR_STATUS_ON:
311853116a1SDavid Brownell 		label = "on";
312853116a1SDavid Brownell 		break;
313853116a1SDavid Brownell 	case REGULATOR_STATUS_ERROR:
314853116a1SDavid Brownell 		label = "error";
315853116a1SDavid Brownell 		break;
316853116a1SDavid Brownell 	case REGULATOR_STATUS_FAST:
317853116a1SDavid Brownell 		label = "fast";
318853116a1SDavid Brownell 		break;
319853116a1SDavid Brownell 	case REGULATOR_STATUS_NORMAL:
320853116a1SDavid Brownell 		label = "normal";
321853116a1SDavid Brownell 		break;
322853116a1SDavid Brownell 	case REGULATOR_STATUS_IDLE:
323853116a1SDavid Brownell 		label = "idle";
324853116a1SDavid Brownell 		break;
325853116a1SDavid Brownell 	case REGULATOR_STATUS_STANDBY:
326853116a1SDavid Brownell 		label = "standby";
327853116a1SDavid Brownell 		break;
328853116a1SDavid Brownell 	default:
329853116a1SDavid Brownell 		return -ERANGE;
330853116a1SDavid Brownell 	}
331853116a1SDavid Brownell 
332853116a1SDavid Brownell 	return sprintf(buf, "%s\n", label);
333853116a1SDavid Brownell }
334853116a1SDavid Brownell static DEVICE_ATTR(status, 0444, regulator_status_show, NULL);
335853116a1SDavid Brownell 
336414c70cbSLiam Girdwood static ssize_t regulator_min_uA_show(struct device *dev,
337414c70cbSLiam Girdwood 				    struct device_attribute *attr, char *buf)
338414c70cbSLiam Girdwood {
339a5766f11SLiam Girdwood 	struct regulator_dev *rdev = dev_get_drvdata(dev);
340414c70cbSLiam Girdwood 
341414c70cbSLiam Girdwood 	if (!rdev->constraints)
342414c70cbSLiam Girdwood 		return sprintf(buf, "constraint not defined\n");
343414c70cbSLiam Girdwood 
344414c70cbSLiam Girdwood 	return sprintf(buf, "%d\n", rdev->constraints->min_uA);
345414c70cbSLiam Girdwood }
3467ad68e2fSDavid Brownell static DEVICE_ATTR(min_microamps, 0444, regulator_min_uA_show, NULL);
347414c70cbSLiam Girdwood 
348414c70cbSLiam Girdwood static ssize_t regulator_max_uA_show(struct device *dev,
349414c70cbSLiam Girdwood 				    struct device_attribute *attr, char *buf)
350414c70cbSLiam Girdwood {
351a5766f11SLiam Girdwood 	struct regulator_dev *rdev = dev_get_drvdata(dev);
352414c70cbSLiam Girdwood 
353414c70cbSLiam Girdwood 	if (!rdev->constraints)
354414c70cbSLiam Girdwood 		return sprintf(buf, "constraint not defined\n");
355414c70cbSLiam Girdwood 
356414c70cbSLiam Girdwood 	return sprintf(buf, "%d\n", rdev->constraints->max_uA);
357414c70cbSLiam Girdwood }
3587ad68e2fSDavid Brownell static DEVICE_ATTR(max_microamps, 0444, regulator_max_uA_show, NULL);
359414c70cbSLiam Girdwood 
360414c70cbSLiam Girdwood static ssize_t regulator_min_uV_show(struct device *dev,
361414c70cbSLiam Girdwood 				    struct device_attribute *attr, char *buf)
362414c70cbSLiam Girdwood {
363a5766f11SLiam Girdwood 	struct regulator_dev *rdev = dev_get_drvdata(dev);
364414c70cbSLiam Girdwood 
365414c70cbSLiam Girdwood 	if (!rdev->constraints)
366414c70cbSLiam Girdwood 		return sprintf(buf, "constraint not defined\n");
367414c70cbSLiam Girdwood 
368414c70cbSLiam Girdwood 	return sprintf(buf, "%d\n", rdev->constraints->min_uV);
369414c70cbSLiam Girdwood }
3707ad68e2fSDavid Brownell static DEVICE_ATTR(min_microvolts, 0444, regulator_min_uV_show, NULL);
371414c70cbSLiam Girdwood 
372414c70cbSLiam Girdwood static ssize_t regulator_max_uV_show(struct device *dev,
373414c70cbSLiam Girdwood 				    struct device_attribute *attr, char *buf)
374414c70cbSLiam Girdwood {
375a5766f11SLiam Girdwood 	struct regulator_dev *rdev = dev_get_drvdata(dev);
376414c70cbSLiam Girdwood 
377414c70cbSLiam Girdwood 	if (!rdev->constraints)
378414c70cbSLiam Girdwood 		return sprintf(buf, "constraint not defined\n");
379414c70cbSLiam Girdwood 
380414c70cbSLiam Girdwood 	return sprintf(buf, "%d\n", rdev->constraints->max_uV);
381414c70cbSLiam Girdwood }
3827ad68e2fSDavid Brownell static DEVICE_ATTR(max_microvolts, 0444, regulator_max_uV_show, NULL);
383414c70cbSLiam Girdwood 
384414c70cbSLiam Girdwood static ssize_t regulator_total_uA_show(struct device *dev,
385414c70cbSLiam Girdwood 				      struct device_attribute *attr, char *buf)
386414c70cbSLiam Girdwood {
387a5766f11SLiam Girdwood 	struct regulator_dev *rdev = dev_get_drvdata(dev);
388414c70cbSLiam Girdwood 	struct regulator *regulator;
389414c70cbSLiam Girdwood 	int uA = 0;
390414c70cbSLiam Girdwood 
391414c70cbSLiam Girdwood 	mutex_lock(&rdev->mutex);
392414c70cbSLiam Girdwood 	list_for_each_entry(regulator, &rdev->consumer_list, list)
393414c70cbSLiam Girdwood 		uA += regulator->uA_load;
394414c70cbSLiam Girdwood 	mutex_unlock(&rdev->mutex);
395414c70cbSLiam Girdwood 	return sprintf(buf, "%d\n", uA);
396414c70cbSLiam Girdwood }
3977ad68e2fSDavid Brownell static DEVICE_ATTR(requested_microamps, 0444, regulator_total_uA_show, NULL);
398414c70cbSLiam Girdwood 
399414c70cbSLiam Girdwood static ssize_t regulator_num_users_show(struct device *dev,
400414c70cbSLiam Girdwood 				      struct device_attribute *attr, char *buf)
401414c70cbSLiam Girdwood {
402a5766f11SLiam Girdwood 	struct regulator_dev *rdev = dev_get_drvdata(dev);
403414c70cbSLiam Girdwood 	return sprintf(buf, "%d\n", rdev->use_count);
404414c70cbSLiam Girdwood }
405414c70cbSLiam Girdwood 
406414c70cbSLiam Girdwood static ssize_t regulator_type_show(struct device *dev,
407414c70cbSLiam Girdwood 				  struct device_attribute *attr, char *buf)
408414c70cbSLiam Girdwood {
409a5766f11SLiam Girdwood 	struct regulator_dev *rdev = dev_get_drvdata(dev);
410414c70cbSLiam Girdwood 
411414c70cbSLiam Girdwood 	switch (rdev->desc->type) {
412414c70cbSLiam Girdwood 	case REGULATOR_VOLTAGE:
413414c70cbSLiam Girdwood 		return sprintf(buf, "voltage\n");
414414c70cbSLiam Girdwood 	case REGULATOR_CURRENT:
415414c70cbSLiam Girdwood 		return sprintf(buf, "current\n");
416414c70cbSLiam Girdwood 	}
417414c70cbSLiam Girdwood 	return sprintf(buf, "unknown\n");
418414c70cbSLiam Girdwood }
419414c70cbSLiam Girdwood 
420414c70cbSLiam Girdwood static ssize_t regulator_suspend_mem_uV_show(struct device *dev,
421414c70cbSLiam Girdwood 				struct device_attribute *attr, char *buf)
422414c70cbSLiam Girdwood {
423a5766f11SLiam Girdwood 	struct regulator_dev *rdev = dev_get_drvdata(dev);
424414c70cbSLiam Girdwood 
425414c70cbSLiam Girdwood 	return sprintf(buf, "%d\n", rdev->constraints->state_mem.uV);
426414c70cbSLiam Girdwood }
4277ad68e2fSDavid Brownell static DEVICE_ATTR(suspend_mem_microvolts, 0444,
4287ad68e2fSDavid Brownell 		regulator_suspend_mem_uV_show, NULL);
429414c70cbSLiam Girdwood 
430414c70cbSLiam Girdwood static ssize_t regulator_suspend_disk_uV_show(struct device *dev,
431414c70cbSLiam Girdwood 				struct device_attribute *attr, char *buf)
432414c70cbSLiam Girdwood {
433a5766f11SLiam Girdwood 	struct regulator_dev *rdev = dev_get_drvdata(dev);
434414c70cbSLiam Girdwood 
435414c70cbSLiam Girdwood 	return sprintf(buf, "%d\n", rdev->constraints->state_disk.uV);
436414c70cbSLiam Girdwood }
4377ad68e2fSDavid Brownell static DEVICE_ATTR(suspend_disk_microvolts, 0444,
4387ad68e2fSDavid Brownell 		regulator_suspend_disk_uV_show, NULL);
439414c70cbSLiam Girdwood 
440414c70cbSLiam Girdwood static ssize_t regulator_suspend_standby_uV_show(struct device *dev,
441414c70cbSLiam Girdwood 				struct device_attribute *attr, char *buf)
442414c70cbSLiam Girdwood {
443a5766f11SLiam Girdwood 	struct regulator_dev *rdev = dev_get_drvdata(dev);
444414c70cbSLiam Girdwood 
445414c70cbSLiam Girdwood 	return sprintf(buf, "%d\n", rdev->constraints->state_standby.uV);
446414c70cbSLiam Girdwood }
4477ad68e2fSDavid Brownell static DEVICE_ATTR(suspend_standby_microvolts, 0444,
4487ad68e2fSDavid Brownell 		regulator_suspend_standby_uV_show, NULL);
449414c70cbSLiam Girdwood 
450414c70cbSLiam Girdwood static ssize_t regulator_suspend_mem_mode_show(struct device *dev,
451414c70cbSLiam Girdwood 				struct device_attribute *attr, char *buf)
452414c70cbSLiam Girdwood {
453a5766f11SLiam Girdwood 	struct regulator_dev *rdev = dev_get_drvdata(dev);
454414c70cbSLiam Girdwood 
4554fca9545SDavid Brownell 	return regulator_print_opmode(buf,
4564fca9545SDavid Brownell 		rdev->constraints->state_mem.mode);
457414c70cbSLiam Girdwood }
4587ad68e2fSDavid Brownell static DEVICE_ATTR(suspend_mem_mode, 0444,
4597ad68e2fSDavid Brownell 		regulator_suspend_mem_mode_show, NULL);
460414c70cbSLiam Girdwood 
461414c70cbSLiam Girdwood static ssize_t regulator_suspend_disk_mode_show(struct device *dev,
462414c70cbSLiam Girdwood 				struct device_attribute *attr, char *buf)
463414c70cbSLiam Girdwood {
464a5766f11SLiam Girdwood 	struct regulator_dev *rdev = dev_get_drvdata(dev);
465414c70cbSLiam Girdwood 
4664fca9545SDavid Brownell 	return regulator_print_opmode(buf,
4674fca9545SDavid Brownell 		rdev->constraints->state_disk.mode);
468414c70cbSLiam Girdwood }
4697ad68e2fSDavid Brownell static DEVICE_ATTR(suspend_disk_mode, 0444,
4707ad68e2fSDavid Brownell 		regulator_suspend_disk_mode_show, NULL);
471414c70cbSLiam Girdwood 
472414c70cbSLiam Girdwood static ssize_t regulator_suspend_standby_mode_show(struct device *dev,
473414c70cbSLiam Girdwood 				struct device_attribute *attr, char *buf)
474414c70cbSLiam Girdwood {
475a5766f11SLiam Girdwood 	struct regulator_dev *rdev = dev_get_drvdata(dev);
476414c70cbSLiam Girdwood 
4774fca9545SDavid Brownell 	return regulator_print_opmode(buf,
4784fca9545SDavid Brownell 		rdev->constraints->state_standby.mode);
479414c70cbSLiam Girdwood }
4807ad68e2fSDavid Brownell static DEVICE_ATTR(suspend_standby_mode, 0444,
4817ad68e2fSDavid Brownell 		regulator_suspend_standby_mode_show, NULL);
482414c70cbSLiam Girdwood 
483414c70cbSLiam Girdwood static ssize_t regulator_suspend_mem_state_show(struct device *dev,
484414c70cbSLiam Girdwood 				   struct device_attribute *attr, char *buf)
485414c70cbSLiam Girdwood {
486a5766f11SLiam Girdwood 	struct regulator_dev *rdev = dev_get_drvdata(dev);
487414c70cbSLiam Girdwood 
4884fca9545SDavid Brownell 	return regulator_print_state(buf,
4894fca9545SDavid Brownell 			rdev->constraints->state_mem.enabled);
490414c70cbSLiam Girdwood }
4917ad68e2fSDavid Brownell static DEVICE_ATTR(suspend_mem_state, 0444,
4927ad68e2fSDavid Brownell 		regulator_suspend_mem_state_show, NULL);
493414c70cbSLiam Girdwood 
494414c70cbSLiam Girdwood static ssize_t regulator_suspend_disk_state_show(struct device *dev,
495414c70cbSLiam Girdwood 				   struct device_attribute *attr, char *buf)
496414c70cbSLiam Girdwood {
497a5766f11SLiam Girdwood 	struct regulator_dev *rdev = dev_get_drvdata(dev);
498414c70cbSLiam Girdwood 
4994fca9545SDavid Brownell 	return regulator_print_state(buf,
5004fca9545SDavid Brownell 			rdev->constraints->state_disk.enabled);
501414c70cbSLiam Girdwood }
5027ad68e2fSDavid Brownell static DEVICE_ATTR(suspend_disk_state, 0444,
5037ad68e2fSDavid Brownell 		regulator_suspend_disk_state_show, NULL);
504414c70cbSLiam Girdwood 
505414c70cbSLiam Girdwood static ssize_t regulator_suspend_standby_state_show(struct device *dev,
506414c70cbSLiam Girdwood 				   struct device_attribute *attr, char *buf)
507414c70cbSLiam Girdwood {
508a5766f11SLiam Girdwood 	struct regulator_dev *rdev = dev_get_drvdata(dev);
509414c70cbSLiam Girdwood 
5104fca9545SDavid Brownell 	return regulator_print_state(buf,
5114fca9545SDavid Brownell 			rdev->constraints->state_standby.enabled);
512414c70cbSLiam Girdwood }
5137ad68e2fSDavid Brownell static DEVICE_ATTR(suspend_standby_state, 0444,
5147ad68e2fSDavid Brownell 		regulator_suspend_standby_state_show, NULL);
515bc558a60SMark Brown 
5167ad68e2fSDavid Brownell 
5177ad68e2fSDavid Brownell /*
5187ad68e2fSDavid Brownell  * These are the only attributes are present for all regulators.
5197ad68e2fSDavid Brownell  * Other attributes are a function of regulator functionality.
5207ad68e2fSDavid Brownell  */
521414c70cbSLiam Girdwood static struct device_attribute regulator_dev_attrs[] = {
522bc558a60SMark Brown 	__ATTR(name, 0444, regulator_name_show, NULL),
523414c70cbSLiam Girdwood 	__ATTR(num_users, 0444, regulator_num_users_show, NULL),
524414c70cbSLiam Girdwood 	__ATTR(type, 0444, regulator_type_show, NULL),
525414c70cbSLiam Girdwood 	__ATTR_NULL,
526414c70cbSLiam Girdwood };
527414c70cbSLiam Girdwood 
528414c70cbSLiam Girdwood static void regulator_dev_release(struct device *dev)
529414c70cbSLiam Girdwood {
530a5766f11SLiam Girdwood 	struct regulator_dev *rdev = dev_get_drvdata(dev);
531414c70cbSLiam Girdwood 	kfree(rdev);
532414c70cbSLiam Girdwood }
533414c70cbSLiam Girdwood 
534414c70cbSLiam Girdwood static struct class regulator_class = {
535414c70cbSLiam Girdwood 	.name = "regulator",
536414c70cbSLiam Girdwood 	.dev_release = regulator_dev_release,
537414c70cbSLiam Girdwood 	.dev_attrs = regulator_dev_attrs,
538414c70cbSLiam Girdwood };
539414c70cbSLiam Girdwood 
540414c70cbSLiam Girdwood /* Calculate the new optimum regulator operating mode based on the new total
541414c70cbSLiam Girdwood  * consumer load. All locks held by caller */
542414c70cbSLiam Girdwood static void drms_uA_update(struct regulator_dev *rdev)
543414c70cbSLiam Girdwood {
544414c70cbSLiam Girdwood 	struct regulator *sibling;
545414c70cbSLiam Girdwood 	int current_uA = 0, output_uV, input_uV, err;
546414c70cbSLiam Girdwood 	unsigned int mode;
547414c70cbSLiam Girdwood 
548414c70cbSLiam Girdwood 	err = regulator_check_drms(rdev);
549414c70cbSLiam Girdwood 	if (err < 0 || !rdev->desc->ops->get_optimum_mode ||
550036de8efSDan Carpenter 	    !rdev->desc->ops->get_voltage || !rdev->desc->ops->set_mode)
551414c70cbSLiam Girdwood 		return;
552414c70cbSLiam Girdwood 
553414c70cbSLiam Girdwood 	/* get output voltage */
554414c70cbSLiam Girdwood 	output_uV = rdev->desc->ops->get_voltage(rdev);
555414c70cbSLiam Girdwood 	if (output_uV <= 0)
556414c70cbSLiam Girdwood 		return;
557414c70cbSLiam Girdwood 
558414c70cbSLiam Girdwood 	/* get input voltage */
559414c70cbSLiam Girdwood 	if (rdev->supply && rdev->supply->desc->ops->get_voltage)
560414c70cbSLiam Girdwood 		input_uV = rdev->supply->desc->ops->get_voltage(rdev->supply);
561414c70cbSLiam Girdwood 	else
562414c70cbSLiam Girdwood 		input_uV = rdev->constraints->input_uV;
563414c70cbSLiam Girdwood 	if (input_uV <= 0)
564414c70cbSLiam Girdwood 		return;
565414c70cbSLiam Girdwood 
566414c70cbSLiam Girdwood 	/* calc total requested load */
567414c70cbSLiam Girdwood 	list_for_each_entry(sibling, &rdev->consumer_list, list)
568414c70cbSLiam Girdwood 		current_uA += sibling->uA_load;
569414c70cbSLiam Girdwood 
570414c70cbSLiam Girdwood 	/* now get the optimum mode for our new total regulator load */
571414c70cbSLiam Girdwood 	mode = rdev->desc->ops->get_optimum_mode(rdev, input_uV,
572414c70cbSLiam Girdwood 						  output_uV, current_uA);
573414c70cbSLiam Girdwood 
574414c70cbSLiam Girdwood 	/* check the new mode is allowed */
575414c70cbSLiam Girdwood 	err = regulator_check_mode(rdev, mode);
576414c70cbSLiam Girdwood 	if (err == 0)
577414c70cbSLiam Girdwood 		rdev->desc->ops->set_mode(rdev, mode);
578414c70cbSLiam Girdwood }
579414c70cbSLiam Girdwood 
580414c70cbSLiam Girdwood static int suspend_set_state(struct regulator_dev *rdev,
581414c70cbSLiam Girdwood 	struct regulator_state *rstate)
582414c70cbSLiam Girdwood {
583414c70cbSLiam Girdwood 	int ret = 0;
584638f85c5SMark Brown 	bool can_set_state;
585414c70cbSLiam Girdwood 
586638f85c5SMark Brown 	can_set_state = rdev->desc->ops->set_suspend_enable &&
587638f85c5SMark Brown 		rdev->desc->ops->set_suspend_disable;
588638f85c5SMark Brown 
589638f85c5SMark Brown 	/* If we have no suspend mode configration don't set anything;
590638f85c5SMark Brown 	 * only warn if the driver actually makes the suspend mode
591638f85c5SMark Brown 	 * configurable.
592638f85c5SMark Brown 	 */
593638f85c5SMark Brown 	if (!rstate->enabled && !rstate->disabled) {
594638f85c5SMark Brown 		if (can_set_state)
595638f85c5SMark Brown 			printk(KERN_WARNING "%s: No configuration for %s\n",
596638f85c5SMark Brown 			       __func__, rdev_get_name(rdev));
597638f85c5SMark Brown 		return 0;
598638f85c5SMark Brown 	}
599638f85c5SMark Brown 
600638f85c5SMark Brown 	if (rstate->enabled && rstate->disabled) {
601638f85c5SMark Brown 		printk(KERN_ERR "%s: invalid configuration for %s\n",
602638f85c5SMark Brown 		       __func__, rdev_get_name(rdev));
603638f85c5SMark Brown 		return -EINVAL;
604638f85c5SMark Brown 	}
605638f85c5SMark Brown 
606638f85c5SMark Brown 	if (!can_set_state) {
607a5766f11SLiam Girdwood 		printk(KERN_ERR "%s: no way to set suspend state\n",
608a5766f11SLiam Girdwood 			__func__);
609414c70cbSLiam Girdwood 		return -EINVAL;
610a5766f11SLiam Girdwood 	}
611414c70cbSLiam Girdwood 
612414c70cbSLiam Girdwood 	if (rstate->enabled)
613414c70cbSLiam Girdwood 		ret = rdev->desc->ops->set_suspend_enable(rdev);
614414c70cbSLiam Girdwood 	else
615414c70cbSLiam Girdwood 		ret = rdev->desc->ops->set_suspend_disable(rdev);
616414c70cbSLiam Girdwood 	if (ret < 0) {
617414c70cbSLiam Girdwood 		printk(KERN_ERR "%s: failed to enabled/disable\n", __func__);
618414c70cbSLiam Girdwood 		return ret;
619414c70cbSLiam Girdwood 	}
620414c70cbSLiam Girdwood 
621414c70cbSLiam Girdwood 	if (rdev->desc->ops->set_suspend_voltage && rstate->uV > 0) {
622414c70cbSLiam Girdwood 		ret = rdev->desc->ops->set_suspend_voltage(rdev, rstate->uV);
623414c70cbSLiam Girdwood 		if (ret < 0) {
624414c70cbSLiam Girdwood 			printk(KERN_ERR "%s: failed to set voltage\n",
625414c70cbSLiam Girdwood 				__func__);
626414c70cbSLiam Girdwood 			return ret;
627414c70cbSLiam Girdwood 		}
628414c70cbSLiam Girdwood 	}
629414c70cbSLiam Girdwood 
630414c70cbSLiam Girdwood 	if (rdev->desc->ops->set_suspend_mode && rstate->mode > 0) {
631414c70cbSLiam Girdwood 		ret = rdev->desc->ops->set_suspend_mode(rdev, rstate->mode);
632414c70cbSLiam Girdwood 		if (ret < 0) {
633414c70cbSLiam Girdwood 			printk(KERN_ERR "%s: failed to set mode\n", __func__);
634414c70cbSLiam Girdwood 			return ret;
635414c70cbSLiam Girdwood 		}
636414c70cbSLiam Girdwood 	}
637414c70cbSLiam Girdwood 	return ret;
638414c70cbSLiam Girdwood }
639414c70cbSLiam Girdwood 
640414c70cbSLiam Girdwood /* locks held by caller */
641414c70cbSLiam Girdwood static int suspend_prepare(struct regulator_dev *rdev, suspend_state_t state)
642414c70cbSLiam Girdwood {
643414c70cbSLiam Girdwood 	if (!rdev->constraints)
644414c70cbSLiam Girdwood 		return -EINVAL;
645414c70cbSLiam Girdwood 
646414c70cbSLiam Girdwood 	switch (state) {
647414c70cbSLiam Girdwood 	case PM_SUSPEND_STANDBY:
648414c70cbSLiam Girdwood 		return suspend_set_state(rdev,
649414c70cbSLiam Girdwood 			&rdev->constraints->state_standby);
650414c70cbSLiam Girdwood 	case PM_SUSPEND_MEM:
651414c70cbSLiam Girdwood 		return suspend_set_state(rdev,
652414c70cbSLiam Girdwood 			&rdev->constraints->state_mem);
653414c70cbSLiam Girdwood 	case PM_SUSPEND_MAX:
654414c70cbSLiam Girdwood 		return suspend_set_state(rdev,
655414c70cbSLiam Girdwood 			&rdev->constraints->state_disk);
656414c70cbSLiam Girdwood 	default:
657414c70cbSLiam Girdwood 		return -EINVAL;
658414c70cbSLiam Girdwood 	}
659414c70cbSLiam Girdwood }
660414c70cbSLiam Girdwood 
661414c70cbSLiam Girdwood static void print_constraints(struct regulator_dev *rdev)
662414c70cbSLiam Girdwood {
663414c70cbSLiam Girdwood 	struct regulation_constraints *constraints = rdev->constraints;
664973e9a27SMark Brown 	char buf[80] = "";
6658f031b48SMark Brown 	int count = 0;
6668f031b48SMark Brown 	int ret;
667414c70cbSLiam Girdwood 
6688f031b48SMark Brown 	if (constraints->min_uV && constraints->max_uV) {
669414c70cbSLiam Girdwood 		if (constraints->min_uV == constraints->max_uV)
6708f031b48SMark Brown 			count += sprintf(buf + count, "%d mV ",
671414c70cbSLiam Girdwood 					 constraints->min_uV / 1000);
672414c70cbSLiam Girdwood 		else
6738f031b48SMark Brown 			count += sprintf(buf + count, "%d <--> %d mV ",
674414c70cbSLiam Girdwood 					 constraints->min_uV / 1000,
675414c70cbSLiam Girdwood 					 constraints->max_uV / 1000);
6768f031b48SMark Brown 	}
6778f031b48SMark Brown 
6788f031b48SMark Brown 	if (!constraints->min_uV ||
6798f031b48SMark Brown 	    constraints->min_uV != constraints->max_uV) {
6808f031b48SMark Brown 		ret = _regulator_get_voltage(rdev);
6818f031b48SMark Brown 		if (ret > 0)
6828f031b48SMark Brown 			count += sprintf(buf + count, "at %d mV ", ret / 1000);
6838f031b48SMark Brown 	}
6848f031b48SMark Brown 
6858f031b48SMark Brown 	if (constraints->min_uA && constraints->max_uA) {
686414c70cbSLiam Girdwood 		if (constraints->min_uA == constraints->max_uA)
6878f031b48SMark Brown 			count += sprintf(buf + count, "%d mA ",
688414c70cbSLiam Girdwood 					 constraints->min_uA / 1000);
689414c70cbSLiam Girdwood 		else
6908f031b48SMark Brown 			count += sprintf(buf + count, "%d <--> %d mA ",
691414c70cbSLiam Girdwood 					 constraints->min_uA / 1000,
692414c70cbSLiam Girdwood 					 constraints->max_uA / 1000);
693414c70cbSLiam Girdwood 	}
6948f031b48SMark Brown 
6958f031b48SMark Brown 	if (!constraints->min_uA ||
6968f031b48SMark Brown 	    constraints->min_uA != constraints->max_uA) {
6978f031b48SMark Brown 		ret = _regulator_get_current_limit(rdev);
6988f031b48SMark Brown 		if (ret > 0)
6998f031b48SMark Brown 			count += sprintf(buf + count, "at %d uA ", ret / 1000);
7008f031b48SMark Brown 	}
7018f031b48SMark Brown 
702414c70cbSLiam Girdwood 	if (constraints->valid_modes_mask & REGULATOR_MODE_FAST)
703414c70cbSLiam Girdwood 		count += sprintf(buf + count, "fast ");
704414c70cbSLiam Girdwood 	if (constraints->valid_modes_mask & REGULATOR_MODE_NORMAL)
705414c70cbSLiam Girdwood 		count += sprintf(buf + count, "normal ");
706414c70cbSLiam Girdwood 	if (constraints->valid_modes_mask & REGULATOR_MODE_IDLE)
707414c70cbSLiam Girdwood 		count += sprintf(buf + count, "idle ");
708414c70cbSLiam Girdwood 	if (constraints->valid_modes_mask & REGULATOR_MODE_STANDBY)
709414c70cbSLiam Girdwood 		count += sprintf(buf + count, "standby");
710414c70cbSLiam Girdwood 
7111083c393SMark Brown 	printk(KERN_INFO "regulator: %s: %s\n", rdev_get_name(rdev), buf);
712414c70cbSLiam Girdwood }
713414c70cbSLiam Girdwood 
714e79055d6SMark Brown static int machine_constraints_voltage(struct regulator_dev *rdev,
7151083c393SMark Brown 	struct regulation_constraints *constraints)
716e79055d6SMark Brown {
717e79055d6SMark Brown 	struct regulator_ops *ops = rdev->desc->ops;
7181083c393SMark Brown 	const char *name = rdev_get_name(rdev);
719af5866c9SMark Brown 	int ret;
720af5866c9SMark Brown 
721af5866c9SMark Brown 	/* do we need to apply the constraint voltage */
722af5866c9SMark Brown 	if (rdev->constraints->apply_uV &&
723af5866c9SMark Brown 		rdev->constraints->min_uV == rdev->constraints->max_uV &&
724af5866c9SMark Brown 		ops->set_voltage) {
725af5866c9SMark Brown 		ret = ops->set_voltage(rdev,
726af5866c9SMark Brown 			rdev->constraints->min_uV, rdev->constraints->max_uV);
727af5866c9SMark Brown 			if (ret < 0) {
728af5866c9SMark Brown 				printk(KERN_ERR "%s: failed to apply %duV constraint to %s\n",
729af5866c9SMark Brown 				       __func__,
730af5866c9SMark Brown 				       rdev->constraints->min_uV, name);
731af5866c9SMark Brown 				rdev->constraints = NULL;
732af5866c9SMark Brown 				return ret;
733af5866c9SMark Brown 			}
734af5866c9SMark Brown 	}
735e79055d6SMark Brown 
736e79055d6SMark Brown 	/* constrain machine-level voltage specs to fit
737e79055d6SMark Brown 	 * the actual range supported by this regulator.
738e79055d6SMark Brown 	 */
739e79055d6SMark Brown 	if (ops->list_voltage && rdev->desc->n_voltages) {
740e79055d6SMark Brown 		int	count = rdev->desc->n_voltages;
741e79055d6SMark Brown 		int	i;
742e79055d6SMark Brown 		int	min_uV = INT_MAX;
743e79055d6SMark Brown 		int	max_uV = INT_MIN;
744e79055d6SMark Brown 		int	cmin = constraints->min_uV;
745e79055d6SMark Brown 		int	cmax = constraints->max_uV;
746e79055d6SMark Brown 
747e79055d6SMark Brown 		/* it's safe to autoconfigure fixed-voltage supplies
748e79055d6SMark Brown 		   and the constraints are used by list_voltage. */
749e79055d6SMark Brown 		if (count == 1 && !cmin) {
750e79055d6SMark Brown 			cmin = 1;
751e79055d6SMark Brown 			cmax = INT_MAX;
752e79055d6SMark Brown 			constraints->min_uV = cmin;
753e79055d6SMark Brown 			constraints->max_uV = cmax;
754e79055d6SMark Brown 		}
755e79055d6SMark Brown 
756e79055d6SMark Brown 		/* voltage constraints are optional */
757e79055d6SMark Brown 		if ((cmin == 0) && (cmax == 0))
758e79055d6SMark Brown 			return 0;
759e79055d6SMark Brown 
760e79055d6SMark Brown 		/* else require explicit machine-level constraints */
761e79055d6SMark Brown 		if (cmin <= 0 || cmax <= 0 || cmax < cmin) {
762e79055d6SMark Brown 			pr_err("%s: %s '%s' voltage constraints\n",
763e79055d6SMark Brown 				       __func__, "invalid", name);
764e79055d6SMark Brown 			return -EINVAL;
765e79055d6SMark Brown 		}
766e79055d6SMark Brown 
767e79055d6SMark Brown 		/* initial: [cmin..cmax] valid, [min_uV..max_uV] not */
768e79055d6SMark Brown 		for (i = 0; i < count; i++) {
769e79055d6SMark Brown 			int	value;
770e79055d6SMark Brown 
771e79055d6SMark Brown 			value = ops->list_voltage(rdev, i);
772e79055d6SMark Brown 			if (value <= 0)
773e79055d6SMark Brown 				continue;
774e79055d6SMark Brown 
775e79055d6SMark Brown 			/* maybe adjust [min_uV..max_uV] */
776e79055d6SMark Brown 			if (value >= cmin && value < min_uV)
777e79055d6SMark Brown 				min_uV = value;
778e79055d6SMark Brown 			if (value <= cmax && value > max_uV)
779e79055d6SMark Brown 				max_uV = value;
780e79055d6SMark Brown 		}
781e79055d6SMark Brown 
782e79055d6SMark Brown 		/* final: [min_uV..max_uV] valid iff constraints valid */
783e79055d6SMark Brown 		if (max_uV < min_uV) {
784e79055d6SMark Brown 			pr_err("%s: %s '%s' voltage constraints\n",
785e79055d6SMark Brown 				       __func__, "unsupportable", name);
786e79055d6SMark Brown 			return -EINVAL;
787e79055d6SMark Brown 		}
788e79055d6SMark Brown 
789e79055d6SMark Brown 		/* use regulator's subset of machine constraints */
790e79055d6SMark Brown 		if (constraints->min_uV < min_uV) {
791e79055d6SMark Brown 			pr_debug("%s: override '%s' %s, %d -> %d\n",
792e79055d6SMark Brown 				       __func__, name, "min_uV",
793e79055d6SMark Brown 					constraints->min_uV, min_uV);
794e79055d6SMark Brown 			constraints->min_uV = min_uV;
795e79055d6SMark Brown 		}
796e79055d6SMark Brown 		if (constraints->max_uV > max_uV) {
797e79055d6SMark Brown 			pr_debug("%s: override '%s' %s, %d -> %d\n",
798e79055d6SMark Brown 				       __func__, name, "max_uV",
799e79055d6SMark Brown 					constraints->max_uV, max_uV);
800e79055d6SMark Brown 			constraints->max_uV = max_uV;
801e79055d6SMark Brown 		}
802e79055d6SMark Brown 	}
803e79055d6SMark Brown 
804e79055d6SMark Brown 	return 0;
805e79055d6SMark Brown }
806e79055d6SMark Brown 
807a5766f11SLiam Girdwood /**
808a5766f11SLiam Girdwood  * set_machine_constraints - sets regulator constraints
80969279fb9SMark Brown  * @rdev: regulator source
810c8e7e464SMark Brown  * @constraints: constraints to apply
811a5766f11SLiam Girdwood  *
812a5766f11SLiam Girdwood  * Allows platform initialisation code to define and constrain
813a5766f11SLiam Girdwood  * regulator circuits e.g. valid voltage/current ranges, etc.  NOTE:
814a5766f11SLiam Girdwood  * Constraints *must* be set by platform code in order for some
815a5766f11SLiam Girdwood  * regulator operations to proceed i.e. set_voltage, set_current_limit,
816a5766f11SLiam Girdwood  * set_mode.
817a5766f11SLiam Girdwood  */
818a5766f11SLiam Girdwood static int set_machine_constraints(struct regulator_dev *rdev,
819a5766f11SLiam Girdwood 	struct regulation_constraints *constraints)
820a5766f11SLiam Girdwood {
821a5766f11SLiam Girdwood 	int ret = 0;
822e06f5b4fSMark Brown 	const char *name;
823e5fda26cSMark Brown 	struct regulator_ops *ops = rdev->desc->ops;
824e06f5b4fSMark Brown 
825af5866c9SMark Brown 	rdev->constraints = constraints;
826af5866c9SMark Brown 
8271083c393SMark Brown 	name = rdev_get_name(rdev);
8281083c393SMark Brown 
8291083c393SMark Brown 	ret = machine_constraints_voltage(rdev, constraints);
830e79055d6SMark Brown 	if (ret != 0)
8313e2b9abdSMark Brown 		goto out;
8323e2b9abdSMark Brown 
833a5766f11SLiam Girdwood 	/* do we need to setup our suspend state */
834e06f5b4fSMark Brown 	if (constraints->initial_state) {
835a5766f11SLiam Girdwood 		ret = suspend_prepare(rdev, constraints->initial_state);
836e06f5b4fSMark Brown 		if (ret < 0) {
837e06f5b4fSMark Brown 			printk(KERN_ERR "%s: failed to set suspend state for %s\n",
838e06f5b4fSMark Brown 			       __func__, name);
839e06f5b4fSMark Brown 			rdev->constraints = NULL;
840e06f5b4fSMark Brown 			goto out;
841e06f5b4fSMark Brown 		}
842e06f5b4fSMark Brown 	}
843a5766f11SLiam Girdwood 
844a308466cSMark Brown 	if (constraints->initial_mode) {
845a308466cSMark Brown 		if (!ops->set_mode) {
846a308466cSMark Brown 			printk(KERN_ERR "%s: no set_mode operation for %s\n",
847a308466cSMark Brown 			       __func__, name);
848a308466cSMark Brown 			ret = -EINVAL;
849a308466cSMark Brown 			goto out;
850a308466cSMark Brown 		}
851a308466cSMark Brown 
852a308466cSMark Brown 		ret = ops->set_mode(rdev, constraints->initial_mode);
853a308466cSMark Brown 		if (ret < 0) {
854a308466cSMark Brown 			printk(KERN_ERR
855a308466cSMark Brown 			       "%s: failed to set initial mode for %s: %d\n",
856a308466cSMark Brown 			       __func__, name, ret);
857a308466cSMark Brown 			goto out;
858a308466cSMark Brown 		}
859a308466cSMark Brown 	}
860a308466cSMark Brown 
861cacf90f2SMark Brown 	/* If the constraints say the regulator should be on at this point
862cacf90f2SMark Brown 	 * and we have control then make sure it is enabled.
863cacf90f2SMark Brown 	 */
864cacf90f2SMark Brown 	if ((constraints->always_on || constraints->boot_on) && ops->enable) {
865e5fda26cSMark Brown 		ret = ops->enable(rdev);
866e5fda26cSMark Brown 		if (ret < 0) {
867e5fda26cSMark Brown 			printk(KERN_ERR "%s: failed to enable %s\n",
868e5fda26cSMark Brown 			       __func__, name);
869e5fda26cSMark Brown 			rdev->constraints = NULL;
870e5fda26cSMark Brown 			goto out;
871e5fda26cSMark Brown 		}
872e5fda26cSMark Brown 	}
873e5fda26cSMark Brown 
874a5766f11SLiam Girdwood 	print_constraints(rdev);
875a5766f11SLiam Girdwood out:
876a5766f11SLiam Girdwood 	return ret;
877a5766f11SLiam Girdwood }
878a5766f11SLiam Girdwood 
879a5766f11SLiam Girdwood /**
880a5766f11SLiam Girdwood  * set_supply - set regulator supply regulator
88169279fb9SMark Brown  * @rdev: regulator name
88269279fb9SMark Brown  * @supply_rdev: supply regulator name
883a5766f11SLiam Girdwood  *
884a5766f11SLiam Girdwood  * Called by platform initialisation code to set the supply regulator for this
885a5766f11SLiam Girdwood  * regulator. This ensures that a regulators supply will also be enabled by the
886a5766f11SLiam Girdwood  * core if it's child is enabled.
887a5766f11SLiam Girdwood  */
888a5766f11SLiam Girdwood static int set_supply(struct regulator_dev *rdev,
889a5766f11SLiam Girdwood 	struct regulator_dev *supply_rdev)
890a5766f11SLiam Girdwood {
891a5766f11SLiam Girdwood 	int err;
892a5766f11SLiam Girdwood 
893a5766f11SLiam Girdwood 	err = sysfs_create_link(&rdev->dev.kobj, &supply_rdev->dev.kobj,
894a5766f11SLiam Girdwood 				"supply");
895a5766f11SLiam Girdwood 	if (err) {
896a5766f11SLiam Girdwood 		printk(KERN_ERR
897a5766f11SLiam Girdwood 		       "%s: could not add device link %s err %d\n",
898a5766f11SLiam Girdwood 		       __func__, supply_rdev->dev.kobj.name, err);
899a5766f11SLiam Girdwood 		       goto out;
900a5766f11SLiam Girdwood 	}
901a5766f11SLiam Girdwood 	rdev->supply = supply_rdev;
902a5766f11SLiam Girdwood 	list_add(&rdev->slist, &supply_rdev->supply_list);
903a5766f11SLiam Girdwood out:
904a5766f11SLiam Girdwood 	return err;
905a5766f11SLiam Girdwood }
906a5766f11SLiam Girdwood 
907a5766f11SLiam Girdwood /**
908a5766f11SLiam Girdwood  * set_consumer_device_supply: Bind a regulator to a symbolic supply
90969279fb9SMark Brown  * @rdev:         regulator source
91069279fb9SMark Brown  * @consumer_dev: device the supply applies to
91140f9244fSMark Brown  * @consumer_dev_name: dev_name() string for device supply applies to
912a5766f11SLiam Girdwood  * @supply:       symbolic name for supply
913a5766f11SLiam Girdwood  *
914a5766f11SLiam Girdwood  * Allows platform initialisation code to map physical regulator
915a5766f11SLiam Girdwood  * sources to symbolic names for supplies for use by devices.  Devices
916a5766f11SLiam Girdwood  * should use these symbolic names to request regulators, avoiding the
917a5766f11SLiam Girdwood  * need to provide board-specific regulator names as platform data.
91840f9244fSMark Brown  *
91940f9244fSMark Brown  * Only one of consumer_dev and consumer_dev_name may be specified.
920a5766f11SLiam Girdwood  */
921a5766f11SLiam Girdwood static int set_consumer_device_supply(struct regulator_dev *rdev,
92240f9244fSMark Brown 	struct device *consumer_dev, const char *consumer_dev_name,
92340f9244fSMark Brown 	const char *supply)
924a5766f11SLiam Girdwood {
925a5766f11SLiam Girdwood 	struct regulator_map *node;
9269ed2099eSMark Brown 	int has_dev;
927a5766f11SLiam Girdwood 
92840f9244fSMark Brown 	if (consumer_dev && consumer_dev_name)
92940f9244fSMark Brown 		return -EINVAL;
93040f9244fSMark Brown 
93140f9244fSMark Brown 	if (!consumer_dev_name && consumer_dev)
93240f9244fSMark Brown 		consumer_dev_name = dev_name(consumer_dev);
93340f9244fSMark Brown 
934a5766f11SLiam Girdwood 	if (supply == NULL)
935a5766f11SLiam Girdwood 		return -EINVAL;
936a5766f11SLiam Girdwood 
9379ed2099eSMark Brown 	if (consumer_dev_name != NULL)
9389ed2099eSMark Brown 		has_dev = 1;
9399ed2099eSMark Brown 	else
9409ed2099eSMark Brown 		has_dev = 0;
9419ed2099eSMark Brown 
9426001e13cSDavid Brownell 	list_for_each_entry(node, &regulator_map_list, list) {
94340f9244fSMark Brown 		if (consumer_dev_name != node->dev_name)
9446001e13cSDavid Brownell 			continue;
9456001e13cSDavid Brownell 		if (strcmp(node->supply, supply) != 0)
9466001e13cSDavid Brownell 			continue;
9476001e13cSDavid Brownell 
9486001e13cSDavid Brownell 		dev_dbg(consumer_dev, "%s/%s is '%s' supply; fail %s/%s\n",
9496001e13cSDavid Brownell 				dev_name(&node->regulator->dev),
9506001e13cSDavid Brownell 				node->regulator->desc->name,
9516001e13cSDavid Brownell 				supply,
9521083c393SMark Brown 				dev_name(&rdev->dev), rdev_get_name(rdev));
9536001e13cSDavid Brownell 		return -EBUSY;
9546001e13cSDavid Brownell 	}
9556001e13cSDavid Brownell 
9569ed2099eSMark Brown 	node = kzalloc(sizeof(struct regulator_map), GFP_KERNEL);
957a5766f11SLiam Girdwood 	if (node == NULL)
958a5766f11SLiam Girdwood 		return -ENOMEM;
959a5766f11SLiam Girdwood 
960a5766f11SLiam Girdwood 	node->regulator = rdev;
961a5766f11SLiam Girdwood 	node->supply = supply;
962a5766f11SLiam Girdwood 
9639ed2099eSMark Brown 	if (has_dev) {
9649ed2099eSMark Brown 		node->dev_name = kstrdup(consumer_dev_name, GFP_KERNEL);
96540f9244fSMark Brown 		if (node->dev_name == NULL) {
96640f9244fSMark Brown 			kfree(node);
96740f9244fSMark Brown 			return -ENOMEM;
96840f9244fSMark Brown 		}
9699ed2099eSMark Brown 	}
97040f9244fSMark Brown 
971a5766f11SLiam Girdwood 	list_add(&node->list, &regulator_map_list);
972a5766f11SLiam Girdwood 	return 0;
973a5766f11SLiam Girdwood }
974a5766f11SLiam Girdwood 
975a5766f11SLiam Girdwood static void unset_consumer_device_supply(struct regulator_dev *rdev,
97640f9244fSMark Brown 	const char *consumer_dev_name, struct device *consumer_dev)
977a5766f11SLiam Girdwood {
978a5766f11SLiam Girdwood 	struct regulator_map *node, *n;
979a5766f11SLiam Girdwood 
98040f9244fSMark Brown 	if (consumer_dev && !consumer_dev_name)
98140f9244fSMark Brown 		consumer_dev_name = dev_name(consumer_dev);
98240f9244fSMark Brown 
983a5766f11SLiam Girdwood 	list_for_each_entry_safe(node, n, &regulator_map_list, list) {
98440f9244fSMark Brown 		if (rdev != node->regulator)
98540f9244fSMark Brown 			continue;
98640f9244fSMark Brown 
98740f9244fSMark Brown 		if (consumer_dev_name && node->dev_name &&
98840f9244fSMark Brown 		    strcmp(consumer_dev_name, node->dev_name))
98940f9244fSMark Brown 			continue;
99040f9244fSMark Brown 
991a5766f11SLiam Girdwood 		list_del(&node->list);
99240f9244fSMark Brown 		kfree(node->dev_name);
993a5766f11SLiam Girdwood 		kfree(node);
994a5766f11SLiam Girdwood 		return;
995a5766f11SLiam Girdwood 	}
996a5766f11SLiam Girdwood }
997a5766f11SLiam Girdwood 
9980f1d747bSMike Rapoport static void unset_regulator_supplies(struct regulator_dev *rdev)
9990f1d747bSMike Rapoport {
10000f1d747bSMike Rapoport 	struct regulator_map *node, *n;
10010f1d747bSMike Rapoport 
10020f1d747bSMike Rapoport 	list_for_each_entry_safe(node, n, &regulator_map_list, list) {
10030f1d747bSMike Rapoport 		if (rdev == node->regulator) {
10040f1d747bSMike Rapoport 			list_del(&node->list);
100540f9244fSMark Brown 			kfree(node->dev_name);
10060f1d747bSMike Rapoport 			kfree(node);
10070f1d747bSMike Rapoport 			return;
10080f1d747bSMike Rapoport 		}
10090f1d747bSMike Rapoport 	}
10100f1d747bSMike Rapoport }
10110f1d747bSMike Rapoport 
1012414c70cbSLiam Girdwood #define REG_STR_SIZE	32
1013414c70cbSLiam Girdwood 
1014414c70cbSLiam Girdwood static struct regulator *create_regulator(struct regulator_dev *rdev,
1015414c70cbSLiam Girdwood 					  struct device *dev,
1016414c70cbSLiam Girdwood 					  const char *supply_name)
1017414c70cbSLiam Girdwood {
1018414c70cbSLiam Girdwood 	struct regulator *regulator;
1019414c70cbSLiam Girdwood 	char buf[REG_STR_SIZE];
1020414c70cbSLiam Girdwood 	int err, size;
1021414c70cbSLiam Girdwood 
1022414c70cbSLiam Girdwood 	regulator = kzalloc(sizeof(*regulator), GFP_KERNEL);
1023414c70cbSLiam Girdwood 	if (regulator == NULL)
1024414c70cbSLiam Girdwood 		return NULL;
1025414c70cbSLiam Girdwood 
1026414c70cbSLiam Girdwood 	mutex_lock(&rdev->mutex);
1027414c70cbSLiam Girdwood 	regulator->rdev = rdev;
1028414c70cbSLiam Girdwood 	list_add(&regulator->list, &rdev->consumer_list);
1029414c70cbSLiam Girdwood 
1030414c70cbSLiam Girdwood 	if (dev) {
1031414c70cbSLiam Girdwood 		/* create a 'requested_microamps_name' sysfs entry */
1032414c70cbSLiam Girdwood 		size = scnprintf(buf, REG_STR_SIZE, "microamps_requested_%s",
1033414c70cbSLiam Girdwood 			supply_name);
1034414c70cbSLiam Girdwood 		if (size >= REG_STR_SIZE)
1035414c70cbSLiam Girdwood 			goto overflow_err;
1036414c70cbSLiam Girdwood 
1037414c70cbSLiam Girdwood 		regulator->dev = dev;
1038414c70cbSLiam Girdwood 		regulator->dev_attr.attr.name = kstrdup(buf, GFP_KERNEL);
1039414c70cbSLiam Girdwood 		if (regulator->dev_attr.attr.name == NULL)
1040414c70cbSLiam Girdwood 			goto attr_name_err;
1041414c70cbSLiam Girdwood 
1042414c70cbSLiam Girdwood 		regulator->dev_attr.attr.owner = THIS_MODULE;
1043414c70cbSLiam Girdwood 		regulator->dev_attr.attr.mode = 0444;
1044414c70cbSLiam Girdwood 		regulator->dev_attr.show = device_requested_uA_show;
1045414c70cbSLiam Girdwood 		err = device_create_file(dev, &regulator->dev_attr);
1046414c70cbSLiam Girdwood 		if (err < 0) {
1047414c70cbSLiam Girdwood 			printk(KERN_WARNING "%s: could not add regulator_dev"
1048414c70cbSLiam Girdwood 				" load sysfs\n", __func__);
1049414c70cbSLiam Girdwood 			goto attr_name_err;
1050414c70cbSLiam Girdwood 		}
1051414c70cbSLiam Girdwood 
1052414c70cbSLiam Girdwood 		/* also add a link to the device sysfs entry */
1053414c70cbSLiam Girdwood 		size = scnprintf(buf, REG_STR_SIZE, "%s-%s",
1054414c70cbSLiam Girdwood 				 dev->kobj.name, supply_name);
1055414c70cbSLiam Girdwood 		if (size >= REG_STR_SIZE)
1056414c70cbSLiam Girdwood 			goto attr_err;
1057414c70cbSLiam Girdwood 
1058414c70cbSLiam Girdwood 		regulator->supply_name = kstrdup(buf, GFP_KERNEL);
1059414c70cbSLiam Girdwood 		if (regulator->supply_name == NULL)
1060414c70cbSLiam Girdwood 			goto attr_err;
1061414c70cbSLiam Girdwood 
1062414c70cbSLiam Girdwood 		err = sysfs_create_link(&rdev->dev.kobj, &dev->kobj,
1063414c70cbSLiam Girdwood 					buf);
1064414c70cbSLiam Girdwood 		if (err) {
1065414c70cbSLiam Girdwood 			printk(KERN_WARNING
1066414c70cbSLiam Girdwood 			       "%s: could not add device link %s err %d\n",
1067414c70cbSLiam Girdwood 			       __func__, dev->kobj.name, err);
1068414c70cbSLiam Girdwood 			device_remove_file(dev, &regulator->dev_attr);
1069414c70cbSLiam Girdwood 			goto link_name_err;
1070414c70cbSLiam Girdwood 		}
1071414c70cbSLiam Girdwood 	}
1072414c70cbSLiam Girdwood 	mutex_unlock(&rdev->mutex);
1073414c70cbSLiam Girdwood 	return regulator;
1074414c70cbSLiam Girdwood link_name_err:
1075414c70cbSLiam Girdwood 	kfree(regulator->supply_name);
1076414c70cbSLiam Girdwood attr_err:
1077414c70cbSLiam Girdwood 	device_remove_file(regulator->dev, &regulator->dev_attr);
1078414c70cbSLiam Girdwood attr_name_err:
1079414c70cbSLiam Girdwood 	kfree(regulator->dev_attr.attr.name);
1080414c70cbSLiam Girdwood overflow_err:
1081414c70cbSLiam Girdwood 	list_del(&regulator->list);
1082414c70cbSLiam Girdwood 	kfree(regulator);
1083414c70cbSLiam Girdwood 	mutex_unlock(&rdev->mutex);
1084414c70cbSLiam Girdwood 	return NULL;
1085414c70cbSLiam Girdwood }
1086414c70cbSLiam Girdwood 
10875ffbd136SMark Brown /* Internal regulator request function */
10885ffbd136SMark Brown static struct regulator *_regulator_get(struct device *dev, const char *id,
10895ffbd136SMark Brown 					int exclusive)
1090414c70cbSLiam Girdwood {
1091414c70cbSLiam Girdwood 	struct regulator_dev *rdev;
1092414c70cbSLiam Girdwood 	struct regulator_map *map;
1093414c70cbSLiam Girdwood 	struct regulator *regulator = ERR_PTR(-ENODEV);
109440f9244fSMark Brown 	const char *devname = NULL;
10955ffbd136SMark Brown 	int ret;
1096414c70cbSLiam Girdwood 
1097414c70cbSLiam Girdwood 	if (id == NULL) {
1098414c70cbSLiam Girdwood 		printk(KERN_ERR "regulator: get() with no identifier\n");
1099414c70cbSLiam Girdwood 		return regulator;
1100414c70cbSLiam Girdwood 	}
1101414c70cbSLiam Girdwood 
110240f9244fSMark Brown 	if (dev)
110340f9244fSMark Brown 		devname = dev_name(dev);
110440f9244fSMark Brown 
1105414c70cbSLiam Girdwood 	mutex_lock(&regulator_list_mutex);
1106414c70cbSLiam Girdwood 
1107414c70cbSLiam Girdwood 	list_for_each_entry(map, &regulator_map_list, list) {
110840f9244fSMark Brown 		/* If the mapping has a device set up it must match */
110940f9244fSMark Brown 		if (map->dev_name &&
111040f9244fSMark Brown 		    (!devname || strcmp(map->dev_name, devname)))
111140f9244fSMark Brown 			continue;
111240f9244fSMark Brown 
111340f9244fSMark Brown 		if (strcmp(map->supply, id) == 0) {
1114a5766f11SLiam Girdwood 			rdev = map->regulator;
1115414c70cbSLiam Girdwood 			goto found;
1116414c70cbSLiam Girdwood 		}
1117a5766f11SLiam Girdwood 	}
1118414c70cbSLiam Girdwood 	mutex_unlock(&regulator_list_mutex);
1119414c70cbSLiam Girdwood 	return regulator;
1120414c70cbSLiam Girdwood 
1121414c70cbSLiam Girdwood found:
11225ffbd136SMark Brown 	if (rdev->exclusive) {
11235ffbd136SMark Brown 		regulator = ERR_PTR(-EPERM);
11245ffbd136SMark Brown 		goto out;
11255ffbd136SMark Brown 	}
11265ffbd136SMark Brown 
11275ffbd136SMark Brown 	if (exclusive && rdev->open_count) {
11285ffbd136SMark Brown 		regulator = ERR_PTR(-EBUSY);
11295ffbd136SMark Brown 		goto out;
11305ffbd136SMark Brown 	}
11315ffbd136SMark Brown 
1132a5766f11SLiam Girdwood 	if (!try_module_get(rdev->owner))
1133a5766f11SLiam Girdwood 		goto out;
1134a5766f11SLiam Girdwood 
1135414c70cbSLiam Girdwood 	regulator = create_regulator(rdev, dev, id);
1136414c70cbSLiam Girdwood 	if (regulator == NULL) {
1137414c70cbSLiam Girdwood 		regulator = ERR_PTR(-ENOMEM);
1138414c70cbSLiam Girdwood 		module_put(rdev->owner);
1139414c70cbSLiam Girdwood 	}
1140414c70cbSLiam Girdwood 
11415ffbd136SMark Brown 	rdev->open_count++;
11425ffbd136SMark Brown 	if (exclusive) {
11435ffbd136SMark Brown 		rdev->exclusive = 1;
11445ffbd136SMark Brown 
11455ffbd136SMark Brown 		ret = _regulator_is_enabled(rdev);
11465ffbd136SMark Brown 		if (ret > 0)
11475ffbd136SMark Brown 			rdev->use_count = 1;
11485ffbd136SMark Brown 		else
11495ffbd136SMark Brown 			rdev->use_count = 0;
11505ffbd136SMark Brown 	}
11515ffbd136SMark Brown 
1152a5766f11SLiam Girdwood out:
1153414c70cbSLiam Girdwood 	mutex_unlock(&regulator_list_mutex);
11545ffbd136SMark Brown 
1155414c70cbSLiam Girdwood 	return regulator;
1156414c70cbSLiam Girdwood }
11575ffbd136SMark Brown 
11585ffbd136SMark Brown /**
11595ffbd136SMark Brown  * regulator_get - lookup and obtain a reference to a regulator.
11605ffbd136SMark Brown  * @dev: device for regulator "consumer"
11615ffbd136SMark Brown  * @id: Supply name or regulator ID.
11625ffbd136SMark Brown  *
11635ffbd136SMark Brown  * Returns a struct regulator corresponding to the regulator producer,
11645ffbd136SMark Brown  * or IS_ERR() condition containing errno.
11655ffbd136SMark Brown  *
11665ffbd136SMark Brown  * Use of supply names configured via regulator_set_device_supply() is
11675ffbd136SMark Brown  * strongly encouraged.  It is recommended that the supply name used
11685ffbd136SMark Brown  * should match the name used for the supply and/or the relevant
11695ffbd136SMark Brown  * device pins in the datasheet.
11705ffbd136SMark Brown  */
11715ffbd136SMark Brown struct regulator *regulator_get(struct device *dev, const char *id)
11725ffbd136SMark Brown {
11735ffbd136SMark Brown 	return _regulator_get(dev, id, 0);
11745ffbd136SMark Brown }
1175414c70cbSLiam Girdwood EXPORT_SYMBOL_GPL(regulator_get);
1176414c70cbSLiam Girdwood 
1177414c70cbSLiam Girdwood /**
11785ffbd136SMark Brown  * regulator_get_exclusive - obtain exclusive access to a regulator.
11795ffbd136SMark Brown  * @dev: device for regulator "consumer"
11805ffbd136SMark Brown  * @id: Supply name or regulator ID.
11815ffbd136SMark Brown  *
11825ffbd136SMark Brown  * Returns a struct regulator corresponding to the regulator producer,
11835ffbd136SMark Brown  * or IS_ERR() condition containing errno.  Other consumers will be
11845ffbd136SMark Brown  * unable to obtain this reference is held and the use count for the
11855ffbd136SMark Brown  * regulator will be initialised to reflect the current state of the
11865ffbd136SMark Brown  * regulator.
11875ffbd136SMark Brown  *
11885ffbd136SMark Brown  * This is intended for use by consumers which cannot tolerate shared
11895ffbd136SMark Brown  * use of the regulator such as those which need to force the
11905ffbd136SMark Brown  * regulator off for correct operation of the hardware they are
11915ffbd136SMark Brown  * controlling.
11925ffbd136SMark Brown  *
11935ffbd136SMark Brown  * Use of supply names configured via regulator_set_device_supply() is
11945ffbd136SMark Brown  * strongly encouraged.  It is recommended that the supply name used
11955ffbd136SMark Brown  * should match the name used for the supply and/or the relevant
11965ffbd136SMark Brown  * device pins in the datasheet.
11975ffbd136SMark Brown  */
11985ffbd136SMark Brown struct regulator *regulator_get_exclusive(struct device *dev, const char *id)
11995ffbd136SMark Brown {
12005ffbd136SMark Brown 	return _regulator_get(dev, id, 1);
12015ffbd136SMark Brown }
12025ffbd136SMark Brown EXPORT_SYMBOL_GPL(regulator_get_exclusive);
12035ffbd136SMark Brown 
12045ffbd136SMark Brown /**
1205414c70cbSLiam Girdwood  * regulator_put - "free" the regulator source
1206414c70cbSLiam Girdwood  * @regulator: regulator source
1207414c70cbSLiam Girdwood  *
1208414c70cbSLiam Girdwood  * Note: drivers must ensure that all regulator_enable calls made on this
1209414c70cbSLiam Girdwood  * regulator source are balanced by regulator_disable calls prior to calling
1210414c70cbSLiam Girdwood  * this function.
1211414c70cbSLiam Girdwood  */
1212414c70cbSLiam Girdwood void regulator_put(struct regulator *regulator)
1213414c70cbSLiam Girdwood {
1214414c70cbSLiam Girdwood 	struct regulator_dev *rdev;
1215414c70cbSLiam Girdwood 
1216414c70cbSLiam Girdwood 	if (regulator == NULL || IS_ERR(regulator))
1217414c70cbSLiam Girdwood 		return;
1218414c70cbSLiam Girdwood 
1219414c70cbSLiam Girdwood 	mutex_lock(&regulator_list_mutex);
1220414c70cbSLiam Girdwood 	rdev = regulator->rdev;
1221414c70cbSLiam Girdwood 
1222414c70cbSLiam Girdwood 	/* remove any sysfs entries */
1223414c70cbSLiam Girdwood 	if (regulator->dev) {
1224414c70cbSLiam Girdwood 		sysfs_remove_link(&rdev->dev.kobj, regulator->supply_name);
1225414c70cbSLiam Girdwood 		kfree(regulator->supply_name);
1226414c70cbSLiam Girdwood 		device_remove_file(regulator->dev, &regulator->dev_attr);
1227414c70cbSLiam Girdwood 		kfree(regulator->dev_attr.attr.name);
1228414c70cbSLiam Girdwood 	}
1229414c70cbSLiam Girdwood 	list_del(&regulator->list);
1230414c70cbSLiam Girdwood 	kfree(regulator);
1231414c70cbSLiam Girdwood 
12325ffbd136SMark Brown 	rdev->open_count--;
12335ffbd136SMark Brown 	rdev->exclusive = 0;
12345ffbd136SMark Brown 
1235414c70cbSLiam Girdwood 	module_put(rdev->owner);
1236414c70cbSLiam Girdwood 	mutex_unlock(&regulator_list_mutex);
1237414c70cbSLiam Girdwood }
1238414c70cbSLiam Girdwood EXPORT_SYMBOL_GPL(regulator_put);
1239414c70cbSLiam Girdwood 
12409a2372faSMark Brown static int _regulator_can_change_status(struct regulator_dev *rdev)
12419a2372faSMark Brown {
12429a2372faSMark Brown 	if (!rdev->constraints)
12439a2372faSMark Brown 		return 0;
12449a2372faSMark Brown 
12459a2372faSMark Brown 	if (rdev->constraints->valid_ops_mask & REGULATOR_CHANGE_STATUS)
12469a2372faSMark Brown 		return 1;
12479a2372faSMark Brown 	else
12489a2372faSMark Brown 		return 0;
12499a2372faSMark Brown }
12509a2372faSMark Brown 
1251414c70cbSLiam Girdwood /* locks held by regulator_enable() */
1252414c70cbSLiam Girdwood static int _regulator_enable(struct regulator_dev *rdev)
1253414c70cbSLiam Girdwood {
12549a2372faSMark Brown 	int ret;
1255414c70cbSLiam Girdwood 
1256414c70cbSLiam Girdwood 	/* do we need to enable the supply regulator first */
1257414c70cbSLiam Girdwood 	if (rdev->supply) {
1258414c70cbSLiam Girdwood 		ret = _regulator_enable(rdev->supply);
1259414c70cbSLiam Girdwood 		if (ret < 0) {
1260414c70cbSLiam Girdwood 			printk(KERN_ERR "%s: failed to enable %s: %d\n",
12611083c393SMark Brown 			       __func__, rdev_get_name(rdev), ret);
1262414c70cbSLiam Girdwood 			return ret;
1263414c70cbSLiam Girdwood 		}
1264414c70cbSLiam Girdwood 	}
1265414c70cbSLiam Girdwood 
1266414c70cbSLiam Girdwood 	/* check voltage and requested load before enabling */
1267414c70cbSLiam Girdwood 	if (rdev->constraints &&
12689a2372faSMark Brown 	    (rdev->constraints->valid_ops_mask & REGULATOR_CHANGE_DRMS))
1269414c70cbSLiam Girdwood 		drms_uA_update(rdev);
1270414c70cbSLiam Girdwood 
12719a2372faSMark Brown 	if (rdev->use_count == 0) {
12729a2372faSMark Brown 		/* The regulator may on if it's not switchable or left on */
12739a2372faSMark Brown 		ret = _regulator_is_enabled(rdev);
12749a2372faSMark Brown 		if (ret == -EINVAL || ret == 0) {
12759a2372faSMark Brown 			if (!_regulator_can_change_status(rdev))
12769a2372faSMark Brown 				return -EPERM;
12779a2372faSMark Brown 
12789a2372faSMark Brown 			if (rdev->desc->ops->enable) {
1279414c70cbSLiam Girdwood 				ret = rdev->desc->ops->enable(rdev);
12809a2372faSMark Brown 				if (ret < 0)
12819a2372faSMark Brown 					return ret;
12829a2372faSMark Brown 			} else {
12839a2372faSMark Brown 				return -EINVAL;
12849a2372faSMark Brown 			}
1285a7433cffSLinus Walleij 		} else if (ret < 0) {
12869a2372faSMark Brown 			printk(KERN_ERR "%s: is_enabled() failed for %s: %d\n",
12871083c393SMark Brown 			       __func__, rdev_get_name(rdev), ret);
1288414c70cbSLiam Girdwood 			return ret;
1289414c70cbSLiam Girdwood 		}
1290a7433cffSLinus Walleij 		/* Fallthrough on positive return values - already enabled */
1291414c70cbSLiam Girdwood 	}
1292414c70cbSLiam Girdwood 
12939a2372faSMark Brown 	rdev->use_count++;
12949a2372faSMark Brown 
12959a2372faSMark Brown 	return 0;
1296414c70cbSLiam Girdwood }
1297414c70cbSLiam Girdwood 
1298414c70cbSLiam Girdwood /**
1299414c70cbSLiam Girdwood  * regulator_enable - enable regulator output
1300414c70cbSLiam Girdwood  * @regulator: regulator source
1301414c70cbSLiam Girdwood  *
1302cf7bbcdfSMark Brown  * Request that the regulator be enabled with the regulator output at
1303cf7bbcdfSMark Brown  * the predefined voltage or current value.  Calls to regulator_enable()
1304cf7bbcdfSMark Brown  * must be balanced with calls to regulator_disable().
1305cf7bbcdfSMark Brown  *
1306414c70cbSLiam Girdwood  * NOTE: the output value can be set by other drivers, boot loader or may be
1307cf7bbcdfSMark Brown  * hardwired in the regulator.
1308414c70cbSLiam Girdwood  */
1309414c70cbSLiam Girdwood int regulator_enable(struct regulator *regulator)
1310414c70cbSLiam Girdwood {
1311412aec61SDavid Brownell 	struct regulator_dev *rdev = regulator->rdev;
1312412aec61SDavid Brownell 	int ret = 0;
1313414c70cbSLiam Girdwood 
1314412aec61SDavid Brownell 	mutex_lock(&rdev->mutex);
1315412aec61SDavid Brownell 	ret = _regulator_enable(rdev);
1316412aec61SDavid Brownell 	mutex_unlock(&rdev->mutex);
1317414c70cbSLiam Girdwood 	return ret;
1318414c70cbSLiam Girdwood }
1319414c70cbSLiam Girdwood EXPORT_SYMBOL_GPL(regulator_enable);
1320414c70cbSLiam Girdwood 
1321414c70cbSLiam Girdwood /* locks held by regulator_disable() */
1322414c70cbSLiam Girdwood static int _regulator_disable(struct regulator_dev *rdev)
1323414c70cbSLiam Girdwood {
1324414c70cbSLiam Girdwood 	int ret = 0;
1325414c70cbSLiam Girdwood 
1326cd94b505SDavid Brownell 	if (WARN(rdev->use_count <= 0,
1327cd94b505SDavid Brownell 			"unbalanced disables for %s\n",
13281083c393SMark Brown 			rdev_get_name(rdev)))
1329cd94b505SDavid Brownell 		return -EIO;
1330cd94b505SDavid Brownell 
1331414c70cbSLiam Girdwood 	/* are we the last user and permitted to disable ? */
133260ef66fcSMark Brown 	if (rdev->use_count == 1 &&
133360ef66fcSMark Brown 	    (rdev->constraints && !rdev->constraints->always_on)) {
1334414c70cbSLiam Girdwood 
1335414c70cbSLiam Girdwood 		/* we are last user */
13369a2372faSMark Brown 		if (_regulator_can_change_status(rdev) &&
13379a2372faSMark Brown 		    rdev->desc->ops->disable) {
1338414c70cbSLiam Girdwood 			ret = rdev->desc->ops->disable(rdev);
1339414c70cbSLiam Girdwood 			if (ret < 0) {
1340414c70cbSLiam Girdwood 				printk(KERN_ERR "%s: failed to disable %s\n",
13411083c393SMark Brown 				       __func__, rdev_get_name(rdev));
1342414c70cbSLiam Girdwood 				return ret;
1343414c70cbSLiam Girdwood 			}
1344414c70cbSLiam Girdwood 		}
1345414c70cbSLiam Girdwood 
1346414c70cbSLiam Girdwood 		/* decrease our supplies ref count and disable if required */
1347414c70cbSLiam Girdwood 		if (rdev->supply)
1348414c70cbSLiam Girdwood 			_regulator_disable(rdev->supply);
1349414c70cbSLiam Girdwood 
1350414c70cbSLiam Girdwood 		rdev->use_count = 0;
1351414c70cbSLiam Girdwood 	} else if (rdev->use_count > 1) {
1352414c70cbSLiam Girdwood 
1353414c70cbSLiam Girdwood 		if (rdev->constraints &&
1354414c70cbSLiam Girdwood 			(rdev->constraints->valid_ops_mask &
1355414c70cbSLiam Girdwood 			REGULATOR_CHANGE_DRMS))
1356414c70cbSLiam Girdwood 			drms_uA_update(rdev);
1357414c70cbSLiam Girdwood 
1358414c70cbSLiam Girdwood 		rdev->use_count--;
1359414c70cbSLiam Girdwood 	}
1360414c70cbSLiam Girdwood 	return ret;
1361414c70cbSLiam Girdwood }
1362414c70cbSLiam Girdwood 
1363414c70cbSLiam Girdwood /**
1364414c70cbSLiam Girdwood  * regulator_disable - disable regulator output
1365414c70cbSLiam Girdwood  * @regulator: regulator source
1366414c70cbSLiam Girdwood  *
1367cf7bbcdfSMark Brown  * Disable the regulator output voltage or current.  Calls to
1368cf7bbcdfSMark Brown  * regulator_enable() must be balanced with calls to
1369cf7bbcdfSMark Brown  * regulator_disable().
137069279fb9SMark Brown  *
1371414c70cbSLiam Girdwood  * NOTE: this will only disable the regulator output if no other consumer
1372cf7bbcdfSMark Brown  * devices have it enabled, the regulator device supports disabling and
1373cf7bbcdfSMark Brown  * machine constraints permit this operation.
1374414c70cbSLiam Girdwood  */
1375414c70cbSLiam Girdwood int regulator_disable(struct regulator *regulator)
1376414c70cbSLiam Girdwood {
1377412aec61SDavid Brownell 	struct regulator_dev *rdev = regulator->rdev;
1378412aec61SDavid Brownell 	int ret = 0;
1379414c70cbSLiam Girdwood 
1380412aec61SDavid Brownell 	mutex_lock(&rdev->mutex);
1381412aec61SDavid Brownell 	ret = _regulator_disable(rdev);
1382412aec61SDavid Brownell 	mutex_unlock(&rdev->mutex);
1383414c70cbSLiam Girdwood 	return ret;
1384414c70cbSLiam Girdwood }
1385414c70cbSLiam Girdwood EXPORT_SYMBOL_GPL(regulator_disable);
1386414c70cbSLiam Girdwood 
1387414c70cbSLiam Girdwood /* locks held by regulator_force_disable() */
1388414c70cbSLiam Girdwood static int _regulator_force_disable(struct regulator_dev *rdev)
1389414c70cbSLiam Girdwood {
1390414c70cbSLiam Girdwood 	int ret = 0;
1391414c70cbSLiam Girdwood 
1392414c70cbSLiam Girdwood 	/* force disable */
1393414c70cbSLiam Girdwood 	if (rdev->desc->ops->disable) {
1394414c70cbSLiam Girdwood 		/* ah well, who wants to live forever... */
1395414c70cbSLiam Girdwood 		ret = rdev->desc->ops->disable(rdev);
1396414c70cbSLiam Girdwood 		if (ret < 0) {
1397414c70cbSLiam Girdwood 			printk(KERN_ERR "%s: failed to force disable %s\n",
13981083c393SMark Brown 			       __func__, rdev_get_name(rdev));
1399414c70cbSLiam Girdwood 			return ret;
1400414c70cbSLiam Girdwood 		}
1401414c70cbSLiam Girdwood 		/* notify other consumers that power has been forced off */
1402414c70cbSLiam Girdwood 		_notifier_call_chain(rdev, REGULATOR_EVENT_FORCE_DISABLE,
1403414c70cbSLiam Girdwood 			NULL);
1404414c70cbSLiam Girdwood 	}
1405414c70cbSLiam Girdwood 
1406414c70cbSLiam Girdwood 	/* decrease our supplies ref count and disable if required */
1407414c70cbSLiam Girdwood 	if (rdev->supply)
1408414c70cbSLiam Girdwood 		_regulator_disable(rdev->supply);
1409414c70cbSLiam Girdwood 
1410414c70cbSLiam Girdwood 	rdev->use_count = 0;
1411414c70cbSLiam Girdwood 	return ret;
1412414c70cbSLiam Girdwood }
1413414c70cbSLiam Girdwood 
1414414c70cbSLiam Girdwood /**
1415414c70cbSLiam Girdwood  * regulator_force_disable - force disable regulator output
1416414c70cbSLiam Girdwood  * @regulator: regulator source
1417414c70cbSLiam Girdwood  *
1418414c70cbSLiam Girdwood  * Forcibly disable the regulator output voltage or current.
1419414c70cbSLiam Girdwood  * NOTE: this *will* disable the regulator output even if other consumer
1420414c70cbSLiam Girdwood  * devices have it enabled. This should be used for situations when device
1421414c70cbSLiam Girdwood  * damage will likely occur if the regulator is not disabled (e.g. over temp).
1422414c70cbSLiam Girdwood  */
1423414c70cbSLiam Girdwood int regulator_force_disable(struct regulator *regulator)
1424414c70cbSLiam Girdwood {
1425414c70cbSLiam Girdwood 	int ret;
1426414c70cbSLiam Girdwood 
1427414c70cbSLiam Girdwood 	mutex_lock(&regulator->rdev->mutex);
1428414c70cbSLiam Girdwood 	regulator->uA_load = 0;
1429414c70cbSLiam Girdwood 	ret = _regulator_force_disable(regulator->rdev);
1430414c70cbSLiam Girdwood 	mutex_unlock(&regulator->rdev->mutex);
1431414c70cbSLiam Girdwood 	return ret;
1432414c70cbSLiam Girdwood }
1433414c70cbSLiam Girdwood EXPORT_SYMBOL_GPL(regulator_force_disable);
1434414c70cbSLiam Girdwood 
1435414c70cbSLiam Girdwood static int _regulator_is_enabled(struct regulator_dev *rdev)
1436414c70cbSLiam Girdwood {
1437414c70cbSLiam Girdwood 	/* sanity check */
14389332546fSMark Brown 	if (!rdev->desc->ops->is_enabled)
14399332546fSMark Brown 		return -EINVAL;
1440414c70cbSLiam Girdwood 
14419332546fSMark Brown 	return rdev->desc->ops->is_enabled(rdev);
1442414c70cbSLiam Girdwood }
1443414c70cbSLiam Girdwood 
1444414c70cbSLiam Girdwood /**
1445414c70cbSLiam Girdwood  * regulator_is_enabled - is the regulator output enabled
1446414c70cbSLiam Girdwood  * @regulator: regulator source
1447414c70cbSLiam Girdwood  *
1448412aec61SDavid Brownell  * Returns positive if the regulator driver backing the source/client
1449412aec61SDavid Brownell  * has requested that the device be enabled, zero if it hasn't, else a
1450412aec61SDavid Brownell  * negative errno code.
1451412aec61SDavid Brownell  *
1452412aec61SDavid Brownell  * Note that the device backing this regulator handle can have multiple
1453412aec61SDavid Brownell  * users, so it might be enabled even if regulator_enable() was never
1454412aec61SDavid Brownell  * called for this particular source.
1455414c70cbSLiam Girdwood  */
1456414c70cbSLiam Girdwood int regulator_is_enabled(struct regulator *regulator)
1457414c70cbSLiam Girdwood {
14589332546fSMark Brown 	int ret;
14599332546fSMark Brown 
14609332546fSMark Brown 	mutex_lock(&regulator->rdev->mutex);
14619332546fSMark Brown 	ret = _regulator_is_enabled(regulator->rdev);
14629332546fSMark Brown 	mutex_unlock(&regulator->rdev->mutex);
14639332546fSMark Brown 
14649332546fSMark Brown 	return ret;
1465414c70cbSLiam Girdwood }
1466414c70cbSLiam Girdwood EXPORT_SYMBOL_GPL(regulator_is_enabled);
1467414c70cbSLiam Girdwood 
1468414c70cbSLiam Girdwood /**
14694367cfdcSDavid Brownell  * regulator_count_voltages - count regulator_list_voltage() selectors
14704367cfdcSDavid Brownell  * @regulator: regulator source
14714367cfdcSDavid Brownell  *
14724367cfdcSDavid Brownell  * Returns number of selectors, or negative errno.  Selectors are
14734367cfdcSDavid Brownell  * numbered starting at zero, and typically correspond to bitfields
14744367cfdcSDavid Brownell  * in hardware registers.
14754367cfdcSDavid Brownell  */
14764367cfdcSDavid Brownell int regulator_count_voltages(struct regulator *regulator)
14774367cfdcSDavid Brownell {
14784367cfdcSDavid Brownell 	struct regulator_dev	*rdev = regulator->rdev;
14794367cfdcSDavid Brownell 
14804367cfdcSDavid Brownell 	return rdev->desc->n_voltages ? : -EINVAL;
14814367cfdcSDavid Brownell }
14824367cfdcSDavid Brownell EXPORT_SYMBOL_GPL(regulator_count_voltages);
14834367cfdcSDavid Brownell 
14844367cfdcSDavid Brownell /**
14854367cfdcSDavid Brownell  * regulator_list_voltage - enumerate supported voltages
14864367cfdcSDavid Brownell  * @regulator: regulator source
14874367cfdcSDavid Brownell  * @selector: identify voltage to list
14884367cfdcSDavid Brownell  * Context: can sleep
14894367cfdcSDavid Brownell  *
14904367cfdcSDavid Brownell  * Returns a voltage that can be passed to @regulator_set_voltage(),
14914367cfdcSDavid Brownell  * zero if this selector code can't be used on this sytem, or a
14924367cfdcSDavid Brownell  * negative errno.
14934367cfdcSDavid Brownell  */
14944367cfdcSDavid Brownell int regulator_list_voltage(struct regulator *regulator, unsigned selector)
14954367cfdcSDavid Brownell {
14964367cfdcSDavid Brownell 	struct regulator_dev	*rdev = regulator->rdev;
14974367cfdcSDavid Brownell 	struct regulator_ops	*ops = rdev->desc->ops;
14984367cfdcSDavid Brownell 	int			ret;
14994367cfdcSDavid Brownell 
15004367cfdcSDavid Brownell 	if (!ops->list_voltage || selector >= rdev->desc->n_voltages)
15014367cfdcSDavid Brownell 		return -EINVAL;
15024367cfdcSDavid Brownell 
15034367cfdcSDavid Brownell 	mutex_lock(&rdev->mutex);
15044367cfdcSDavid Brownell 	ret = ops->list_voltage(rdev, selector);
15054367cfdcSDavid Brownell 	mutex_unlock(&rdev->mutex);
15064367cfdcSDavid Brownell 
15074367cfdcSDavid Brownell 	if (ret > 0) {
15084367cfdcSDavid Brownell 		if (ret < rdev->constraints->min_uV)
15094367cfdcSDavid Brownell 			ret = 0;
15104367cfdcSDavid Brownell 		else if (ret > rdev->constraints->max_uV)
15114367cfdcSDavid Brownell 			ret = 0;
15124367cfdcSDavid Brownell 	}
15134367cfdcSDavid Brownell 
15144367cfdcSDavid Brownell 	return ret;
15154367cfdcSDavid Brownell }
15164367cfdcSDavid Brownell EXPORT_SYMBOL_GPL(regulator_list_voltage);
15174367cfdcSDavid Brownell 
15184367cfdcSDavid Brownell /**
1519a7a1ad90SMark Brown  * regulator_is_supported_voltage - check if a voltage range can be supported
1520a7a1ad90SMark Brown  *
1521a7a1ad90SMark Brown  * @regulator: Regulator to check.
1522a7a1ad90SMark Brown  * @min_uV: Minimum required voltage in uV.
1523a7a1ad90SMark Brown  * @max_uV: Maximum required voltage in uV.
1524a7a1ad90SMark Brown  *
1525a7a1ad90SMark Brown  * Returns a boolean or a negative error code.
1526a7a1ad90SMark Brown  */
1527a7a1ad90SMark Brown int regulator_is_supported_voltage(struct regulator *regulator,
1528a7a1ad90SMark Brown 				   int min_uV, int max_uV)
1529a7a1ad90SMark Brown {
1530a7a1ad90SMark Brown 	int i, voltages, ret;
1531a7a1ad90SMark Brown 
1532a7a1ad90SMark Brown 	ret = regulator_count_voltages(regulator);
1533a7a1ad90SMark Brown 	if (ret < 0)
1534a7a1ad90SMark Brown 		return ret;
1535a7a1ad90SMark Brown 	voltages = ret;
1536a7a1ad90SMark Brown 
1537a7a1ad90SMark Brown 	for (i = 0; i < voltages; i++) {
1538a7a1ad90SMark Brown 		ret = regulator_list_voltage(regulator, i);
1539a7a1ad90SMark Brown 
1540a7a1ad90SMark Brown 		if (ret >= min_uV && ret <= max_uV)
1541a7a1ad90SMark Brown 			return 1;
1542a7a1ad90SMark Brown 	}
1543a7a1ad90SMark Brown 
1544a7a1ad90SMark Brown 	return 0;
1545a7a1ad90SMark Brown }
1546a7a1ad90SMark Brown 
1547a7a1ad90SMark Brown /**
1548414c70cbSLiam Girdwood  * regulator_set_voltage - set regulator output voltage
1549414c70cbSLiam Girdwood  * @regulator: regulator source
1550414c70cbSLiam Girdwood  * @min_uV: Minimum required voltage in uV
1551414c70cbSLiam Girdwood  * @max_uV: Maximum acceptable voltage in uV
1552414c70cbSLiam Girdwood  *
1553414c70cbSLiam Girdwood  * Sets a voltage regulator to the desired output voltage. This can be set
1554414c70cbSLiam Girdwood  * during any regulator state. IOW, regulator can be disabled or enabled.
1555414c70cbSLiam Girdwood  *
1556414c70cbSLiam Girdwood  * If the regulator is enabled then the voltage will change to the new value
1557414c70cbSLiam Girdwood  * immediately otherwise if the regulator is disabled the regulator will
1558414c70cbSLiam Girdwood  * output at the new voltage when enabled.
1559414c70cbSLiam Girdwood  *
1560414c70cbSLiam Girdwood  * NOTE: If the regulator is shared between several devices then the lowest
1561414c70cbSLiam Girdwood  * request voltage that meets the system constraints will be used.
156269279fb9SMark Brown  * Regulator system constraints must be set for this regulator before
1563414c70cbSLiam Girdwood  * calling this function otherwise this call will fail.
1564414c70cbSLiam Girdwood  */
1565414c70cbSLiam Girdwood int regulator_set_voltage(struct regulator *regulator, int min_uV, int max_uV)
1566414c70cbSLiam Girdwood {
1567414c70cbSLiam Girdwood 	struct regulator_dev *rdev = regulator->rdev;
1568414c70cbSLiam Girdwood 	int ret;
1569414c70cbSLiam Girdwood 
1570414c70cbSLiam Girdwood 	mutex_lock(&rdev->mutex);
1571414c70cbSLiam Girdwood 
1572414c70cbSLiam Girdwood 	/* sanity check */
1573414c70cbSLiam Girdwood 	if (!rdev->desc->ops->set_voltage) {
1574414c70cbSLiam Girdwood 		ret = -EINVAL;
1575414c70cbSLiam Girdwood 		goto out;
1576414c70cbSLiam Girdwood 	}
1577414c70cbSLiam Girdwood 
1578414c70cbSLiam Girdwood 	/* constraints check */
1579414c70cbSLiam Girdwood 	ret = regulator_check_voltage(rdev, &min_uV, &max_uV);
1580414c70cbSLiam Girdwood 	if (ret < 0)
1581414c70cbSLiam Girdwood 		goto out;
1582414c70cbSLiam Girdwood 	regulator->min_uV = min_uV;
1583414c70cbSLiam Girdwood 	regulator->max_uV = max_uV;
1584414c70cbSLiam Girdwood 	ret = rdev->desc->ops->set_voltage(rdev, min_uV, max_uV);
1585414c70cbSLiam Girdwood 
1586414c70cbSLiam Girdwood out:
1587b136fb44SJonathan Cameron 	_notifier_call_chain(rdev, REGULATOR_EVENT_VOLTAGE_CHANGE, NULL);
1588414c70cbSLiam Girdwood 	mutex_unlock(&rdev->mutex);
1589414c70cbSLiam Girdwood 	return ret;
1590414c70cbSLiam Girdwood }
1591414c70cbSLiam Girdwood EXPORT_SYMBOL_GPL(regulator_set_voltage);
1592414c70cbSLiam Girdwood 
1593414c70cbSLiam Girdwood static int _regulator_get_voltage(struct regulator_dev *rdev)
1594414c70cbSLiam Girdwood {
1595414c70cbSLiam Girdwood 	/* sanity check */
1596414c70cbSLiam Girdwood 	if (rdev->desc->ops->get_voltage)
1597414c70cbSLiam Girdwood 		return rdev->desc->ops->get_voltage(rdev);
1598414c70cbSLiam Girdwood 	else
1599414c70cbSLiam Girdwood 		return -EINVAL;
1600414c70cbSLiam Girdwood }
1601414c70cbSLiam Girdwood 
1602414c70cbSLiam Girdwood /**
1603414c70cbSLiam Girdwood  * regulator_get_voltage - get regulator output voltage
1604414c70cbSLiam Girdwood  * @regulator: regulator source
1605414c70cbSLiam Girdwood  *
1606414c70cbSLiam Girdwood  * This returns the current regulator voltage in uV.
1607414c70cbSLiam Girdwood  *
1608414c70cbSLiam Girdwood  * NOTE: If the regulator is disabled it will return the voltage value. This
1609414c70cbSLiam Girdwood  * function should not be used to determine regulator state.
1610414c70cbSLiam Girdwood  */
1611414c70cbSLiam Girdwood int regulator_get_voltage(struct regulator *regulator)
1612414c70cbSLiam Girdwood {
1613414c70cbSLiam Girdwood 	int ret;
1614414c70cbSLiam Girdwood 
1615414c70cbSLiam Girdwood 	mutex_lock(&regulator->rdev->mutex);
1616414c70cbSLiam Girdwood 
1617414c70cbSLiam Girdwood 	ret = _regulator_get_voltage(regulator->rdev);
1618414c70cbSLiam Girdwood 
1619414c70cbSLiam Girdwood 	mutex_unlock(&regulator->rdev->mutex);
1620414c70cbSLiam Girdwood 
1621414c70cbSLiam Girdwood 	return ret;
1622414c70cbSLiam Girdwood }
1623414c70cbSLiam Girdwood EXPORT_SYMBOL_GPL(regulator_get_voltage);
1624414c70cbSLiam Girdwood 
1625414c70cbSLiam Girdwood /**
1626414c70cbSLiam Girdwood  * regulator_set_current_limit - set regulator output current limit
1627414c70cbSLiam Girdwood  * @regulator: regulator source
1628414c70cbSLiam Girdwood  * @min_uA: Minimuum supported current in uA
1629414c70cbSLiam Girdwood  * @max_uA: Maximum supported current in uA
1630414c70cbSLiam Girdwood  *
1631414c70cbSLiam Girdwood  * Sets current sink to the desired output current. This can be set during
1632414c70cbSLiam Girdwood  * any regulator state. IOW, regulator can be disabled or enabled.
1633414c70cbSLiam Girdwood  *
1634414c70cbSLiam Girdwood  * If the regulator is enabled then the current will change to the new value
1635414c70cbSLiam Girdwood  * immediately otherwise if the regulator is disabled the regulator will
1636414c70cbSLiam Girdwood  * output at the new current when enabled.
1637414c70cbSLiam Girdwood  *
1638414c70cbSLiam Girdwood  * NOTE: Regulator system constraints must be set for this regulator before
1639414c70cbSLiam Girdwood  * calling this function otherwise this call will fail.
1640414c70cbSLiam Girdwood  */
1641414c70cbSLiam Girdwood int regulator_set_current_limit(struct regulator *regulator,
1642414c70cbSLiam Girdwood 			       int min_uA, int max_uA)
1643414c70cbSLiam Girdwood {
1644414c70cbSLiam Girdwood 	struct regulator_dev *rdev = regulator->rdev;
1645414c70cbSLiam Girdwood 	int ret;
1646414c70cbSLiam Girdwood 
1647414c70cbSLiam Girdwood 	mutex_lock(&rdev->mutex);
1648414c70cbSLiam Girdwood 
1649414c70cbSLiam Girdwood 	/* sanity check */
1650414c70cbSLiam Girdwood 	if (!rdev->desc->ops->set_current_limit) {
1651414c70cbSLiam Girdwood 		ret = -EINVAL;
1652414c70cbSLiam Girdwood 		goto out;
1653414c70cbSLiam Girdwood 	}
1654414c70cbSLiam Girdwood 
1655414c70cbSLiam Girdwood 	/* constraints check */
1656414c70cbSLiam Girdwood 	ret = regulator_check_current_limit(rdev, &min_uA, &max_uA);
1657414c70cbSLiam Girdwood 	if (ret < 0)
1658414c70cbSLiam Girdwood 		goto out;
1659414c70cbSLiam Girdwood 
1660414c70cbSLiam Girdwood 	ret = rdev->desc->ops->set_current_limit(rdev, min_uA, max_uA);
1661414c70cbSLiam Girdwood out:
1662414c70cbSLiam Girdwood 	mutex_unlock(&rdev->mutex);
1663414c70cbSLiam Girdwood 	return ret;
1664414c70cbSLiam Girdwood }
1665414c70cbSLiam Girdwood EXPORT_SYMBOL_GPL(regulator_set_current_limit);
1666414c70cbSLiam Girdwood 
1667414c70cbSLiam Girdwood static int _regulator_get_current_limit(struct regulator_dev *rdev)
1668414c70cbSLiam Girdwood {
1669414c70cbSLiam Girdwood 	int ret;
1670414c70cbSLiam Girdwood 
1671414c70cbSLiam Girdwood 	mutex_lock(&rdev->mutex);
1672414c70cbSLiam Girdwood 
1673414c70cbSLiam Girdwood 	/* sanity check */
1674414c70cbSLiam Girdwood 	if (!rdev->desc->ops->get_current_limit) {
1675414c70cbSLiam Girdwood 		ret = -EINVAL;
1676414c70cbSLiam Girdwood 		goto out;
1677414c70cbSLiam Girdwood 	}
1678414c70cbSLiam Girdwood 
1679414c70cbSLiam Girdwood 	ret = rdev->desc->ops->get_current_limit(rdev);
1680414c70cbSLiam Girdwood out:
1681414c70cbSLiam Girdwood 	mutex_unlock(&rdev->mutex);
1682414c70cbSLiam Girdwood 	return ret;
1683414c70cbSLiam Girdwood }
1684414c70cbSLiam Girdwood 
1685414c70cbSLiam Girdwood /**
1686414c70cbSLiam Girdwood  * regulator_get_current_limit - get regulator output current
1687414c70cbSLiam Girdwood  * @regulator: regulator source
1688414c70cbSLiam Girdwood  *
1689414c70cbSLiam Girdwood  * This returns the current supplied by the specified current sink in uA.
1690414c70cbSLiam Girdwood  *
1691414c70cbSLiam Girdwood  * NOTE: If the regulator is disabled it will return the current value. This
1692414c70cbSLiam Girdwood  * function should not be used to determine regulator state.
1693414c70cbSLiam Girdwood  */
1694414c70cbSLiam Girdwood int regulator_get_current_limit(struct regulator *regulator)
1695414c70cbSLiam Girdwood {
1696414c70cbSLiam Girdwood 	return _regulator_get_current_limit(regulator->rdev);
1697414c70cbSLiam Girdwood }
1698414c70cbSLiam Girdwood EXPORT_SYMBOL_GPL(regulator_get_current_limit);
1699414c70cbSLiam Girdwood 
1700414c70cbSLiam Girdwood /**
1701414c70cbSLiam Girdwood  * regulator_set_mode - set regulator operating mode
1702414c70cbSLiam Girdwood  * @regulator: regulator source
1703414c70cbSLiam Girdwood  * @mode: operating mode - one of the REGULATOR_MODE constants
1704414c70cbSLiam Girdwood  *
1705414c70cbSLiam Girdwood  * Set regulator operating mode to increase regulator efficiency or improve
1706414c70cbSLiam Girdwood  * regulation performance.
1707414c70cbSLiam Girdwood  *
1708414c70cbSLiam Girdwood  * NOTE: Regulator system constraints must be set for this regulator before
1709414c70cbSLiam Girdwood  * calling this function otherwise this call will fail.
1710414c70cbSLiam Girdwood  */
1711414c70cbSLiam Girdwood int regulator_set_mode(struct regulator *regulator, unsigned int mode)
1712414c70cbSLiam Girdwood {
1713414c70cbSLiam Girdwood 	struct regulator_dev *rdev = regulator->rdev;
1714414c70cbSLiam Girdwood 	int ret;
1715414c70cbSLiam Girdwood 
1716414c70cbSLiam Girdwood 	mutex_lock(&rdev->mutex);
1717414c70cbSLiam Girdwood 
1718414c70cbSLiam Girdwood 	/* sanity check */
1719414c70cbSLiam Girdwood 	if (!rdev->desc->ops->set_mode) {
1720414c70cbSLiam Girdwood 		ret = -EINVAL;
1721414c70cbSLiam Girdwood 		goto out;
1722414c70cbSLiam Girdwood 	}
1723414c70cbSLiam Girdwood 
1724414c70cbSLiam Girdwood 	/* constraints check */
1725414c70cbSLiam Girdwood 	ret = regulator_check_mode(rdev, mode);
1726414c70cbSLiam Girdwood 	if (ret < 0)
1727414c70cbSLiam Girdwood 		goto out;
1728414c70cbSLiam Girdwood 
1729414c70cbSLiam Girdwood 	ret = rdev->desc->ops->set_mode(rdev, mode);
1730414c70cbSLiam Girdwood out:
1731414c70cbSLiam Girdwood 	mutex_unlock(&rdev->mutex);
1732414c70cbSLiam Girdwood 	return ret;
1733414c70cbSLiam Girdwood }
1734414c70cbSLiam Girdwood EXPORT_SYMBOL_GPL(regulator_set_mode);
1735414c70cbSLiam Girdwood 
1736414c70cbSLiam Girdwood static unsigned int _regulator_get_mode(struct regulator_dev *rdev)
1737414c70cbSLiam Girdwood {
1738414c70cbSLiam Girdwood 	int ret;
1739414c70cbSLiam Girdwood 
1740414c70cbSLiam Girdwood 	mutex_lock(&rdev->mutex);
1741414c70cbSLiam Girdwood 
1742414c70cbSLiam Girdwood 	/* sanity check */
1743414c70cbSLiam Girdwood 	if (!rdev->desc->ops->get_mode) {
1744414c70cbSLiam Girdwood 		ret = -EINVAL;
1745414c70cbSLiam Girdwood 		goto out;
1746414c70cbSLiam Girdwood 	}
1747414c70cbSLiam Girdwood 
1748414c70cbSLiam Girdwood 	ret = rdev->desc->ops->get_mode(rdev);
1749414c70cbSLiam Girdwood out:
1750414c70cbSLiam Girdwood 	mutex_unlock(&rdev->mutex);
1751414c70cbSLiam Girdwood 	return ret;
1752414c70cbSLiam Girdwood }
1753414c70cbSLiam Girdwood 
1754414c70cbSLiam Girdwood /**
1755414c70cbSLiam Girdwood  * regulator_get_mode - get regulator operating mode
1756414c70cbSLiam Girdwood  * @regulator: regulator source
1757414c70cbSLiam Girdwood  *
1758414c70cbSLiam Girdwood  * Get the current regulator operating mode.
1759414c70cbSLiam Girdwood  */
1760414c70cbSLiam Girdwood unsigned int regulator_get_mode(struct regulator *regulator)
1761414c70cbSLiam Girdwood {
1762414c70cbSLiam Girdwood 	return _regulator_get_mode(regulator->rdev);
1763414c70cbSLiam Girdwood }
1764414c70cbSLiam Girdwood EXPORT_SYMBOL_GPL(regulator_get_mode);
1765414c70cbSLiam Girdwood 
1766414c70cbSLiam Girdwood /**
1767414c70cbSLiam Girdwood  * regulator_set_optimum_mode - set regulator optimum operating mode
1768414c70cbSLiam Girdwood  * @regulator: regulator source
1769414c70cbSLiam Girdwood  * @uA_load: load current
1770414c70cbSLiam Girdwood  *
1771414c70cbSLiam Girdwood  * Notifies the regulator core of a new device load. This is then used by
1772414c70cbSLiam Girdwood  * DRMS (if enabled by constraints) to set the most efficient regulator
1773414c70cbSLiam Girdwood  * operating mode for the new regulator loading.
1774414c70cbSLiam Girdwood  *
1775414c70cbSLiam Girdwood  * Consumer devices notify their supply regulator of the maximum power
1776414c70cbSLiam Girdwood  * they will require (can be taken from device datasheet in the power
1777414c70cbSLiam Girdwood  * consumption tables) when they change operational status and hence power
1778414c70cbSLiam Girdwood  * state. Examples of operational state changes that can affect power
1779414c70cbSLiam Girdwood  * consumption are :-
1780414c70cbSLiam Girdwood  *
1781414c70cbSLiam Girdwood  *    o Device is opened / closed.
1782414c70cbSLiam Girdwood  *    o Device I/O is about to begin or has just finished.
1783414c70cbSLiam Girdwood  *    o Device is idling in between work.
1784414c70cbSLiam Girdwood  *
1785414c70cbSLiam Girdwood  * This information is also exported via sysfs to userspace.
1786414c70cbSLiam Girdwood  *
1787414c70cbSLiam Girdwood  * DRMS will sum the total requested load on the regulator and change
1788414c70cbSLiam Girdwood  * to the most efficient operating mode if platform constraints allow.
1789414c70cbSLiam Girdwood  *
1790414c70cbSLiam Girdwood  * Returns the new regulator mode or error.
1791414c70cbSLiam Girdwood  */
1792414c70cbSLiam Girdwood int regulator_set_optimum_mode(struct regulator *regulator, int uA_load)
1793414c70cbSLiam Girdwood {
1794414c70cbSLiam Girdwood 	struct regulator_dev *rdev = regulator->rdev;
1795414c70cbSLiam Girdwood 	struct regulator *consumer;
1796414c70cbSLiam Girdwood 	int ret, output_uV, input_uV, total_uA_load = 0;
1797414c70cbSLiam Girdwood 	unsigned int mode;
1798414c70cbSLiam Girdwood 
1799414c70cbSLiam Girdwood 	mutex_lock(&rdev->mutex);
1800414c70cbSLiam Girdwood 
1801414c70cbSLiam Girdwood 	regulator->uA_load = uA_load;
1802414c70cbSLiam Girdwood 	ret = regulator_check_drms(rdev);
1803414c70cbSLiam Girdwood 	if (ret < 0)
1804414c70cbSLiam Girdwood 		goto out;
1805414c70cbSLiam Girdwood 	ret = -EINVAL;
1806414c70cbSLiam Girdwood 
1807414c70cbSLiam Girdwood 	/* sanity check */
1808414c70cbSLiam Girdwood 	if (!rdev->desc->ops->get_optimum_mode)
1809414c70cbSLiam Girdwood 		goto out;
1810414c70cbSLiam Girdwood 
1811414c70cbSLiam Girdwood 	/* get output voltage */
1812414c70cbSLiam Girdwood 	output_uV = rdev->desc->ops->get_voltage(rdev);
1813414c70cbSLiam Girdwood 	if (output_uV <= 0) {
1814414c70cbSLiam Girdwood 		printk(KERN_ERR "%s: invalid output voltage found for %s\n",
18151083c393SMark Brown 			__func__, rdev_get_name(rdev));
1816414c70cbSLiam Girdwood 		goto out;
1817414c70cbSLiam Girdwood 	}
1818414c70cbSLiam Girdwood 
1819414c70cbSLiam Girdwood 	/* get input voltage */
1820414c70cbSLiam Girdwood 	if (rdev->supply && rdev->supply->desc->ops->get_voltage)
1821414c70cbSLiam Girdwood 		input_uV = rdev->supply->desc->ops->get_voltage(rdev->supply);
1822414c70cbSLiam Girdwood 	else
1823414c70cbSLiam Girdwood 		input_uV = rdev->constraints->input_uV;
1824414c70cbSLiam Girdwood 	if (input_uV <= 0) {
1825414c70cbSLiam Girdwood 		printk(KERN_ERR "%s: invalid input voltage found for %s\n",
18261083c393SMark Brown 			__func__, rdev_get_name(rdev));
1827414c70cbSLiam Girdwood 		goto out;
1828414c70cbSLiam Girdwood 	}
1829414c70cbSLiam Girdwood 
1830414c70cbSLiam Girdwood 	/* calc total requested load for this regulator */
1831414c70cbSLiam Girdwood 	list_for_each_entry(consumer, &rdev->consumer_list, list)
1832414c70cbSLiam Girdwood 		total_uA_load += consumer->uA_load;
1833414c70cbSLiam Girdwood 
1834414c70cbSLiam Girdwood 	mode = rdev->desc->ops->get_optimum_mode(rdev,
1835414c70cbSLiam Girdwood 						 input_uV, output_uV,
1836414c70cbSLiam Girdwood 						 total_uA_load);
1837e573520bSDavid Brownell 	ret = regulator_check_mode(rdev, mode);
1838e573520bSDavid Brownell 	if (ret < 0) {
1839414c70cbSLiam Girdwood 		printk(KERN_ERR "%s: failed to get optimum mode for %s @"
18401083c393SMark Brown 			" %d uA %d -> %d uV\n", __func__, rdev_get_name(rdev),
1841414c70cbSLiam Girdwood 			total_uA_load, input_uV, output_uV);
1842414c70cbSLiam Girdwood 		goto out;
1843414c70cbSLiam Girdwood 	}
1844414c70cbSLiam Girdwood 
1845414c70cbSLiam Girdwood 	ret = rdev->desc->ops->set_mode(rdev, mode);
1846e573520bSDavid Brownell 	if (ret < 0) {
1847414c70cbSLiam Girdwood 		printk(KERN_ERR "%s: failed to set optimum mode %x for %s\n",
18481083c393SMark Brown 			__func__, mode, rdev_get_name(rdev));
1849414c70cbSLiam Girdwood 		goto out;
1850414c70cbSLiam Girdwood 	}
1851414c70cbSLiam Girdwood 	ret = mode;
1852414c70cbSLiam Girdwood out:
1853414c70cbSLiam Girdwood 	mutex_unlock(&rdev->mutex);
1854414c70cbSLiam Girdwood 	return ret;
1855414c70cbSLiam Girdwood }
1856414c70cbSLiam Girdwood EXPORT_SYMBOL_GPL(regulator_set_optimum_mode);
1857414c70cbSLiam Girdwood 
1858414c70cbSLiam Girdwood /**
1859414c70cbSLiam Girdwood  * regulator_register_notifier - register regulator event notifier
1860414c70cbSLiam Girdwood  * @regulator: regulator source
186169279fb9SMark Brown  * @nb: notifier block
1862414c70cbSLiam Girdwood  *
1863414c70cbSLiam Girdwood  * Register notifier block to receive regulator events.
1864414c70cbSLiam Girdwood  */
1865414c70cbSLiam Girdwood int regulator_register_notifier(struct regulator *regulator,
1866414c70cbSLiam Girdwood 			      struct notifier_block *nb)
1867414c70cbSLiam Girdwood {
1868414c70cbSLiam Girdwood 	return blocking_notifier_chain_register(&regulator->rdev->notifier,
1869414c70cbSLiam Girdwood 						nb);
1870414c70cbSLiam Girdwood }
1871414c70cbSLiam Girdwood EXPORT_SYMBOL_GPL(regulator_register_notifier);
1872414c70cbSLiam Girdwood 
1873414c70cbSLiam Girdwood /**
1874414c70cbSLiam Girdwood  * regulator_unregister_notifier - unregister regulator event notifier
1875414c70cbSLiam Girdwood  * @regulator: regulator source
187669279fb9SMark Brown  * @nb: notifier block
1877414c70cbSLiam Girdwood  *
1878414c70cbSLiam Girdwood  * Unregister regulator event notifier block.
1879414c70cbSLiam Girdwood  */
1880414c70cbSLiam Girdwood int regulator_unregister_notifier(struct regulator *regulator,
1881414c70cbSLiam Girdwood 				struct notifier_block *nb)
1882414c70cbSLiam Girdwood {
1883414c70cbSLiam Girdwood 	return blocking_notifier_chain_unregister(&regulator->rdev->notifier,
1884414c70cbSLiam Girdwood 						  nb);
1885414c70cbSLiam Girdwood }
1886414c70cbSLiam Girdwood EXPORT_SYMBOL_GPL(regulator_unregister_notifier);
1887414c70cbSLiam Girdwood 
1888b136fb44SJonathan Cameron /* notify regulator consumers and downstream regulator consumers.
1889b136fb44SJonathan Cameron  * Note mutex must be held by caller.
1890b136fb44SJonathan Cameron  */
1891414c70cbSLiam Girdwood static void _notifier_call_chain(struct regulator_dev *rdev,
1892414c70cbSLiam Girdwood 				  unsigned long event, void *data)
1893414c70cbSLiam Girdwood {
1894414c70cbSLiam Girdwood 	struct regulator_dev *_rdev;
1895414c70cbSLiam Girdwood 
1896414c70cbSLiam Girdwood 	/* call rdev chain first */
1897414c70cbSLiam Girdwood 	blocking_notifier_call_chain(&rdev->notifier, event, NULL);
1898414c70cbSLiam Girdwood 
1899414c70cbSLiam Girdwood 	/* now notify regulator we supply */
1900b136fb44SJonathan Cameron 	list_for_each_entry(_rdev, &rdev->supply_list, slist) {
1901b136fb44SJonathan Cameron 		mutex_lock(&_rdev->mutex);
1902414c70cbSLiam Girdwood 		_notifier_call_chain(_rdev, event, data);
1903b136fb44SJonathan Cameron 		mutex_unlock(&_rdev->mutex);
1904b136fb44SJonathan Cameron 	}
1905414c70cbSLiam Girdwood }
1906414c70cbSLiam Girdwood 
1907414c70cbSLiam Girdwood /**
1908414c70cbSLiam Girdwood  * regulator_bulk_get - get multiple regulator consumers
1909414c70cbSLiam Girdwood  *
1910414c70cbSLiam Girdwood  * @dev:           Device to supply
1911414c70cbSLiam Girdwood  * @num_consumers: Number of consumers to register
1912414c70cbSLiam Girdwood  * @consumers:     Configuration of consumers; clients are stored here.
1913414c70cbSLiam Girdwood  *
1914414c70cbSLiam Girdwood  * @return 0 on success, an errno on failure.
1915414c70cbSLiam Girdwood  *
1916414c70cbSLiam Girdwood  * This helper function allows drivers to get several regulator
1917414c70cbSLiam Girdwood  * consumers in one operation.  If any of the regulators cannot be
1918414c70cbSLiam Girdwood  * acquired then any regulators that were allocated will be freed
1919414c70cbSLiam Girdwood  * before returning to the caller.
1920414c70cbSLiam Girdwood  */
1921414c70cbSLiam Girdwood int regulator_bulk_get(struct device *dev, int num_consumers,
1922414c70cbSLiam Girdwood 		       struct regulator_bulk_data *consumers)
1923414c70cbSLiam Girdwood {
1924414c70cbSLiam Girdwood 	int i;
1925414c70cbSLiam Girdwood 	int ret;
1926414c70cbSLiam Girdwood 
1927414c70cbSLiam Girdwood 	for (i = 0; i < num_consumers; i++)
1928414c70cbSLiam Girdwood 		consumers[i].consumer = NULL;
1929414c70cbSLiam Girdwood 
1930414c70cbSLiam Girdwood 	for (i = 0; i < num_consumers; i++) {
1931414c70cbSLiam Girdwood 		consumers[i].consumer = regulator_get(dev,
1932414c70cbSLiam Girdwood 						      consumers[i].supply);
1933414c70cbSLiam Girdwood 		if (IS_ERR(consumers[i].consumer)) {
1934414c70cbSLiam Girdwood 			ret = PTR_ERR(consumers[i].consumer);
19355b307627SMark Brown 			dev_err(dev, "Failed to get supply '%s': %d\n",
19365b307627SMark Brown 				consumers[i].supply, ret);
1937414c70cbSLiam Girdwood 			consumers[i].consumer = NULL;
1938414c70cbSLiam Girdwood 			goto err;
1939414c70cbSLiam Girdwood 		}
1940414c70cbSLiam Girdwood 	}
1941414c70cbSLiam Girdwood 
1942414c70cbSLiam Girdwood 	return 0;
1943414c70cbSLiam Girdwood 
1944414c70cbSLiam Girdwood err:
1945414c70cbSLiam Girdwood 	for (i = 0; i < num_consumers && consumers[i].consumer; i++)
1946414c70cbSLiam Girdwood 		regulator_put(consumers[i].consumer);
1947414c70cbSLiam Girdwood 
1948414c70cbSLiam Girdwood 	return ret;
1949414c70cbSLiam Girdwood }
1950414c70cbSLiam Girdwood EXPORT_SYMBOL_GPL(regulator_bulk_get);
1951414c70cbSLiam Girdwood 
1952414c70cbSLiam Girdwood /**
1953414c70cbSLiam Girdwood  * regulator_bulk_enable - enable multiple regulator consumers
1954414c70cbSLiam Girdwood  *
1955414c70cbSLiam Girdwood  * @num_consumers: Number of consumers
1956414c70cbSLiam Girdwood  * @consumers:     Consumer data; clients are stored here.
1957414c70cbSLiam Girdwood  * @return         0 on success, an errno on failure
1958414c70cbSLiam Girdwood  *
1959414c70cbSLiam Girdwood  * This convenience API allows consumers to enable multiple regulator
1960414c70cbSLiam Girdwood  * clients in a single API call.  If any consumers cannot be enabled
1961414c70cbSLiam Girdwood  * then any others that were enabled will be disabled again prior to
1962414c70cbSLiam Girdwood  * return.
1963414c70cbSLiam Girdwood  */
1964414c70cbSLiam Girdwood int regulator_bulk_enable(int num_consumers,
1965414c70cbSLiam Girdwood 			  struct regulator_bulk_data *consumers)
1966414c70cbSLiam Girdwood {
1967414c70cbSLiam Girdwood 	int i;
1968414c70cbSLiam Girdwood 	int ret;
1969414c70cbSLiam Girdwood 
1970414c70cbSLiam Girdwood 	for (i = 0; i < num_consumers; i++) {
1971414c70cbSLiam Girdwood 		ret = regulator_enable(consumers[i].consumer);
1972414c70cbSLiam Girdwood 		if (ret != 0)
1973414c70cbSLiam Girdwood 			goto err;
1974414c70cbSLiam Girdwood 	}
1975414c70cbSLiam Girdwood 
1976414c70cbSLiam Girdwood 	return 0;
1977414c70cbSLiam Girdwood 
1978414c70cbSLiam Girdwood err:
19795b307627SMark Brown 	printk(KERN_ERR "Failed to enable %s: %d\n", consumers[i].supply, ret);
1980eb143ac1SLars-Peter Clausen 	for (--i; i >= 0; --i)
1981414c70cbSLiam Girdwood 		regulator_disable(consumers[i].consumer);
1982414c70cbSLiam Girdwood 
1983414c70cbSLiam Girdwood 	return ret;
1984414c70cbSLiam Girdwood }
1985414c70cbSLiam Girdwood EXPORT_SYMBOL_GPL(regulator_bulk_enable);
1986414c70cbSLiam Girdwood 
1987414c70cbSLiam Girdwood /**
1988414c70cbSLiam Girdwood  * regulator_bulk_disable - disable multiple regulator consumers
1989414c70cbSLiam Girdwood  *
1990414c70cbSLiam Girdwood  * @num_consumers: Number of consumers
1991414c70cbSLiam Girdwood  * @consumers:     Consumer data; clients are stored here.
1992414c70cbSLiam Girdwood  * @return         0 on success, an errno on failure
1993414c70cbSLiam Girdwood  *
1994414c70cbSLiam Girdwood  * This convenience API allows consumers to disable multiple regulator
1995414c70cbSLiam Girdwood  * clients in a single API call.  If any consumers cannot be enabled
1996414c70cbSLiam Girdwood  * then any others that were disabled will be disabled again prior to
1997414c70cbSLiam Girdwood  * return.
1998414c70cbSLiam Girdwood  */
1999414c70cbSLiam Girdwood int regulator_bulk_disable(int num_consumers,
2000414c70cbSLiam Girdwood 			   struct regulator_bulk_data *consumers)
2001414c70cbSLiam Girdwood {
2002414c70cbSLiam Girdwood 	int i;
2003414c70cbSLiam Girdwood 	int ret;
2004414c70cbSLiam Girdwood 
2005414c70cbSLiam Girdwood 	for (i = 0; i < num_consumers; i++) {
2006414c70cbSLiam Girdwood 		ret = regulator_disable(consumers[i].consumer);
2007414c70cbSLiam Girdwood 		if (ret != 0)
2008414c70cbSLiam Girdwood 			goto err;
2009414c70cbSLiam Girdwood 	}
2010414c70cbSLiam Girdwood 
2011414c70cbSLiam Girdwood 	return 0;
2012414c70cbSLiam Girdwood 
2013414c70cbSLiam Girdwood err:
20145b307627SMark Brown 	printk(KERN_ERR "Failed to disable %s: %d\n", consumers[i].supply,
20155b307627SMark Brown 	       ret);
2016eb143ac1SLars-Peter Clausen 	for (--i; i >= 0; --i)
2017414c70cbSLiam Girdwood 		regulator_enable(consumers[i].consumer);
2018414c70cbSLiam Girdwood 
2019414c70cbSLiam Girdwood 	return ret;
2020414c70cbSLiam Girdwood }
2021414c70cbSLiam Girdwood EXPORT_SYMBOL_GPL(regulator_bulk_disable);
2022414c70cbSLiam Girdwood 
2023414c70cbSLiam Girdwood /**
2024414c70cbSLiam Girdwood  * regulator_bulk_free - free multiple regulator consumers
2025414c70cbSLiam Girdwood  *
2026414c70cbSLiam Girdwood  * @num_consumers: Number of consumers
2027414c70cbSLiam Girdwood  * @consumers:     Consumer data; clients are stored here.
2028414c70cbSLiam Girdwood  *
2029414c70cbSLiam Girdwood  * This convenience API allows consumers to free multiple regulator
2030414c70cbSLiam Girdwood  * clients in a single API call.
2031414c70cbSLiam Girdwood  */
2032414c70cbSLiam Girdwood void regulator_bulk_free(int num_consumers,
2033414c70cbSLiam Girdwood 			 struct regulator_bulk_data *consumers)
2034414c70cbSLiam Girdwood {
2035414c70cbSLiam Girdwood 	int i;
2036414c70cbSLiam Girdwood 
2037414c70cbSLiam Girdwood 	for (i = 0; i < num_consumers; i++) {
2038414c70cbSLiam Girdwood 		regulator_put(consumers[i].consumer);
2039414c70cbSLiam Girdwood 		consumers[i].consumer = NULL;
2040414c70cbSLiam Girdwood 	}
2041414c70cbSLiam Girdwood }
2042414c70cbSLiam Girdwood EXPORT_SYMBOL_GPL(regulator_bulk_free);
2043414c70cbSLiam Girdwood 
2044414c70cbSLiam Girdwood /**
2045414c70cbSLiam Girdwood  * regulator_notifier_call_chain - call regulator event notifier
204669279fb9SMark Brown  * @rdev: regulator source
2047414c70cbSLiam Girdwood  * @event: notifier block
204869279fb9SMark Brown  * @data: callback-specific data.
2049414c70cbSLiam Girdwood  *
2050414c70cbSLiam Girdwood  * Called by regulator drivers to notify clients a regulator event has
2051414c70cbSLiam Girdwood  * occurred. We also notify regulator clients downstream.
2052b136fb44SJonathan Cameron  * Note lock must be held by caller.
2053414c70cbSLiam Girdwood  */
2054414c70cbSLiam Girdwood int regulator_notifier_call_chain(struct regulator_dev *rdev,
2055414c70cbSLiam Girdwood 				  unsigned long event, void *data)
2056414c70cbSLiam Girdwood {
2057414c70cbSLiam Girdwood 	_notifier_call_chain(rdev, event, data);
2058414c70cbSLiam Girdwood 	return NOTIFY_DONE;
2059414c70cbSLiam Girdwood 
2060414c70cbSLiam Girdwood }
2061414c70cbSLiam Girdwood EXPORT_SYMBOL_GPL(regulator_notifier_call_chain);
2062414c70cbSLiam Girdwood 
2063be721979SMark Brown /**
2064be721979SMark Brown  * regulator_mode_to_status - convert a regulator mode into a status
2065be721979SMark Brown  *
2066be721979SMark Brown  * @mode: Mode to convert
2067be721979SMark Brown  *
2068be721979SMark Brown  * Convert a regulator mode into a status.
2069be721979SMark Brown  */
2070be721979SMark Brown int regulator_mode_to_status(unsigned int mode)
2071be721979SMark Brown {
2072be721979SMark Brown 	switch (mode) {
2073be721979SMark Brown 	case REGULATOR_MODE_FAST:
2074be721979SMark Brown 		return REGULATOR_STATUS_FAST;
2075be721979SMark Brown 	case REGULATOR_MODE_NORMAL:
2076be721979SMark Brown 		return REGULATOR_STATUS_NORMAL;
2077be721979SMark Brown 	case REGULATOR_MODE_IDLE:
2078be721979SMark Brown 		return REGULATOR_STATUS_IDLE;
2079be721979SMark Brown 	case REGULATOR_STATUS_STANDBY:
2080be721979SMark Brown 		return REGULATOR_STATUS_STANDBY;
2081be721979SMark Brown 	default:
2082be721979SMark Brown 		return 0;
2083be721979SMark Brown 	}
2084be721979SMark Brown }
2085be721979SMark Brown EXPORT_SYMBOL_GPL(regulator_mode_to_status);
2086be721979SMark Brown 
20877ad68e2fSDavid Brownell /*
20887ad68e2fSDavid Brownell  * To avoid cluttering sysfs (and memory) with useless state, only
20897ad68e2fSDavid Brownell  * create attributes that can be meaningfully displayed.
20907ad68e2fSDavid Brownell  */
20917ad68e2fSDavid Brownell static int add_regulator_attributes(struct regulator_dev *rdev)
20927ad68e2fSDavid Brownell {
20937ad68e2fSDavid Brownell 	struct device		*dev = &rdev->dev;
20947ad68e2fSDavid Brownell 	struct regulator_ops	*ops = rdev->desc->ops;
20957ad68e2fSDavid Brownell 	int			status = 0;
20967ad68e2fSDavid Brownell 
20977ad68e2fSDavid Brownell 	/* some attributes need specific methods to be displayed */
20987ad68e2fSDavid Brownell 	if (ops->get_voltage) {
20997ad68e2fSDavid Brownell 		status = device_create_file(dev, &dev_attr_microvolts);
21007ad68e2fSDavid Brownell 		if (status < 0)
21017ad68e2fSDavid Brownell 			return status;
21027ad68e2fSDavid Brownell 	}
21037ad68e2fSDavid Brownell 	if (ops->get_current_limit) {
21047ad68e2fSDavid Brownell 		status = device_create_file(dev, &dev_attr_microamps);
21057ad68e2fSDavid Brownell 		if (status < 0)
21067ad68e2fSDavid Brownell 			return status;
21077ad68e2fSDavid Brownell 	}
21087ad68e2fSDavid Brownell 	if (ops->get_mode) {
21097ad68e2fSDavid Brownell 		status = device_create_file(dev, &dev_attr_opmode);
21107ad68e2fSDavid Brownell 		if (status < 0)
21117ad68e2fSDavid Brownell 			return status;
21127ad68e2fSDavid Brownell 	}
21137ad68e2fSDavid Brownell 	if (ops->is_enabled) {
21147ad68e2fSDavid Brownell 		status = device_create_file(dev, &dev_attr_state);
21157ad68e2fSDavid Brownell 		if (status < 0)
21167ad68e2fSDavid Brownell 			return status;
21177ad68e2fSDavid Brownell 	}
2118853116a1SDavid Brownell 	if (ops->get_status) {
2119853116a1SDavid Brownell 		status = device_create_file(dev, &dev_attr_status);
2120853116a1SDavid Brownell 		if (status < 0)
2121853116a1SDavid Brownell 			return status;
2122853116a1SDavid Brownell 	}
21237ad68e2fSDavid Brownell 
21247ad68e2fSDavid Brownell 	/* some attributes are type-specific */
21257ad68e2fSDavid Brownell 	if (rdev->desc->type == REGULATOR_CURRENT) {
21267ad68e2fSDavid Brownell 		status = device_create_file(dev, &dev_attr_requested_microamps);
21277ad68e2fSDavid Brownell 		if (status < 0)
21287ad68e2fSDavid Brownell 			return status;
21297ad68e2fSDavid Brownell 	}
21307ad68e2fSDavid Brownell 
21317ad68e2fSDavid Brownell 	/* all the other attributes exist to support constraints;
21327ad68e2fSDavid Brownell 	 * don't show them if there are no constraints, or if the
21337ad68e2fSDavid Brownell 	 * relevant supporting methods are missing.
21347ad68e2fSDavid Brownell 	 */
21357ad68e2fSDavid Brownell 	if (!rdev->constraints)
21367ad68e2fSDavid Brownell 		return status;
21377ad68e2fSDavid Brownell 
21387ad68e2fSDavid Brownell 	/* constraints need specific supporting methods */
21397ad68e2fSDavid Brownell 	if (ops->set_voltage) {
21407ad68e2fSDavid Brownell 		status = device_create_file(dev, &dev_attr_min_microvolts);
21417ad68e2fSDavid Brownell 		if (status < 0)
21427ad68e2fSDavid Brownell 			return status;
21437ad68e2fSDavid Brownell 		status = device_create_file(dev, &dev_attr_max_microvolts);
21447ad68e2fSDavid Brownell 		if (status < 0)
21457ad68e2fSDavid Brownell 			return status;
21467ad68e2fSDavid Brownell 	}
21477ad68e2fSDavid Brownell 	if (ops->set_current_limit) {
21487ad68e2fSDavid Brownell 		status = device_create_file(dev, &dev_attr_min_microamps);
21497ad68e2fSDavid Brownell 		if (status < 0)
21507ad68e2fSDavid Brownell 			return status;
21517ad68e2fSDavid Brownell 		status = device_create_file(dev, &dev_attr_max_microamps);
21527ad68e2fSDavid Brownell 		if (status < 0)
21537ad68e2fSDavid Brownell 			return status;
21547ad68e2fSDavid Brownell 	}
21557ad68e2fSDavid Brownell 
21567ad68e2fSDavid Brownell 	/* suspend mode constraints need multiple supporting methods */
21577ad68e2fSDavid Brownell 	if (!(ops->set_suspend_enable && ops->set_suspend_disable))
21587ad68e2fSDavid Brownell 		return status;
21597ad68e2fSDavid Brownell 
21607ad68e2fSDavid Brownell 	status = device_create_file(dev, &dev_attr_suspend_standby_state);
21617ad68e2fSDavid Brownell 	if (status < 0)
21627ad68e2fSDavid Brownell 		return status;
21637ad68e2fSDavid Brownell 	status = device_create_file(dev, &dev_attr_suspend_mem_state);
21647ad68e2fSDavid Brownell 	if (status < 0)
21657ad68e2fSDavid Brownell 		return status;
21667ad68e2fSDavid Brownell 	status = device_create_file(dev, &dev_attr_suspend_disk_state);
21677ad68e2fSDavid Brownell 	if (status < 0)
21687ad68e2fSDavid Brownell 		return status;
21697ad68e2fSDavid Brownell 
21707ad68e2fSDavid Brownell 	if (ops->set_suspend_voltage) {
21717ad68e2fSDavid Brownell 		status = device_create_file(dev,
21727ad68e2fSDavid Brownell 				&dev_attr_suspend_standby_microvolts);
21737ad68e2fSDavid Brownell 		if (status < 0)
21747ad68e2fSDavid Brownell 			return status;
21757ad68e2fSDavid Brownell 		status = device_create_file(dev,
21767ad68e2fSDavid Brownell 				&dev_attr_suspend_mem_microvolts);
21777ad68e2fSDavid Brownell 		if (status < 0)
21787ad68e2fSDavid Brownell 			return status;
21797ad68e2fSDavid Brownell 		status = device_create_file(dev,
21807ad68e2fSDavid Brownell 				&dev_attr_suspend_disk_microvolts);
21817ad68e2fSDavid Brownell 		if (status < 0)
21827ad68e2fSDavid Brownell 			return status;
21837ad68e2fSDavid Brownell 	}
21847ad68e2fSDavid Brownell 
21857ad68e2fSDavid Brownell 	if (ops->set_suspend_mode) {
21867ad68e2fSDavid Brownell 		status = device_create_file(dev,
21877ad68e2fSDavid Brownell 				&dev_attr_suspend_standby_mode);
21887ad68e2fSDavid Brownell 		if (status < 0)
21897ad68e2fSDavid Brownell 			return status;
21907ad68e2fSDavid Brownell 		status = device_create_file(dev,
21917ad68e2fSDavid Brownell 				&dev_attr_suspend_mem_mode);
21927ad68e2fSDavid Brownell 		if (status < 0)
21937ad68e2fSDavid Brownell 			return status;
21947ad68e2fSDavid Brownell 		status = device_create_file(dev,
21957ad68e2fSDavid Brownell 				&dev_attr_suspend_disk_mode);
21967ad68e2fSDavid Brownell 		if (status < 0)
21977ad68e2fSDavid Brownell 			return status;
21987ad68e2fSDavid Brownell 	}
21997ad68e2fSDavid Brownell 
22007ad68e2fSDavid Brownell 	return status;
22017ad68e2fSDavid Brownell }
22027ad68e2fSDavid Brownell 
2203414c70cbSLiam Girdwood /**
2204414c70cbSLiam Girdwood  * regulator_register - register regulator
220569279fb9SMark Brown  * @regulator_desc: regulator to register
220669279fb9SMark Brown  * @dev: struct device for the regulator
22070527100fSMark Brown  * @init_data: platform provided init data, passed through by driver
220869279fb9SMark Brown  * @driver_data: private regulator data
2209414c70cbSLiam Girdwood  *
2210414c70cbSLiam Girdwood  * Called by regulator drivers to register a regulator.
2211414c70cbSLiam Girdwood  * Returns 0 on success.
2212414c70cbSLiam Girdwood  */
2213414c70cbSLiam Girdwood struct regulator_dev *regulator_register(struct regulator_desc *regulator_desc,
22140527100fSMark Brown 	struct device *dev, struct regulator_init_data *init_data,
22150527100fSMark Brown 	void *driver_data)
2216414c70cbSLiam Girdwood {
2217414c70cbSLiam Girdwood 	static atomic_t regulator_no = ATOMIC_INIT(0);
2218414c70cbSLiam Girdwood 	struct regulator_dev *rdev;
2219a5766f11SLiam Girdwood 	int ret, i;
2220414c70cbSLiam Girdwood 
2221414c70cbSLiam Girdwood 	if (regulator_desc == NULL)
2222414c70cbSLiam Girdwood 		return ERR_PTR(-EINVAL);
2223414c70cbSLiam Girdwood 
2224414c70cbSLiam Girdwood 	if (regulator_desc->name == NULL || regulator_desc->ops == NULL)
2225414c70cbSLiam Girdwood 		return ERR_PTR(-EINVAL);
2226414c70cbSLiam Girdwood 
2227cd78dfc6SDiego Liziero 	if (regulator_desc->type != REGULATOR_VOLTAGE &&
2228cd78dfc6SDiego Liziero 	    regulator_desc->type != REGULATOR_CURRENT)
2229414c70cbSLiam Girdwood 		return ERR_PTR(-EINVAL);
2230414c70cbSLiam Girdwood 
223146fabe1eSMark Brown 	if (!init_data)
223246fabe1eSMark Brown 		return ERR_PTR(-EINVAL);
223346fabe1eSMark Brown 
2234414c70cbSLiam Girdwood 	rdev = kzalloc(sizeof(struct regulator_dev), GFP_KERNEL);
2235414c70cbSLiam Girdwood 	if (rdev == NULL)
2236414c70cbSLiam Girdwood 		return ERR_PTR(-ENOMEM);
2237414c70cbSLiam Girdwood 
2238414c70cbSLiam Girdwood 	mutex_lock(&regulator_list_mutex);
2239414c70cbSLiam Girdwood 
2240414c70cbSLiam Girdwood 	mutex_init(&rdev->mutex);
2241a5766f11SLiam Girdwood 	rdev->reg_data = driver_data;
2242414c70cbSLiam Girdwood 	rdev->owner = regulator_desc->owner;
2243414c70cbSLiam Girdwood 	rdev->desc = regulator_desc;
2244414c70cbSLiam Girdwood 	INIT_LIST_HEAD(&rdev->consumer_list);
2245414c70cbSLiam Girdwood 	INIT_LIST_HEAD(&rdev->supply_list);
2246414c70cbSLiam Girdwood 	INIT_LIST_HEAD(&rdev->list);
2247414c70cbSLiam Girdwood 	INIT_LIST_HEAD(&rdev->slist);
2248414c70cbSLiam Girdwood 	BLOCKING_INIT_NOTIFIER_HEAD(&rdev->notifier);
2249414c70cbSLiam Girdwood 
2250a5766f11SLiam Girdwood 	/* preform any regulator specific init */
2251a5766f11SLiam Girdwood 	if (init_data->regulator_init) {
2252a5766f11SLiam Girdwood 		ret = init_data->regulator_init(rdev->reg_data);
22534fca9545SDavid Brownell 		if (ret < 0)
22544fca9545SDavid Brownell 			goto clean;
2255a5766f11SLiam Girdwood 	}
2256a5766f11SLiam Girdwood 
2257a5766f11SLiam Girdwood 	/* register with sysfs */
2258a5766f11SLiam Girdwood 	rdev->dev.class = &regulator_class;
2259a5766f11SLiam Girdwood 	rdev->dev.parent = dev;
2260812460a9SKay Sievers 	dev_set_name(&rdev->dev, "regulator.%d",
2261812460a9SKay Sievers 		     atomic_inc_return(&regulator_no) - 1);
2262a5766f11SLiam Girdwood 	ret = device_register(&rdev->dev);
22634fca9545SDavid Brownell 	if (ret != 0)
22644fca9545SDavid Brownell 		goto clean;
2265a5766f11SLiam Girdwood 
2266a5766f11SLiam Girdwood 	dev_set_drvdata(&rdev->dev, rdev);
2267a5766f11SLiam Girdwood 
226874f544c1SMike Rapoport 	/* set regulator constraints */
226974f544c1SMike Rapoport 	ret = set_machine_constraints(rdev, &init_data->constraints);
227074f544c1SMike Rapoport 	if (ret < 0)
227174f544c1SMike Rapoport 		goto scrub;
227274f544c1SMike Rapoport 
22737ad68e2fSDavid Brownell 	/* add attributes supported by this regulator */
22747ad68e2fSDavid Brownell 	ret = add_regulator_attributes(rdev);
22757ad68e2fSDavid Brownell 	if (ret < 0)
22767ad68e2fSDavid Brownell 		goto scrub;
22777ad68e2fSDavid Brownell 
2278a5766f11SLiam Girdwood 	/* set supply regulator if it exists */
2279a5766f11SLiam Girdwood 	if (init_data->supply_regulator_dev) {
2280a5766f11SLiam Girdwood 		ret = set_supply(rdev,
2281a5766f11SLiam Girdwood 			dev_get_drvdata(init_data->supply_regulator_dev));
22824fca9545SDavid Brownell 		if (ret < 0)
22834fca9545SDavid Brownell 			goto scrub;
2284a5766f11SLiam Girdwood 	}
2285a5766f11SLiam Girdwood 
2286a5766f11SLiam Girdwood 	/* add consumers devices */
2287a5766f11SLiam Girdwood 	for (i = 0; i < init_data->num_consumer_supplies; i++) {
2288a5766f11SLiam Girdwood 		ret = set_consumer_device_supply(rdev,
2289a5766f11SLiam Girdwood 			init_data->consumer_supplies[i].dev,
229040f9244fSMark Brown 			init_data->consumer_supplies[i].dev_name,
2291a5766f11SLiam Girdwood 			init_data->consumer_supplies[i].supply);
2292a5766f11SLiam Girdwood 		if (ret < 0) {
2293a5766f11SLiam Girdwood 			for (--i; i >= 0; i--)
2294a5766f11SLiam Girdwood 				unset_consumer_device_supply(rdev,
229540f9244fSMark Brown 				    init_data->consumer_supplies[i].dev_name,
2296a5766f11SLiam Girdwood 				    init_data->consumer_supplies[i].dev);
22974fca9545SDavid Brownell 			goto scrub;
2298a5766f11SLiam Girdwood 		}
2299a5766f11SLiam Girdwood 	}
2300a5766f11SLiam Girdwood 
2301a5766f11SLiam Girdwood 	list_add(&rdev->list, &regulator_list);
2302a5766f11SLiam Girdwood out:
2303414c70cbSLiam Girdwood 	mutex_unlock(&regulator_list_mutex);
2304414c70cbSLiam Girdwood 	return rdev;
23054fca9545SDavid Brownell 
23064fca9545SDavid Brownell scrub:
23074fca9545SDavid Brownell 	device_unregister(&rdev->dev);
230853032dafSPaul Walmsley 	/* device core frees rdev */
230953032dafSPaul Walmsley 	rdev = ERR_PTR(ret);
231053032dafSPaul Walmsley 	goto out;
231153032dafSPaul Walmsley 
23124fca9545SDavid Brownell clean:
23134fca9545SDavid Brownell 	kfree(rdev);
23144fca9545SDavid Brownell 	rdev = ERR_PTR(ret);
23154fca9545SDavid Brownell 	goto out;
2316414c70cbSLiam Girdwood }
2317414c70cbSLiam Girdwood EXPORT_SYMBOL_GPL(regulator_register);
2318414c70cbSLiam Girdwood 
2319414c70cbSLiam Girdwood /**
2320414c70cbSLiam Girdwood  * regulator_unregister - unregister regulator
232169279fb9SMark Brown  * @rdev: regulator to unregister
2322414c70cbSLiam Girdwood  *
2323414c70cbSLiam Girdwood  * Called by regulator drivers to unregister a regulator.
2324414c70cbSLiam Girdwood  */
2325414c70cbSLiam Girdwood void regulator_unregister(struct regulator_dev *rdev)
2326414c70cbSLiam Girdwood {
2327414c70cbSLiam Girdwood 	if (rdev == NULL)
2328414c70cbSLiam Girdwood 		return;
2329414c70cbSLiam Girdwood 
2330414c70cbSLiam Girdwood 	mutex_lock(&regulator_list_mutex);
23316bf87d17SMark Brown 	WARN_ON(rdev->open_count);
23320f1d747bSMike Rapoport 	unset_regulator_supplies(rdev);
2333414c70cbSLiam Girdwood 	list_del(&rdev->list);
2334414c70cbSLiam Girdwood 	if (rdev->supply)
2335414c70cbSLiam Girdwood 		sysfs_remove_link(&rdev->dev.kobj, "supply");
2336414c70cbSLiam Girdwood 	device_unregister(&rdev->dev);
2337414c70cbSLiam Girdwood 	mutex_unlock(&regulator_list_mutex);
2338414c70cbSLiam Girdwood }
2339414c70cbSLiam Girdwood EXPORT_SYMBOL_GPL(regulator_unregister);
2340414c70cbSLiam Girdwood 
2341414c70cbSLiam Girdwood /**
2342cf7bbcdfSMark Brown  * regulator_suspend_prepare - prepare regulators for system wide suspend
2343414c70cbSLiam Girdwood  * @state: system suspend state
2344414c70cbSLiam Girdwood  *
2345414c70cbSLiam Girdwood  * Configure each regulator with it's suspend operating parameters for state.
2346414c70cbSLiam Girdwood  * This will usually be called by machine suspend code prior to supending.
2347414c70cbSLiam Girdwood  */
2348414c70cbSLiam Girdwood int regulator_suspend_prepare(suspend_state_t state)
2349414c70cbSLiam Girdwood {
2350414c70cbSLiam Girdwood 	struct regulator_dev *rdev;
2351414c70cbSLiam Girdwood 	int ret = 0;
2352414c70cbSLiam Girdwood 
2353414c70cbSLiam Girdwood 	/* ON is handled by regulator active state */
2354414c70cbSLiam Girdwood 	if (state == PM_SUSPEND_ON)
2355414c70cbSLiam Girdwood 		return -EINVAL;
2356414c70cbSLiam Girdwood 
2357414c70cbSLiam Girdwood 	mutex_lock(&regulator_list_mutex);
2358414c70cbSLiam Girdwood 	list_for_each_entry(rdev, &regulator_list, list) {
2359414c70cbSLiam Girdwood 
2360414c70cbSLiam Girdwood 		mutex_lock(&rdev->mutex);
2361414c70cbSLiam Girdwood 		ret = suspend_prepare(rdev, state);
2362414c70cbSLiam Girdwood 		mutex_unlock(&rdev->mutex);
2363414c70cbSLiam Girdwood 
2364414c70cbSLiam Girdwood 		if (ret < 0) {
2365414c70cbSLiam Girdwood 			printk(KERN_ERR "%s: failed to prepare %s\n",
23661083c393SMark Brown 				__func__, rdev_get_name(rdev));
2367414c70cbSLiam Girdwood 			goto out;
2368414c70cbSLiam Girdwood 		}
2369414c70cbSLiam Girdwood 	}
2370414c70cbSLiam Girdwood out:
2371414c70cbSLiam Girdwood 	mutex_unlock(&regulator_list_mutex);
2372414c70cbSLiam Girdwood 	return ret;
2373414c70cbSLiam Girdwood }
2374414c70cbSLiam Girdwood EXPORT_SYMBOL_GPL(regulator_suspend_prepare);
2375414c70cbSLiam Girdwood 
2376414c70cbSLiam Girdwood /**
2377ca725561SMark Brown  * regulator_has_full_constraints - the system has fully specified constraints
2378ca725561SMark Brown  *
2379ca725561SMark Brown  * Calling this function will cause the regulator API to disable all
2380ca725561SMark Brown  * regulators which have a zero use count and don't have an always_on
2381ca725561SMark Brown  * constraint in a late_initcall.
2382ca725561SMark Brown  *
2383ca725561SMark Brown  * The intention is that this will become the default behaviour in a
2384ca725561SMark Brown  * future kernel release so users are encouraged to use this facility
2385ca725561SMark Brown  * now.
2386ca725561SMark Brown  */
2387ca725561SMark Brown void regulator_has_full_constraints(void)
2388ca725561SMark Brown {
2389ca725561SMark Brown 	has_full_constraints = 1;
2390ca725561SMark Brown }
2391ca725561SMark Brown EXPORT_SYMBOL_GPL(regulator_has_full_constraints);
2392ca725561SMark Brown 
2393ca725561SMark Brown /**
2394414c70cbSLiam Girdwood  * rdev_get_drvdata - get rdev regulator driver data
239569279fb9SMark Brown  * @rdev: regulator
2396414c70cbSLiam Girdwood  *
2397414c70cbSLiam Girdwood  * Get rdev regulator driver private data. This call can be used in the
2398414c70cbSLiam Girdwood  * regulator driver context.
2399414c70cbSLiam Girdwood  */
2400414c70cbSLiam Girdwood void *rdev_get_drvdata(struct regulator_dev *rdev)
2401414c70cbSLiam Girdwood {
2402414c70cbSLiam Girdwood 	return rdev->reg_data;
2403414c70cbSLiam Girdwood }
2404414c70cbSLiam Girdwood EXPORT_SYMBOL_GPL(rdev_get_drvdata);
2405414c70cbSLiam Girdwood 
2406414c70cbSLiam Girdwood /**
2407414c70cbSLiam Girdwood  * regulator_get_drvdata - get regulator driver data
2408414c70cbSLiam Girdwood  * @regulator: regulator
2409414c70cbSLiam Girdwood  *
2410414c70cbSLiam Girdwood  * Get regulator driver private data. This call can be used in the consumer
2411414c70cbSLiam Girdwood  * driver context when non API regulator specific functions need to be called.
2412414c70cbSLiam Girdwood  */
2413414c70cbSLiam Girdwood void *regulator_get_drvdata(struct regulator *regulator)
2414414c70cbSLiam Girdwood {
2415414c70cbSLiam Girdwood 	return regulator->rdev->reg_data;
2416414c70cbSLiam Girdwood }
2417414c70cbSLiam Girdwood EXPORT_SYMBOL_GPL(regulator_get_drvdata);
2418414c70cbSLiam Girdwood 
2419414c70cbSLiam Girdwood /**
2420414c70cbSLiam Girdwood  * regulator_set_drvdata - set regulator driver data
2421414c70cbSLiam Girdwood  * @regulator: regulator
2422414c70cbSLiam Girdwood  * @data: data
2423414c70cbSLiam Girdwood  */
2424414c70cbSLiam Girdwood void regulator_set_drvdata(struct regulator *regulator, void *data)
2425414c70cbSLiam Girdwood {
2426414c70cbSLiam Girdwood 	regulator->rdev->reg_data = data;
2427414c70cbSLiam Girdwood }
2428414c70cbSLiam Girdwood EXPORT_SYMBOL_GPL(regulator_set_drvdata);
2429414c70cbSLiam Girdwood 
2430414c70cbSLiam Girdwood /**
2431414c70cbSLiam Girdwood  * regulator_get_id - get regulator ID
243269279fb9SMark Brown  * @rdev: regulator
2433414c70cbSLiam Girdwood  */
2434414c70cbSLiam Girdwood int rdev_get_id(struct regulator_dev *rdev)
2435414c70cbSLiam Girdwood {
2436414c70cbSLiam Girdwood 	return rdev->desc->id;
2437414c70cbSLiam Girdwood }
2438414c70cbSLiam Girdwood EXPORT_SYMBOL_GPL(rdev_get_id);
2439414c70cbSLiam Girdwood 
2440a5766f11SLiam Girdwood struct device *rdev_get_dev(struct regulator_dev *rdev)
2441a5766f11SLiam Girdwood {
2442a5766f11SLiam Girdwood 	return &rdev->dev;
2443a5766f11SLiam Girdwood }
2444a5766f11SLiam Girdwood EXPORT_SYMBOL_GPL(rdev_get_dev);
2445a5766f11SLiam Girdwood 
2446a5766f11SLiam Girdwood void *regulator_get_init_drvdata(struct regulator_init_data *reg_init_data)
2447a5766f11SLiam Girdwood {
2448a5766f11SLiam Girdwood 	return reg_init_data->driver_data;
2449a5766f11SLiam Girdwood }
2450a5766f11SLiam Girdwood EXPORT_SYMBOL_GPL(regulator_get_init_drvdata);
2451a5766f11SLiam Girdwood 
2452414c70cbSLiam Girdwood static int __init regulator_init(void)
2453414c70cbSLiam Girdwood {
2454414c70cbSLiam Girdwood 	printk(KERN_INFO "regulator: core version %s\n", REGULATOR_VERSION);
2455414c70cbSLiam Girdwood 	return class_register(&regulator_class);
2456414c70cbSLiam Girdwood }
2457414c70cbSLiam Girdwood 
2458414c70cbSLiam Girdwood /* init early to allow our consumers to complete system booting */
2459414c70cbSLiam Girdwood core_initcall(regulator_init);
2460ca725561SMark Brown 
2461ca725561SMark Brown static int __init regulator_init_complete(void)
2462ca725561SMark Brown {
2463ca725561SMark Brown 	struct regulator_dev *rdev;
2464ca725561SMark Brown 	struct regulator_ops *ops;
2465ca725561SMark Brown 	struct regulation_constraints *c;
2466ca725561SMark Brown 	int enabled, ret;
2467ca725561SMark Brown 	const char *name;
2468ca725561SMark Brown 
2469ca725561SMark Brown 	mutex_lock(&regulator_list_mutex);
2470ca725561SMark Brown 
2471ca725561SMark Brown 	/* If we have a full configuration then disable any regulators
2472ca725561SMark Brown 	 * which are not in use or always_on.  This will become the
2473ca725561SMark Brown 	 * default behaviour in the future.
2474ca725561SMark Brown 	 */
2475ca725561SMark Brown 	list_for_each_entry(rdev, &regulator_list, list) {
2476ca725561SMark Brown 		ops = rdev->desc->ops;
2477ca725561SMark Brown 		c = rdev->constraints;
2478ca725561SMark Brown 
24791083c393SMark Brown 		name = rdev_get_name(rdev);
2480ca725561SMark Brown 
2481f25e0b4fSMark Brown 		if (!ops->disable || (c && c->always_on))
2482ca725561SMark Brown 			continue;
2483ca725561SMark Brown 
2484ca725561SMark Brown 		mutex_lock(&rdev->mutex);
2485ca725561SMark Brown 
2486ca725561SMark Brown 		if (rdev->use_count)
2487ca725561SMark Brown 			goto unlock;
2488ca725561SMark Brown 
2489ca725561SMark Brown 		/* If we can't read the status assume it's on. */
2490ca725561SMark Brown 		if (ops->is_enabled)
2491ca725561SMark Brown 			enabled = ops->is_enabled(rdev);
2492ca725561SMark Brown 		else
2493ca725561SMark Brown 			enabled = 1;
2494ca725561SMark Brown 
2495ca725561SMark Brown 		if (!enabled)
2496ca725561SMark Brown 			goto unlock;
2497ca725561SMark Brown 
2498ca725561SMark Brown 		if (has_full_constraints) {
2499ca725561SMark Brown 			/* We log since this may kill the system if it
2500ca725561SMark Brown 			 * goes wrong. */
2501ca725561SMark Brown 			printk(KERN_INFO "%s: disabling %s\n",
2502ca725561SMark Brown 			       __func__, name);
2503ca725561SMark Brown 			ret = ops->disable(rdev);
2504ca725561SMark Brown 			if (ret != 0) {
2505ca725561SMark Brown 				printk(KERN_ERR
2506ca725561SMark Brown 				       "%s: couldn't disable %s: %d\n",
2507ca725561SMark Brown 				       __func__, name, ret);
2508ca725561SMark Brown 			}
2509ca725561SMark Brown 		} else {
2510ca725561SMark Brown 			/* The intention is that in future we will
2511ca725561SMark Brown 			 * assume that full constraints are provided
2512ca725561SMark Brown 			 * so warn even if we aren't going to do
2513ca725561SMark Brown 			 * anything here.
2514ca725561SMark Brown 			 */
2515ca725561SMark Brown 			printk(KERN_WARNING
2516ca725561SMark Brown 			       "%s: incomplete constraints, leaving %s on\n",
2517ca725561SMark Brown 			       __func__, name);
2518ca725561SMark Brown 		}
2519ca725561SMark Brown 
2520ca725561SMark Brown unlock:
2521ca725561SMark Brown 		mutex_unlock(&rdev->mutex);
2522ca725561SMark Brown 	}
2523ca725561SMark Brown 
2524ca725561SMark Brown 	mutex_unlock(&regulator_list_mutex);
2525ca725561SMark Brown 
2526ca725561SMark Brown 	return 0;
2527ca725561SMark Brown }
2528ca725561SMark Brown late_initcall(regulator_init_complete);
2529