blob: 60fcfba52592c8e67b8e551560ecd9574459fe5f [file] [log] [blame]
Liam Girdwood414c70c2008-04-30 15:59:04 +01001/*
2 * core.c -- Voltage/Current Regulator framework.
3 *
4 * Copyright 2007, 2008 Wolfson Microelectronics PLC.
Liam Girdwooda5766f12008-10-10 13:22:20 +01005 * Copyright 2008 SlimLogic Ltd.
Liam Girdwood414c70c2008-04-30 15:59:04 +01006 *
Liam Girdwooda5766f12008-10-10 13:22:20 +01007 * Author: Liam Girdwood <lrg@slimlogic.co.uk>
Liam Girdwood414c70c2008-04-30 15:59:04 +01008 *
9 * This program is free software; you can redistribute it and/or modify it
10 * under the terms of the GNU General Public License as published by the
11 * Free Software Foundation; either version 2 of the License, or (at your
12 * option) any later version.
13 *
14 */
15
16#include <linux/kernel.h>
17#include <linux/init.h>
Mark Brown1130e5b2010-12-21 23:49:31 +000018#include <linux/debugfs.h>
Liam Girdwood414c70c2008-04-30 15:59:04 +010019#include <linux/device.h>
Tejun Heo5a0e3ad2010-03-24 17:04:11 +090020#include <linux/slab.h>
Mark Brownf21e0e82011-05-24 08:12:40 +080021#include <linux/async.h>
Liam Girdwood414c70c2008-04-30 15:59:04 +010022#include <linux/err.h>
23#include <linux/mutex.h>
24#include <linux/suspend.h>
Mark Brown31aae2b2009-12-21 12:21:52 +000025#include <linux/delay.h>
Mark Brown65f73502012-06-27 14:14:38 +010026#include <linux/gpio.h>
Russell King778b28b2014-06-29 17:55:54 +010027#include <linux/gpio/consumer.h>
Rajendra Nayak69511a42011-11-18 16:47:20 +053028#include <linux/of.h>
Mark Brown65b19ce2012-04-15 11:16:05 +010029#include <linux/regmap.h>
Rajendra Nayak69511a42011-11-18 16:47:20 +053030#include <linux/regulator/of_regulator.h>
Liam Girdwood414c70c2008-04-30 15:59:04 +010031#include <linux/regulator/consumer.h>
32#include <linux/regulator/driver.h>
33#include <linux/regulator/machine.h>
Paul Gortmaker65602c32011-07-17 16:28:23 -040034#include <linux/module.h>
Liam Girdwood414c70c2008-04-30 15:59:04 +010035
Mark Brown02fa3ec2010-11-10 14:38:30 +000036#define CREATE_TRACE_POINTS
37#include <trace/events/regulator.h>
38
Mark Brown34abbd62010-02-12 10:18:08 +000039#include "dummy.h"
Mark Brown0cdfcc02013-09-11 13:15:40 +010040#include "internal.h"
Mark Brown34abbd62010-02-12 10:18:08 +000041
Mark Brown7d51a0d2011-06-09 16:06:37 +010042#define rdev_crit(rdev, fmt, ...) \
43 pr_crit("%s: " fmt, rdev_get_name(rdev), ##__VA_ARGS__)
Joe Perches5da84fd2010-11-30 05:53:48 -080044#define rdev_err(rdev, fmt, ...) \
45 pr_err("%s: " fmt, rdev_get_name(rdev), ##__VA_ARGS__)
46#define rdev_warn(rdev, fmt, ...) \
47 pr_warn("%s: " fmt, rdev_get_name(rdev), ##__VA_ARGS__)
48#define rdev_info(rdev, fmt, ...) \
49 pr_info("%s: " fmt, rdev_get_name(rdev), ##__VA_ARGS__)
50#define rdev_dbg(rdev, fmt, ...) \
51 pr_debug("%s: " fmt, rdev_get_name(rdev), ##__VA_ARGS__)
52
Liam Girdwood414c70c2008-04-30 15:59:04 +010053static DEFINE_MUTEX(regulator_list_mutex);
54static LIST_HEAD(regulator_list);
55static LIST_HEAD(regulator_map_list);
Kim, Milof19b00d2013-02-18 06:50:39 +000056static LIST_HEAD(regulator_ena_gpio_list);
Charles Keepaxa06ccd92013-10-15 20:14:20 +010057static LIST_HEAD(regulator_supply_alias_list);
Mark Brown21cf8912010-12-21 23:30:07 +000058static bool has_full_constraints;
Liam Girdwood414c70c2008-04-30 15:59:04 +010059
Mark Brown1130e5b2010-12-21 23:49:31 +000060static struct dentry *debugfs_root;
Mark Brown1130e5b2010-12-21 23:49:31 +000061
Mark Brown8dc53902008-12-31 12:52:40 +000062/*
Liam Girdwood414c70c2008-04-30 15:59:04 +010063 * struct regulator_map
64 *
65 * Used to provide symbolic supply names to devices.
66 */
67struct regulator_map {
68 struct list_head list;
Mark Brown40f92442009-06-17 17:56:39 +010069 const char *dev_name; /* The dev_name() for the consumer */
Liam Girdwood414c70c2008-04-30 15:59:04 +010070 const char *supply;
Liam Girdwooda5766f12008-10-10 13:22:20 +010071 struct regulator_dev *regulator;
Liam Girdwood414c70c2008-04-30 15:59:04 +010072};
73
Liam Girdwood414c70c2008-04-30 15:59:04 +010074/*
Kim, Milof19b00d2013-02-18 06:50:39 +000075 * struct regulator_enable_gpio
76 *
77 * Management for shared enable GPIO pin
78 */
79struct regulator_enable_gpio {
80 struct list_head list;
Russell King778b28b2014-06-29 17:55:54 +010081 struct gpio_desc *gpiod;
Kim, Milof19b00d2013-02-18 06:50:39 +000082 u32 enable_count; /* a number of enabled shared GPIO */
83 u32 request_count; /* a number of requested shared GPIO */
84 unsigned int ena_gpio_invert:1;
85};
86
Charles Keepaxa06ccd92013-10-15 20:14:20 +010087/*
88 * struct regulator_supply_alias
89 *
90 * Used to map lookups for a supply onto an alternative device.
91 */
92struct regulator_supply_alias {
93 struct list_head list;
94 struct device *src_dev;
95 const char *src_supply;
96 struct device *alias_dev;
97 const char *alias_supply;
98};
99
Liam Girdwood414c70c2008-04-30 15:59:04 +0100100static int _regulator_is_enabled(struct regulator_dev *rdev);
Mark Brown3801b862011-06-09 16:22:22 +0100101static int _regulator_disable(struct regulator_dev *rdev);
Liam Girdwood414c70c2008-04-30 15:59:04 +0100102static int _regulator_get_voltage(struct regulator_dev *rdev);
103static int _regulator_get_current_limit(struct regulator_dev *rdev);
104static unsigned int _regulator_get_mode(struct regulator_dev *rdev);
Heiko Stübner71795692014-08-28 12:36:04 -0700105static int _notifier_call_chain(struct regulator_dev *rdev,
Liam Girdwood414c70c2008-04-30 15:59:04 +0100106 unsigned long event, void *data);
Mark Brown75790252010-12-12 14:25:50 +0000107static int _regulator_do_set_voltage(struct regulator_dev *rdev,
108 int min_uV, int max_uV);
Mark Brown3801b862011-06-09 16:22:22 +0100109static struct regulator *create_regulator(struct regulator_dev *rdev,
110 struct device *dev,
111 const char *supply_name);
Liam Girdwood414c70c2008-04-30 15:59:04 +0100112
Mark Brown1083c392009-10-22 16:31:32 +0100113static const char *rdev_get_name(struct regulator_dev *rdev)
114{
115 if (rdev->constraints && rdev->constraints->name)
116 return rdev->constraints->name;
117 else if (rdev->desc->name)
118 return rdev->desc->name;
119 else
120 return "";
121}
122
Mark Brown87b28412013-11-27 16:13:10 +0000123static bool have_full_constraints(void)
124{
Mark Brown75bc9642013-11-27 16:22:53 +0000125 return has_full_constraints || of_have_populated_dt();
Mark Brown87b28412013-11-27 16:13:10 +0000126}
127
Rajendra Nayak69511a42011-11-18 16:47:20 +0530128/**
129 * of_get_regulator - get a regulator device node based on supply name
130 * @dev: Device pointer for the consumer (of regulator) device
131 * @supply: regulator supply name
132 *
133 * Extract the regulator device node corresponding to the supply name.
Maxime Ripard167d41d2013-03-23 11:00:41 +0100134 * returns the device node corresponding to the regulator if found, else
Rajendra Nayak69511a42011-11-18 16:47:20 +0530135 * returns NULL.
136 */
137static struct device_node *of_get_regulator(struct device *dev, const char *supply)
138{
139 struct device_node *regnode = NULL;
140 char prop_name[32]; /* 32 is max size of property name */
141
142 dev_dbg(dev, "Looking up %s-supply from device tree\n", supply);
143
144 snprintf(prop_name, 32, "%s-supply", supply);
145 regnode = of_parse_phandle(dev->of_node, prop_name, 0);
146
147 if (!regnode) {
Rajendra Nayak16fbcc32012-03-16 15:50:21 +0530148 dev_dbg(dev, "Looking up %s property in node %s failed",
Rajendra Nayak69511a42011-11-18 16:47:20 +0530149 prop_name, dev->of_node->full_name);
150 return NULL;
151 }
152 return regnode;
153}
154
Mark Brown6492bc12012-04-19 13:19:07 +0100155static int _regulator_can_change_status(struct regulator_dev *rdev)
156{
157 if (!rdev->constraints)
158 return 0;
159
160 if (rdev->constraints->valid_ops_mask & REGULATOR_CHANGE_STATUS)
161 return 1;
162 else
163 return 0;
164}
165
Liam Girdwood414c70c2008-04-30 15:59:04 +0100166/* Platform voltage constraint check */
167static int regulator_check_voltage(struct regulator_dev *rdev,
168 int *min_uV, int *max_uV)
169{
170 BUG_ON(*min_uV > *max_uV);
171
172 if (!rdev->constraints) {
Joe Perches5da84fd2010-11-30 05:53:48 -0800173 rdev_err(rdev, "no constraints\n");
Liam Girdwood414c70c2008-04-30 15:59:04 +0100174 return -ENODEV;
175 }
176 if (!(rdev->constraints->valid_ops_mask & REGULATOR_CHANGE_VOLTAGE)) {
Joe Perches5da84fd2010-11-30 05:53:48 -0800177 rdev_err(rdev, "operation not allowed\n");
Liam Girdwood414c70c2008-04-30 15:59:04 +0100178 return -EPERM;
179 }
180
181 if (*max_uV > rdev->constraints->max_uV)
182 *max_uV = rdev->constraints->max_uV;
183 if (*min_uV < rdev->constraints->min_uV)
184 *min_uV = rdev->constraints->min_uV;
185
Mark Brown89f425e2011-07-12 11:20:37 +0900186 if (*min_uV > *max_uV) {
187 rdev_err(rdev, "unsupportable voltage range: %d-%duV\n",
Mark Brown54abd332011-07-21 15:07:37 +0100188 *min_uV, *max_uV);
Liam Girdwood414c70c2008-04-30 15:59:04 +0100189 return -EINVAL;
Mark Brown89f425e2011-07-12 11:20:37 +0900190 }
Liam Girdwood414c70c2008-04-30 15:59:04 +0100191
192 return 0;
193}
194
Thomas Petazzoni05fda3b1a2010-12-03 11:31:07 +0100195/* Make sure we select a voltage that suits the needs of all
196 * regulator consumers
197 */
198static int regulator_check_consumers(struct regulator_dev *rdev,
199 int *min_uV, int *max_uV)
200{
201 struct regulator *regulator;
202
203 list_for_each_entry(regulator, &rdev->consumer_list, list) {
Mark Brown4aa922c2011-05-14 13:42:34 -0700204 /*
205 * Assume consumers that didn't say anything are OK
206 * with anything in the constraint range.
207 */
208 if (!regulator->min_uV && !regulator->max_uV)
209 continue;
210
Thomas Petazzoni05fda3b1a2010-12-03 11:31:07 +0100211 if (*max_uV > regulator->max_uV)
212 *max_uV = regulator->max_uV;
213 if (*min_uV < regulator->min_uV)
214 *min_uV = regulator->min_uV;
215 }
216
Mark Browndd8004a2012-11-28 17:09:27 +0000217 if (*min_uV > *max_uV) {
Russ Dill9c7b4e82013-02-14 04:46:33 -0800218 rdev_err(rdev, "Restricting voltage, %u-%uuV\n",
219 *min_uV, *max_uV);
Thomas Petazzoni05fda3b1a2010-12-03 11:31:07 +0100220 return -EINVAL;
Mark Browndd8004a2012-11-28 17:09:27 +0000221 }
Thomas Petazzoni05fda3b1a2010-12-03 11:31:07 +0100222
223 return 0;
224}
225
Liam Girdwood414c70c2008-04-30 15:59:04 +0100226/* current constraint check */
227static int regulator_check_current_limit(struct regulator_dev *rdev,
228 int *min_uA, int *max_uA)
229{
230 BUG_ON(*min_uA > *max_uA);
231
232 if (!rdev->constraints) {
Joe Perches5da84fd2010-11-30 05:53:48 -0800233 rdev_err(rdev, "no constraints\n");
Liam Girdwood414c70c2008-04-30 15:59:04 +0100234 return -ENODEV;
235 }
236 if (!(rdev->constraints->valid_ops_mask & REGULATOR_CHANGE_CURRENT)) {
Joe Perches5da84fd2010-11-30 05:53:48 -0800237 rdev_err(rdev, "operation not allowed\n");
Liam Girdwood414c70c2008-04-30 15:59:04 +0100238 return -EPERM;
239 }
240
241 if (*max_uA > rdev->constraints->max_uA)
242 *max_uA = rdev->constraints->max_uA;
243 if (*min_uA < rdev->constraints->min_uA)
244 *min_uA = rdev->constraints->min_uA;
245
Mark Brown89f425e2011-07-12 11:20:37 +0900246 if (*min_uA > *max_uA) {
247 rdev_err(rdev, "unsupportable current range: %d-%duA\n",
Mark Brown54abd332011-07-21 15:07:37 +0100248 *min_uA, *max_uA);
Liam Girdwood414c70c2008-04-30 15:59:04 +0100249 return -EINVAL;
Mark Brown89f425e2011-07-12 11:20:37 +0900250 }
Liam Girdwood414c70c2008-04-30 15:59:04 +0100251
252 return 0;
253}
254
255/* operating mode constraint check */
Mark Brown2c608232011-03-30 06:29:12 +0900256static int regulator_mode_constrain(struct regulator_dev *rdev, int *mode)
Liam Girdwood414c70c2008-04-30 15:59:04 +0100257{
Mark Brown2c608232011-03-30 06:29:12 +0900258 switch (*mode) {
David Brownelle5735202008-11-16 11:46:56 -0800259 case REGULATOR_MODE_FAST:
260 case REGULATOR_MODE_NORMAL:
261 case REGULATOR_MODE_IDLE:
262 case REGULATOR_MODE_STANDBY:
263 break;
264 default:
Mark Brown89f425e2011-07-12 11:20:37 +0900265 rdev_err(rdev, "invalid mode %x specified\n", *mode);
David Brownelle5735202008-11-16 11:46:56 -0800266 return -EINVAL;
267 }
268
Liam Girdwood414c70c2008-04-30 15:59:04 +0100269 if (!rdev->constraints) {
Joe Perches5da84fd2010-11-30 05:53:48 -0800270 rdev_err(rdev, "no constraints\n");
Liam Girdwood414c70c2008-04-30 15:59:04 +0100271 return -ENODEV;
272 }
273 if (!(rdev->constraints->valid_ops_mask & REGULATOR_CHANGE_MODE)) {
Joe Perches5da84fd2010-11-30 05:53:48 -0800274 rdev_err(rdev, "operation not allowed\n");
Liam Girdwood414c70c2008-04-30 15:59:04 +0100275 return -EPERM;
276 }
Mark Brown2c608232011-03-30 06:29:12 +0900277
278 /* The modes are bitmasks, the most power hungry modes having
279 * the lowest values. If the requested mode isn't supported
280 * try higher modes. */
281 while (*mode) {
282 if (rdev->constraints->valid_modes_mask & *mode)
283 return 0;
284 *mode /= 2;
Liam Girdwood414c70c2008-04-30 15:59:04 +0100285 }
Mark Brown2c608232011-03-30 06:29:12 +0900286
287 return -EINVAL;
Liam Girdwood414c70c2008-04-30 15:59:04 +0100288}
289
290/* dynamic regulator mode switching constraint check */
291static int regulator_check_drms(struct regulator_dev *rdev)
292{
293 if (!rdev->constraints) {
Joe Perches5da84fd2010-11-30 05:53:48 -0800294 rdev_err(rdev, "no constraints\n");
Liam Girdwood414c70c2008-04-30 15:59:04 +0100295 return -ENODEV;
296 }
297 if (!(rdev->constraints->valid_ops_mask & REGULATOR_CHANGE_DRMS)) {
Joe Perches5da84fd2010-11-30 05:53:48 -0800298 rdev_err(rdev, "operation not allowed\n");
Liam Girdwood414c70c2008-04-30 15:59:04 +0100299 return -EPERM;
300 }
301 return 0;
302}
303
Liam Girdwood414c70c2008-04-30 15:59:04 +0100304static ssize_t regulator_uV_show(struct device *dev,
305 struct device_attribute *attr, char *buf)
306{
Liam Girdwooda5766f12008-10-10 13:22:20 +0100307 struct regulator_dev *rdev = dev_get_drvdata(dev);
Liam Girdwood414c70c2008-04-30 15:59:04 +0100308 ssize_t ret;
309
310 mutex_lock(&rdev->mutex);
311 ret = sprintf(buf, "%d\n", _regulator_get_voltage(rdev));
312 mutex_unlock(&rdev->mutex);
313
314 return ret;
315}
David Brownell7ad68e22008-11-11 17:39:02 -0800316static DEVICE_ATTR(microvolts, 0444, regulator_uV_show, NULL);
Liam Girdwood414c70c2008-04-30 15:59:04 +0100317
318static ssize_t regulator_uA_show(struct device *dev,
319 struct device_attribute *attr, char *buf)
320{
Liam Girdwooda5766f12008-10-10 13:22:20 +0100321 struct regulator_dev *rdev = dev_get_drvdata(dev);
Liam Girdwood414c70c2008-04-30 15:59:04 +0100322
323 return sprintf(buf, "%d\n", _regulator_get_current_limit(rdev));
324}
David Brownell7ad68e22008-11-11 17:39:02 -0800325static DEVICE_ATTR(microamps, 0444, regulator_uA_show, NULL);
Liam Girdwood414c70c2008-04-30 15:59:04 +0100326
Greg Kroah-Hartman587cea22013-07-24 15:05:21 -0700327static ssize_t name_show(struct device *dev, struct device_attribute *attr,
328 char *buf)
Mark Brownbc558a62008-10-10 15:33:20 +0100329{
330 struct regulator_dev *rdev = dev_get_drvdata(dev);
Mark Brownbc558a62008-10-10 15:33:20 +0100331
Mark Brown1083c392009-10-22 16:31:32 +0100332 return sprintf(buf, "%s\n", rdev_get_name(rdev));
Mark Brownbc558a62008-10-10 15:33:20 +0100333}
Greg Kroah-Hartman587cea22013-07-24 15:05:21 -0700334static DEVICE_ATTR_RO(name);
Mark Brownbc558a62008-10-10 15:33:20 +0100335
David Brownell4fca9542008-11-11 17:38:53 -0800336static ssize_t regulator_print_opmode(char *buf, int mode)
Liam Girdwood414c70c2008-04-30 15:59:04 +0100337{
Liam Girdwood414c70c2008-04-30 15:59:04 +0100338 switch (mode) {
339 case REGULATOR_MODE_FAST:
340 return sprintf(buf, "fast\n");
341 case REGULATOR_MODE_NORMAL:
342 return sprintf(buf, "normal\n");
343 case REGULATOR_MODE_IDLE:
344 return sprintf(buf, "idle\n");
345 case REGULATOR_MODE_STANDBY:
346 return sprintf(buf, "standby\n");
347 }
348 return sprintf(buf, "unknown\n");
349}
350
David Brownell4fca9542008-11-11 17:38:53 -0800351static ssize_t regulator_opmode_show(struct device *dev,
352 struct device_attribute *attr, char *buf)
Liam Girdwood414c70c2008-04-30 15:59:04 +0100353{
Liam Girdwooda5766f12008-10-10 13:22:20 +0100354 struct regulator_dev *rdev = dev_get_drvdata(dev);
Liam Girdwood414c70c2008-04-30 15:59:04 +0100355
David Brownell4fca9542008-11-11 17:38:53 -0800356 return regulator_print_opmode(buf, _regulator_get_mode(rdev));
357}
David Brownell7ad68e22008-11-11 17:39:02 -0800358static DEVICE_ATTR(opmode, 0444, regulator_opmode_show, NULL);
David Brownell4fca9542008-11-11 17:38:53 -0800359
360static ssize_t regulator_print_state(char *buf, int state)
361{
Liam Girdwood414c70c2008-04-30 15:59:04 +0100362 if (state > 0)
363 return sprintf(buf, "enabled\n");
364 else if (state == 0)
365 return sprintf(buf, "disabled\n");
366 else
367 return sprintf(buf, "unknown\n");
368}
369
David Brownell4fca9542008-11-11 17:38:53 -0800370static ssize_t regulator_state_show(struct device *dev,
371 struct device_attribute *attr, char *buf)
372{
373 struct regulator_dev *rdev = dev_get_drvdata(dev);
Mark Brown93325462009-08-03 18:49:56 +0100374 ssize_t ret;
David Brownell4fca9542008-11-11 17:38:53 -0800375
Mark Brown93325462009-08-03 18:49:56 +0100376 mutex_lock(&rdev->mutex);
377 ret = regulator_print_state(buf, _regulator_is_enabled(rdev));
378 mutex_unlock(&rdev->mutex);
379
380 return ret;
David Brownell4fca9542008-11-11 17:38:53 -0800381}
David Brownell7ad68e22008-11-11 17:39:02 -0800382static DEVICE_ATTR(state, 0444, regulator_state_show, NULL);
David Brownell4fca9542008-11-11 17:38:53 -0800383
David Brownell853116a2009-01-14 23:03:17 -0800384static ssize_t regulator_status_show(struct device *dev,
385 struct device_attribute *attr, char *buf)
386{
387 struct regulator_dev *rdev = dev_get_drvdata(dev);
388 int status;
389 char *label;
390
391 status = rdev->desc->ops->get_status(rdev);
392 if (status < 0)
393 return status;
394
395 switch (status) {
396 case REGULATOR_STATUS_OFF:
397 label = "off";
398 break;
399 case REGULATOR_STATUS_ON:
400 label = "on";
401 break;
402 case REGULATOR_STATUS_ERROR:
403 label = "error";
404 break;
405 case REGULATOR_STATUS_FAST:
406 label = "fast";
407 break;
408 case REGULATOR_STATUS_NORMAL:
409 label = "normal";
410 break;
411 case REGULATOR_STATUS_IDLE:
412 label = "idle";
413 break;
414 case REGULATOR_STATUS_STANDBY:
415 label = "standby";
416 break;
Mark Brownf59c8f92012-08-31 10:36:37 -0700417 case REGULATOR_STATUS_BYPASS:
418 label = "bypass";
419 break;
Krystian Garbaciak1beaf762012-07-12 13:53:35 +0100420 case REGULATOR_STATUS_UNDEFINED:
421 label = "undefined";
422 break;
David Brownell853116a2009-01-14 23:03:17 -0800423 default:
424 return -ERANGE;
425 }
426
427 return sprintf(buf, "%s\n", label);
428}
429static DEVICE_ATTR(status, 0444, regulator_status_show, NULL);
430
Liam Girdwood414c70c2008-04-30 15:59:04 +0100431static ssize_t regulator_min_uA_show(struct device *dev,
432 struct device_attribute *attr, char *buf)
433{
Liam Girdwooda5766f12008-10-10 13:22:20 +0100434 struct regulator_dev *rdev = dev_get_drvdata(dev);
Liam Girdwood414c70c2008-04-30 15:59:04 +0100435
436 if (!rdev->constraints)
437 return sprintf(buf, "constraint not defined\n");
438
439 return sprintf(buf, "%d\n", rdev->constraints->min_uA);
440}
David Brownell7ad68e22008-11-11 17:39:02 -0800441static DEVICE_ATTR(min_microamps, 0444, regulator_min_uA_show, NULL);
Liam Girdwood414c70c2008-04-30 15:59:04 +0100442
443static ssize_t regulator_max_uA_show(struct device *dev,
444 struct device_attribute *attr, char *buf)
445{
Liam Girdwooda5766f12008-10-10 13:22:20 +0100446 struct regulator_dev *rdev = dev_get_drvdata(dev);
Liam Girdwood414c70c2008-04-30 15:59:04 +0100447
448 if (!rdev->constraints)
449 return sprintf(buf, "constraint not defined\n");
450
451 return sprintf(buf, "%d\n", rdev->constraints->max_uA);
452}
David Brownell7ad68e22008-11-11 17:39:02 -0800453static DEVICE_ATTR(max_microamps, 0444, regulator_max_uA_show, NULL);
Liam Girdwood414c70c2008-04-30 15:59:04 +0100454
455static ssize_t regulator_min_uV_show(struct device *dev,
456 struct device_attribute *attr, char *buf)
457{
Liam Girdwooda5766f12008-10-10 13:22:20 +0100458 struct regulator_dev *rdev = dev_get_drvdata(dev);
Liam Girdwood414c70c2008-04-30 15:59:04 +0100459
460 if (!rdev->constraints)
461 return sprintf(buf, "constraint not defined\n");
462
463 return sprintf(buf, "%d\n", rdev->constraints->min_uV);
464}
David Brownell7ad68e22008-11-11 17:39:02 -0800465static DEVICE_ATTR(min_microvolts, 0444, regulator_min_uV_show, NULL);
Liam Girdwood414c70c2008-04-30 15:59:04 +0100466
467static ssize_t regulator_max_uV_show(struct device *dev,
468 struct device_attribute *attr, char *buf)
469{
Liam Girdwooda5766f12008-10-10 13:22:20 +0100470 struct regulator_dev *rdev = dev_get_drvdata(dev);
Liam Girdwood414c70c2008-04-30 15:59:04 +0100471
472 if (!rdev->constraints)
473 return sprintf(buf, "constraint not defined\n");
474
475 return sprintf(buf, "%d\n", rdev->constraints->max_uV);
476}
David Brownell7ad68e22008-11-11 17:39:02 -0800477static DEVICE_ATTR(max_microvolts, 0444, regulator_max_uV_show, NULL);
Liam Girdwood414c70c2008-04-30 15:59:04 +0100478
479static ssize_t regulator_total_uA_show(struct device *dev,
480 struct device_attribute *attr, char *buf)
481{
Liam Girdwooda5766f12008-10-10 13:22:20 +0100482 struct regulator_dev *rdev = dev_get_drvdata(dev);
Liam Girdwood414c70c2008-04-30 15:59:04 +0100483 struct regulator *regulator;
484 int uA = 0;
485
486 mutex_lock(&rdev->mutex);
487 list_for_each_entry(regulator, &rdev->consumer_list, list)
Stefan Roesefa2984d2009-11-27 15:56:34 +0100488 uA += regulator->uA_load;
Liam Girdwood414c70c2008-04-30 15:59:04 +0100489 mutex_unlock(&rdev->mutex);
490 return sprintf(buf, "%d\n", uA);
491}
David Brownell7ad68e22008-11-11 17:39:02 -0800492static DEVICE_ATTR(requested_microamps, 0444, regulator_total_uA_show, NULL);
Liam Girdwood414c70c2008-04-30 15:59:04 +0100493
Greg Kroah-Hartman587cea22013-07-24 15:05:21 -0700494static ssize_t num_users_show(struct device *dev, struct device_attribute *attr,
495 char *buf)
Liam Girdwood414c70c2008-04-30 15:59:04 +0100496{
Liam Girdwooda5766f12008-10-10 13:22:20 +0100497 struct regulator_dev *rdev = dev_get_drvdata(dev);
Liam Girdwood414c70c2008-04-30 15:59:04 +0100498 return sprintf(buf, "%d\n", rdev->use_count);
499}
Greg Kroah-Hartman587cea22013-07-24 15:05:21 -0700500static DEVICE_ATTR_RO(num_users);
Liam Girdwood414c70c2008-04-30 15:59:04 +0100501
Greg Kroah-Hartman587cea22013-07-24 15:05:21 -0700502static ssize_t type_show(struct device *dev, struct device_attribute *attr,
503 char *buf)
Liam Girdwood414c70c2008-04-30 15:59:04 +0100504{
Liam Girdwooda5766f12008-10-10 13:22:20 +0100505 struct regulator_dev *rdev = dev_get_drvdata(dev);
Liam Girdwood414c70c2008-04-30 15:59:04 +0100506
507 switch (rdev->desc->type) {
508 case REGULATOR_VOLTAGE:
509 return sprintf(buf, "voltage\n");
510 case REGULATOR_CURRENT:
511 return sprintf(buf, "current\n");
512 }
513 return sprintf(buf, "unknown\n");
514}
Greg Kroah-Hartman587cea22013-07-24 15:05:21 -0700515static DEVICE_ATTR_RO(type);
Liam Girdwood414c70c2008-04-30 15:59:04 +0100516
517static ssize_t regulator_suspend_mem_uV_show(struct device *dev,
518 struct device_attribute *attr, char *buf)
519{
Liam Girdwooda5766f12008-10-10 13:22:20 +0100520 struct regulator_dev *rdev = dev_get_drvdata(dev);
Liam Girdwood414c70c2008-04-30 15:59:04 +0100521
Liam Girdwood414c70c2008-04-30 15:59:04 +0100522 return sprintf(buf, "%d\n", rdev->constraints->state_mem.uV);
523}
David Brownell7ad68e22008-11-11 17:39:02 -0800524static DEVICE_ATTR(suspend_mem_microvolts, 0444,
525 regulator_suspend_mem_uV_show, NULL);
Liam Girdwood414c70c2008-04-30 15:59:04 +0100526
527static ssize_t regulator_suspend_disk_uV_show(struct device *dev,
528 struct device_attribute *attr, char *buf)
529{
Liam Girdwooda5766f12008-10-10 13:22:20 +0100530 struct regulator_dev *rdev = dev_get_drvdata(dev);
Liam Girdwood414c70c2008-04-30 15:59:04 +0100531
Liam Girdwood414c70c2008-04-30 15:59:04 +0100532 return sprintf(buf, "%d\n", rdev->constraints->state_disk.uV);
533}
David Brownell7ad68e22008-11-11 17:39:02 -0800534static DEVICE_ATTR(suspend_disk_microvolts, 0444,
535 regulator_suspend_disk_uV_show, NULL);
Liam Girdwood414c70c2008-04-30 15:59:04 +0100536
537static ssize_t regulator_suspend_standby_uV_show(struct device *dev,
538 struct device_attribute *attr, char *buf)
539{
Liam Girdwooda5766f12008-10-10 13:22:20 +0100540 struct regulator_dev *rdev = dev_get_drvdata(dev);
Liam Girdwood414c70c2008-04-30 15:59:04 +0100541
Liam Girdwood414c70c2008-04-30 15:59:04 +0100542 return sprintf(buf, "%d\n", rdev->constraints->state_standby.uV);
543}
David Brownell7ad68e22008-11-11 17:39:02 -0800544static DEVICE_ATTR(suspend_standby_microvolts, 0444,
545 regulator_suspend_standby_uV_show, NULL);
Liam Girdwood414c70c2008-04-30 15:59:04 +0100546
Liam Girdwood414c70c2008-04-30 15:59:04 +0100547static ssize_t regulator_suspend_mem_mode_show(struct device *dev,
548 struct device_attribute *attr, char *buf)
549{
Liam Girdwooda5766f12008-10-10 13:22:20 +0100550 struct regulator_dev *rdev = dev_get_drvdata(dev);
Liam Girdwood414c70c2008-04-30 15:59:04 +0100551
David Brownell4fca9542008-11-11 17:38:53 -0800552 return regulator_print_opmode(buf,
553 rdev->constraints->state_mem.mode);
Liam Girdwood414c70c2008-04-30 15:59:04 +0100554}
David Brownell7ad68e22008-11-11 17:39:02 -0800555static DEVICE_ATTR(suspend_mem_mode, 0444,
556 regulator_suspend_mem_mode_show, NULL);
Liam Girdwood414c70c2008-04-30 15:59:04 +0100557
558static ssize_t regulator_suspend_disk_mode_show(struct device *dev,
559 struct device_attribute *attr, char *buf)
560{
Liam Girdwooda5766f12008-10-10 13:22:20 +0100561 struct regulator_dev *rdev = dev_get_drvdata(dev);
Liam Girdwood414c70c2008-04-30 15:59:04 +0100562
David Brownell4fca9542008-11-11 17:38:53 -0800563 return regulator_print_opmode(buf,
564 rdev->constraints->state_disk.mode);
Liam Girdwood414c70c2008-04-30 15:59:04 +0100565}
David Brownell7ad68e22008-11-11 17:39:02 -0800566static DEVICE_ATTR(suspend_disk_mode, 0444,
567 regulator_suspend_disk_mode_show, NULL);
Liam Girdwood414c70c2008-04-30 15:59:04 +0100568
569static ssize_t regulator_suspend_standby_mode_show(struct device *dev,
570 struct device_attribute *attr, char *buf)
571{
Liam Girdwooda5766f12008-10-10 13:22:20 +0100572 struct regulator_dev *rdev = dev_get_drvdata(dev);
Liam Girdwood414c70c2008-04-30 15:59:04 +0100573
David Brownell4fca9542008-11-11 17:38:53 -0800574 return regulator_print_opmode(buf,
575 rdev->constraints->state_standby.mode);
Liam Girdwood414c70c2008-04-30 15:59:04 +0100576}
David Brownell7ad68e22008-11-11 17:39:02 -0800577static DEVICE_ATTR(suspend_standby_mode, 0444,
578 regulator_suspend_standby_mode_show, NULL);
Liam Girdwood414c70c2008-04-30 15:59:04 +0100579
580static ssize_t regulator_suspend_mem_state_show(struct device *dev,
581 struct device_attribute *attr, char *buf)
582{
Liam Girdwooda5766f12008-10-10 13:22:20 +0100583 struct regulator_dev *rdev = dev_get_drvdata(dev);
Liam Girdwood414c70c2008-04-30 15:59:04 +0100584
David Brownell4fca9542008-11-11 17:38:53 -0800585 return regulator_print_state(buf,
586 rdev->constraints->state_mem.enabled);
Liam Girdwood414c70c2008-04-30 15:59:04 +0100587}
David Brownell7ad68e22008-11-11 17:39:02 -0800588static DEVICE_ATTR(suspend_mem_state, 0444,
589 regulator_suspend_mem_state_show, NULL);
Liam Girdwood414c70c2008-04-30 15:59:04 +0100590
591static ssize_t regulator_suspend_disk_state_show(struct device *dev,
592 struct device_attribute *attr, char *buf)
593{
Liam Girdwooda5766f12008-10-10 13:22:20 +0100594 struct regulator_dev *rdev = dev_get_drvdata(dev);
Liam Girdwood414c70c2008-04-30 15:59:04 +0100595
David Brownell4fca9542008-11-11 17:38:53 -0800596 return regulator_print_state(buf,
597 rdev->constraints->state_disk.enabled);
Liam Girdwood414c70c2008-04-30 15:59:04 +0100598}
David Brownell7ad68e22008-11-11 17:39:02 -0800599static DEVICE_ATTR(suspend_disk_state, 0444,
600 regulator_suspend_disk_state_show, NULL);
Liam Girdwood414c70c2008-04-30 15:59:04 +0100601
602static ssize_t regulator_suspend_standby_state_show(struct device *dev,
603 struct device_attribute *attr, char *buf)
604{
Liam Girdwooda5766f12008-10-10 13:22:20 +0100605 struct regulator_dev *rdev = dev_get_drvdata(dev);
Liam Girdwood414c70c2008-04-30 15:59:04 +0100606
David Brownell4fca9542008-11-11 17:38:53 -0800607 return regulator_print_state(buf,
608 rdev->constraints->state_standby.enabled);
Liam Girdwood414c70c2008-04-30 15:59:04 +0100609}
David Brownell7ad68e22008-11-11 17:39:02 -0800610static DEVICE_ATTR(suspend_standby_state, 0444,
611 regulator_suspend_standby_state_show, NULL);
Mark Brownbc558a62008-10-10 15:33:20 +0100612
Mark Brownf59c8f92012-08-31 10:36:37 -0700613static ssize_t regulator_bypass_show(struct device *dev,
614 struct device_attribute *attr, char *buf)
615{
616 struct regulator_dev *rdev = dev_get_drvdata(dev);
617 const char *report;
618 bool bypass;
619 int ret;
620
621 ret = rdev->desc->ops->get_bypass(rdev, &bypass);
622
623 if (ret != 0)
624 report = "unknown";
625 else if (bypass)
626 report = "enabled";
627 else
628 report = "disabled";
629
630 return sprintf(buf, "%s\n", report);
631}
632static DEVICE_ATTR(bypass, 0444,
633 regulator_bypass_show, NULL);
David Brownell7ad68e22008-11-11 17:39:02 -0800634
Liam Girdwood414c70c2008-04-30 15:59:04 +0100635/* Calculate the new optimum regulator operating mode based on the new total
636 * consumer load. All locks held by caller */
Bjorn Andersson8460ef32015-01-27 18:46:31 -0800637static int drms_uA_update(struct regulator_dev *rdev)
Liam Girdwood414c70c2008-04-30 15:59:04 +0100638{
639 struct regulator *sibling;
640 int current_uA = 0, output_uV, input_uV, err;
641 unsigned int mode;
642
Bjorn Andersson8460ef32015-01-27 18:46:31 -0800643 /*
644 * first check to see if we can set modes at all, otherwise just
645 * tell the consumer everything is OK.
646 */
Liam Girdwood414c70c2008-04-30 15:59:04 +0100647 err = regulator_check_drms(rdev);
Bjorn Andersson8460ef32015-01-27 18:46:31 -0800648 if (err < 0)
649 return 0;
650
Bjorn Andersson8f4490e2015-02-11 19:39:12 -0800651 if (!rdev->desc->ops->get_optimum_mode &&
652 !rdev->desc->ops->set_load)
Bjorn Andersson8460ef32015-01-27 18:46:31 -0800653 return 0;
654
Bjorn Andersson8f4490e2015-02-11 19:39:12 -0800655 if (!rdev->desc->ops->set_mode &&
656 !rdev->desc->ops->set_load)
Bjorn Andersson8460ef32015-01-27 18:46:31 -0800657 return -EINVAL;
Liam Girdwood414c70c2008-04-30 15:59:04 +0100658
659 /* get output voltage */
Mark Brown1bf5a1f2010-12-10 17:28:06 +0000660 output_uV = _regulator_get_voltage(rdev);
Bjorn Andersson8460ef32015-01-27 18:46:31 -0800661 if (output_uV <= 0) {
662 rdev_err(rdev, "invalid output voltage found\n");
663 return -EINVAL;
664 }
Liam Girdwood414c70c2008-04-30 15:59:04 +0100665
666 /* get input voltage */
Mark Brown1bf5a1f2010-12-10 17:28:06 +0000667 input_uV = 0;
668 if (rdev->supply)
Axel Lin3f24f5a2012-04-13 21:35:05 +0800669 input_uV = regulator_get_voltage(rdev->supply);
Mark Brown1bf5a1f2010-12-10 17:28:06 +0000670 if (input_uV <= 0)
Liam Girdwood414c70c2008-04-30 15:59:04 +0100671 input_uV = rdev->constraints->input_uV;
Bjorn Andersson8460ef32015-01-27 18:46:31 -0800672 if (input_uV <= 0) {
673 rdev_err(rdev, "invalid input voltage found\n");
674 return -EINVAL;
675 }
Liam Girdwood414c70c2008-04-30 15:59:04 +0100676
677 /* calc total requested load */
678 list_for_each_entry(sibling, &rdev->consumer_list, list)
Stefan Roesefa2984d2009-11-27 15:56:34 +0100679 current_uA += sibling->uA_load;
Liam Girdwood414c70c2008-04-30 15:59:04 +0100680
Stephen Boyd22a10bc2015-06-11 17:37:03 -0700681 current_uA += rdev->constraints->system_load;
682
Bjorn Andersson8f4490e2015-02-11 19:39:12 -0800683 if (rdev->desc->ops->set_load) {
684 /* set the optimum mode for our new total regulator load */
685 err = rdev->desc->ops->set_load(rdev, current_uA);
686 if (err < 0)
687 rdev_err(rdev, "failed to set load %d\n", current_uA);
688 } else {
689 /* now get the optimum mode for our new total regulator load */
690 mode = rdev->desc->ops->get_optimum_mode(rdev, input_uV,
691 output_uV, current_uA);
Liam Girdwood414c70c2008-04-30 15:59:04 +0100692
Bjorn Andersson8f4490e2015-02-11 19:39:12 -0800693 /* check the new mode is allowed */
694 err = regulator_mode_constrain(rdev, &mode);
695 if (err < 0) {
696 rdev_err(rdev, "failed to get optimum mode @ %d uA %d -> %d uV\n",
697 current_uA, input_uV, output_uV);
698 return err;
699 }
700
701 err = rdev->desc->ops->set_mode(rdev, mode);
702 if (err < 0)
703 rdev_err(rdev, "failed to set optimum mode %x\n", mode);
Bjorn Andersson8460ef32015-01-27 18:46:31 -0800704 }
705
Bjorn Andersson8460ef32015-01-27 18:46:31 -0800706 return err;
Liam Girdwood414c70c2008-04-30 15:59:04 +0100707}
708
709static int suspend_set_state(struct regulator_dev *rdev,
710 struct regulator_state *rstate)
711{
712 int ret = 0;
Mark Brown638f85c2009-10-22 16:31:33 +0100713
714 /* If we have no suspend mode configration don't set anything;
Axel Lin8ac0e952012-04-14 09:14:34 +0800715 * only warn if the driver implements set_suspend_voltage or
716 * set_suspend_mode callback.
Mark Brown638f85c2009-10-22 16:31:33 +0100717 */
718 if (!rstate->enabled && !rstate->disabled) {
Axel Lin8ac0e952012-04-14 09:14:34 +0800719 if (rdev->desc->ops->set_suspend_voltage ||
720 rdev->desc->ops->set_suspend_mode)
Joe Perches5da84fd2010-11-30 05:53:48 -0800721 rdev_warn(rdev, "No configuration\n");
Mark Brown638f85c2009-10-22 16:31:33 +0100722 return 0;
723 }
724
725 if (rstate->enabled && rstate->disabled) {
Joe Perches5da84fd2010-11-30 05:53:48 -0800726 rdev_err(rdev, "invalid configuration\n");
Mark Brown638f85c2009-10-22 16:31:33 +0100727 return -EINVAL;
728 }
729
Axel Lin8ac0e952012-04-14 09:14:34 +0800730 if (rstate->enabled && rdev->desc->ops->set_suspend_enable)
Liam Girdwood414c70c2008-04-30 15:59:04 +0100731 ret = rdev->desc->ops->set_suspend_enable(rdev);
Axel Lin8ac0e952012-04-14 09:14:34 +0800732 else if (rstate->disabled && rdev->desc->ops->set_suspend_disable)
Liam Girdwood414c70c2008-04-30 15:59:04 +0100733 ret = rdev->desc->ops->set_suspend_disable(rdev);
Axel Lin8ac0e952012-04-14 09:14:34 +0800734 else /* OK if set_suspend_enable or set_suspend_disable is NULL */
735 ret = 0;
736
Liam Girdwood414c70c2008-04-30 15:59:04 +0100737 if (ret < 0) {
Joe Perches5da84fd2010-11-30 05:53:48 -0800738 rdev_err(rdev, "failed to enabled/disable\n");
Liam Girdwood414c70c2008-04-30 15:59:04 +0100739 return ret;
740 }
741
742 if (rdev->desc->ops->set_suspend_voltage && rstate->uV > 0) {
743 ret = rdev->desc->ops->set_suspend_voltage(rdev, rstate->uV);
744 if (ret < 0) {
Joe Perches5da84fd2010-11-30 05:53:48 -0800745 rdev_err(rdev, "failed to set voltage\n");
Liam Girdwood414c70c2008-04-30 15:59:04 +0100746 return ret;
747 }
748 }
749
750 if (rdev->desc->ops->set_suspend_mode && rstate->mode > 0) {
751 ret = rdev->desc->ops->set_suspend_mode(rdev, rstate->mode);
752 if (ret < 0) {
Joe Perches5da84fd2010-11-30 05:53:48 -0800753 rdev_err(rdev, "failed to set mode\n");
Liam Girdwood414c70c2008-04-30 15:59:04 +0100754 return ret;
755 }
756 }
757 return ret;
758}
759
760/* locks held by caller */
761static int suspend_prepare(struct regulator_dev *rdev, suspend_state_t state)
762{
763 if (!rdev->constraints)
764 return -EINVAL;
765
766 switch (state) {
767 case PM_SUSPEND_STANDBY:
768 return suspend_set_state(rdev,
769 &rdev->constraints->state_standby);
770 case PM_SUSPEND_MEM:
771 return suspend_set_state(rdev,
772 &rdev->constraints->state_mem);
773 case PM_SUSPEND_MAX:
774 return suspend_set_state(rdev,
775 &rdev->constraints->state_disk);
776 default:
777 return -EINVAL;
778 }
779}
780
781static void print_constraints(struct regulator_dev *rdev)
782{
783 struct regulation_constraints *constraints = rdev->constraints;
Mark Brown973e9a22010-02-11 19:20:48 +0000784 char buf[80] = "";
Mark Brown8f031b42009-10-22 16:31:31 +0100785 int count = 0;
786 int ret;
Liam Girdwood414c70c2008-04-30 15:59:04 +0100787
Mark Brown8f031b42009-10-22 16:31:31 +0100788 if (constraints->min_uV && constraints->max_uV) {
Liam Girdwood414c70c2008-04-30 15:59:04 +0100789 if (constraints->min_uV == constraints->max_uV)
Mark Brown8f031b42009-10-22 16:31:31 +0100790 count += sprintf(buf + count, "%d mV ",
791 constraints->min_uV / 1000);
Liam Girdwood414c70c2008-04-30 15:59:04 +0100792 else
Mark Brown8f031b42009-10-22 16:31:31 +0100793 count += sprintf(buf + count, "%d <--> %d mV ",
794 constraints->min_uV / 1000,
795 constraints->max_uV / 1000);
Liam Girdwood414c70c2008-04-30 15:59:04 +0100796 }
Mark Brown8f031b42009-10-22 16:31:31 +0100797
798 if (!constraints->min_uV ||
799 constraints->min_uV != constraints->max_uV) {
800 ret = _regulator_get_voltage(rdev);
801 if (ret > 0)
802 count += sprintf(buf + count, "at %d mV ", ret / 1000);
803 }
804
Mark Brownbf5892a2011-05-08 22:13:37 +0100805 if (constraints->uV_offset)
806 count += sprintf(buf, "%dmV offset ",
807 constraints->uV_offset / 1000);
808
Mark Brown8f031b42009-10-22 16:31:31 +0100809 if (constraints->min_uA && constraints->max_uA) {
810 if (constraints->min_uA == constraints->max_uA)
811 count += sprintf(buf + count, "%d mA ",
812 constraints->min_uA / 1000);
813 else
814 count += sprintf(buf + count, "%d <--> %d mA ",
815 constraints->min_uA / 1000,
816 constraints->max_uA / 1000);
817 }
818
819 if (!constraints->min_uA ||
820 constraints->min_uA != constraints->max_uA) {
821 ret = _regulator_get_current_limit(rdev);
822 if (ret > 0)
Cyril Chemparathye4a63762010-09-22 12:30:15 -0400823 count += sprintf(buf + count, "at %d mA ", ret / 1000);
Mark Brown8f031b42009-10-22 16:31:31 +0100824 }
825
Liam Girdwood414c70c2008-04-30 15:59:04 +0100826 if (constraints->valid_modes_mask & REGULATOR_MODE_FAST)
827 count += sprintf(buf + count, "fast ");
828 if (constraints->valid_modes_mask & REGULATOR_MODE_NORMAL)
829 count += sprintf(buf + count, "normal ");
830 if (constraints->valid_modes_mask & REGULATOR_MODE_IDLE)
831 count += sprintf(buf + count, "idle ");
832 if (constraints->valid_modes_mask & REGULATOR_MODE_STANDBY)
833 count += sprintf(buf + count, "standby");
834
Uwe Kleine-König215b8b02012-08-07 21:01:37 +0200835 if (!count)
836 sprintf(buf, "no parameters");
837
Mark Brown194dbae2014-10-31 19:11:59 +0000838 rdev_dbg(rdev, "%s\n", buf);
Mark Brown4a682922012-02-09 13:26:13 +0000839
840 if ((constraints->min_uV != constraints->max_uV) &&
841 !(constraints->valid_ops_mask & REGULATOR_CHANGE_VOLTAGE))
842 rdev_warn(rdev,
843 "Voltage range but no REGULATOR_CHANGE_VOLTAGE\n");
Liam Girdwood414c70c2008-04-30 15:59:04 +0100844}
845
Mark Browne79055d2009-10-19 15:53:50 +0100846static int machine_constraints_voltage(struct regulator_dev *rdev,
Mark Brown1083c392009-10-22 16:31:32 +0100847 struct regulation_constraints *constraints)
Mark Browne79055d2009-10-19 15:53:50 +0100848{
Guodong Xu272e2312014-08-13 19:33:38 +0800849 const struct regulator_ops *ops = rdev->desc->ops;
Mark Brownaf5866c2009-10-22 16:31:30 +0100850 int ret;
851
852 /* do we need to apply the constraint voltage */
853 if (rdev->constraints->apply_uV &&
Mark Brown75790252010-12-12 14:25:50 +0000854 rdev->constraints->min_uV == rdev->constraints->max_uV) {
Alban Bedel064d5cd2014-05-20 12:12:16 +0200855 int current_uV = _regulator_get_voltage(rdev);
856 if (current_uV < 0) {
Nishanth Menon69d58832014-06-04 14:53:25 -0500857 rdev_err(rdev,
858 "failed to get the current voltage(%d)\n",
859 current_uV);
Alban Bedel064d5cd2014-05-20 12:12:16 +0200860 return current_uV;
861 }
862 if (current_uV < rdev->constraints->min_uV ||
863 current_uV > rdev->constraints->max_uV) {
864 ret = _regulator_do_set_voltage(
865 rdev, rdev->constraints->min_uV,
866 rdev->constraints->max_uV);
867 if (ret < 0) {
868 rdev_err(rdev,
Nishanth Menon69d58832014-06-04 14:53:25 -0500869 "failed to apply %duV constraint(%d)\n",
870 rdev->constraints->min_uV, ret);
Alban Bedel064d5cd2014-05-20 12:12:16 +0200871 return ret;
872 }
Mark Brown75790252010-12-12 14:25:50 +0000873 }
Mark Brownaf5866c2009-10-22 16:31:30 +0100874 }
Mark Browne79055d2009-10-19 15:53:50 +0100875
876 /* constrain machine-level voltage specs to fit
877 * the actual range supported by this regulator.
878 */
879 if (ops->list_voltage && rdev->desc->n_voltages) {
880 int count = rdev->desc->n_voltages;
881 int i;
882 int min_uV = INT_MAX;
883 int max_uV = INT_MIN;
884 int cmin = constraints->min_uV;
885 int cmax = constraints->max_uV;
886
887 /* it's safe to autoconfigure fixed-voltage supplies
888 and the constraints are used by list_voltage. */
889 if (count == 1 && !cmin) {
890 cmin = 1;
891 cmax = INT_MAX;
892 constraints->min_uV = cmin;
893 constraints->max_uV = cmax;
894 }
895
896 /* voltage constraints are optional */
897 if ((cmin == 0) && (cmax == 0))
898 return 0;
899
900 /* else require explicit machine-level constraints */
901 if (cmin <= 0 || cmax <= 0 || cmax < cmin) {
Joe Perches5da84fd2010-11-30 05:53:48 -0800902 rdev_err(rdev, "invalid voltage constraints\n");
Mark Browne79055d2009-10-19 15:53:50 +0100903 return -EINVAL;
904 }
905
906 /* initial: [cmin..cmax] valid, [min_uV..max_uV] not */
907 for (i = 0; i < count; i++) {
908 int value;
909
910 value = ops->list_voltage(rdev, i);
911 if (value <= 0)
912 continue;
913
914 /* maybe adjust [min_uV..max_uV] */
915 if (value >= cmin && value < min_uV)
916 min_uV = value;
917 if (value <= cmax && value > max_uV)
918 max_uV = value;
919 }
920
921 /* final: [min_uV..max_uV] valid iff constraints valid */
922 if (max_uV < min_uV) {
Mark Brownfff15be2012-11-27 18:48:56 +0000923 rdev_err(rdev,
924 "unsupportable voltage constraints %u-%uuV\n",
925 min_uV, max_uV);
Mark Browne79055d2009-10-19 15:53:50 +0100926 return -EINVAL;
927 }
928
929 /* use regulator's subset of machine constraints */
930 if (constraints->min_uV < min_uV) {
Joe Perches5da84fd2010-11-30 05:53:48 -0800931 rdev_dbg(rdev, "override min_uV, %d -> %d\n",
932 constraints->min_uV, min_uV);
Mark Browne79055d2009-10-19 15:53:50 +0100933 constraints->min_uV = min_uV;
934 }
935 if (constraints->max_uV > max_uV) {
Joe Perches5da84fd2010-11-30 05:53:48 -0800936 rdev_dbg(rdev, "override max_uV, %d -> %d\n",
937 constraints->max_uV, max_uV);
Mark Browne79055d2009-10-19 15:53:50 +0100938 constraints->max_uV = max_uV;
939 }
940 }
941
942 return 0;
943}
944
Laxman Dewanganf8c17002013-09-20 13:13:02 +0530945static int machine_constraints_current(struct regulator_dev *rdev,
946 struct regulation_constraints *constraints)
947{
Guodong Xu272e2312014-08-13 19:33:38 +0800948 const struct regulator_ops *ops = rdev->desc->ops;
Laxman Dewanganf8c17002013-09-20 13:13:02 +0530949 int ret;
950
951 if (!constraints->min_uA && !constraints->max_uA)
952 return 0;
953
954 if (constraints->min_uA > constraints->max_uA) {
955 rdev_err(rdev, "Invalid current constraints\n");
956 return -EINVAL;
957 }
958
959 if (!ops->set_current_limit || !ops->get_current_limit) {
960 rdev_warn(rdev, "Operation of current configuration missing\n");
961 return 0;
962 }
963
964 /* Set regulator current in constraints range */
965 ret = ops->set_current_limit(rdev, constraints->min_uA,
966 constraints->max_uA);
967 if (ret < 0) {
968 rdev_err(rdev, "Failed to set current constraint, %d\n", ret);
969 return ret;
970 }
971
972 return 0;
973}
974
Markus Pargmann30c21972014-02-20 17:36:03 +0100975static int _regulator_do_enable(struct regulator_dev *rdev);
976
Liam Girdwooda5766f12008-10-10 13:22:20 +0100977/**
978 * set_machine_constraints - sets regulator constraints
Mark Brown69279fb2008-12-31 12:52:41 +0000979 * @rdev: regulator source
Mark Brownc8e7e462008-12-31 12:52:42 +0000980 * @constraints: constraints to apply
Liam Girdwooda5766f12008-10-10 13:22:20 +0100981 *
982 * Allows platform initialisation code to define and constrain
983 * regulator circuits e.g. valid voltage/current ranges, etc. NOTE:
984 * Constraints *must* be set by platform code in order for some
985 * regulator operations to proceed i.e. set_voltage, set_current_limit,
986 * set_mode.
987 */
988static int set_machine_constraints(struct regulator_dev *rdev,
Mark Brownf8c12fe2010-11-29 15:55:17 +0000989 const struct regulation_constraints *constraints)
Liam Girdwooda5766f12008-10-10 13:22:20 +0100990{
991 int ret = 0;
Guodong Xu272e2312014-08-13 19:33:38 +0800992 const struct regulator_ops *ops = rdev->desc->ops;
Mark Browne06f5b42008-09-09 16:21:19 +0100993
Mark Brown9a8f5e02011-11-29 18:11:19 +0000994 if (constraints)
995 rdev->constraints = kmemdup(constraints, sizeof(*constraints),
996 GFP_KERNEL);
997 else
998 rdev->constraints = kzalloc(sizeof(*constraints),
999 GFP_KERNEL);
Mark Brownf8c12fe2010-11-29 15:55:17 +00001000 if (!rdev->constraints)
1001 return -ENOMEM;
Mark Brownaf5866c2009-10-22 16:31:30 +01001002
Mark Brownf8c12fe2010-11-29 15:55:17 +00001003 ret = machine_constraints_voltage(rdev, rdev->constraints);
Mark Browne79055d2009-10-19 15:53:50 +01001004 if (ret != 0)
1005 goto out;
David Brownell4367cfd2009-02-26 11:48:36 -08001006
Laxman Dewanganf8c17002013-09-20 13:13:02 +05301007 ret = machine_constraints_current(rdev, rdev->constraints);
1008 if (ret != 0)
1009 goto out;
1010
Liam Girdwooda5766f12008-10-10 13:22:20 +01001011 /* do we need to setup our suspend state */
Mark Brown9a8f5e02011-11-29 18:11:19 +00001012 if (rdev->constraints->initial_state) {
Mark Brownf8c12fe2010-11-29 15:55:17 +00001013 ret = suspend_prepare(rdev, rdev->constraints->initial_state);
Mark Browne06f5b42008-09-09 16:21:19 +01001014 if (ret < 0) {
Joe Perches5da84fd2010-11-30 05:53:48 -08001015 rdev_err(rdev, "failed to set suspend state\n");
Mark Browne06f5b42008-09-09 16:21:19 +01001016 goto out;
1017 }
1018 }
Liam Girdwooda5766f12008-10-10 13:22:20 +01001019
Mark Brown9a8f5e02011-11-29 18:11:19 +00001020 if (rdev->constraints->initial_mode) {
Mark Browna3084662009-02-26 19:24:19 +00001021 if (!ops->set_mode) {
Joe Perches5da84fd2010-11-30 05:53:48 -08001022 rdev_err(rdev, "no set_mode operation\n");
Mark Browna3084662009-02-26 19:24:19 +00001023 ret = -EINVAL;
1024 goto out;
1025 }
1026
Mark Brownf8c12fe2010-11-29 15:55:17 +00001027 ret = ops->set_mode(rdev, rdev->constraints->initial_mode);
Mark Browna3084662009-02-26 19:24:19 +00001028 if (ret < 0) {
Joe Perches5da84fd2010-11-30 05:53:48 -08001029 rdev_err(rdev, "failed to set initial mode: %d\n", ret);
Mark Browna3084662009-02-26 19:24:19 +00001030 goto out;
1031 }
1032 }
1033
Mark Browncacf90f2009-03-02 16:32:46 +00001034 /* If the constraints say the regulator should be on at this point
1035 * and we have control then make sure it is enabled.
1036 */
Markus Pargmann30c21972014-02-20 17:36:03 +01001037 if (rdev->constraints->always_on || rdev->constraints->boot_on) {
1038 ret = _regulator_do_enable(rdev);
1039 if (ret < 0 && ret != -EINVAL) {
Joe Perches5da84fd2010-11-30 05:53:48 -08001040 rdev_err(rdev, "failed to enable\n");
Mark Browne5fda262008-09-09 16:21:20 +01001041 goto out;
1042 }
1043 }
1044
Yadwinder Singh Brar1653ccf2013-06-29 18:21:15 +05301045 if ((rdev->constraints->ramp_delay || rdev->constraints->ramp_disable)
1046 && ops->set_ramp_delay) {
Yadwinder Singh Brar6f0b2c62012-06-11 17:41:08 +05301047 ret = ops->set_ramp_delay(rdev, rdev->constraints->ramp_delay);
1048 if (ret < 0) {
1049 rdev_err(rdev, "failed to set ramp_delay\n");
1050 goto out;
1051 }
1052 }
1053
Stephen Boyd23c779b2015-06-11 17:37:04 -07001054 if (rdev->constraints->pull_down && ops->set_pull_down) {
1055 ret = ops->set_pull_down(rdev);
1056 if (ret < 0) {
1057 rdev_err(rdev, "failed to set pull down\n");
1058 goto out;
1059 }
1060 }
1061
Liam Girdwooda5766f12008-10-10 13:22:20 +01001062 print_constraints(rdev);
Axel Lin1a6958e72011-07-15 10:50:43 +08001063 return 0;
Liam Girdwooda5766f12008-10-10 13:22:20 +01001064out:
Axel Lin1a6958e72011-07-15 10:50:43 +08001065 kfree(rdev->constraints);
1066 rdev->constraints = NULL;
Liam Girdwooda5766f12008-10-10 13:22:20 +01001067 return ret;
1068}
1069
1070/**
1071 * set_supply - set regulator supply regulator
Mark Brown69279fb2008-12-31 12:52:41 +00001072 * @rdev: regulator name
1073 * @supply_rdev: supply regulator name
Liam Girdwooda5766f12008-10-10 13:22:20 +01001074 *
1075 * Called by platform initialisation code to set the supply regulator for this
1076 * regulator. This ensures that a regulators supply will also be enabled by the
1077 * core if it's child is enabled.
1078 */
1079static int set_supply(struct regulator_dev *rdev,
Mark Brown3801b862011-06-09 16:22:22 +01001080 struct regulator_dev *supply_rdev)
Liam Girdwooda5766f12008-10-10 13:22:20 +01001081{
1082 int err;
1083
Mark Brown3801b862011-06-09 16:22:22 +01001084 rdev_info(rdev, "supplied by %s\n", rdev_get_name(supply_rdev));
1085
1086 rdev->supply = create_regulator(supply_rdev, &rdev->dev, "SUPPLY");
Axel Lin32c78de2011-12-29 17:03:20 +08001087 if (rdev->supply == NULL) {
1088 err = -ENOMEM;
Mark Brown3801b862011-06-09 16:22:22 +01001089 return err;
Liam Girdwooda5766f12008-10-10 13:22:20 +01001090 }
Laxman Dewangan57ad526a2012-07-23 20:35:46 +05301091 supply_rdev->open_count++;
Mark Brown3801b862011-06-09 16:22:22 +01001092
1093 return 0;
Liam Girdwooda5766f12008-10-10 13:22:20 +01001094}
1095
1096/**
Randy Dunlap06c63f92010-11-18 15:02:26 -08001097 * set_consumer_device_supply - Bind a regulator to a symbolic supply
Mark Brown69279fb2008-12-31 12:52:41 +00001098 * @rdev: regulator source
Mark Brown40f92442009-06-17 17:56:39 +01001099 * @consumer_dev_name: dev_name() string for device supply applies to
Mark Brown69279fb2008-12-31 12:52:41 +00001100 * @supply: symbolic name for supply
Liam Girdwooda5766f12008-10-10 13:22:20 +01001101 *
1102 * Allows platform initialisation code to map physical regulator
1103 * sources to symbolic names for supplies for use by devices. Devices
1104 * should use these symbolic names to request regulators, avoiding the
1105 * need to provide board-specific regulator names as platform data.
1106 */
1107static int set_consumer_device_supply(struct regulator_dev *rdev,
Mark Brown737f3602012-02-02 00:10:51 +00001108 const char *consumer_dev_name,
1109 const char *supply)
Liam Girdwooda5766f12008-10-10 13:22:20 +01001110{
1111 struct regulator_map *node;
Mark Brown9ed20992009-07-21 16:00:26 +01001112 int has_dev;
Liam Girdwooda5766f12008-10-10 13:22:20 +01001113
1114 if (supply == NULL)
1115 return -EINVAL;
1116
Mark Brown9ed20992009-07-21 16:00:26 +01001117 if (consumer_dev_name != NULL)
1118 has_dev = 1;
1119 else
1120 has_dev = 0;
1121
David Brownell6001e132008-12-31 12:54:19 +00001122 list_for_each_entry(node, &regulator_map_list, list) {
Jani Nikula23b5cc22010-04-29 10:55:09 +03001123 if (node->dev_name && consumer_dev_name) {
1124 if (strcmp(node->dev_name, consumer_dev_name) != 0)
1125 continue;
1126 } else if (node->dev_name || consumer_dev_name) {
David Brownell6001e132008-12-31 12:54:19 +00001127 continue;
Jani Nikula23b5cc22010-04-29 10:55:09 +03001128 }
1129
David Brownell6001e132008-12-31 12:54:19 +00001130 if (strcmp(node->supply, supply) != 0)
1131 continue;
1132
Mark Brown737f3602012-02-02 00:10:51 +00001133 pr_debug("%s: %s/%s is '%s' supply; fail %s/%s\n",
1134 consumer_dev_name,
1135 dev_name(&node->regulator->dev),
1136 node->regulator->desc->name,
1137 supply,
1138 dev_name(&rdev->dev), rdev_get_name(rdev));
David Brownell6001e132008-12-31 12:54:19 +00001139 return -EBUSY;
1140 }
1141
Mark Brown9ed20992009-07-21 16:00:26 +01001142 node = kzalloc(sizeof(struct regulator_map), GFP_KERNEL);
Liam Girdwooda5766f12008-10-10 13:22:20 +01001143 if (node == NULL)
1144 return -ENOMEM;
1145
1146 node->regulator = rdev;
Liam Girdwooda5766f12008-10-10 13:22:20 +01001147 node->supply = supply;
1148
Mark Brown9ed20992009-07-21 16:00:26 +01001149 if (has_dev) {
1150 node->dev_name = kstrdup(consumer_dev_name, GFP_KERNEL);
1151 if (node->dev_name == NULL) {
1152 kfree(node);
1153 return -ENOMEM;
1154 }
Mark Brown40f92442009-06-17 17:56:39 +01001155 }
1156
Liam Girdwooda5766f12008-10-10 13:22:20 +01001157 list_add(&node->list, &regulator_map_list);
1158 return 0;
1159}
1160
Mike Rapoport0f1d7472009-01-22 16:00:29 +02001161static void unset_regulator_supplies(struct regulator_dev *rdev)
1162{
1163 struct regulator_map *node, *n;
1164
1165 list_for_each_entry_safe(node, n, &regulator_map_list, list) {
1166 if (rdev == node->regulator) {
1167 list_del(&node->list);
Mark Brown40f92442009-06-17 17:56:39 +01001168 kfree(node->dev_name);
Mike Rapoport0f1d7472009-01-22 16:00:29 +02001169 kfree(node);
Mike Rapoport0f1d7472009-01-22 16:00:29 +02001170 }
1171 }
1172}
1173
Mark Brownf5726ae2011-06-09 16:22:20 +01001174#define REG_STR_SIZE 64
Liam Girdwood414c70c2008-04-30 15:59:04 +01001175
1176static struct regulator *create_regulator(struct regulator_dev *rdev,
1177 struct device *dev,
1178 const char *supply_name)
1179{
1180 struct regulator *regulator;
1181 char buf[REG_STR_SIZE];
1182 int err, size;
1183
1184 regulator = kzalloc(sizeof(*regulator), GFP_KERNEL);
1185 if (regulator == NULL)
1186 return NULL;
1187
1188 mutex_lock(&rdev->mutex);
1189 regulator->rdev = rdev;
1190 list_add(&regulator->list, &rdev->consumer_list);
1191
1192 if (dev) {
Shawn Guoe2c98ea2012-07-05 14:19:42 +08001193 regulator->dev = dev;
1194
Mark Brown222cc7b2012-06-22 11:39:16 +01001195 /* Add a link to the device sysfs entry */
Liam Girdwood414c70c2008-04-30 15:59:04 +01001196 size = scnprintf(buf, REG_STR_SIZE, "%s-%s",
1197 dev->kobj.name, supply_name);
1198 if (size >= REG_STR_SIZE)
Mark Brown222cc7b2012-06-22 11:39:16 +01001199 goto overflow_err;
Liam Girdwood414c70c2008-04-30 15:59:04 +01001200
1201 regulator->supply_name = kstrdup(buf, GFP_KERNEL);
1202 if (regulator->supply_name == NULL)
Mark Brown222cc7b2012-06-22 11:39:16 +01001203 goto overflow_err;
Liam Girdwood414c70c2008-04-30 15:59:04 +01001204
1205 err = sysfs_create_link(&rdev->dev.kobj, &dev->kobj,
1206 buf);
1207 if (err) {
Joe Perches5da84fd2010-11-30 05:53:48 -08001208 rdev_warn(rdev, "could not add device link %s err %d\n",
1209 dev->kobj.name, err);
Mark Brown222cc7b2012-06-22 11:39:16 +01001210 /* non-fatal */
Liam Girdwood414c70c2008-04-30 15:59:04 +01001211 }
Mark Brown5de70512011-06-19 13:33:16 +01001212 } else {
1213 regulator->supply_name = kstrdup(supply_name, GFP_KERNEL);
1214 if (regulator->supply_name == NULL)
Mark Brown222cc7b2012-06-22 11:39:16 +01001215 goto overflow_err;
Liam Girdwood414c70c2008-04-30 15:59:04 +01001216 }
Mark Brown5de70512011-06-19 13:33:16 +01001217
Mark Brown5de70512011-06-19 13:33:16 +01001218 regulator->debugfs = debugfs_create_dir(regulator->supply_name,
1219 rdev->debugfs);
Stephen Boyd24751432012-02-20 22:50:42 -08001220 if (!regulator->debugfs) {
Mark Brown5de70512011-06-19 13:33:16 +01001221 rdev_warn(rdev, "Failed to create debugfs directory\n");
Mark Brown5de70512011-06-19 13:33:16 +01001222 } else {
1223 debugfs_create_u32("uA_load", 0444, regulator->debugfs,
1224 &regulator->uA_load);
1225 debugfs_create_u32("min_uV", 0444, regulator->debugfs,
1226 &regulator->min_uV);
1227 debugfs_create_u32("max_uV", 0444, regulator->debugfs,
1228 &regulator->max_uV);
1229 }
Mark Brown5de70512011-06-19 13:33:16 +01001230
Mark Brown6492bc12012-04-19 13:19:07 +01001231 /*
1232 * Check now if the regulator is an always on regulator - if
1233 * it is then we don't need to do nearly so much work for
1234 * enable/disable calls.
1235 */
1236 if (!_regulator_can_change_status(rdev) &&
1237 _regulator_is_enabled(rdev))
1238 regulator->always_on = true;
1239
Liam Girdwood414c70c2008-04-30 15:59:04 +01001240 mutex_unlock(&rdev->mutex);
1241 return regulator;
Liam Girdwood414c70c2008-04-30 15:59:04 +01001242overflow_err:
1243 list_del(&regulator->list);
1244 kfree(regulator);
1245 mutex_unlock(&rdev->mutex);
1246 return NULL;
1247}
1248
Mark Brown31aae2b2009-12-21 12:21:52 +00001249static int _regulator_get_enable_time(struct regulator_dev *rdev)
1250{
Laxman Dewangan00c877c2013-09-18 18:18:02 +05301251 if (rdev->constraints && rdev->constraints->enable_time)
1252 return rdev->constraints->enable_time;
Mark Brown31aae2b2009-12-21 12:21:52 +00001253 if (!rdev->desc->ops->enable_time)
Mark Brown79511ed2012-06-27 14:23:10 +01001254 return rdev->desc->enable_time;
Mark Brown31aae2b2009-12-21 12:21:52 +00001255 return rdev->desc->ops->enable_time(rdev);
1256}
1257
Charles Keepaxa06ccd92013-10-15 20:14:20 +01001258static struct regulator_supply_alias *regulator_find_supply_alias(
1259 struct device *dev, const char *supply)
1260{
1261 struct regulator_supply_alias *map;
1262
1263 list_for_each_entry(map, &regulator_supply_alias_list, list)
1264 if (map->src_dev == dev && strcmp(map->src_supply, supply) == 0)
1265 return map;
1266
1267 return NULL;
1268}
1269
1270static void regulator_supply_alias(struct device **dev, const char **supply)
1271{
1272 struct regulator_supply_alias *map;
1273
1274 map = regulator_find_supply_alias(*dev, *supply);
1275 if (map) {
1276 dev_dbg(*dev, "Mapping supply %s to %s,%s\n",
1277 *supply, map->alias_supply,
1278 dev_name(map->alias_dev));
1279 *dev = map->alias_dev;
1280 *supply = map->alias_supply;
1281 }
1282}
1283
Rajendra Nayak69511a42011-11-18 16:47:20 +05301284static struct regulator_dev *regulator_dev_lookup(struct device *dev,
Mark Brown6d191a52012-03-29 14:19:02 +01001285 const char *supply,
1286 int *ret)
Rajendra Nayak69511a42011-11-18 16:47:20 +05301287{
1288 struct regulator_dev *r;
1289 struct device_node *node;
Mark Brown576ca4362012-03-30 12:24:37 +01001290 struct regulator_map *map;
1291 const char *devname = NULL;
Rajendra Nayak69511a42011-11-18 16:47:20 +05301292
Charles Keepaxa06ccd92013-10-15 20:14:20 +01001293 regulator_supply_alias(&dev, &supply);
1294
Rajendra Nayak69511a42011-11-18 16:47:20 +05301295 /* first do a dt based lookup */
1296 if (dev && dev->of_node) {
1297 node = of_get_regulator(dev, supply);
Mark Brown6d191a52012-03-29 14:19:02 +01001298 if (node) {
Rajendra Nayak69511a42011-11-18 16:47:20 +05301299 list_for_each_entry(r, &regulator_list, list)
1300 if (r->dev.parent &&
1301 node == r->dev.of_node)
1302 return r;
Mark Brown317b5682014-01-27 17:34:07 +00001303 *ret = -EPROBE_DEFER;
1304 return NULL;
Mark Brown6d191a52012-03-29 14:19:02 +01001305 } else {
1306 /*
1307 * If we couldn't even get the node then it's
1308 * not just that the device didn't register
1309 * yet, there's no node and we'll never
1310 * succeed.
1311 */
1312 *ret = -ENODEV;
1313 }
Rajendra Nayak69511a42011-11-18 16:47:20 +05301314 }
1315
1316 /* if not found, try doing it non-dt way */
Mark Brown576ca4362012-03-30 12:24:37 +01001317 if (dev)
1318 devname = dev_name(dev);
1319
Rajendra Nayak69511a42011-11-18 16:47:20 +05301320 list_for_each_entry(r, &regulator_list, list)
1321 if (strcmp(rdev_get_name(r), supply) == 0)
1322 return r;
1323
Mark Brown576ca4362012-03-30 12:24:37 +01001324 list_for_each_entry(map, &regulator_map_list, list) {
1325 /* If the mapping has a device set up it must match */
1326 if (map->dev_name &&
1327 (!devname || strcmp(map->dev_name, devname)))
1328 continue;
1329
1330 if (strcmp(map->supply, supply) == 0)
1331 return map->regulator;
1332 }
1333
1334
Rajendra Nayak69511a42011-11-18 16:47:20 +05301335 return NULL;
1336}
1337
Bjorn Andersson6261b062015-03-24 18:56:05 -07001338static int regulator_resolve_supply(struct regulator_dev *rdev)
1339{
1340 struct regulator_dev *r;
1341 struct device *dev = rdev->dev.parent;
1342 int ret;
1343
1344 /* No supply to resovle? */
1345 if (!rdev->supply_name)
1346 return 0;
1347
1348 /* Supply already resolved? */
1349 if (rdev->supply)
1350 return 0;
1351
1352 r = regulator_dev_lookup(dev, rdev->supply_name, &ret);
1353 if (ret == -ENODEV) {
1354 /*
1355 * No supply was specified for this regulator and
1356 * there will never be one.
1357 */
1358 return 0;
1359 }
1360
1361 if (!r) {
1362 dev_err(dev, "Failed to resolve %s-supply for %s\n",
1363 rdev->supply_name, rdev->desc->name);
1364 return -EPROBE_DEFER;
1365 }
1366
1367 /* Recursively resolve the supply of the supply */
1368 ret = regulator_resolve_supply(r);
1369 if (ret < 0)
1370 return ret;
1371
1372 ret = set_supply(rdev, r);
1373 if (ret < 0)
1374 return ret;
1375
1376 /* Cascade always-on state to supply */
1377 if (_regulator_is_enabled(rdev)) {
1378 ret = regulator_enable(rdev->supply);
1379 if (ret < 0)
1380 return ret;
1381 }
1382
1383 return 0;
1384}
1385
Mark Brown5ffbd132009-07-21 16:00:23 +01001386/* Internal regulator request function */
1387static struct regulator *_regulator_get(struct device *dev, const char *id,
Mark Brown4ddfebd2013-09-13 19:50:37 +01001388 bool exclusive, bool allow_dummy)
Liam Girdwood414c70c2008-04-30 15:59:04 +01001389{
1390 struct regulator_dev *rdev;
Mark Brown04bf3012012-03-11 13:07:56 +00001391 struct regulator *regulator = ERR_PTR(-EPROBE_DEFER);
Mark Brown40f92442009-06-17 17:56:39 +01001392 const char *devname = NULL;
Mark Brown317b5682014-01-27 17:34:07 +00001393 int ret;
Liam Girdwood414c70c2008-04-30 15:59:04 +01001394
1395 if (id == NULL) {
Joe Perches5da84fd2010-11-30 05:53:48 -08001396 pr_err("get() with no identifier\n");
Mark Brown043c9982013-09-20 12:32:18 +01001397 return ERR_PTR(-EINVAL);
Liam Girdwood414c70c2008-04-30 15:59:04 +01001398 }
1399
Mark Brown40f92442009-06-17 17:56:39 +01001400 if (dev)
1401 devname = dev_name(dev);
1402
Mark Brown317b5682014-01-27 17:34:07 +00001403 if (have_full_constraints())
1404 ret = -ENODEV;
1405 else
1406 ret = -EPROBE_DEFER;
1407
Liam Girdwood414c70c2008-04-30 15:59:04 +01001408 mutex_lock(&regulator_list_mutex);
1409
Mark Brown6d191a52012-03-29 14:19:02 +01001410 rdev = regulator_dev_lookup(dev, id, &ret);
Rajendra Nayak69511a42011-11-18 16:47:20 +05301411 if (rdev)
1412 goto found;
1413
Mark Brownef60abb2013-09-23 16:12:52 +01001414 regulator = ERR_PTR(ret);
1415
Nishanth Menon1e4b5452013-04-16 16:45:16 -05001416 /*
1417 * If we have return value from dev_lookup fail, we do not expect to
1418 * succeed, so, quit with appropriate error value
1419 */
Jingoo Han0d25d092014-01-08 10:02:16 +09001420 if (ret && ret != -ENODEV)
Nishanth Menon1e4b5452013-04-16 16:45:16 -05001421 goto out;
Nishanth Menon1e4b5452013-04-16 16:45:16 -05001422
Mark Brown34abbd62010-02-12 10:18:08 +00001423 if (!devname)
1424 devname = "deviceless";
1425
Mark Brown4ddfebd2013-09-13 19:50:37 +01001426 /*
1427 * Assume that a regulator is physically present and enabled
1428 * even if it isn't hooked up and just provide a dummy.
Mark Brown34abbd62010-02-12 10:18:08 +00001429 */
Mark Brown87b28412013-11-27 16:13:10 +00001430 if (have_full_constraints() && allow_dummy) {
Joe Perches5da84fd2010-11-30 05:53:48 -08001431 pr_warn("%s supply %s not found, using dummy regulator\n",
1432 devname, id);
Mark Brown4ddfebd2013-09-13 19:50:37 +01001433
Mark Brown34abbd62010-02-12 10:18:08 +00001434 rdev = dummy_regulator_rdev;
1435 goto found;
Hans de Goede07817192013-12-17 16:24:57 +01001436 /* Don't log an error when called from regulator_get_optional() */
1437 } else if (!have_full_constraints() || exclusive) {
Shuah Khanacc3d5c2014-02-20 12:58:15 -07001438 dev_warn(dev, "dummy supplies not allowed\n");
Mark Brown34abbd62010-02-12 10:18:08 +00001439 }
Mark Brown34abbd62010-02-12 10:18:08 +00001440
Liam Girdwood414c70c2008-04-30 15:59:04 +01001441 mutex_unlock(&regulator_list_mutex);
1442 return regulator;
1443
1444found:
Mark Brown5ffbd132009-07-21 16:00:23 +01001445 if (rdev->exclusive) {
1446 regulator = ERR_PTR(-EPERM);
1447 goto out;
1448 }
1449
1450 if (exclusive && rdev->open_count) {
1451 regulator = ERR_PTR(-EBUSY);
1452 goto out;
1453 }
1454
Bjorn Andersson6261b062015-03-24 18:56:05 -07001455 ret = regulator_resolve_supply(rdev);
1456 if (ret < 0) {
1457 regulator = ERR_PTR(ret);
1458 goto out;
1459 }
1460
Liam Girdwooda5766f12008-10-10 13:22:20 +01001461 if (!try_module_get(rdev->owner))
1462 goto out;
1463
Liam Girdwood414c70c2008-04-30 15:59:04 +01001464 regulator = create_regulator(rdev, dev, id);
1465 if (regulator == NULL) {
1466 regulator = ERR_PTR(-ENOMEM);
1467 module_put(rdev->owner);
Axel Linbcda4322011-12-29 17:02:08 +08001468 goto out;
Liam Girdwood414c70c2008-04-30 15:59:04 +01001469 }
1470
Mark Brown5ffbd132009-07-21 16:00:23 +01001471 rdev->open_count++;
1472 if (exclusive) {
1473 rdev->exclusive = 1;
1474
1475 ret = _regulator_is_enabled(rdev);
1476 if (ret > 0)
1477 rdev->use_count = 1;
1478 else
1479 rdev->use_count = 0;
1480 }
1481
Liam Girdwooda5766f12008-10-10 13:22:20 +01001482out:
Liam Girdwood414c70c2008-04-30 15:59:04 +01001483 mutex_unlock(&regulator_list_mutex);
Mark Brown5ffbd132009-07-21 16:00:23 +01001484
Liam Girdwood414c70c2008-04-30 15:59:04 +01001485 return regulator;
1486}
Mark Brown5ffbd132009-07-21 16:00:23 +01001487
1488/**
1489 * regulator_get - lookup and obtain a reference to a regulator.
1490 * @dev: device for regulator "consumer"
1491 * @id: Supply name or regulator ID.
1492 *
1493 * Returns a struct regulator corresponding to the regulator producer,
1494 * or IS_ERR() condition containing errno.
1495 *
1496 * Use of supply names configured via regulator_set_device_supply() is
1497 * strongly encouraged. It is recommended that the supply name used
1498 * should match the name used for the supply and/or the relevant
1499 * device pins in the datasheet.
1500 */
1501struct regulator *regulator_get(struct device *dev, const char *id)
1502{
Mark Brown4ddfebd2013-09-13 19:50:37 +01001503 return _regulator_get(dev, id, false, true);
Mark Brown5ffbd132009-07-21 16:00:23 +01001504}
Liam Girdwood414c70c2008-04-30 15:59:04 +01001505EXPORT_SYMBOL_GPL(regulator_get);
1506
Stephen Boyd070b9072012-01-16 19:39:58 -08001507/**
Mark Brown5ffbd132009-07-21 16:00:23 +01001508 * regulator_get_exclusive - obtain exclusive access to a regulator.
1509 * @dev: device for regulator "consumer"
1510 * @id: Supply name or regulator ID.
1511 *
1512 * Returns a struct regulator corresponding to the regulator producer,
1513 * or IS_ERR() condition containing errno. Other consumers will be
Stephen Boyd69c3f722014-05-28 12:41:28 -07001514 * unable to obtain this regulator while this reference is held and the
1515 * use count for the regulator will be initialised to reflect the current
1516 * state of the regulator.
Mark Brown5ffbd132009-07-21 16:00:23 +01001517 *
1518 * This is intended for use by consumers which cannot tolerate shared
1519 * use of the regulator such as those which need to force the
1520 * regulator off for correct operation of the hardware they are
1521 * controlling.
1522 *
1523 * Use of supply names configured via regulator_set_device_supply() is
1524 * strongly encouraged. It is recommended that the supply name used
1525 * should match the name used for the supply and/or the relevant
1526 * device pins in the datasheet.
1527 */
1528struct regulator *regulator_get_exclusive(struct device *dev, const char *id)
1529{
Mark Brown4ddfebd2013-09-13 19:50:37 +01001530 return _regulator_get(dev, id, true, false);
Mark Brown5ffbd132009-07-21 16:00:23 +01001531}
1532EXPORT_SYMBOL_GPL(regulator_get_exclusive);
1533
Mark Brownde1dd9f2013-07-29 21:42:42 +01001534/**
1535 * regulator_get_optional - obtain optional access to a regulator.
1536 * @dev: device for regulator "consumer"
1537 * @id: Supply name or regulator ID.
1538 *
1539 * Returns a struct regulator corresponding to the regulator producer,
Stephen Boyd69c3f722014-05-28 12:41:28 -07001540 * or IS_ERR() condition containing errno.
Mark Brownde1dd9f2013-07-29 21:42:42 +01001541 *
1542 * This is intended for use by consumers for devices which can have
1543 * some supplies unconnected in normal use, such as some MMC devices.
1544 * It can allow the regulator core to provide stub supplies for other
1545 * supplies requested using normal regulator_get() calls without
1546 * disrupting the operation of drivers that can handle absent
1547 * supplies.
1548 *
1549 * Use of supply names configured via regulator_set_device_supply() is
1550 * strongly encouraged. It is recommended that the supply name used
1551 * should match the name used for the supply and/or the relevant
1552 * device pins in the datasheet.
1553 */
1554struct regulator *regulator_get_optional(struct device *dev, const char *id)
1555{
Mark Brown4ddfebd2013-09-13 19:50:37 +01001556 return _regulator_get(dev, id, false, false);
Mark Brownde1dd9f2013-07-29 21:42:42 +01001557}
1558EXPORT_SYMBOL_GPL(regulator_get_optional);
1559
Ashay Jaiswal83b03022015-01-08 18:54:25 +05301560/* regulator_list_mutex lock held by regulator_put() */
Charles Keepax23ff2f02012-11-14 09:39:31 +00001561static void _regulator_put(struct regulator *regulator)
Liam Girdwood414c70c2008-04-30 15:59:04 +01001562{
1563 struct regulator_dev *rdev;
1564
1565 if (regulator == NULL || IS_ERR(regulator))
1566 return;
1567
Liam Girdwood414c70c2008-04-30 15:59:04 +01001568 rdev = regulator->rdev;
1569
Mark Brown5de70512011-06-19 13:33:16 +01001570 debugfs_remove_recursive(regulator->debugfs);
Mark Brown5de70512011-06-19 13:33:16 +01001571
Liam Girdwood414c70c2008-04-30 15:59:04 +01001572 /* remove any sysfs entries */
Shawn Guoe2c98ea2012-07-05 14:19:42 +08001573 if (regulator->dev)
Liam Girdwood414c70c2008-04-30 15:59:04 +01001574 sysfs_remove_link(&rdev->dev.kobj, regulator->supply_name);
Ashay Jaiswal83b03022015-01-08 18:54:25 +05301575 mutex_lock(&rdev->mutex);
Mark Brown5de70512011-06-19 13:33:16 +01001576 kfree(regulator->supply_name);
Liam Girdwood414c70c2008-04-30 15:59:04 +01001577 list_del(&regulator->list);
1578 kfree(regulator);
1579
Mark Brown5ffbd132009-07-21 16:00:23 +01001580 rdev->open_count--;
1581 rdev->exclusive = 0;
Ashay Jaiswal83b03022015-01-08 18:54:25 +05301582 mutex_unlock(&rdev->mutex);
Mark Brown5ffbd132009-07-21 16:00:23 +01001583
Liam Girdwood414c70c2008-04-30 15:59:04 +01001584 module_put(rdev->owner);
Charles Keepax23ff2f02012-11-14 09:39:31 +00001585}
1586
1587/**
1588 * regulator_put - "free" the regulator source
1589 * @regulator: regulator source
1590 *
1591 * Note: drivers must ensure that all regulator_enable calls made on this
1592 * regulator source are balanced by regulator_disable calls prior to calling
1593 * this function.
1594 */
1595void regulator_put(struct regulator *regulator)
1596{
1597 mutex_lock(&regulator_list_mutex);
1598 _regulator_put(regulator);
Liam Girdwood414c70c2008-04-30 15:59:04 +01001599 mutex_unlock(&regulator_list_mutex);
1600}
1601EXPORT_SYMBOL_GPL(regulator_put);
1602
Charles Keepaxa06ccd92013-10-15 20:14:20 +01001603/**
1604 * regulator_register_supply_alias - Provide device alias for supply lookup
1605 *
1606 * @dev: device that will be given as the regulator "consumer"
1607 * @id: Supply name or regulator ID
1608 * @alias_dev: device that should be used to lookup the supply
1609 * @alias_id: Supply name or regulator ID that should be used to lookup the
1610 * supply
1611 *
1612 * All lookups for id on dev will instead be conducted for alias_id on
1613 * alias_dev.
1614 */
1615int regulator_register_supply_alias(struct device *dev, const char *id,
1616 struct device *alias_dev,
1617 const char *alias_id)
1618{
1619 struct regulator_supply_alias *map;
1620
1621 map = regulator_find_supply_alias(dev, id);
1622 if (map)
1623 return -EEXIST;
1624
1625 map = kzalloc(sizeof(struct regulator_supply_alias), GFP_KERNEL);
1626 if (!map)
1627 return -ENOMEM;
1628
1629 map->src_dev = dev;
1630 map->src_supply = id;
1631 map->alias_dev = alias_dev;
1632 map->alias_supply = alias_id;
1633
1634 list_add(&map->list, &regulator_supply_alias_list);
1635
1636 pr_info("Adding alias for supply %s,%s -> %s,%s\n",
1637 id, dev_name(dev), alias_id, dev_name(alias_dev));
1638
1639 return 0;
1640}
1641EXPORT_SYMBOL_GPL(regulator_register_supply_alias);
1642
1643/**
1644 * regulator_unregister_supply_alias - Remove device alias
1645 *
1646 * @dev: device that will be given as the regulator "consumer"
1647 * @id: Supply name or regulator ID
1648 *
1649 * Remove a lookup alias if one exists for id on dev.
1650 */
1651void regulator_unregister_supply_alias(struct device *dev, const char *id)
1652{
1653 struct regulator_supply_alias *map;
1654
1655 map = regulator_find_supply_alias(dev, id);
1656 if (map) {
1657 list_del(&map->list);
1658 kfree(map);
1659 }
1660}
1661EXPORT_SYMBOL_GPL(regulator_unregister_supply_alias);
1662
1663/**
1664 * regulator_bulk_register_supply_alias - register multiple aliases
1665 *
1666 * @dev: device that will be given as the regulator "consumer"
1667 * @id: List of supply names or regulator IDs
1668 * @alias_dev: device that should be used to lookup the supply
1669 * @alias_id: List of supply names or regulator IDs that should be used to
1670 * lookup the supply
1671 * @num_id: Number of aliases to register
1672 *
1673 * @return 0 on success, an errno on failure.
1674 *
1675 * This helper function allows drivers to register several supply
1676 * aliases in one operation. If any of the aliases cannot be
1677 * registered any aliases that were registered will be removed
1678 * before returning to the caller.
1679 */
Lee Jones9f8c0fe2014-05-23 16:44:10 +01001680int regulator_bulk_register_supply_alias(struct device *dev,
1681 const char *const *id,
Charles Keepaxa06ccd92013-10-15 20:14:20 +01001682 struct device *alias_dev,
Lee Jones9f8c0fe2014-05-23 16:44:10 +01001683 const char *const *alias_id,
Charles Keepaxa06ccd92013-10-15 20:14:20 +01001684 int num_id)
1685{
1686 int i;
1687 int ret;
1688
1689 for (i = 0; i < num_id; ++i) {
1690 ret = regulator_register_supply_alias(dev, id[i], alias_dev,
1691 alias_id[i]);
1692 if (ret < 0)
1693 goto err;
1694 }
1695
1696 return 0;
1697
1698err:
1699 dev_err(dev,
1700 "Failed to create supply alias %s,%s -> %s,%s\n",
1701 id[i], dev_name(dev), alias_id[i], dev_name(alias_dev));
1702
1703 while (--i >= 0)
1704 regulator_unregister_supply_alias(dev, id[i]);
1705
1706 return ret;
1707}
1708EXPORT_SYMBOL_GPL(regulator_bulk_register_supply_alias);
1709
1710/**
1711 * regulator_bulk_unregister_supply_alias - unregister multiple aliases
1712 *
1713 * @dev: device that will be given as the regulator "consumer"
1714 * @id: List of supply names or regulator IDs
1715 * @num_id: Number of aliases to unregister
1716 *
1717 * This helper function allows drivers to unregister several supply
1718 * aliases in one operation.
1719 */
1720void regulator_bulk_unregister_supply_alias(struct device *dev,
Lee Jones9f8c0fe2014-05-23 16:44:10 +01001721 const char *const *id,
Charles Keepaxa06ccd92013-10-15 20:14:20 +01001722 int num_id)
1723{
1724 int i;
1725
1726 for (i = 0; i < num_id; ++i)
1727 regulator_unregister_supply_alias(dev, id[i]);
1728}
1729EXPORT_SYMBOL_GPL(regulator_bulk_unregister_supply_alias);
1730
1731
Kim, Milof19b00d2013-02-18 06:50:39 +00001732/* Manage enable GPIO list. Same GPIO pin can be shared among regulators */
1733static int regulator_ena_gpio_request(struct regulator_dev *rdev,
1734 const struct regulator_config *config)
1735{
1736 struct regulator_enable_gpio *pin;
Russell King778b28b2014-06-29 17:55:54 +01001737 struct gpio_desc *gpiod;
Kim, Milof19b00d2013-02-18 06:50:39 +00001738 int ret;
1739
Russell King778b28b2014-06-29 17:55:54 +01001740 gpiod = gpio_to_desc(config->ena_gpio);
1741
Kim, Milof19b00d2013-02-18 06:50:39 +00001742 list_for_each_entry(pin, &regulator_ena_gpio_list, list) {
Russell King778b28b2014-06-29 17:55:54 +01001743 if (pin->gpiod == gpiod) {
Kim, Milof19b00d2013-02-18 06:50:39 +00001744 rdev_dbg(rdev, "GPIO %d is already used\n",
1745 config->ena_gpio);
1746 goto update_ena_gpio_to_rdev;
1747 }
1748 }
1749
1750 ret = gpio_request_one(config->ena_gpio,
1751 GPIOF_DIR_OUT | config->ena_gpio_flags,
1752 rdev_get_name(rdev));
1753 if (ret)
1754 return ret;
1755
1756 pin = kzalloc(sizeof(struct regulator_enable_gpio), GFP_KERNEL);
1757 if (pin == NULL) {
1758 gpio_free(config->ena_gpio);
1759 return -ENOMEM;
1760 }
1761
Russell King778b28b2014-06-29 17:55:54 +01001762 pin->gpiod = gpiod;
Kim, Milof19b00d2013-02-18 06:50:39 +00001763 pin->ena_gpio_invert = config->ena_gpio_invert;
1764 list_add(&pin->list, &regulator_ena_gpio_list);
1765
1766update_ena_gpio_to_rdev:
1767 pin->request_count++;
1768 rdev->ena_pin = pin;
1769 return 0;
1770}
1771
1772static void regulator_ena_gpio_free(struct regulator_dev *rdev)
1773{
1774 struct regulator_enable_gpio *pin, *n;
1775
1776 if (!rdev->ena_pin)
1777 return;
1778
1779 /* Free the GPIO only in case of no use */
1780 list_for_each_entry_safe(pin, n, &regulator_ena_gpio_list, list) {
Russell King778b28b2014-06-29 17:55:54 +01001781 if (pin->gpiod == rdev->ena_pin->gpiod) {
Kim, Milof19b00d2013-02-18 06:50:39 +00001782 if (pin->request_count <= 1) {
1783 pin->request_count = 0;
Russell King778b28b2014-06-29 17:55:54 +01001784 gpiod_put(pin->gpiod);
Kim, Milof19b00d2013-02-18 06:50:39 +00001785 list_del(&pin->list);
1786 kfree(pin);
Seung-Woo Kim60a23622014-12-04 19:17:17 +09001787 rdev->ena_pin = NULL;
1788 return;
Kim, Milof19b00d2013-02-18 06:50:39 +00001789 } else {
1790 pin->request_count--;
1791 }
1792 }
1793 }
1794}
1795
Kim, Milo967cfb12013-02-18 06:50:48 +00001796/**
Robert P. J. Day31d6eeb2013-05-02 10:19:11 -04001797 * regulator_ena_gpio_ctrl - balance enable_count of each GPIO and actual GPIO pin control
1798 * @rdev: regulator_dev structure
1799 * @enable: enable GPIO at initial use?
1800 *
Kim, Milo967cfb12013-02-18 06:50:48 +00001801 * GPIO is enabled in case of initial use. (enable_count is 0)
1802 * GPIO is disabled when it is not shared any more. (enable_count <= 1)
1803 */
1804static int regulator_ena_gpio_ctrl(struct regulator_dev *rdev, bool enable)
1805{
1806 struct regulator_enable_gpio *pin = rdev->ena_pin;
1807
1808 if (!pin)
1809 return -EINVAL;
1810
1811 if (enable) {
1812 /* Enable GPIO at initial use */
1813 if (pin->enable_count == 0)
Russell King778b28b2014-06-29 17:55:54 +01001814 gpiod_set_value_cansleep(pin->gpiod,
1815 !pin->ena_gpio_invert);
Kim, Milo967cfb12013-02-18 06:50:48 +00001816
1817 pin->enable_count++;
1818 } else {
1819 if (pin->enable_count > 1) {
1820 pin->enable_count--;
1821 return 0;
1822 }
1823
1824 /* Disable GPIO if not used */
1825 if (pin->enable_count <= 1) {
Russell King778b28b2014-06-29 17:55:54 +01001826 gpiod_set_value_cansleep(pin->gpiod,
1827 pin->ena_gpio_invert);
Kim, Milo967cfb12013-02-18 06:50:48 +00001828 pin->enable_count = 0;
1829 }
1830 }
1831
1832 return 0;
1833}
1834
Guodong Xu79fd1142014-08-13 19:33:39 +08001835/**
1836 * _regulator_enable_delay - a delay helper function
1837 * @delay: time to delay in microseconds
1838 *
1839 * Delay for the requested amount of time as per the guidelines in:
1840 *
1841 * Documentation/timers/timers-howto.txt
1842 *
1843 * The assumption here is that regulators will never be enabled in
1844 * atomic context and therefore sleeping functions can be used.
1845 */
1846static void _regulator_enable_delay(unsigned int delay)
1847{
1848 unsigned int ms = delay / 1000;
1849 unsigned int us = delay % 1000;
1850
1851 if (ms > 0) {
1852 /*
1853 * For small enough values, handle super-millisecond
1854 * delays in the usleep_range() call below.
1855 */
1856 if (ms < 20)
1857 us += ms * 1000;
1858 else
1859 msleep(ms);
1860 }
1861
1862 /*
1863 * Give the scheduler some room to coalesce with any other
1864 * wakeup sources. For delays shorter than 10 us, don't even
1865 * bother setting up high-resolution timers and just busy-
1866 * loop.
1867 */
1868 if (us >= 10)
1869 usleep_range(us, us + 100);
1870 else
1871 udelay(us);
1872}
1873
Mark Brown5c5659d2012-06-27 13:21:26 +01001874static int _regulator_do_enable(struct regulator_dev *rdev)
1875{
1876 int ret, delay;
1877
1878 /* Query before enabling in case configuration dependent. */
1879 ret = _regulator_get_enable_time(rdev);
1880 if (ret >= 0) {
1881 delay = ret;
1882 } else {
1883 rdev_warn(rdev, "enable_time() failed: %d\n", ret);
1884 delay = 0;
1885 }
1886
1887 trace_regulator_enable(rdev_get_name(rdev));
1888
Guodong Xu871f5652014-08-13 19:33:40 +08001889 if (rdev->desc->off_on_delay) {
1890 /* if needed, keep a distance of off_on_delay from last time
1891 * this regulator was disabled.
1892 */
1893 unsigned long start_jiffy = jiffies;
1894 unsigned long intended, max_delay, remaining;
1895
1896 max_delay = usecs_to_jiffies(rdev->desc->off_on_delay);
1897 intended = rdev->last_off_jiffy + max_delay;
1898
1899 if (time_before(start_jiffy, intended)) {
1900 /* calc remaining jiffies to deal with one-time
1901 * timer wrapping.
1902 * in case of multiple timer wrapping, either it can be
1903 * detected by out-of-range remaining, or it cannot be
1904 * detected and we gets a panelty of
1905 * _regulator_enable_delay().
1906 */
1907 remaining = intended - start_jiffy;
1908 if (remaining <= max_delay)
1909 _regulator_enable_delay(
1910 jiffies_to_usecs(remaining));
1911 }
1912 }
1913
Kim, Milo967cfb12013-02-18 06:50:48 +00001914 if (rdev->ena_pin) {
Doug Anderson29d62ec2015-03-03 15:20:47 -08001915 if (!rdev->ena_gpio_state) {
1916 ret = regulator_ena_gpio_ctrl(rdev, true);
1917 if (ret < 0)
1918 return ret;
1919 rdev->ena_gpio_state = 1;
1920 }
Mark Brown65f73502012-06-27 14:14:38 +01001921 } else if (rdev->desc->ops->enable) {
Mark Brown5c5659d2012-06-27 13:21:26 +01001922 ret = rdev->desc->ops->enable(rdev);
1923 if (ret < 0)
1924 return ret;
1925 } else {
1926 return -EINVAL;
1927 }
1928
1929 /* Allow the regulator to ramp; it would be useful to extend
1930 * this for bulk operations so that the regulators can ramp
1931 * together. */
1932 trace_regulator_enable_delay(rdev_get_name(rdev));
1933
Guodong Xu79fd1142014-08-13 19:33:39 +08001934 _regulator_enable_delay(delay);
Mark Brown5c5659d2012-06-27 13:21:26 +01001935
1936 trace_regulator_enable_complete(rdev_get_name(rdev));
1937
1938 return 0;
1939}
1940
Liam Girdwood414c70c2008-04-30 15:59:04 +01001941/* locks held by regulator_enable() */
1942static int _regulator_enable(struct regulator_dev *rdev)
1943{
Mark Brown5c5659d2012-06-27 13:21:26 +01001944 int ret;
Liam Girdwood414c70c2008-04-30 15:59:04 +01001945
Liam Girdwood414c70c2008-04-30 15:59:04 +01001946 /* check voltage and requested load before enabling */
Mark Brown9a2372f2009-08-03 18:49:57 +01001947 if (rdev->constraints &&
1948 (rdev->constraints->valid_ops_mask & REGULATOR_CHANGE_DRMS))
1949 drms_uA_update(rdev);
Liam Girdwood414c70c2008-04-30 15:59:04 +01001950
Mark Brown9a2372f2009-08-03 18:49:57 +01001951 if (rdev->use_count == 0) {
1952 /* The regulator may on if it's not switchable or left on */
1953 ret = _regulator_is_enabled(rdev);
1954 if (ret == -EINVAL || ret == 0) {
1955 if (!_regulator_can_change_status(rdev))
1956 return -EPERM;
Liam Girdwood414c70c2008-04-30 15:59:04 +01001957
Mark Brown5c5659d2012-06-27 13:21:26 +01001958 ret = _regulator_do_enable(rdev);
Mark Brown31aae2b2009-12-21 12:21:52 +00001959 if (ret < 0)
1960 return ret;
1961
Linus Walleija7433cf2009-08-26 12:54:04 +02001962 } else if (ret < 0) {
Joe Perches5da84fd2010-11-30 05:53:48 -08001963 rdev_err(rdev, "is_enabled() failed: %d\n", ret);
Liam Girdwood414c70c2008-04-30 15:59:04 +01001964 return ret;
1965 }
Linus Walleija7433cf2009-08-26 12:54:04 +02001966 /* Fallthrough on positive return values - already enabled */
Liam Girdwood414c70c2008-04-30 15:59:04 +01001967 }
1968
Mark Brown9a2372f2009-08-03 18:49:57 +01001969 rdev->use_count++;
1970
1971 return 0;
Liam Girdwood414c70c2008-04-30 15:59:04 +01001972}
1973
1974/**
1975 * regulator_enable - enable regulator output
1976 * @regulator: regulator source
1977 *
Mark Browncf7bbcd2008-12-31 12:52:43 +00001978 * Request that the regulator be enabled with the regulator output at
1979 * the predefined voltage or current value. Calls to regulator_enable()
1980 * must be balanced with calls to regulator_disable().
1981 *
Liam Girdwood414c70c2008-04-30 15:59:04 +01001982 * NOTE: the output value can be set by other drivers, boot loader or may be
Mark Browncf7bbcd2008-12-31 12:52:43 +00001983 * hardwired in the regulator.
Liam Girdwood414c70c2008-04-30 15:59:04 +01001984 */
1985int regulator_enable(struct regulator *regulator)
1986{
David Brownell412aec62008-11-16 11:44:46 -08001987 struct regulator_dev *rdev = regulator->rdev;
1988 int ret = 0;
Liam Girdwood414c70c2008-04-30 15:59:04 +01001989
Mark Brown6492bc12012-04-19 13:19:07 +01001990 if (regulator->always_on)
1991 return 0;
1992
Mark Brown3801b862011-06-09 16:22:22 +01001993 if (rdev->supply) {
1994 ret = regulator_enable(rdev->supply);
1995 if (ret != 0)
1996 return ret;
1997 }
1998
David Brownell412aec62008-11-16 11:44:46 -08001999 mutex_lock(&rdev->mutex);
David Brownellcd94b502009-03-11 16:43:34 -08002000 ret = _regulator_enable(rdev);
David Brownell412aec62008-11-16 11:44:46 -08002001 mutex_unlock(&rdev->mutex);
Mark Brown3801b862011-06-09 16:22:22 +01002002
Heiko Stübnerd1685e42011-10-14 18:00:29 +02002003 if (ret != 0 && rdev->supply)
Mark Brown3801b862011-06-09 16:22:22 +01002004 regulator_disable(rdev->supply);
2005
Liam Girdwood414c70c2008-04-30 15:59:04 +01002006 return ret;
2007}
2008EXPORT_SYMBOL_GPL(regulator_enable);
2009
Mark Brown5c5659d2012-06-27 13:21:26 +01002010static int _regulator_do_disable(struct regulator_dev *rdev)
2011{
2012 int ret;
2013
2014 trace_regulator_disable(rdev_get_name(rdev));
2015
Kim, Milo967cfb12013-02-18 06:50:48 +00002016 if (rdev->ena_pin) {
Doug Anderson29d62ec2015-03-03 15:20:47 -08002017 if (rdev->ena_gpio_state) {
2018 ret = regulator_ena_gpio_ctrl(rdev, false);
2019 if (ret < 0)
2020 return ret;
2021 rdev->ena_gpio_state = 0;
2022 }
Mark Brown5c5659d2012-06-27 13:21:26 +01002023
2024 } else if (rdev->desc->ops->disable) {
2025 ret = rdev->desc->ops->disable(rdev);
2026 if (ret != 0)
2027 return ret;
2028 }
2029
Guodong Xu871f5652014-08-13 19:33:40 +08002030 /* cares about last_off_jiffy only if off_on_delay is required by
2031 * device.
2032 */
2033 if (rdev->desc->off_on_delay)
2034 rdev->last_off_jiffy = jiffies;
2035
Mark Brown5c5659d2012-06-27 13:21:26 +01002036 trace_regulator_disable_complete(rdev_get_name(rdev));
2037
Mark Brown5c5659d2012-06-27 13:21:26 +01002038 return 0;
2039}
2040
Liam Girdwood414c70c2008-04-30 15:59:04 +01002041/* locks held by regulator_disable() */
Mark Brown3801b862011-06-09 16:22:22 +01002042static int _regulator_disable(struct regulator_dev *rdev)
Liam Girdwood414c70c2008-04-30 15:59:04 +01002043{
2044 int ret = 0;
2045
David Brownellcd94b502009-03-11 16:43:34 -08002046 if (WARN(rdev->use_count <= 0,
Joe Perches43e7ee32010-12-06 14:05:19 -08002047 "unbalanced disables for %s\n", rdev_get_name(rdev)))
David Brownellcd94b502009-03-11 16:43:34 -08002048 return -EIO;
2049
Liam Girdwood414c70c2008-04-30 15:59:04 +01002050 /* are we the last user and permitted to disable ? */
Mark Brown60ef66f2009-10-13 13:06:50 +01002051 if (rdev->use_count == 1 &&
2052 (rdev->constraints && !rdev->constraints->always_on)) {
Liam Girdwood414c70c2008-04-30 15:59:04 +01002053
2054 /* we are last user */
Mark Brown5c5659d2012-06-27 13:21:26 +01002055 if (_regulator_can_change_status(rdev)) {
Richard Fitzgeralda1c8a552014-11-24 14:10:52 +00002056 ret = _notifier_call_chain(rdev,
2057 REGULATOR_EVENT_PRE_DISABLE,
2058 NULL);
2059 if (ret & NOTIFY_STOP_MASK)
2060 return -EINVAL;
2061
Mark Brown5c5659d2012-06-27 13:21:26 +01002062 ret = _regulator_do_disable(rdev);
Liam Girdwood414c70c2008-04-30 15:59:04 +01002063 if (ret < 0) {
Joe Perches5da84fd2010-11-30 05:53:48 -08002064 rdev_err(rdev, "failed to disable\n");
Richard Fitzgeralda1c8a552014-11-24 14:10:52 +00002065 _notifier_call_chain(rdev,
2066 REGULATOR_EVENT_ABORT_DISABLE,
2067 NULL);
Liam Girdwood414c70c2008-04-30 15:59:04 +01002068 return ret;
2069 }
Markus Pargmann66fda752014-02-20 17:36:04 +01002070 _notifier_call_chain(rdev, REGULATOR_EVENT_DISABLE,
2071 NULL);
Liam Girdwood414c70c2008-04-30 15:59:04 +01002072 }
2073
Liam Girdwood414c70c2008-04-30 15:59:04 +01002074 rdev->use_count = 0;
2075 } else if (rdev->use_count > 1) {
2076
2077 if (rdev->constraints &&
2078 (rdev->constraints->valid_ops_mask &
2079 REGULATOR_CHANGE_DRMS))
2080 drms_uA_update(rdev);
2081
2082 rdev->use_count--;
2083 }
Mark Brown3801b862011-06-09 16:22:22 +01002084
Liam Girdwood414c70c2008-04-30 15:59:04 +01002085 return ret;
2086}
2087
2088/**
2089 * regulator_disable - disable regulator output
2090 * @regulator: regulator source
2091 *
Mark Browncf7bbcd2008-12-31 12:52:43 +00002092 * Disable the regulator output voltage or current. Calls to
2093 * regulator_enable() must be balanced with calls to
2094 * regulator_disable().
Mark Brown69279fb2008-12-31 12:52:41 +00002095 *
Liam Girdwood414c70c2008-04-30 15:59:04 +01002096 * NOTE: this will only disable the regulator output if no other consumer
Mark Browncf7bbcd2008-12-31 12:52:43 +00002097 * devices have it enabled, the regulator device supports disabling and
2098 * machine constraints permit this operation.
Liam Girdwood414c70c2008-04-30 15:59:04 +01002099 */
2100int regulator_disable(struct regulator *regulator)
2101{
David Brownell412aec62008-11-16 11:44:46 -08002102 struct regulator_dev *rdev = regulator->rdev;
2103 int ret = 0;
Liam Girdwood414c70c2008-04-30 15:59:04 +01002104
Mark Brown6492bc12012-04-19 13:19:07 +01002105 if (regulator->always_on)
2106 return 0;
2107
David Brownell412aec62008-11-16 11:44:46 -08002108 mutex_lock(&rdev->mutex);
Mark Brown3801b862011-06-09 16:22:22 +01002109 ret = _regulator_disable(rdev);
David Brownell412aec62008-11-16 11:44:46 -08002110 mutex_unlock(&rdev->mutex);
Jeffrey Carlyle8cbf8112010-10-08 14:49:19 -05002111
Mark Brown3801b862011-06-09 16:22:22 +01002112 if (ret == 0 && rdev->supply)
2113 regulator_disable(rdev->supply);
Jeffrey Carlyle8cbf8112010-10-08 14:49:19 -05002114
Liam Girdwood414c70c2008-04-30 15:59:04 +01002115 return ret;
2116}
2117EXPORT_SYMBOL_GPL(regulator_disable);
2118
2119/* locks held by regulator_force_disable() */
Mark Brown3801b862011-06-09 16:22:22 +01002120static int _regulator_force_disable(struct regulator_dev *rdev)
Liam Girdwood414c70c2008-04-30 15:59:04 +01002121{
2122 int ret = 0;
2123
Richard Fitzgeralda1c8a552014-11-24 14:10:52 +00002124 ret = _notifier_call_chain(rdev, REGULATOR_EVENT_FORCE_DISABLE |
2125 REGULATOR_EVENT_PRE_DISABLE, NULL);
2126 if (ret & NOTIFY_STOP_MASK)
2127 return -EINVAL;
2128
Markus Pargmann66fda752014-02-20 17:36:04 +01002129 ret = _regulator_do_disable(rdev);
2130 if (ret < 0) {
2131 rdev_err(rdev, "failed to force disable\n");
Richard Fitzgeralda1c8a552014-11-24 14:10:52 +00002132 _notifier_call_chain(rdev, REGULATOR_EVENT_FORCE_DISABLE |
2133 REGULATOR_EVENT_ABORT_DISABLE, NULL);
Markus Pargmann66fda752014-02-20 17:36:04 +01002134 return ret;
Liam Girdwood414c70c2008-04-30 15:59:04 +01002135 }
2136
Markus Pargmann66fda752014-02-20 17:36:04 +01002137 _notifier_call_chain(rdev, REGULATOR_EVENT_FORCE_DISABLE |
2138 REGULATOR_EVENT_DISABLE, NULL);
2139
2140 return 0;
Liam Girdwood414c70c2008-04-30 15:59:04 +01002141}
2142
2143/**
2144 * regulator_force_disable - force disable regulator output
2145 * @regulator: regulator source
2146 *
2147 * Forcibly disable the regulator output voltage or current.
2148 * NOTE: this *will* disable the regulator output even if other consumer
2149 * devices have it enabled. This should be used for situations when device
2150 * damage will likely occur if the regulator is not disabled (e.g. over temp).
2151 */
2152int regulator_force_disable(struct regulator *regulator)
2153{
Mark Brown82d15832011-05-09 11:41:02 +02002154 struct regulator_dev *rdev = regulator->rdev;
Liam Girdwood414c70c2008-04-30 15:59:04 +01002155 int ret;
2156
Mark Brown82d15832011-05-09 11:41:02 +02002157 mutex_lock(&rdev->mutex);
Liam Girdwood414c70c2008-04-30 15:59:04 +01002158 regulator->uA_load = 0;
Mark Brown3801b862011-06-09 16:22:22 +01002159 ret = _regulator_force_disable(regulator->rdev);
Mark Brown82d15832011-05-09 11:41:02 +02002160 mutex_unlock(&rdev->mutex);
Jeffrey Carlyle8cbf8112010-10-08 14:49:19 -05002161
Mark Brown3801b862011-06-09 16:22:22 +01002162 if (rdev->supply)
2163 while (rdev->open_count--)
2164 regulator_disable(rdev->supply);
Jeffrey Carlyle8cbf8112010-10-08 14:49:19 -05002165
Liam Girdwood414c70c2008-04-30 15:59:04 +01002166 return ret;
2167}
2168EXPORT_SYMBOL_GPL(regulator_force_disable);
2169
Mark Brownda07ecd2011-09-11 09:53:50 +01002170static void regulator_disable_work(struct work_struct *work)
2171{
2172 struct regulator_dev *rdev = container_of(work, struct regulator_dev,
2173 disable_work.work);
2174 int count, i, ret;
2175
2176 mutex_lock(&rdev->mutex);
2177
2178 BUG_ON(!rdev->deferred_disables);
2179
2180 count = rdev->deferred_disables;
2181 rdev->deferred_disables = 0;
2182
2183 for (i = 0; i < count; i++) {
2184 ret = _regulator_disable(rdev);
2185 if (ret != 0)
2186 rdev_err(rdev, "Deferred disable failed: %d\n", ret);
2187 }
2188
2189 mutex_unlock(&rdev->mutex);
2190
2191 if (rdev->supply) {
2192 for (i = 0; i < count; i++) {
2193 ret = regulator_disable(rdev->supply);
2194 if (ret != 0) {
2195 rdev_err(rdev,
2196 "Supply disable failed: %d\n", ret);
2197 }
2198 }
2199 }
2200}
2201
2202/**
2203 * regulator_disable_deferred - disable regulator output with delay
2204 * @regulator: regulator source
2205 * @ms: miliseconds until the regulator is disabled
2206 *
2207 * Execute regulator_disable() on the regulator after a delay. This
2208 * is intended for use with devices that require some time to quiesce.
2209 *
2210 * NOTE: this will only disable the regulator output if no other consumer
2211 * devices have it enabled, the regulator device supports disabling and
2212 * machine constraints permit this operation.
2213 */
2214int regulator_disable_deferred(struct regulator *regulator, int ms)
2215{
2216 struct regulator_dev *rdev = regulator->rdev;
Mark Brownaa598022011-10-03 22:42:43 +01002217 int ret;
Mark Brownda07ecd2011-09-11 09:53:50 +01002218
Mark Brown6492bc12012-04-19 13:19:07 +01002219 if (regulator->always_on)
2220 return 0;
2221
Mark Brown2b5a24a2012-09-07 11:00:53 +08002222 if (!ms)
2223 return regulator_disable(regulator);
2224
Mark Brownda07ecd2011-09-11 09:53:50 +01002225 mutex_lock(&rdev->mutex);
2226 rdev->deferred_disables++;
2227 mutex_unlock(&rdev->mutex);
2228
Mark Brown070260f2013-07-18 11:52:04 +01002229 ret = queue_delayed_work(system_power_efficient_wq,
2230 &rdev->disable_work,
2231 msecs_to_jiffies(ms));
Mark Brownaa598022011-10-03 22:42:43 +01002232 if (ret < 0)
2233 return ret;
2234 else
2235 return 0;
Mark Brownda07ecd2011-09-11 09:53:50 +01002236}
2237EXPORT_SYMBOL_GPL(regulator_disable_deferred);
2238
Liam Girdwood414c70c2008-04-30 15:59:04 +01002239static int _regulator_is_enabled(struct regulator_dev *rdev)
2240{
Mark Brown65f73502012-06-27 14:14:38 +01002241 /* A GPIO control always takes precedence */
Kim, Milo7b74d142013-02-18 06:50:55 +00002242 if (rdev->ena_pin)
Mark Brown65f73502012-06-27 14:14:38 +01002243 return rdev->ena_gpio_state;
2244
Mark Brown9a7f6a42010-02-11 17:22:45 +00002245 /* If we don't know then assume that the regulator is always on */
Mark Brown93325462009-08-03 18:49:56 +01002246 if (!rdev->desc->ops->is_enabled)
Mark Brown9a7f6a42010-02-11 17:22:45 +00002247 return 1;
Liam Girdwood414c70c2008-04-30 15:59:04 +01002248
Mark Brown93325462009-08-03 18:49:56 +01002249 return rdev->desc->ops->is_enabled(rdev);
Liam Girdwood414c70c2008-04-30 15:59:04 +01002250}
2251
2252/**
2253 * regulator_is_enabled - is the regulator output enabled
2254 * @regulator: regulator source
2255 *
David Brownell412aec62008-11-16 11:44:46 -08002256 * Returns positive if the regulator driver backing the source/client
2257 * has requested that the device be enabled, zero if it hasn't, else a
2258 * negative errno code.
2259 *
2260 * Note that the device backing this regulator handle can have multiple
2261 * users, so it might be enabled even if regulator_enable() was never
2262 * called for this particular source.
Liam Girdwood414c70c2008-04-30 15:59:04 +01002263 */
2264int regulator_is_enabled(struct regulator *regulator)
2265{
Mark Brown93325462009-08-03 18:49:56 +01002266 int ret;
2267
Mark Brown6492bc12012-04-19 13:19:07 +01002268 if (regulator->always_on)
2269 return 1;
2270
Mark Brown93325462009-08-03 18:49:56 +01002271 mutex_lock(&regulator->rdev->mutex);
2272 ret = _regulator_is_enabled(regulator->rdev);
2273 mutex_unlock(&regulator->rdev->mutex);
2274
2275 return ret;
Liam Girdwood414c70c2008-04-30 15:59:04 +01002276}
2277EXPORT_SYMBOL_GPL(regulator_is_enabled);
2278
2279/**
Marek Szyprowskid1e7de32012-12-04 15:01:01 +01002280 * regulator_can_change_voltage - check if regulator can change voltage
2281 * @regulator: regulator source
2282 *
2283 * Returns positive if the regulator driver backing the source/client
Masanari Iidae2278672014-02-18 22:54:36 +09002284 * can change its voltage, false otherwise. Useful for detecting fixed
Marek Szyprowskid1e7de32012-12-04 15:01:01 +01002285 * or dummy regulators and disabling voltage change logic in the client
2286 * driver.
2287 */
2288int regulator_can_change_voltage(struct regulator *regulator)
2289{
2290 struct regulator_dev *rdev = regulator->rdev;
2291
2292 if (rdev->constraints &&
Axel Lin19280e42012-12-12 09:22:46 +08002293 (rdev->constraints->valid_ops_mask & REGULATOR_CHANGE_VOLTAGE)) {
2294 if (rdev->desc->n_voltages - rdev->desc->linear_min_sel > 1)
2295 return 1;
2296
2297 if (rdev->desc->continuous_voltage_range &&
2298 rdev->constraints->min_uV && rdev->constraints->max_uV &&
2299 rdev->constraints->min_uV != rdev->constraints->max_uV)
2300 return 1;
2301 }
Marek Szyprowskid1e7de32012-12-04 15:01:01 +01002302
2303 return 0;
2304}
2305EXPORT_SYMBOL_GPL(regulator_can_change_voltage);
2306
2307/**
David Brownell4367cfd2009-02-26 11:48:36 -08002308 * regulator_count_voltages - count regulator_list_voltage() selectors
2309 * @regulator: regulator source
2310 *
2311 * Returns number of selectors, or negative errno. Selectors are
2312 * numbered starting at zero, and typically correspond to bitfields
2313 * in hardware registers.
2314 */
2315int regulator_count_voltages(struct regulator *regulator)
2316{
2317 struct regulator_dev *rdev = regulator->rdev;
2318
Javier Martinez Canillas26988ef2014-07-29 18:28:56 +02002319 if (rdev->desc->n_voltages)
2320 return rdev->desc->n_voltages;
2321
2322 if (!rdev->supply)
2323 return -EINVAL;
2324
2325 return regulator_count_voltages(rdev->supply);
David Brownell4367cfd2009-02-26 11:48:36 -08002326}
2327EXPORT_SYMBOL_GPL(regulator_count_voltages);
2328
2329/**
2330 * regulator_list_voltage - enumerate supported voltages
2331 * @regulator: regulator source
2332 * @selector: identify voltage to list
2333 * Context: can sleep
2334 *
2335 * Returns a voltage that can be passed to @regulator_set_voltage(),
Thomas Weber88393162010-03-16 11:47:56 +01002336 * zero if this selector code can't be used on this system, or a
David Brownell4367cfd2009-02-26 11:48:36 -08002337 * negative errno.
2338 */
2339int regulator_list_voltage(struct regulator *regulator, unsigned selector)
2340{
Guodong Xu272e2312014-08-13 19:33:38 +08002341 struct regulator_dev *rdev = regulator->rdev;
2342 const struct regulator_ops *ops = rdev->desc->ops;
2343 int ret;
David Brownell4367cfd2009-02-26 11:48:36 -08002344
Guennadi Liakhovetskif4460432013-11-13 12:33:00 +01002345 if (rdev->desc->fixed_uV && rdev->desc->n_voltages == 1 && !selector)
2346 return rdev->desc->fixed_uV;
2347
Javier Martinez Canillas26988ef2014-07-29 18:28:56 +02002348 if (ops->list_voltage) {
2349 if (selector >= rdev->desc->n_voltages)
2350 return -EINVAL;
2351 mutex_lock(&rdev->mutex);
2352 ret = ops->list_voltage(rdev, selector);
2353 mutex_unlock(&rdev->mutex);
2354 } else if (rdev->supply) {
2355 ret = regulator_list_voltage(rdev->supply, selector);
2356 } else {
David Brownell4367cfd2009-02-26 11:48:36 -08002357 return -EINVAL;
Javier Martinez Canillas26988ef2014-07-29 18:28:56 +02002358 }
David Brownell4367cfd2009-02-26 11:48:36 -08002359
2360 if (ret > 0) {
2361 if (ret < rdev->constraints->min_uV)
2362 ret = 0;
2363 else if (ret > rdev->constraints->max_uV)
2364 ret = 0;
2365 }
2366
2367 return ret;
2368}
2369EXPORT_SYMBOL_GPL(regulator_list_voltage);
2370
2371/**
Tuomas Tynkkynen04eca282014-07-21 18:38:48 +03002372 * regulator_get_regmap - get the regulator's register map
2373 * @regulator: regulator source
2374 *
2375 * Returns the register map for the given regulator, or an ERR_PTR value
2376 * if the regulator doesn't use regmap.
2377 */
2378struct regmap *regulator_get_regmap(struct regulator *regulator)
2379{
2380 struct regmap *map = regulator->rdev->regmap;
2381
2382 return map ? map : ERR_PTR(-EOPNOTSUPP);
2383}
2384
2385/**
2386 * regulator_get_hardware_vsel_register - get the HW voltage selector register
2387 * @regulator: regulator source
2388 * @vsel_reg: voltage selector register, output parameter
2389 * @vsel_mask: mask for voltage selector bitfield, output parameter
2390 *
2391 * Returns the hardware register offset and bitmask used for setting the
2392 * regulator voltage. This might be useful when configuring voltage-scaling
2393 * hardware or firmware that can make I2C requests behind the kernel's back,
2394 * for example.
2395 *
2396 * On success, the output parameters @vsel_reg and @vsel_mask are filled in
2397 * and 0 is returned, otherwise a negative errno is returned.
2398 */
2399int regulator_get_hardware_vsel_register(struct regulator *regulator,
2400 unsigned *vsel_reg,
2401 unsigned *vsel_mask)
2402{
Guodong Xu39f54602014-08-19 18:07:41 +08002403 struct regulator_dev *rdev = regulator->rdev;
2404 const struct regulator_ops *ops = rdev->desc->ops;
Tuomas Tynkkynen04eca282014-07-21 18:38:48 +03002405
2406 if (ops->set_voltage_sel != regulator_set_voltage_sel_regmap)
2407 return -EOPNOTSUPP;
2408
2409 *vsel_reg = rdev->desc->vsel_reg;
2410 *vsel_mask = rdev->desc->vsel_mask;
2411
2412 return 0;
2413}
2414EXPORT_SYMBOL_GPL(regulator_get_hardware_vsel_register);
2415
2416/**
2417 * regulator_list_hardware_vsel - get the HW-specific register value for a selector
2418 * @regulator: regulator source
2419 * @selector: identify voltage to list
2420 *
2421 * Converts the selector to a hardware-specific voltage selector that can be
2422 * directly written to the regulator registers. The address of the voltage
2423 * register can be determined by calling @regulator_get_hardware_vsel_register.
2424 *
2425 * On error a negative errno is returned.
2426 */
2427int regulator_list_hardware_vsel(struct regulator *regulator,
2428 unsigned selector)
2429{
Guodong Xu39f54602014-08-19 18:07:41 +08002430 struct regulator_dev *rdev = regulator->rdev;
2431 const struct regulator_ops *ops = rdev->desc->ops;
Tuomas Tynkkynen04eca282014-07-21 18:38:48 +03002432
2433 if (selector >= rdev->desc->n_voltages)
2434 return -EINVAL;
2435 if (ops->set_voltage_sel != regulator_set_voltage_sel_regmap)
2436 return -EOPNOTSUPP;
2437
2438 return selector;
2439}
2440EXPORT_SYMBOL_GPL(regulator_list_hardware_vsel);
2441
2442/**
Paul Walmsley2a668a82013-06-07 08:06:56 +00002443 * regulator_get_linear_step - return the voltage step size between VSEL values
2444 * @regulator: regulator source
2445 *
2446 * Returns the voltage step size between VSEL values for linear
2447 * regulators, or return 0 if the regulator isn't a linear regulator.
2448 */
2449unsigned int regulator_get_linear_step(struct regulator *regulator)
2450{
2451 struct regulator_dev *rdev = regulator->rdev;
2452
2453 return rdev->desc->uV_step;
2454}
2455EXPORT_SYMBOL_GPL(regulator_get_linear_step);
2456
2457/**
Mark Browna7a1ad92009-07-21 16:00:24 +01002458 * regulator_is_supported_voltage - check if a voltage range can be supported
2459 *
2460 * @regulator: Regulator to check.
2461 * @min_uV: Minimum required voltage in uV.
2462 * @max_uV: Maximum required voltage in uV.
2463 *
2464 * Returns a boolean or a negative error code.
2465 */
2466int regulator_is_supported_voltage(struct regulator *regulator,
2467 int min_uV, int max_uV)
2468{
Mark Brownc5f39392012-07-02 15:00:18 +01002469 struct regulator_dev *rdev = regulator->rdev;
Mark Browna7a1ad92009-07-21 16:00:24 +01002470 int i, voltages, ret;
2471
Mark Brownc5f39392012-07-02 15:00:18 +01002472 /* If we can't change voltage check the current voltage */
2473 if (!(rdev->constraints->valid_ops_mask & REGULATOR_CHANGE_VOLTAGE)) {
2474 ret = regulator_get_voltage(regulator);
2475 if (ret >= 0)
Jingoo Han0d25d092014-01-08 10:02:16 +09002476 return min_uV <= ret && ret <= max_uV;
Mark Brownc5f39392012-07-02 15:00:18 +01002477 else
2478 return ret;
2479 }
2480
Pawel Mollbd7a2b62012-09-24 18:56:53 +01002481 /* Any voltage within constrains range is fine? */
2482 if (rdev->desc->continuous_voltage_range)
2483 return min_uV >= rdev->constraints->min_uV &&
2484 max_uV <= rdev->constraints->max_uV;
2485
Mark Browna7a1ad92009-07-21 16:00:24 +01002486 ret = regulator_count_voltages(regulator);
2487 if (ret < 0)
2488 return ret;
2489 voltages = ret;
2490
2491 for (i = 0; i < voltages; i++) {
2492 ret = regulator_list_voltage(regulator, i);
2493
2494 if (ret >= min_uV && ret <= max_uV)
2495 return 1;
2496 }
2497
2498 return 0;
2499}
Mark Browna398eaa2011-12-28 12:48:45 +00002500EXPORT_SYMBOL_GPL(regulator_is_supported_voltage);
Mark Browna7a1ad92009-07-21 16:00:24 +01002501
Heiko Stübner71795692014-08-28 12:36:04 -07002502static int _regulator_call_set_voltage(struct regulator_dev *rdev,
2503 int min_uV, int max_uV,
2504 unsigned *selector)
2505{
2506 struct pre_voltage_change_data data;
2507 int ret;
2508
2509 data.old_uV = _regulator_get_voltage(rdev);
2510 data.min_uV = min_uV;
2511 data.max_uV = max_uV;
2512 ret = _notifier_call_chain(rdev, REGULATOR_EVENT_PRE_VOLTAGE_CHANGE,
2513 &data);
2514 if (ret & NOTIFY_STOP_MASK)
2515 return -EINVAL;
2516
2517 ret = rdev->desc->ops->set_voltage(rdev, min_uV, max_uV, selector);
2518 if (ret >= 0)
2519 return ret;
2520
2521 _notifier_call_chain(rdev, REGULATOR_EVENT_ABORT_VOLTAGE_CHANGE,
2522 (void *)data.old_uV);
2523
2524 return ret;
2525}
2526
2527static int _regulator_call_set_voltage_sel(struct regulator_dev *rdev,
2528 int uV, unsigned selector)
2529{
2530 struct pre_voltage_change_data data;
2531 int ret;
2532
2533 data.old_uV = _regulator_get_voltage(rdev);
2534 data.min_uV = uV;
2535 data.max_uV = uV;
2536 ret = _notifier_call_chain(rdev, REGULATOR_EVENT_PRE_VOLTAGE_CHANGE,
2537 &data);
2538 if (ret & NOTIFY_STOP_MASK)
2539 return -EINVAL;
2540
2541 ret = rdev->desc->ops->set_voltage_sel(rdev, selector);
2542 if (ret >= 0)
2543 return ret;
2544
2545 _notifier_call_chain(rdev, REGULATOR_EVENT_ABORT_VOLTAGE_CHANGE,
2546 (void *)data.old_uV);
2547
2548 return ret;
2549}
2550
Mark Brown75790252010-12-12 14:25:50 +00002551static int _regulator_do_set_voltage(struct regulator_dev *rdev,
2552 int min_uV, int max_uV)
2553{
2554 int ret;
Linus Walleij77af1b2642011-03-17 13:24:36 +01002555 int delay = 0;
Mark Browne113d792012-06-26 10:57:51 +01002556 int best_val = 0;
Mark Brown75790252010-12-12 14:25:50 +00002557 unsigned int selector;
Axel Lineba41a52012-04-04 10:32:10 +08002558 int old_selector = -1;
Mark Brown75790252010-12-12 14:25:50 +00002559
2560 trace_regulator_set_voltage(rdev_get_name(rdev), min_uV, max_uV);
2561
Mark Brownbf5892a2011-05-08 22:13:37 +01002562 min_uV += rdev->constraints->uV_offset;
2563 max_uV += rdev->constraints->uV_offset;
2564
Axel Lineba41a52012-04-04 10:32:10 +08002565 /*
2566 * If we can't obtain the old selector there is not enough
2567 * info to call set_voltage_time_sel().
2568 */
Axel Lin8b7485e2012-05-21 09:37:52 +08002569 if (_regulator_is_enabled(rdev) &&
2570 rdev->desc->ops->set_voltage_time_sel &&
Axel Lineba41a52012-04-04 10:32:10 +08002571 rdev->desc->ops->get_voltage_sel) {
2572 old_selector = rdev->desc->ops->get_voltage_sel(rdev);
2573 if (old_selector < 0)
2574 return old_selector;
2575 }
2576
Mark Brown75790252010-12-12 14:25:50 +00002577 if (rdev->desc->ops->set_voltage) {
Heiko Stübner71795692014-08-28 12:36:04 -07002578 ret = _regulator_call_set_voltage(rdev, min_uV, max_uV,
2579 &selector);
Mark Browne113d792012-06-26 10:57:51 +01002580
2581 if (ret >= 0) {
2582 if (rdev->desc->ops->list_voltage)
2583 best_val = rdev->desc->ops->list_voltage(rdev,
2584 selector);
2585 else
2586 best_val = _regulator_get_voltage(rdev);
2587 }
2588
Mark Browne8eef822010-12-12 14:36:17 +00002589 } else if (rdev->desc->ops->set_voltage_sel) {
Axel Lin9152c362012-06-04 09:41:38 +08002590 if (rdev->desc->ops->map_voltage) {
Mark Browne843fc42012-05-09 21:16:06 +01002591 ret = rdev->desc->ops->map_voltage(rdev, min_uV,
2592 max_uV);
Axel Lin9152c362012-06-04 09:41:38 +08002593 } else {
2594 if (rdev->desc->ops->list_voltage ==
2595 regulator_list_voltage_linear)
2596 ret = regulator_map_voltage_linear(rdev,
2597 min_uV, max_uV);
Axel Lin36698622014-05-24 11:10:43 +08002598 else if (rdev->desc->ops->list_voltage ==
2599 regulator_list_voltage_linear_range)
2600 ret = regulator_map_voltage_linear_range(rdev,
2601 min_uV, max_uV);
Axel Lin9152c362012-06-04 09:41:38 +08002602 else
2603 ret = regulator_map_voltage_iterate(rdev,
2604 min_uV, max_uV);
2605 }
Mark Browne8eef822010-12-12 14:36:17 +00002606
Mark Browne843fc42012-05-09 21:16:06 +01002607 if (ret >= 0) {
Mark Browne113d792012-06-26 10:57:51 +01002608 best_val = rdev->desc->ops->list_voltage(rdev, ret);
2609 if (min_uV <= best_val && max_uV >= best_val) {
2610 selector = ret;
Axel Linc66a5662013-02-06 11:09:48 +08002611 if (old_selector == selector)
2612 ret = 0;
2613 else
Heiko Stübner71795692014-08-28 12:36:04 -07002614 ret = _regulator_call_set_voltage_sel(
2615 rdev, best_val, selector);
Mark Browne113d792012-06-26 10:57:51 +01002616 } else {
2617 ret = -EINVAL;
2618 }
Mark Browne8eef822010-12-12 14:36:17 +00002619 }
Mark Brown75790252010-12-12 14:25:50 +00002620 } else {
2621 ret = -EINVAL;
2622 }
2623
Axel Lineba41a52012-04-04 10:32:10 +08002624 /* Call set_voltage_time_sel if successfully obtained old_selector */
Yadwinder Singh Brar5b175952013-06-29 18:21:19 +05302625 if (ret == 0 && !rdev->constraints->ramp_disable && old_selector >= 0
2626 && old_selector != selector) {
Axel Lineba41a52012-04-04 10:32:10 +08002627
2628 delay = rdev->desc->ops->set_voltage_time_sel(rdev,
2629 old_selector, selector);
2630 if (delay < 0) {
2631 rdev_warn(rdev, "set_voltage_time_sel() failed: %d\n",
2632 delay);
2633 delay = 0;
2634 }
Axel Lineba41a52012-04-04 10:32:10 +08002635
Philip Rakity8b96de32012-06-14 15:07:56 -07002636 /* Insert any necessary delays */
2637 if (delay >= 1000) {
2638 mdelay(delay / 1000);
2639 udelay(delay % 1000);
2640 } else if (delay) {
2641 udelay(delay);
2642 }
Linus Walleij77af1b2642011-03-17 13:24:36 +01002643 }
2644
Axel Lin2f6c7972012-08-06 23:44:19 +08002645 if (ret == 0 && best_val >= 0) {
2646 unsigned long data = best_val;
2647
Mark Brownded06a52010-12-16 13:59:10 +00002648 _notifier_call_chain(rdev, REGULATOR_EVENT_VOLTAGE_CHANGE,
Axel Lin2f6c7972012-08-06 23:44:19 +08002649 (void *)data);
2650 }
Mark Brownded06a52010-12-16 13:59:10 +00002651
Axel Lineba41a52012-04-04 10:32:10 +08002652 trace_regulator_set_voltage_complete(rdev_get_name(rdev), best_val);
Mark Brown75790252010-12-12 14:25:50 +00002653
2654 return ret;
2655}
2656
Mark Browna7a1ad92009-07-21 16:00:24 +01002657/**
Liam Girdwood414c70c2008-04-30 15:59:04 +01002658 * regulator_set_voltage - set regulator output voltage
2659 * @regulator: regulator source
2660 * @min_uV: Minimum required voltage in uV
2661 * @max_uV: Maximum acceptable voltage in uV
2662 *
2663 * Sets a voltage regulator to the desired output voltage. This can be set
2664 * during any regulator state. IOW, regulator can be disabled or enabled.
2665 *
2666 * If the regulator is enabled then the voltage will change to the new value
2667 * immediately otherwise if the regulator is disabled the regulator will
2668 * output at the new voltage when enabled.
2669 *
2670 * NOTE: If the regulator is shared between several devices then the lowest
2671 * request voltage that meets the system constraints will be used.
Mark Brown69279fb2008-12-31 12:52:41 +00002672 * Regulator system constraints must be set for this regulator before
Liam Girdwood414c70c2008-04-30 15:59:04 +01002673 * calling this function otherwise this call will fail.
2674 */
2675int regulator_set_voltage(struct regulator *regulator, int min_uV, int max_uV)
2676{
2677 struct regulator_dev *rdev = regulator->rdev;
Mark Brown95a3c232010-12-16 15:49:37 +00002678 int ret = 0;
Paolo Pisati92d7a552012-12-13 10:13:00 +01002679 int old_min_uV, old_max_uV;
Bjorn Anderssonc00dc352014-02-05 12:30:26 -08002680 int current_uV;
Liam Girdwood414c70c2008-04-30 15:59:04 +01002681
2682 mutex_lock(&rdev->mutex);
2683
Mark Brown95a3c232010-12-16 15:49:37 +00002684 /* If we're setting the same range as last time the change
2685 * should be a noop (some cpufreq implementations use the same
2686 * voltage for multiple frequencies, for example).
2687 */
2688 if (regulator->min_uV == min_uV && regulator->max_uV == max_uV)
2689 goto out;
2690
Bjorn Anderssonc00dc352014-02-05 12:30:26 -08002691 /* If we're trying to set a range that overlaps the current voltage,
2692 * return succesfully even though the regulator does not support
2693 * changing the voltage.
2694 */
2695 if (!(rdev->constraints->valid_ops_mask & REGULATOR_CHANGE_VOLTAGE)) {
2696 current_uV = _regulator_get_voltage(rdev);
2697 if (min_uV <= current_uV && current_uV <= max_uV) {
2698 regulator->min_uV = min_uV;
2699 regulator->max_uV = max_uV;
2700 goto out;
2701 }
2702 }
2703
Liam Girdwood414c70c2008-04-30 15:59:04 +01002704 /* sanity check */
Mark Browne8eef822010-12-12 14:36:17 +00002705 if (!rdev->desc->ops->set_voltage &&
2706 !rdev->desc->ops->set_voltage_sel) {
Liam Girdwood414c70c2008-04-30 15:59:04 +01002707 ret = -EINVAL;
2708 goto out;
2709 }
2710
2711 /* constraints check */
2712 ret = regulator_check_voltage(rdev, &min_uV, &max_uV);
2713 if (ret < 0)
2714 goto out;
Jingoo Han0d25d092014-01-08 10:02:16 +09002715
Paolo Pisati92d7a552012-12-13 10:13:00 +01002716 /* restore original values in case of error */
2717 old_min_uV = regulator->min_uV;
2718 old_max_uV = regulator->max_uV;
Liam Girdwood414c70c2008-04-30 15:59:04 +01002719 regulator->min_uV = min_uV;
2720 regulator->max_uV = max_uV;
Mark Brown3a93f2a2010-11-10 14:38:29 +00002721
Thomas Petazzoni05fda3b1a2010-12-03 11:31:07 +01002722 ret = regulator_check_consumers(rdev, &min_uV, &max_uV);
2723 if (ret < 0)
Paolo Pisati92d7a552012-12-13 10:13:00 +01002724 goto out2;
Thomas Petazzoni05fda3b1a2010-12-03 11:31:07 +01002725
Mark Brown75790252010-12-12 14:25:50 +00002726 ret = _regulator_do_set_voltage(rdev, min_uV, max_uV);
Paolo Pisati92d7a552012-12-13 10:13:00 +01002727 if (ret < 0)
2728 goto out2;
Jingoo Han0d25d092014-01-08 10:02:16 +09002729
Liam Girdwood414c70c2008-04-30 15:59:04 +01002730out:
2731 mutex_unlock(&rdev->mutex);
2732 return ret;
Paolo Pisati92d7a552012-12-13 10:13:00 +01002733out2:
2734 regulator->min_uV = old_min_uV;
2735 regulator->max_uV = old_max_uV;
2736 mutex_unlock(&rdev->mutex);
2737 return ret;
Liam Girdwood414c70c2008-04-30 15:59:04 +01002738}
2739EXPORT_SYMBOL_GPL(regulator_set_voltage);
2740
Mark Brown606a2562010-12-16 15:49:36 +00002741/**
Linus Walleij88cd222b2011-03-17 13:24:52 +01002742 * regulator_set_voltage_time - get raise/fall time
2743 * @regulator: regulator source
2744 * @old_uV: starting voltage in microvolts
2745 * @new_uV: target voltage in microvolts
2746 *
2747 * Provided with the starting and ending voltage, this function attempts to
2748 * calculate the time in microseconds required to rise or fall to this new
2749 * voltage.
2750 */
2751int regulator_set_voltage_time(struct regulator *regulator,
2752 int old_uV, int new_uV)
2753{
Guodong Xu272e2312014-08-13 19:33:38 +08002754 struct regulator_dev *rdev = regulator->rdev;
2755 const struct regulator_ops *ops = rdev->desc->ops;
Linus Walleij88cd222b2011-03-17 13:24:52 +01002756 int old_sel = -1;
2757 int new_sel = -1;
2758 int voltage;
2759 int i;
2760
2761 /* Currently requires operations to do this */
2762 if (!ops->list_voltage || !ops->set_voltage_time_sel
2763 || !rdev->desc->n_voltages)
2764 return -EINVAL;
2765
2766 for (i = 0; i < rdev->desc->n_voltages; i++) {
2767 /* We only look for exact voltage matches here */
2768 voltage = regulator_list_voltage(regulator, i);
2769 if (voltage < 0)
2770 return -EINVAL;
2771 if (voltage == 0)
2772 continue;
2773 if (voltage == old_uV)
2774 old_sel = i;
2775 if (voltage == new_uV)
2776 new_sel = i;
2777 }
2778
2779 if (old_sel < 0 || new_sel < 0)
2780 return -EINVAL;
2781
2782 return ops->set_voltage_time_sel(rdev, old_sel, new_sel);
2783}
2784EXPORT_SYMBOL_GPL(regulator_set_voltage_time);
2785
2786/**
Randy Dunlap296c6562012-08-18 17:44:14 -07002787 * regulator_set_voltage_time_sel - get raise/fall time
2788 * @rdev: regulator source device
Yadwinder Singh Brar98a175b2012-06-09 16:40:38 +05302789 * @old_selector: selector for starting voltage
2790 * @new_selector: selector for target voltage
2791 *
2792 * Provided with the starting and target voltage selectors, this function
2793 * returns time in microseconds required to rise or fall to this new voltage
2794 *
Axel Linf11d08c2012-06-19 09:38:45 +08002795 * Drivers providing ramp_delay in regulation_constraints can use this as their
Axel Lin398715a2012-06-18 10:11:28 +08002796 * set_voltage_time_sel() operation.
Yadwinder Singh Brar98a175b2012-06-09 16:40:38 +05302797 */
2798int regulator_set_voltage_time_sel(struct regulator_dev *rdev,
2799 unsigned int old_selector,
2800 unsigned int new_selector)
2801{
Axel Lin398715a2012-06-18 10:11:28 +08002802 unsigned int ramp_delay = 0;
Axel Linf11d08c2012-06-19 09:38:45 +08002803 int old_volt, new_volt;
Axel Lin398715a2012-06-18 10:11:28 +08002804
2805 if (rdev->constraints->ramp_delay)
2806 ramp_delay = rdev->constraints->ramp_delay;
2807 else if (rdev->desc->ramp_delay)
2808 ramp_delay = rdev->desc->ramp_delay;
2809
2810 if (ramp_delay == 0) {
Yadwinder Singh Brar6f0b2c62012-06-11 17:41:08 +05302811 rdev_warn(rdev, "ramp_delay not set\n");
Axel Lin398715a2012-06-18 10:11:28 +08002812 return 0;
Yadwinder Singh Brar6f0b2c62012-06-11 17:41:08 +05302813 }
Axel Lin398715a2012-06-18 10:11:28 +08002814
Axel Linf11d08c2012-06-19 09:38:45 +08002815 /* sanity check */
2816 if (!rdev->desc->ops->list_voltage)
2817 return -EINVAL;
Axel Lin398715a2012-06-18 10:11:28 +08002818
Axel Linf11d08c2012-06-19 09:38:45 +08002819 old_volt = rdev->desc->ops->list_voltage(rdev, old_selector);
2820 new_volt = rdev->desc->ops->list_voltage(rdev, new_selector);
2821
2822 return DIV_ROUND_UP(abs(new_volt - old_volt), ramp_delay);
Yadwinder Singh Brar98a175b2012-06-09 16:40:38 +05302823}
Mark Brownb19dbf72012-06-23 11:34:20 +01002824EXPORT_SYMBOL_GPL(regulator_set_voltage_time_sel);
Yadwinder Singh Brar98a175b2012-06-09 16:40:38 +05302825
2826/**
Mark Brown606a2562010-12-16 15:49:36 +00002827 * regulator_sync_voltage - re-apply last regulator output voltage
2828 * @regulator: regulator source
2829 *
2830 * Re-apply the last configured voltage. This is intended to be used
2831 * where some external control source the consumer is cooperating with
2832 * has caused the configured voltage to change.
2833 */
2834int regulator_sync_voltage(struct regulator *regulator)
2835{
2836 struct regulator_dev *rdev = regulator->rdev;
2837 int ret, min_uV, max_uV;
2838
2839 mutex_lock(&rdev->mutex);
2840
2841 if (!rdev->desc->ops->set_voltage &&
2842 !rdev->desc->ops->set_voltage_sel) {
2843 ret = -EINVAL;
2844 goto out;
2845 }
2846
2847 /* This is only going to work if we've had a voltage configured. */
2848 if (!regulator->min_uV && !regulator->max_uV) {
2849 ret = -EINVAL;
2850 goto out;
2851 }
2852
2853 min_uV = regulator->min_uV;
2854 max_uV = regulator->max_uV;
2855
2856 /* This should be a paranoia check... */
2857 ret = regulator_check_voltage(rdev, &min_uV, &max_uV);
2858 if (ret < 0)
2859 goto out;
2860
2861 ret = regulator_check_consumers(rdev, &min_uV, &max_uV);
2862 if (ret < 0)
2863 goto out;
2864
2865 ret = _regulator_do_set_voltage(rdev, min_uV, max_uV);
2866
2867out:
2868 mutex_unlock(&rdev->mutex);
2869 return ret;
2870}
2871EXPORT_SYMBOL_GPL(regulator_sync_voltage);
2872
Liam Girdwood414c70c2008-04-30 15:59:04 +01002873static int _regulator_get_voltage(struct regulator_dev *rdev)
2874{
Mark Brownbf5892a2011-05-08 22:13:37 +01002875 int sel, ret;
Mark Brown476c2d82010-12-10 17:28:07 +00002876
2877 if (rdev->desc->ops->get_voltage_sel) {
2878 sel = rdev->desc->ops->get_voltage_sel(rdev);
2879 if (sel < 0)
2880 return sel;
Mark Brownbf5892a2011-05-08 22:13:37 +01002881 ret = rdev->desc->ops->list_voltage(rdev, sel);
Axel Lincb220d12011-05-23 20:08:10 +08002882 } else if (rdev->desc->ops->get_voltage) {
Mark Brownbf5892a2011-05-08 22:13:37 +01002883 ret = rdev->desc->ops->get_voltage(rdev);
Mark Brownf7df20e2012-08-09 16:42:19 +01002884 } else if (rdev->desc->ops->list_voltage) {
2885 ret = rdev->desc->ops->list_voltage(rdev, 0);
Laxman Dewangan5a523602013-09-10 15:45:05 +05302886 } else if (rdev->desc->fixed_uV && (rdev->desc->n_voltages == 1)) {
2887 ret = rdev->desc->fixed_uV;
Javier Martinez Canillase3039962014-07-29 18:28:55 +02002888 } else if (rdev->supply) {
2889 ret = regulator_get_voltage(rdev->supply);
Axel Lincb220d12011-05-23 20:08:10 +08002890 } else {
Liam Girdwood414c70c2008-04-30 15:59:04 +01002891 return -EINVAL;
Axel Lincb220d12011-05-23 20:08:10 +08002892 }
Mark Brownbf5892a2011-05-08 22:13:37 +01002893
Axel Lincb220d12011-05-23 20:08:10 +08002894 if (ret < 0)
2895 return ret;
Mark Brownbf5892a2011-05-08 22:13:37 +01002896 return ret - rdev->constraints->uV_offset;
Liam Girdwood414c70c2008-04-30 15:59:04 +01002897}
2898
2899/**
2900 * regulator_get_voltage - get regulator output voltage
2901 * @regulator: regulator source
2902 *
2903 * This returns the current regulator voltage in uV.
2904 *
2905 * NOTE: If the regulator is disabled it will return the voltage value. This
2906 * function should not be used to determine regulator state.
2907 */
2908int regulator_get_voltage(struct regulator *regulator)
2909{
2910 int ret;
2911
2912 mutex_lock(&regulator->rdev->mutex);
2913
2914 ret = _regulator_get_voltage(regulator->rdev);
2915
2916 mutex_unlock(&regulator->rdev->mutex);
2917
2918 return ret;
2919}
2920EXPORT_SYMBOL_GPL(regulator_get_voltage);
2921
2922/**
2923 * regulator_set_current_limit - set regulator output current limit
2924 * @regulator: regulator source
Charles Keepaxce0d10f2013-05-21 15:04:07 +01002925 * @min_uA: Minimum supported current in uA
Liam Girdwood414c70c2008-04-30 15:59:04 +01002926 * @max_uA: Maximum supported current in uA
2927 *
2928 * Sets current sink to the desired output current. This can be set during
2929 * any regulator state. IOW, regulator can be disabled or enabled.
2930 *
2931 * If the regulator is enabled then the current will change to the new value
2932 * immediately otherwise if the regulator is disabled the regulator will
2933 * output at the new current when enabled.
2934 *
2935 * NOTE: Regulator system constraints must be set for this regulator before
2936 * calling this function otherwise this call will fail.
2937 */
2938int regulator_set_current_limit(struct regulator *regulator,
2939 int min_uA, int max_uA)
2940{
2941 struct regulator_dev *rdev = regulator->rdev;
2942 int ret;
2943
2944 mutex_lock(&rdev->mutex);
2945
2946 /* sanity check */
2947 if (!rdev->desc->ops->set_current_limit) {
2948 ret = -EINVAL;
2949 goto out;
2950 }
2951
2952 /* constraints check */
2953 ret = regulator_check_current_limit(rdev, &min_uA, &max_uA);
2954 if (ret < 0)
2955 goto out;
2956
2957 ret = rdev->desc->ops->set_current_limit(rdev, min_uA, max_uA);
2958out:
2959 mutex_unlock(&rdev->mutex);
2960 return ret;
2961}
2962EXPORT_SYMBOL_GPL(regulator_set_current_limit);
2963
2964static int _regulator_get_current_limit(struct regulator_dev *rdev)
2965{
2966 int ret;
2967
2968 mutex_lock(&rdev->mutex);
2969
2970 /* sanity check */
2971 if (!rdev->desc->ops->get_current_limit) {
2972 ret = -EINVAL;
2973 goto out;
2974 }
2975
2976 ret = rdev->desc->ops->get_current_limit(rdev);
2977out:
2978 mutex_unlock(&rdev->mutex);
2979 return ret;
2980}
2981
2982/**
2983 * regulator_get_current_limit - get regulator output current
2984 * @regulator: regulator source
2985 *
2986 * This returns the current supplied by the specified current sink in uA.
2987 *
2988 * NOTE: If the regulator is disabled it will return the current value. This
2989 * function should not be used to determine regulator state.
2990 */
2991int regulator_get_current_limit(struct regulator *regulator)
2992{
2993 return _regulator_get_current_limit(regulator->rdev);
2994}
2995EXPORT_SYMBOL_GPL(regulator_get_current_limit);
2996
2997/**
2998 * regulator_set_mode - set regulator operating mode
2999 * @regulator: regulator source
3000 * @mode: operating mode - one of the REGULATOR_MODE constants
3001 *
3002 * Set regulator operating mode to increase regulator efficiency or improve
3003 * regulation performance.
3004 *
3005 * NOTE: Regulator system constraints must be set for this regulator before
3006 * calling this function otherwise this call will fail.
3007 */
3008int regulator_set_mode(struct regulator *regulator, unsigned int mode)
3009{
3010 struct regulator_dev *rdev = regulator->rdev;
3011 int ret;
Sundar R Iyer500b4ac2010-05-17 21:24:48 +05303012 int regulator_curr_mode;
Liam Girdwood414c70c2008-04-30 15:59:04 +01003013
3014 mutex_lock(&rdev->mutex);
3015
3016 /* sanity check */
3017 if (!rdev->desc->ops->set_mode) {
3018 ret = -EINVAL;
3019 goto out;
3020 }
3021
Sundar R Iyer500b4ac2010-05-17 21:24:48 +05303022 /* return if the same mode is requested */
3023 if (rdev->desc->ops->get_mode) {
3024 regulator_curr_mode = rdev->desc->ops->get_mode(rdev);
3025 if (regulator_curr_mode == mode) {
3026 ret = 0;
3027 goto out;
3028 }
3029 }
3030
Liam Girdwood414c70c2008-04-30 15:59:04 +01003031 /* constraints check */
Axel Lin22c51b42011-04-01 18:25:25 +08003032 ret = regulator_mode_constrain(rdev, &mode);
Liam Girdwood414c70c2008-04-30 15:59:04 +01003033 if (ret < 0)
3034 goto out;
3035
3036 ret = rdev->desc->ops->set_mode(rdev, mode);
3037out:
3038 mutex_unlock(&rdev->mutex);
3039 return ret;
3040}
3041EXPORT_SYMBOL_GPL(regulator_set_mode);
3042
3043static unsigned int _regulator_get_mode(struct regulator_dev *rdev)
3044{
3045 int ret;
3046
3047 mutex_lock(&rdev->mutex);
3048
3049 /* sanity check */
3050 if (!rdev->desc->ops->get_mode) {
3051 ret = -EINVAL;
3052 goto out;
3053 }
3054
3055 ret = rdev->desc->ops->get_mode(rdev);
3056out:
3057 mutex_unlock(&rdev->mutex);
3058 return ret;
3059}
3060
3061/**
3062 * regulator_get_mode - get regulator operating mode
3063 * @regulator: regulator source
3064 *
3065 * Get the current regulator operating mode.
3066 */
3067unsigned int regulator_get_mode(struct regulator *regulator)
3068{
3069 return _regulator_get_mode(regulator->rdev);
3070}
3071EXPORT_SYMBOL_GPL(regulator_get_mode);
3072
3073/**
Bjorn Anderssone39ce482015-02-11 19:35:27 -08003074 * regulator_set_load - set regulator load
Liam Girdwood414c70c2008-04-30 15:59:04 +01003075 * @regulator: regulator source
3076 * @uA_load: load current
3077 *
3078 * Notifies the regulator core of a new device load. This is then used by
3079 * DRMS (if enabled by constraints) to set the most efficient regulator
3080 * operating mode for the new regulator loading.
3081 *
3082 * Consumer devices notify their supply regulator of the maximum power
3083 * they will require (can be taken from device datasheet in the power
3084 * consumption tables) when they change operational status and hence power
3085 * state. Examples of operational state changes that can affect power
3086 * consumption are :-
3087 *
3088 * o Device is opened / closed.
3089 * o Device I/O is about to begin or has just finished.
3090 * o Device is idling in between work.
3091 *
3092 * This information is also exported via sysfs to userspace.
3093 *
3094 * DRMS will sum the total requested load on the regulator and change
3095 * to the most efficient operating mode if platform constraints allow.
3096 *
Bjorn Anderssone39ce482015-02-11 19:35:27 -08003097 * On error a negative errno is returned.
Liam Girdwood414c70c2008-04-30 15:59:04 +01003098 */
Bjorn Anderssone39ce482015-02-11 19:35:27 -08003099int regulator_set_load(struct regulator *regulator, int uA_load)
Liam Girdwood414c70c2008-04-30 15:59:04 +01003100{
3101 struct regulator_dev *rdev = regulator->rdev;
Bjorn Andersson8460ef32015-01-27 18:46:31 -08003102 int ret;
Stephen Boydd92d95b62012-07-02 19:21:06 -07003103
Liam Girdwood414c70c2008-04-30 15:59:04 +01003104 mutex_lock(&rdev->mutex);
Liam Girdwood414c70c2008-04-30 15:59:04 +01003105 regulator->uA_load = uA_load;
Bjorn Andersson8460ef32015-01-27 18:46:31 -08003106 ret = drms_uA_update(rdev);
Liam Girdwood414c70c2008-04-30 15:59:04 +01003107 mutex_unlock(&rdev->mutex);
Bjorn Andersson8460ef32015-01-27 18:46:31 -08003108
Liam Girdwood414c70c2008-04-30 15:59:04 +01003109 return ret;
3110}
Bjorn Anderssone39ce482015-02-11 19:35:27 -08003111EXPORT_SYMBOL_GPL(regulator_set_load);
Liam Girdwood414c70c2008-04-30 15:59:04 +01003112
3113/**
Mark Brownf59c8f92012-08-31 10:36:37 -07003114 * regulator_allow_bypass - allow the regulator to go into bypass mode
3115 *
3116 * @regulator: Regulator to configure
Nishanth Menon9345dfb2013-02-28 18:44:54 -06003117 * @enable: enable or disable bypass mode
Mark Brownf59c8f92012-08-31 10:36:37 -07003118 *
3119 * Allow the regulator to go into bypass mode if all other consumers
3120 * for the regulator also enable bypass mode and the machine
3121 * constraints allow this. Bypass mode means that the regulator is
3122 * simply passing the input directly to the output with no regulation.
3123 */
3124int regulator_allow_bypass(struct regulator *regulator, bool enable)
3125{
3126 struct regulator_dev *rdev = regulator->rdev;
3127 int ret = 0;
3128
3129 if (!rdev->desc->ops->set_bypass)
3130 return 0;
3131
3132 if (rdev->constraints &&
3133 !(rdev->constraints->valid_ops_mask & REGULATOR_CHANGE_BYPASS))
3134 return 0;
3135
3136 mutex_lock(&rdev->mutex);
3137
3138 if (enable && !regulator->bypass) {
3139 rdev->bypass_count++;
3140
3141 if (rdev->bypass_count == rdev->open_count) {
3142 ret = rdev->desc->ops->set_bypass(rdev, enable);
3143 if (ret != 0)
3144 rdev->bypass_count--;
3145 }
3146
3147 } else if (!enable && regulator->bypass) {
3148 rdev->bypass_count--;
3149
3150 if (rdev->bypass_count != rdev->open_count) {
3151 ret = rdev->desc->ops->set_bypass(rdev, enable);
3152 if (ret != 0)
3153 rdev->bypass_count++;
3154 }
3155 }
3156
3157 if (ret == 0)
3158 regulator->bypass = enable;
3159
3160 mutex_unlock(&rdev->mutex);
3161
3162 return ret;
3163}
3164EXPORT_SYMBOL_GPL(regulator_allow_bypass);
3165
3166/**
Liam Girdwood414c70c2008-04-30 15:59:04 +01003167 * regulator_register_notifier - register regulator event notifier
3168 * @regulator: regulator source
Mark Brown69279fb2008-12-31 12:52:41 +00003169 * @nb: notifier block
Liam Girdwood414c70c2008-04-30 15:59:04 +01003170 *
3171 * Register notifier block to receive regulator events.
3172 */
3173int regulator_register_notifier(struct regulator *regulator,
3174 struct notifier_block *nb)
3175{
3176 return blocking_notifier_chain_register(&regulator->rdev->notifier,
3177 nb);
3178}
3179EXPORT_SYMBOL_GPL(regulator_register_notifier);
3180
3181/**
3182 * regulator_unregister_notifier - unregister regulator event notifier
3183 * @regulator: regulator source
Mark Brown69279fb2008-12-31 12:52:41 +00003184 * @nb: notifier block
Liam Girdwood414c70c2008-04-30 15:59:04 +01003185 *
3186 * Unregister regulator event notifier block.
3187 */
3188int regulator_unregister_notifier(struct regulator *regulator,
3189 struct notifier_block *nb)
3190{
3191 return blocking_notifier_chain_unregister(&regulator->rdev->notifier,
3192 nb);
3193}
3194EXPORT_SYMBOL_GPL(regulator_unregister_notifier);
3195
Jonathan Cameronb136fb42009-01-19 18:20:58 +00003196/* notify regulator consumers and downstream regulator consumers.
3197 * Note mutex must be held by caller.
3198 */
Heiko Stübner71795692014-08-28 12:36:04 -07003199static int _notifier_call_chain(struct regulator_dev *rdev,
Liam Girdwood414c70c2008-04-30 15:59:04 +01003200 unsigned long event, void *data)
3201{
Liam Girdwood414c70c2008-04-30 15:59:04 +01003202 /* call rdev chain first */
Heiko Stübner71795692014-08-28 12:36:04 -07003203 return blocking_notifier_call_chain(&rdev->notifier, event, data);
Liam Girdwood414c70c2008-04-30 15:59:04 +01003204}
3205
3206/**
3207 * regulator_bulk_get - get multiple regulator consumers
3208 *
3209 * @dev: Device to supply
3210 * @num_consumers: Number of consumers to register
3211 * @consumers: Configuration of consumers; clients are stored here.
3212 *
3213 * @return 0 on success, an errno on failure.
3214 *
3215 * This helper function allows drivers to get several regulator
3216 * consumers in one operation. If any of the regulators cannot be
3217 * acquired then any regulators that were allocated will be freed
3218 * before returning to the caller.
3219 */
3220int regulator_bulk_get(struct device *dev, int num_consumers,
3221 struct regulator_bulk_data *consumers)
3222{
3223 int i;
3224 int ret;
3225
3226 for (i = 0; i < num_consumers; i++)
3227 consumers[i].consumer = NULL;
3228
3229 for (i = 0; i < num_consumers; i++) {
3230 consumers[i].consumer = regulator_get(dev,
3231 consumers[i].supply);
3232 if (IS_ERR(consumers[i].consumer)) {
Liam Girdwood414c70c2008-04-30 15:59:04 +01003233 ret = PTR_ERR(consumers[i].consumer);
Mark Brown5b307622009-10-13 13:06:49 +01003234 dev_err(dev, "Failed to get supply '%s': %d\n",
3235 consumers[i].supply, ret);
Liam Girdwood414c70c2008-04-30 15:59:04 +01003236 consumers[i].consumer = NULL;
3237 goto err;
3238 }
3239 }
3240
3241 return 0;
3242
3243err:
Axel Linb29c7692012-02-20 10:32:16 +08003244 while (--i >= 0)
Liam Girdwood414c70c2008-04-30 15:59:04 +01003245 regulator_put(consumers[i].consumer);
3246
3247 return ret;
3248}
3249EXPORT_SYMBOL_GPL(regulator_bulk_get);
3250
Mark Brownf21e0e82011-05-24 08:12:40 +08003251static void regulator_bulk_enable_async(void *data, async_cookie_t cookie)
3252{
3253 struct regulator_bulk_data *bulk = data;
3254
3255 bulk->ret = regulator_enable(bulk->consumer);
3256}
3257
Liam Girdwood414c70c2008-04-30 15:59:04 +01003258/**
3259 * regulator_bulk_enable - enable multiple regulator consumers
3260 *
3261 * @num_consumers: Number of consumers
3262 * @consumers: Consumer data; clients are stored here.
3263 * @return 0 on success, an errno on failure
3264 *
3265 * This convenience API allows consumers to enable multiple regulator
3266 * clients in a single API call. If any consumers cannot be enabled
3267 * then any others that were enabled will be disabled again prior to
3268 * return.
3269 */
3270int regulator_bulk_enable(int num_consumers,
3271 struct regulator_bulk_data *consumers)
3272{
Dan Williams2955b472012-07-09 19:33:25 -07003273 ASYNC_DOMAIN_EXCLUSIVE(async_domain);
Liam Girdwood414c70c2008-04-30 15:59:04 +01003274 int i;
Mark Brownf21e0e82011-05-24 08:12:40 +08003275 int ret = 0;
Liam Girdwood414c70c2008-04-30 15:59:04 +01003276
Mark Brown6492bc12012-04-19 13:19:07 +01003277 for (i = 0; i < num_consumers; i++) {
3278 if (consumers[i].consumer->always_on)
3279 consumers[i].ret = 0;
3280 else
3281 async_schedule_domain(regulator_bulk_enable_async,
3282 &consumers[i], &async_domain);
3283 }
Mark Brownf21e0e82011-05-24 08:12:40 +08003284
3285 async_synchronize_full_domain(&async_domain);
3286
3287 /* If any consumer failed we need to unwind any that succeeded */
Liam Girdwood414c70c2008-04-30 15:59:04 +01003288 for (i = 0; i < num_consumers; i++) {
Mark Brownf21e0e82011-05-24 08:12:40 +08003289 if (consumers[i].ret != 0) {
3290 ret = consumers[i].ret;
Liam Girdwood414c70c2008-04-30 15:59:04 +01003291 goto err;
Mark Brownf21e0e82011-05-24 08:12:40 +08003292 }
Liam Girdwood414c70c2008-04-30 15:59:04 +01003293 }
3294
3295 return 0;
3296
3297err:
Andrzej Hajdafbe31052013-03-01 12:24:05 +01003298 for (i = 0; i < num_consumers; i++) {
3299 if (consumers[i].ret < 0)
3300 pr_err("Failed to enable %s: %d\n", consumers[i].supply,
3301 consumers[i].ret);
3302 else
3303 regulator_disable(consumers[i].consumer);
3304 }
Liam Girdwood414c70c2008-04-30 15:59:04 +01003305
3306 return ret;
3307}
3308EXPORT_SYMBOL_GPL(regulator_bulk_enable);
3309
3310/**
3311 * regulator_bulk_disable - disable multiple regulator consumers
3312 *
3313 * @num_consumers: Number of consumers
3314 * @consumers: Consumer data; clients are stored here.
3315 * @return 0 on success, an errno on failure
3316 *
3317 * This convenience API allows consumers to disable multiple regulator
Sylwester Nawrocki49e22632012-01-25 12:35:38 +01003318 * clients in a single API call. If any consumers cannot be disabled
3319 * then any others that were disabled will be enabled again prior to
Liam Girdwood414c70c2008-04-30 15:59:04 +01003320 * return.
3321 */
3322int regulator_bulk_disable(int num_consumers,
3323 struct regulator_bulk_data *consumers)
3324{
3325 int i;
Mark Brown01e86f42012-03-28 21:36:38 +01003326 int ret, r;
Liam Girdwood414c70c2008-04-30 15:59:04 +01003327
Sylwester Nawrocki49e22632012-01-25 12:35:38 +01003328 for (i = num_consumers - 1; i >= 0; --i) {
Liam Girdwood414c70c2008-04-30 15:59:04 +01003329 ret = regulator_disable(consumers[i].consumer);
3330 if (ret != 0)
3331 goto err;
3332 }
3333
3334 return 0;
3335
3336err:
Joe Perches5da84fd2010-11-30 05:53:48 -08003337 pr_err("Failed to disable %s: %d\n", consumers[i].supply, ret);
Mark Brown01e86f42012-03-28 21:36:38 +01003338 for (++i; i < num_consumers; ++i) {
3339 r = regulator_enable(consumers[i].consumer);
3340 if (r != 0)
3341 pr_err("Failed to reename %s: %d\n",
3342 consumers[i].supply, r);
3343 }
Liam Girdwood414c70c2008-04-30 15:59:04 +01003344
3345 return ret;
3346}
3347EXPORT_SYMBOL_GPL(regulator_bulk_disable);
3348
3349/**
Donggeun Kime1de2f42012-01-03 16:22:03 +09003350 * regulator_bulk_force_disable - force disable multiple regulator consumers
3351 *
3352 * @num_consumers: Number of consumers
3353 * @consumers: Consumer data; clients are stored here.
3354 * @return 0 on success, an errno on failure
3355 *
3356 * This convenience API allows consumers to forcibly disable multiple regulator
3357 * clients in a single API call.
3358 * NOTE: This should be used for situations when device damage will
3359 * likely occur if the regulators are not disabled (e.g. over temp).
3360 * Although regulator_force_disable function call for some consumers can
3361 * return error numbers, the function is called for all consumers.
3362 */
3363int regulator_bulk_force_disable(int num_consumers,
3364 struct regulator_bulk_data *consumers)
3365{
3366 int i;
3367 int ret;
3368
3369 for (i = 0; i < num_consumers; i++)
3370 consumers[i].ret =
3371 regulator_force_disable(consumers[i].consumer);
3372
3373 for (i = 0; i < num_consumers; i++) {
3374 if (consumers[i].ret != 0) {
3375 ret = consumers[i].ret;
3376 goto out;
3377 }
3378 }
3379
3380 return 0;
3381out:
3382 return ret;
3383}
3384EXPORT_SYMBOL_GPL(regulator_bulk_force_disable);
3385
3386/**
Liam Girdwood414c70c2008-04-30 15:59:04 +01003387 * regulator_bulk_free - free multiple regulator consumers
3388 *
3389 * @num_consumers: Number of consumers
3390 * @consumers: Consumer data; clients are stored here.
3391 *
3392 * This convenience API allows consumers to free multiple regulator
3393 * clients in a single API call.
3394 */
3395void regulator_bulk_free(int num_consumers,
3396 struct regulator_bulk_data *consumers)
3397{
3398 int i;
3399
3400 for (i = 0; i < num_consumers; i++) {
3401 regulator_put(consumers[i].consumer);
3402 consumers[i].consumer = NULL;
3403 }
3404}
3405EXPORT_SYMBOL_GPL(regulator_bulk_free);
3406
3407/**
3408 * regulator_notifier_call_chain - call regulator event notifier
Mark Brown69279fb2008-12-31 12:52:41 +00003409 * @rdev: regulator source
Liam Girdwood414c70c2008-04-30 15:59:04 +01003410 * @event: notifier block
Mark Brown69279fb2008-12-31 12:52:41 +00003411 * @data: callback-specific data.
Liam Girdwood414c70c2008-04-30 15:59:04 +01003412 *
3413 * Called by regulator drivers to notify clients a regulator event has
3414 * occurred. We also notify regulator clients downstream.
Jonathan Cameronb136fb42009-01-19 18:20:58 +00003415 * Note lock must be held by caller.
Liam Girdwood414c70c2008-04-30 15:59:04 +01003416 */
3417int regulator_notifier_call_chain(struct regulator_dev *rdev,
3418 unsigned long event, void *data)
3419{
3420 _notifier_call_chain(rdev, event, data);
3421 return NOTIFY_DONE;
3422
3423}
3424EXPORT_SYMBOL_GPL(regulator_notifier_call_chain);
3425
Mark Brownbe721972009-08-04 20:09:52 +02003426/**
3427 * regulator_mode_to_status - convert a regulator mode into a status
3428 *
3429 * @mode: Mode to convert
3430 *
3431 * Convert a regulator mode into a status.
3432 */
3433int regulator_mode_to_status(unsigned int mode)
3434{
3435 switch (mode) {
3436 case REGULATOR_MODE_FAST:
3437 return REGULATOR_STATUS_FAST;
3438 case REGULATOR_MODE_NORMAL:
3439 return REGULATOR_STATUS_NORMAL;
3440 case REGULATOR_MODE_IDLE:
3441 return REGULATOR_STATUS_IDLE;
Krystian Garbaciak03ffcf32012-07-12 11:50:38 +01003442 case REGULATOR_MODE_STANDBY:
Mark Brownbe721972009-08-04 20:09:52 +02003443 return REGULATOR_STATUS_STANDBY;
3444 default:
Krystian Garbaciak1beaf762012-07-12 13:53:35 +01003445 return REGULATOR_STATUS_UNDEFINED;
Mark Brownbe721972009-08-04 20:09:52 +02003446 }
3447}
3448EXPORT_SYMBOL_GPL(regulator_mode_to_status);
3449
Takashi Iwai39f802d2015-01-30 20:29:31 +01003450static struct attribute *regulator_dev_attrs[] = {
3451 &dev_attr_name.attr,
3452 &dev_attr_num_users.attr,
3453 &dev_attr_type.attr,
3454 &dev_attr_microvolts.attr,
3455 &dev_attr_microamps.attr,
3456 &dev_attr_opmode.attr,
3457 &dev_attr_state.attr,
3458 &dev_attr_status.attr,
3459 &dev_attr_bypass.attr,
3460 &dev_attr_requested_microamps.attr,
3461 &dev_attr_min_microvolts.attr,
3462 &dev_attr_max_microvolts.attr,
3463 &dev_attr_min_microamps.attr,
3464 &dev_attr_max_microamps.attr,
3465 &dev_attr_suspend_standby_state.attr,
3466 &dev_attr_suspend_mem_state.attr,
3467 &dev_attr_suspend_disk_state.attr,
3468 &dev_attr_suspend_standby_microvolts.attr,
3469 &dev_attr_suspend_mem_microvolts.attr,
3470 &dev_attr_suspend_disk_microvolts.attr,
3471 &dev_attr_suspend_standby_mode.attr,
3472 &dev_attr_suspend_mem_mode.attr,
3473 &dev_attr_suspend_disk_mode.attr,
3474 NULL
3475};
3476
David Brownell7ad68e22008-11-11 17:39:02 -08003477/*
3478 * To avoid cluttering sysfs (and memory) with useless state, only
3479 * create attributes that can be meaningfully displayed.
3480 */
Takashi Iwai39f802d2015-01-30 20:29:31 +01003481static umode_t regulator_attr_is_visible(struct kobject *kobj,
3482 struct attribute *attr, int idx)
David Brownell7ad68e22008-11-11 17:39:02 -08003483{
Takashi Iwai39f802d2015-01-30 20:29:31 +01003484 struct device *dev = kobj_to_dev(kobj);
3485 struct regulator_dev *rdev = container_of(dev, struct regulator_dev, dev);
Guodong Xu272e2312014-08-13 19:33:38 +08003486 const struct regulator_ops *ops = rdev->desc->ops;
Takashi Iwai39f802d2015-01-30 20:29:31 +01003487 umode_t mode = attr->mode;
3488
3489 /* these three are always present */
3490 if (attr == &dev_attr_name.attr ||
3491 attr == &dev_attr_num_users.attr ||
3492 attr == &dev_attr_type.attr)
3493 return mode;
David Brownell7ad68e22008-11-11 17:39:02 -08003494
3495 /* some attributes need specific methods to be displayed */
Takashi Iwai39f802d2015-01-30 20:29:31 +01003496 if (attr == &dev_attr_microvolts.attr) {
3497 if ((ops->get_voltage && ops->get_voltage(rdev) >= 0) ||
3498 (ops->get_voltage_sel && ops->get_voltage_sel(rdev) >= 0) ||
3499 (ops->list_voltage && ops->list_voltage(rdev, 0) >= 0) ||
3500 (rdev->desc->fixed_uV && rdev->desc->n_voltages == 1))
3501 return mode;
3502 return 0;
Mark Brownf59c8f92012-08-31 10:36:37 -07003503 }
David Brownell7ad68e22008-11-11 17:39:02 -08003504
Takashi Iwai39f802d2015-01-30 20:29:31 +01003505 if (attr == &dev_attr_microamps.attr)
3506 return ops->get_current_limit ? mode : 0;
3507
3508 if (attr == &dev_attr_opmode.attr)
3509 return ops->get_mode ? mode : 0;
3510
3511 if (attr == &dev_attr_state.attr)
3512 return (rdev->ena_pin || ops->is_enabled) ? mode : 0;
3513
3514 if (attr == &dev_attr_status.attr)
3515 return ops->get_status ? mode : 0;
3516
3517 if (attr == &dev_attr_bypass.attr)
3518 return ops->get_bypass ? mode : 0;
3519
David Brownell7ad68e22008-11-11 17:39:02 -08003520 /* some attributes are type-specific */
Takashi Iwai39f802d2015-01-30 20:29:31 +01003521 if (attr == &dev_attr_requested_microamps.attr)
3522 return rdev->desc->type == REGULATOR_CURRENT ? mode : 0;
David Brownell7ad68e22008-11-11 17:39:02 -08003523
David Brownell7ad68e22008-11-11 17:39:02 -08003524 /* constraints need specific supporting methods */
Takashi Iwai39f802d2015-01-30 20:29:31 +01003525 if (attr == &dev_attr_min_microvolts.attr ||
3526 attr == &dev_attr_max_microvolts.attr)
3527 return (ops->set_voltage || ops->set_voltage_sel) ? mode : 0;
David Brownell7ad68e22008-11-11 17:39:02 -08003528
Takashi Iwai39f802d2015-01-30 20:29:31 +01003529 if (attr == &dev_attr_min_microamps.attr ||
3530 attr == &dev_attr_max_microamps.attr)
3531 return ops->set_current_limit ? mode : 0;
David Brownell7ad68e22008-11-11 17:39:02 -08003532
Takashi Iwai39f802d2015-01-30 20:29:31 +01003533 if (attr == &dev_attr_suspend_standby_state.attr ||
3534 attr == &dev_attr_suspend_mem_state.attr ||
3535 attr == &dev_attr_suspend_disk_state.attr)
3536 return mode;
David Brownell7ad68e22008-11-11 17:39:02 -08003537
Takashi Iwai39f802d2015-01-30 20:29:31 +01003538 if (attr == &dev_attr_suspend_standby_microvolts.attr ||
3539 attr == &dev_attr_suspend_mem_microvolts.attr ||
3540 attr == &dev_attr_suspend_disk_microvolts.attr)
3541 return ops->set_suspend_voltage ? mode : 0;
David Brownell7ad68e22008-11-11 17:39:02 -08003542
Takashi Iwai39f802d2015-01-30 20:29:31 +01003543 if (attr == &dev_attr_suspend_standby_mode.attr ||
3544 attr == &dev_attr_suspend_mem_mode.attr ||
3545 attr == &dev_attr_suspend_disk_mode.attr)
3546 return ops->set_suspend_mode ? mode : 0;
3547
3548 return mode;
David Brownell7ad68e22008-11-11 17:39:02 -08003549}
3550
Takashi Iwai39f802d2015-01-30 20:29:31 +01003551static const struct attribute_group regulator_dev_group = {
3552 .attrs = regulator_dev_attrs,
3553 .is_visible = regulator_attr_is_visible,
3554};
3555
3556static const struct attribute_group *regulator_dev_groups[] = {
3557 &regulator_dev_group,
3558 NULL
3559};
3560
3561static void regulator_dev_release(struct device *dev)
3562{
3563 struct regulator_dev *rdev = dev_get_drvdata(dev);
3564 kfree(rdev);
3565}
3566
3567static struct class regulator_class = {
3568 .name = "regulator",
3569 .dev_release = regulator_dev_release,
3570 .dev_groups = regulator_dev_groups,
3571};
3572
Mark Brown1130e5b2010-12-21 23:49:31 +00003573static void rdev_init_debugfs(struct regulator_dev *rdev)
3574{
Guenter Roecka9eaa812014-10-17 08:17:03 -07003575 struct device *parent = rdev->dev.parent;
3576 const char *rname = rdev_get_name(rdev);
3577 char name[NAME_MAX];
3578
3579 /* Avoid duplicate debugfs directory names */
3580 if (parent && rname == rdev->desc->name) {
3581 snprintf(name, sizeof(name), "%s-%s", dev_name(parent),
3582 rname);
3583 rname = name;
3584 }
3585
3586 rdev->debugfs = debugfs_create_dir(rname, debugfs_root);
Stephen Boyd24751432012-02-20 22:50:42 -08003587 if (!rdev->debugfs) {
Mark Brown1130e5b2010-12-21 23:49:31 +00003588 rdev_warn(rdev, "Failed to create debugfs directory\n");
Mark Brown1130e5b2010-12-21 23:49:31 +00003589 return;
3590 }
3591
3592 debugfs_create_u32("use_count", 0444, rdev->debugfs,
3593 &rdev->use_count);
3594 debugfs_create_u32("open_count", 0444, rdev->debugfs,
3595 &rdev->open_count);
Mark Brownf59c8f92012-08-31 10:36:37 -07003596 debugfs_create_u32("bypass_count", 0444, rdev->debugfs,
3597 &rdev->bypass_count);
Mark Brown1130e5b2010-12-21 23:49:31 +00003598}
3599
Liam Girdwood414c70c2008-04-30 15:59:04 +01003600/**
3601 * regulator_register - register regulator
Mark Brown69279fb2008-12-31 12:52:41 +00003602 * @regulator_desc: regulator to register
Krzysztof Kozlowskif47531b2015-01-12 09:01:39 +01003603 * @cfg: runtime configuration for regulator
Liam Girdwood414c70c2008-04-30 15:59:04 +01003604 *
3605 * Called by regulator drivers to register a regulator.
Axel Lin03846182013-01-03 21:01:47 +08003606 * Returns a valid pointer to struct regulator_dev on success
3607 * or an ERR_PTR() on error.
Liam Girdwood414c70c2008-04-30 15:59:04 +01003608 */
Mark Brown65f26842012-04-03 20:46:53 +01003609struct regulator_dev *
3610regulator_register(const struct regulator_desc *regulator_desc,
Krzysztof Kozlowski1b3de222015-01-05 12:48:41 +01003611 const struct regulator_config *cfg)
Liam Girdwood414c70c2008-04-30 15:59:04 +01003612{
Mark Brown9a8f5e02011-11-29 18:11:19 +00003613 const struct regulation_constraints *constraints = NULL;
Mark Brownc1727082012-04-04 00:50:22 +01003614 const struct regulator_init_data *init_data;
Krzysztof Kozlowski1b3de222015-01-05 12:48:41 +01003615 struct regulator_config *config = NULL;
Aniroop Mathur72dca062014-12-28 22:08:38 +05303616 static atomic_t regulator_no = ATOMIC_INIT(-1);
Liam Girdwood414c70c2008-04-30 15:59:04 +01003617 struct regulator_dev *rdev;
Mark Brown32c8fad2012-04-11 10:19:12 +01003618 struct device *dev;
Liam Girdwooda5766f12008-10-10 13:22:20 +01003619 int ret, i;
Liam Girdwood414c70c2008-04-30 15:59:04 +01003620
Krzysztof Kozlowski1b3de222015-01-05 12:48:41 +01003621 if (regulator_desc == NULL || cfg == NULL)
Liam Girdwood414c70c2008-04-30 15:59:04 +01003622 return ERR_PTR(-EINVAL);
3623
Krzysztof Kozlowski1b3de222015-01-05 12:48:41 +01003624 dev = cfg->dev;
Mark Browndcf70112012-05-08 18:09:12 +01003625 WARN_ON(!dev);
Mark Brown32c8fad2012-04-11 10:19:12 +01003626
Liam Girdwood414c70c2008-04-30 15:59:04 +01003627 if (regulator_desc->name == NULL || regulator_desc->ops == NULL)
3628 return ERR_PTR(-EINVAL);
3629
Diego Lizierocd78dfc2009-04-14 03:04:47 +02003630 if (regulator_desc->type != REGULATOR_VOLTAGE &&
3631 regulator_desc->type != REGULATOR_CURRENT)
Liam Girdwood414c70c2008-04-30 15:59:04 +01003632 return ERR_PTR(-EINVAL);
3633
Mark Brown476c2d82010-12-10 17:28:07 +00003634 /* Only one of each should be implemented */
3635 WARN_ON(regulator_desc->ops->get_voltage &&
3636 regulator_desc->ops->get_voltage_sel);
Mark Browne8eef822010-12-12 14:36:17 +00003637 WARN_ON(regulator_desc->ops->set_voltage &&
3638 regulator_desc->ops->set_voltage_sel);
Mark Brown476c2d82010-12-10 17:28:07 +00003639
3640 /* If we're using selectors we must implement list_voltage. */
3641 if (regulator_desc->ops->get_voltage_sel &&
3642 !regulator_desc->ops->list_voltage) {
3643 return ERR_PTR(-EINVAL);
3644 }
Mark Browne8eef822010-12-12 14:36:17 +00003645 if (regulator_desc->ops->set_voltage_sel &&
3646 !regulator_desc->ops->list_voltage) {
3647 return ERR_PTR(-EINVAL);
3648 }
Mark Brown476c2d82010-12-10 17:28:07 +00003649
Liam Girdwood414c70c2008-04-30 15:59:04 +01003650 rdev = kzalloc(sizeof(struct regulator_dev), GFP_KERNEL);
3651 if (rdev == NULL)
3652 return ERR_PTR(-ENOMEM);
3653
Krzysztof Kozlowski1b3de222015-01-05 12:48:41 +01003654 /*
3655 * Duplicate the config so the driver could override it after
3656 * parsing init data.
3657 */
3658 config = kmemdup(cfg, sizeof(*cfg), GFP_KERNEL);
3659 if (config == NULL) {
3660 kfree(rdev);
3661 return ERR_PTR(-ENOMEM);
3662 }
3663
Krzysztof Kozlowskibfa21a02015-01-05 12:48:42 +01003664 init_data = regulator_of_get_init_data(dev, regulator_desc, config,
Mark Browna0c7b162014-09-09 23:13:57 +01003665 &rdev->dev.of_node);
3666 if (!init_data) {
3667 init_data = config->init_data;
3668 rdev->dev.of_node = of_node_get(config->of_node);
3669 }
3670
Liam Girdwood414c70c2008-04-30 15:59:04 +01003671 mutex_lock(&regulator_list_mutex);
3672
3673 mutex_init(&rdev->mutex);
Mark Brownc1727082012-04-04 00:50:22 +01003674 rdev->reg_data = config->driver_data;
Liam Girdwood414c70c2008-04-30 15:59:04 +01003675 rdev->owner = regulator_desc->owner;
3676 rdev->desc = regulator_desc;
Mark Brown3a4b0a02012-05-08 18:10:45 +01003677 if (config->regmap)
3678 rdev->regmap = config->regmap;
AnilKumar Ch52b84da2012-09-07 20:45:05 +05303679 else if (dev_get_regmap(dev, NULL))
Mark Brown3a4b0a02012-05-08 18:10:45 +01003680 rdev->regmap = dev_get_regmap(dev, NULL);
AnilKumar Ch52b84da2012-09-07 20:45:05 +05303681 else if (dev->parent)
3682 rdev->regmap = dev_get_regmap(dev->parent, NULL);
Liam Girdwood414c70c2008-04-30 15:59:04 +01003683 INIT_LIST_HEAD(&rdev->consumer_list);
Liam Girdwood414c70c2008-04-30 15:59:04 +01003684 INIT_LIST_HEAD(&rdev->list);
Liam Girdwood414c70c2008-04-30 15:59:04 +01003685 BLOCKING_INIT_NOTIFIER_HEAD(&rdev->notifier);
Mark Brownda07ecd2011-09-11 09:53:50 +01003686 INIT_DELAYED_WORK(&rdev->disable_work, regulator_disable_work);
Liam Girdwood414c70c2008-04-30 15:59:04 +01003687
Liam Girdwooda5766f12008-10-10 13:22:20 +01003688 /* preform any regulator specific init */
Mark Brown9a8f5e02011-11-29 18:11:19 +00003689 if (init_data && init_data->regulator_init) {
Liam Girdwooda5766f12008-10-10 13:22:20 +01003690 ret = init_data->regulator_init(rdev->reg_data);
David Brownell4fca9542008-11-11 17:38:53 -08003691 if (ret < 0)
3692 goto clean;
Liam Girdwooda5766f12008-10-10 13:22:20 +01003693 }
Liam Girdwood414c70c2008-04-30 15:59:04 +01003694
Liam Girdwooda5766f12008-10-10 13:22:20 +01003695 /* register with sysfs */
3696 rdev->dev.class = &regulator_class;
3697 rdev->dev.parent = dev;
Aniroop Mathur72dca062014-12-28 22:08:38 +05303698 dev_set_name(&rdev->dev, "regulator.%lu",
Aniroop Mathur39138812014-12-29 22:36:48 +05303699 (unsigned long) atomic_inc_return(&regulator_no));
Liam Girdwooda5766f12008-10-10 13:22:20 +01003700 ret = device_register(&rdev->dev);
Vasiliy Kulikovad7725c2010-09-19 16:55:01 +04003701 if (ret != 0) {
3702 put_device(&rdev->dev);
David Brownell4fca9542008-11-11 17:38:53 -08003703 goto clean;
Vasiliy Kulikovad7725c2010-09-19 16:55:01 +04003704 }
Liam Girdwooda5766f12008-10-10 13:22:20 +01003705
3706 dev_set_drvdata(&rdev->dev, rdev);
3707
Markus Pargmann76f439d2014-10-08 15:47:05 +02003708 if ((config->ena_gpio || config->ena_gpio_initialized) &&
3709 gpio_is_valid(config->ena_gpio)) {
Kim, Milof19b00d2013-02-18 06:50:39 +00003710 ret = regulator_ena_gpio_request(rdev, config);
Mark Brown65f73502012-06-27 14:14:38 +01003711 if (ret != 0) {
3712 rdev_err(rdev, "Failed to request enable GPIO%d: %d\n",
3713 config->ena_gpio, ret);
Andrew Lunnb2da55d2012-10-28 16:01:11 +01003714 goto wash;
Mark Brown65f73502012-06-27 14:14:38 +01003715 }
Mark Brown65f73502012-06-27 14:14:38 +01003716 }
3717
Mike Rapoport74f544c2008-11-25 14:53:53 +02003718 /* set regulator constraints */
Mark Brown9a8f5e02011-11-29 18:11:19 +00003719 if (init_data)
3720 constraints = &init_data->constraints;
3721
3722 ret = set_machine_constraints(rdev, constraints);
Mike Rapoport74f544c2008-11-25 14:53:53 +02003723 if (ret < 0)
3724 goto scrub;
3725
Mark Brown9a8f5e02011-11-29 18:11:19 +00003726 if (init_data && init_data->supply_regulator)
Bjorn Andersson6261b062015-03-24 18:56:05 -07003727 rdev->supply_name = init_data->supply_regulator;
Rajendra Nayak69511a42011-11-18 16:47:20 +05303728 else if (regulator_desc->supply_name)
Bjorn Andersson6261b062015-03-24 18:56:05 -07003729 rdev->supply_name = regulator_desc->supply_name;
Rajendra Nayak69511a42011-11-18 16:47:20 +05303730
Liam Girdwooda5766f12008-10-10 13:22:20 +01003731 /* add consumers devices */
Mark Brown9a8f5e02011-11-29 18:11:19 +00003732 if (init_data) {
3733 for (i = 0; i < init_data->num_consumer_supplies; i++) {
3734 ret = set_consumer_device_supply(rdev,
Mark Brown9a8f5e02011-11-29 18:11:19 +00003735 init_data->consumer_supplies[i].dev_name,
Mark Brown23c2f042011-02-24 17:39:09 +00003736 init_data->consumer_supplies[i].supply);
Mark Brown9a8f5e02011-11-29 18:11:19 +00003737 if (ret < 0) {
3738 dev_err(dev, "Failed to set supply %s\n",
3739 init_data->consumer_supplies[i].supply);
3740 goto unset_supplies;
3741 }
Mark Brown23c2f042011-02-24 17:39:09 +00003742 }
Liam Girdwooda5766f12008-10-10 13:22:20 +01003743 }
3744
3745 list_add(&rdev->list, &regulator_list);
Mark Brown1130e5b2010-12-21 23:49:31 +00003746
3747 rdev_init_debugfs(rdev);
Liam Girdwooda5766f12008-10-10 13:22:20 +01003748out:
Liam Girdwood414c70c2008-04-30 15:59:04 +01003749 mutex_unlock(&regulator_list_mutex);
Krzysztof Kozlowski1b3de222015-01-05 12:48:41 +01003750 kfree(config);
Liam Girdwood414c70c2008-04-30 15:59:04 +01003751 return rdev;
David Brownell4fca9542008-11-11 17:38:53 -08003752
Jani Nikulad4033b52010-04-29 10:55:11 +03003753unset_supplies:
3754 unset_regulator_supplies(rdev);
3755
David Brownell4fca9542008-11-11 17:38:53 -08003756scrub:
Kim, Milof19b00d2013-02-18 06:50:39 +00003757 regulator_ena_gpio_free(rdev);
Axel Lin1a6958e72011-07-15 10:50:43 +08003758 kfree(rdev->constraints);
Andrew Lunnb2da55d2012-10-28 16:01:11 +01003759wash:
David Brownell4fca9542008-11-11 17:38:53 -08003760 device_unregister(&rdev->dev);
Paul Walmsley53032da2009-04-25 05:28:36 -06003761 /* device core frees rdev */
3762 rdev = ERR_PTR(ret);
3763 goto out;
3764
David Brownell4fca9542008-11-11 17:38:53 -08003765clean:
3766 kfree(rdev);
3767 rdev = ERR_PTR(ret);
3768 goto out;
Liam Girdwood414c70c2008-04-30 15:59:04 +01003769}
3770EXPORT_SYMBOL_GPL(regulator_register);
3771
3772/**
3773 * regulator_unregister - unregister regulator
Mark Brown69279fb2008-12-31 12:52:41 +00003774 * @rdev: regulator to unregister
Liam Girdwood414c70c2008-04-30 15:59:04 +01003775 *
3776 * Called by regulator drivers to unregister a regulator.
3777 */
3778void regulator_unregister(struct regulator_dev *rdev)
3779{
3780 if (rdev == NULL)
3781 return;
3782
Mark Brown891636e2013-07-08 09:14:45 +01003783 if (rdev->supply) {
3784 while (rdev->use_count--)
3785 regulator_disable(rdev->supply);
Mark Browne032b372012-03-28 21:17:55 +01003786 regulator_put(rdev->supply);
Mark Brown891636e2013-07-08 09:14:45 +01003787 }
Liam Girdwood414c70c2008-04-30 15:59:04 +01003788 mutex_lock(&regulator_list_mutex);
Mark Brown1130e5b2010-12-21 23:49:31 +00003789 debugfs_remove_recursive(rdev->debugfs);
Tejun Heo43829732012-08-20 14:51:24 -07003790 flush_work(&rdev->disable_work.work);
Mark Brown6bf87d12009-07-21 16:00:25 +01003791 WARN_ON(rdev->open_count);
Mike Rapoport0f1d7472009-01-22 16:00:29 +02003792 unset_regulator_supplies(rdev);
Liam Girdwood414c70c2008-04-30 15:59:04 +01003793 list_del(&rdev->list);
Mark Brownf8c12fe2010-11-29 15:55:17 +00003794 kfree(rdev->constraints);
Kim, Milof19b00d2013-02-18 06:50:39 +00003795 regulator_ena_gpio_free(rdev);
Charles Keepax63c7c9e2014-04-03 15:32:17 +01003796 of_node_put(rdev->dev.of_node);
Lothar Waßmann58fb5cf2011-11-28 15:38:37 +01003797 device_unregister(&rdev->dev);
Liam Girdwood414c70c2008-04-30 15:59:04 +01003798 mutex_unlock(&regulator_list_mutex);
3799}
3800EXPORT_SYMBOL_GPL(regulator_unregister);
3801
3802/**
Mark Browncf7bbcd2008-12-31 12:52:43 +00003803 * regulator_suspend_prepare - prepare regulators for system wide suspend
Liam Girdwood414c70c2008-04-30 15:59:04 +01003804 * @state: system suspend state
3805 *
3806 * Configure each regulator with it's suspend operating parameters for state.
3807 * This will usually be called by machine suspend code prior to supending.
3808 */
3809int regulator_suspend_prepare(suspend_state_t state)
3810{
3811 struct regulator_dev *rdev;
3812 int ret = 0;
3813
3814 /* ON is handled by regulator active state */
3815 if (state == PM_SUSPEND_ON)
3816 return -EINVAL;
3817
3818 mutex_lock(&regulator_list_mutex);
3819 list_for_each_entry(rdev, &regulator_list, list) {
3820
3821 mutex_lock(&rdev->mutex);
3822 ret = suspend_prepare(rdev, state);
3823 mutex_unlock(&rdev->mutex);
3824
3825 if (ret < 0) {
Joe Perches5da84fd2010-11-30 05:53:48 -08003826 rdev_err(rdev, "failed to prepare\n");
Liam Girdwood414c70c2008-04-30 15:59:04 +01003827 goto out;
3828 }
3829 }
3830out:
3831 mutex_unlock(&regulator_list_mutex);
3832 return ret;
3833}
3834EXPORT_SYMBOL_GPL(regulator_suspend_prepare);
3835
3836/**
MyungJoo Ham7a32b582011-03-11 10:13:59 +09003837 * regulator_suspend_finish - resume regulators from system wide suspend
3838 *
3839 * Turn on regulators that might be turned off by regulator_suspend_prepare
3840 * and that should be turned on according to the regulators properties.
3841 */
3842int regulator_suspend_finish(void)
3843{
3844 struct regulator_dev *rdev;
3845 int ret = 0, error;
3846
3847 mutex_lock(&regulator_list_mutex);
3848 list_for_each_entry(rdev, &regulator_list, list) {
MyungJoo Ham7a32b582011-03-11 10:13:59 +09003849 mutex_lock(&rdev->mutex);
Markus Pargmann30c21972014-02-20 17:36:03 +01003850 if (rdev->use_count > 0 || rdev->constraints->always_on) {
Javier Martinez Canillas0548bf42015-03-02 21:40:39 +01003851 if (!_regulator_is_enabled(rdev)) {
3852 error = _regulator_do_enable(rdev);
3853 if (error)
3854 ret = error;
3855 }
MyungJoo Ham7a32b582011-03-11 10:13:59 +09003856 } else {
Mark Brown87b28412013-11-27 16:13:10 +00003857 if (!have_full_constraints())
MyungJoo Ham7a32b582011-03-11 10:13:59 +09003858 goto unlock;
Mark Brownb1a86832012-05-14 00:40:14 +01003859 if (!_regulator_is_enabled(rdev))
MyungJoo Ham7a32b582011-03-11 10:13:59 +09003860 goto unlock;
3861
Markus Pargmann66fda752014-02-20 17:36:04 +01003862 error = _regulator_do_disable(rdev);
MyungJoo Ham7a32b582011-03-11 10:13:59 +09003863 if (error)
3864 ret = error;
3865 }
3866unlock:
3867 mutex_unlock(&rdev->mutex);
3868 }
3869 mutex_unlock(&regulator_list_mutex);
3870 return ret;
3871}
3872EXPORT_SYMBOL_GPL(regulator_suspend_finish);
3873
3874/**
Mark Brownca725562009-03-16 19:36:34 +00003875 * regulator_has_full_constraints - the system has fully specified constraints
3876 *
3877 * Calling this function will cause the regulator API to disable all
3878 * regulators which have a zero use count and don't have an always_on
3879 * constraint in a late_initcall.
3880 *
3881 * The intention is that this will become the default behaviour in a
3882 * future kernel release so users are encouraged to use this facility
3883 * now.
3884 */
3885void regulator_has_full_constraints(void)
3886{
3887 has_full_constraints = 1;
3888}
3889EXPORT_SYMBOL_GPL(regulator_has_full_constraints);
3890
3891/**
Liam Girdwood414c70c2008-04-30 15:59:04 +01003892 * rdev_get_drvdata - get rdev regulator driver data
Mark Brown69279fb2008-12-31 12:52:41 +00003893 * @rdev: regulator
Liam Girdwood414c70c2008-04-30 15:59:04 +01003894 *
3895 * Get rdev regulator driver private data. This call can be used in the
3896 * regulator driver context.
3897 */
3898void *rdev_get_drvdata(struct regulator_dev *rdev)
3899{
3900 return rdev->reg_data;
3901}
3902EXPORT_SYMBOL_GPL(rdev_get_drvdata);
3903
3904/**
3905 * regulator_get_drvdata - get regulator driver data
3906 * @regulator: regulator
3907 *
3908 * Get regulator driver private data. This call can be used in the consumer
3909 * driver context when non API regulator specific functions need to be called.
3910 */
3911void *regulator_get_drvdata(struct regulator *regulator)
3912{
3913 return regulator->rdev->reg_data;
3914}
3915EXPORT_SYMBOL_GPL(regulator_get_drvdata);
3916
3917/**
3918 * regulator_set_drvdata - set regulator driver data
3919 * @regulator: regulator
3920 * @data: data
3921 */
3922void regulator_set_drvdata(struct regulator *regulator, void *data)
3923{
3924 regulator->rdev->reg_data = data;
3925}
3926EXPORT_SYMBOL_GPL(regulator_set_drvdata);
3927
3928/**
3929 * regulator_get_id - get regulator ID
Mark Brown69279fb2008-12-31 12:52:41 +00003930 * @rdev: regulator
Liam Girdwood414c70c2008-04-30 15:59:04 +01003931 */
3932int rdev_get_id(struct regulator_dev *rdev)
3933{
3934 return rdev->desc->id;
3935}
3936EXPORT_SYMBOL_GPL(rdev_get_id);
3937
Liam Girdwooda5766f12008-10-10 13:22:20 +01003938struct device *rdev_get_dev(struct regulator_dev *rdev)
3939{
3940 return &rdev->dev;
3941}
3942EXPORT_SYMBOL_GPL(rdev_get_dev);
3943
3944void *regulator_get_init_drvdata(struct regulator_init_data *reg_init_data)
3945{
3946 return reg_init_data->driver_data;
3947}
3948EXPORT_SYMBOL_GPL(regulator_get_init_drvdata);
3949
Mark Brownba55a972011-08-23 17:39:10 +01003950#ifdef CONFIG_DEBUG_FS
3951static ssize_t supply_map_read_file(struct file *file, char __user *user_buf,
3952 size_t count, loff_t *ppos)
3953{
3954 char *buf = kmalloc(PAGE_SIZE, GFP_KERNEL);
3955 ssize_t len, ret = 0;
3956 struct regulator_map *map;
3957
3958 if (!buf)
3959 return -ENOMEM;
3960
3961 list_for_each_entry(map, &regulator_map_list, list) {
3962 len = snprintf(buf + ret, PAGE_SIZE - ret,
3963 "%s -> %s.%s\n",
3964 rdev_get_name(map->regulator), map->dev_name,
3965 map->supply);
3966 if (len >= 0)
3967 ret += len;
3968 if (ret > PAGE_SIZE) {
3969 ret = PAGE_SIZE;
3970 break;
3971 }
3972 }
3973
3974 ret = simple_read_from_buffer(user_buf, count, ppos, buf, ret);
3975
3976 kfree(buf);
3977
3978 return ret;
3979}
Stephen Boyd24751432012-02-20 22:50:42 -08003980#endif
Mark Brownba55a972011-08-23 17:39:10 +01003981
3982static const struct file_operations supply_map_fops = {
Stephen Boyd24751432012-02-20 22:50:42 -08003983#ifdef CONFIG_DEBUG_FS
Mark Brownba55a972011-08-23 17:39:10 +01003984 .read = supply_map_read_file,
3985 .llseek = default_llseek,
Mark Brownba55a972011-08-23 17:39:10 +01003986#endif
Stephen Boyd24751432012-02-20 22:50:42 -08003987};
Mark Brownba55a972011-08-23 17:39:10 +01003988
Heiko Stübner7c225ec2015-04-07 16:16:39 +02003989#ifdef CONFIG_DEBUG_FS
3990static void regulator_summary_show_subtree(struct seq_file *s,
3991 struct regulator_dev *rdev,
3992 int level)
3993{
3994 struct list_head *list = s->private;
3995 struct regulator_dev *child;
3996 struct regulation_constraints *c;
3997 struct regulator *consumer;
3998
3999 if (!rdev)
4000 return;
4001
Heiko Stübner7c225ec2015-04-07 16:16:39 +02004002 seq_printf(s, "%*s%-*s %3d %4d %6d ",
4003 level * 3 + 1, "",
4004 30 - level * 3, rdev_get_name(rdev),
4005 rdev->use_count, rdev->open_count, rdev->bypass_count);
4006
Heiko Stübner23296092015-04-10 13:48:41 +02004007 seq_printf(s, "%5dmV ", _regulator_get_voltage(rdev) / 1000);
4008 seq_printf(s, "%5dmA ", _regulator_get_current_limit(rdev) / 1000);
Heiko Stübner7c225ec2015-04-07 16:16:39 +02004009
4010 c = rdev->constraints;
4011 if (c) {
4012 switch (rdev->desc->type) {
4013 case REGULATOR_VOLTAGE:
4014 seq_printf(s, "%5dmV %5dmV ",
4015 c->min_uV / 1000, c->max_uV / 1000);
4016 break;
4017 case REGULATOR_CURRENT:
4018 seq_printf(s, "%5dmA %5dmA ",
4019 c->min_uA / 1000, c->max_uA / 1000);
4020 break;
4021 }
4022 }
4023
4024 seq_puts(s, "\n");
4025
4026 list_for_each_entry(consumer, &rdev->consumer_list, list) {
4027 if (consumer->dev->class == &regulator_class)
4028 continue;
4029
4030 seq_printf(s, "%*s%-*s ",
4031 (level + 1) * 3 + 1, "",
4032 30 - (level + 1) * 3, dev_name(consumer->dev));
4033
4034 switch (rdev->desc->type) {
4035 case REGULATOR_VOLTAGE:
Heiko Stübner23296092015-04-10 13:48:41 +02004036 seq_printf(s, "%37dmV %5dmV",
Heiko Stübner7c225ec2015-04-07 16:16:39 +02004037 consumer->min_uV / 1000,
4038 consumer->max_uV / 1000);
4039 break;
4040 case REGULATOR_CURRENT:
Heiko Stübner7c225ec2015-04-07 16:16:39 +02004041 break;
4042 }
4043
4044 seq_puts(s, "\n");
4045 }
4046
Heiko Stübner7c225ec2015-04-07 16:16:39 +02004047 list_for_each_entry(child, list, list) {
4048 /* handle only non-root regulators supplied by current rdev */
4049 if (!child->supply || child->supply->rdev != rdev)
4050 continue;
4051
4052 regulator_summary_show_subtree(s, child, level + 1);
4053 }
4054}
4055
4056static int regulator_summary_show(struct seq_file *s, void *data)
4057{
4058 struct list_head *list = s->private;
4059 struct regulator_dev *rdev;
4060
Heiko Stübner23296092015-04-10 13:48:41 +02004061 seq_puts(s, " regulator use open bypass voltage current min max\n");
4062 seq_puts(s, "-------------------------------------------------------------------------------\n");
Heiko Stübner7c225ec2015-04-07 16:16:39 +02004063
4064 mutex_lock(&regulator_list_mutex);
4065
4066 list_for_each_entry(rdev, list, list) {
4067 if (rdev->supply)
4068 continue;
4069
4070 regulator_summary_show_subtree(s, rdev, 0);
4071 }
4072
4073 mutex_unlock(&regulator_list_mutex);
4074
4075 return 0;
4076}
4077
4078static int regulator_summary_open(struct inode *inode, struct file *file)
4079{
4080 return single_open(file, regulator_summary_show, inode->i_private);
4081}
4082#endif
4083
4084static const struct file_operations regulator_summary_fops = {
4085#ifdef CONFIG_DEBUG_FS
4086 .open = regulator_summary_open,
4087 .read = seq_read,
4088 .llseek = seq_lseek,
4089 .release = single_release,
4090#endif
4091};
4092
Liam Girdwood414c70c2008-04-30 15:59:04 +01004093static int __init regulator_init(void)
4094{
Mark Brown34abbd62010-02-12 10:18:08 +00004095 int ret;
4096
Mark Brown34abbd62010-02-12 10:18:08 +00004097 ret = class_register(&regulator_class);
4098
Mark Brown1130e5b2010-12-21 23:49:31 +00004099 debugfs_root = debugfs_create_dir("regulator", NULL);
Stephen Boyd24751432012-02-20 22:50:42 -08004100 if (!debugfs_root)
Mark Brown1130e5b2010-12-21 23:49:31 +00004101 pr_warn("regulator: Failed to create debugfs directory\n");
Mark Brownba55a972011-08-23 17:39:10 +01004102
Mark Brownf4d562c2012-02-20 21:01:04 +00004103 debugfs_create_file("supply_map", 0444, debugfs_root, NULL,
4104 &supply_map_fops);
Mark Brown1130e5b2010-12-21 23:49:31 +00004105
Heiko Stübner7c225ec2015-04-07 16:16:39 +02004106 debugfs_create_file("regulator_summary", 0444, debugfs_root,
4107 &regulator_list, &regulator_summary_fops);
4108
Mark Brown34abbd62010-02-12 10:18:08 +00004109 regulator_dummy_init();
4110
4111 return ret;
Liam Girdwood414c70c2008-04-30 15:59:04 +01004112}
4113
4114/* init early to allow our consumers to complete system booting */
4115core_initcall(regulator_init);
Mark Brownca725562009-03-16 19:36:34 +00004116
4117static int __init regulator_init_complete(void)
4118{
4119 struct regulator_dev *rdev;
Guodong Xu272e2312014-08-13 19:33:38 +08004120 const struct regulator_ops *ops;
Mark Brownca725562009-03-16 19:36:34 +00004121 struct regulation_constraints *c;
4122 int enabled, ret;
Mark Brownca725562009-03-16 19:36:34 +00004123
Mark Brown86f5fcf2012-07-06 18:19:13 +01004124 /*
4125 * Since DT doesn't provide an idiomatic mechanism for
4126 * enabling full constraints and since it's much more natural
4127 * with DT to provide them just assume that a DT enabled
4128 * system has full constraints.
4129 */
4130 if (of_have_populated_dt())
4131 has_full_constraints = true;
4132
Mark Brownca725562009-03-16 19:36:34 +00004133 mutex_lock(&regulator_list_mutex);
4134
4135 /* If we have a full configuration then disable any regulators
Mark Browne9535832014-06-01 19:15:16 +01004136 * we have permission to change the status for and which are
4137 * not in use or always_on. This is effectively the default
4138 * for DT and ACPI as they have full constraints.
Mark Brownca725562009-03-16 19:36:34 +00004139 */
4140 list_for_each_entry(rdev, &regulator_list, list) {
4141 ops = rdev->desc->ops;
4142 c = rdev->constraints;
4143
Markus Pargmann66fda752014-02-20 17:36:04 +01004144 if (c && c->always_on)
Mark Brownca725562009-03-16 19:36:34 +00004145 continue;
4146
Mark Browne9535832014-06-01 19:15:16 +01004147 if (c && !(c->valid_ops_mask & REGULATOR_CHANGE_STATUS))
4148 continue;
4149
Mark Brownca725562009-03-16 19:36:34 +00004150 mutex_lock(&rdev->mutex);
4151
4152 if (rdev->use_count)
4153 goto unlock;
4154
4155 /* If we can't read the status assume it's on. */
4156 if (ops->is_enabled)
4157 enabled = ops->is_enabled(rdev);
4158 else
4159 enabled = 1;
4160
4161 if (!enabled)
4162 goto unlock;
4163
Mark Brown87b28412013-11-27 16:13:10 +00004164 if (have_full_constraints()) {
Mark Brownca725562009-03-16 19:36:34 +00004165 /* We log since this may kill the system if it
4166 * goes wrong. */
Joe Perches5da84fd2010-11-30 05:53:48 -08004167 rdev_info(rdev, "disabling\n");
Markus Pargmann66fda752014-02-20 17:36:04 +01004168 ret = _regulator_do_disable(rdev);
Jingoo Han0d25d092014-01-08 10:02:16 +09004169 if (ret != 0)
Joe Perches5da84fd2010-11-30 05:53:48 -08004170 rdev_err(rdev, "couldn't disable: %d\n", ret);
Mark Brownca725562009-03-16 19:36:34 +00004171 } else {
4172 /* The intention is that in future we will
4173 * assume that full constraints are provided
4174 * so warn even if we aren't going to do
4175 * anything here.
4176 */
Joe Perches5da84fd2010-11-30 05:53:48 -08004177 rdev_warn(rdev, "incomplete constraints, leaving on\n");
Mark Brownca725562009-03-16 19:36:34 +00004178 }
4179
4180unlock:
4181 mutex_unlock(&rdev->mutex);
4182 }
4183
4184 mutex_unlock(&regulator_list_mutex);
4185
4186 return 0;
4187}
Saravana Kannanfd482a32014-04-23 18:10:50 -05004188late_initcall_sync(regulator_init_complete);