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