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 16c5e28ed7SDaniel Walker #define pr_fmt(fmt) "%s: " fmt, __func__ 17c5e28ed7SDaniel Walker 18414c70cbSLiam Girdwood #include <linux/kernel.h> 19414c70cbSLiam Girdwood #include <linux/init.h> 20414c70cbSLiam Girdwood #include <linux/device.h> 215a0e3ad6STejun Heo #include <linux/slab.h> 22414c70cbSLiam Girdwood #include <linux/err.h> 23414c70cbSLiam Girdwood #include <linux/mutex.h> 24414c70cbSLiam Girdwood #include <linux/suspend.h> 2531aae2beSMark Brown #include <linux/delay.h> 26414c70cbSLiam Girdwood #include <linux/regulator/consumer.h> 27414c70cbSLiam Girdwood #include <linux/regulator/driver.h> 28414c70cbSLiam Girdwood #include <linux/regulator/machine.h> 29414c70cbSLiam Girdwood 3002fa3ec0SMark Brown #define CREATE_TRACE_POINTS 3102fa3ec0SMark Brown #include <trace/events/regulator.h> 3202fa3ec0SMark Brown 3334abbd68SMark Brown #include "dummy.h" 3434abbd68SMark Brown 355da84fd9SJoe Perches #define rdev_err(rdev, fmt, ...) \ 365da84fd9SJoe Perches pr_err("%s: " fmt, rdev_get_name(rdev), ##__VA_ARGS__) 375da84fd9SJoe Perches #define rdev_warn(rdev, fmt, ...) \ 385da84fd9SJoe Perches pr_warn("%s: " fmt, rdev_get_name(rdev), ##__VA_ARGS__) 395da84fd9SJoe Perches #define rdev_info(rdev, fmt, ...) \ 405da84fd9SJoe Perches pr_info("%s: " fmt, rdev_get_name(rdev), ##__VA_ARGS__) 415da84fd9SJoe Perches #define rdev_dbg(rdev, fmt, ...) \ 425da84fd9SJoe Perches pr_debug("%s: " fmt, rdev_get_name(rdev), ##__VA_ARGS__) 435da84fd9SJoe Perches 44414c70cbSLiam Girdwood static DEFINE_MUTEX(regulator_list_mutex); 45414c70cbSLiam Girdwood static LIST_HEAD(regulator_list); 46414c70cbSLiam Girdwood static LIST_HEAD(regulator_map_list); 47ca725561SMark Brown static int has_full_constraints; 48688fe99aSMark Brown static bool board_wants_dummy_regulator; 49414c70cbSLiam Girdwood 508dc5390dSMark Brown /* 51414c70cbSLiam Girdwood * struct regulator_map 52414c70cbSLiam Girdwood * 53414c70cbSLiam Girdwood * Used to provide symbolic supply names to devices. 54414c70cbSLiam Girdwood */ 55414c70cbSLiam Girdwood struct regulator_map { 56414c70cbSLiam Girdwood struct list_head list; 5740f9244fSMark Brown const char *dev_name; /* The dev_name() for the consumer */ 58414c70cbSLiam Girdwood const char *supply; 59a5766f11SLiam Girdwood struct regulator_dev *regulator; 60414c70cbSLiam Girdwood }; 61414c70cbSLiam Girdwood 62414c70cbSLiam Girdwood /* 63414c70cbSLiam Girdwood * struct regulator 64414c70cbSLiam Girdwood * 65414c70cbSLiam Girdwood * One for each consumer device. 66414c70cbSLiam Girdwood */ 67414c70cbSLiam Girdwood struct regulator { 68414c70cbSLiam Girdwood struct device *dev; 69414c70cbSLiam Girdwood struct list_head list; 70414c70cbSLiam Girdwood int uA_load; 71414c70cbSLiam Girdwood int min_uV; 72414c70cbSLiam Girdwood int max_uV; 73414c70cbSLiam Girdwood char *supply_name; 74414c70cbSLiam Girdwood struct device_attribute dev_attr; 75414c70cbSLiam Girdwood struct regulator_dev *rdev; 76414c70cbSLiam Girdwood }; 77414c70cbSLiam Girdwood 78414c70cbSLiam Girdwood static int _regulator_is_enabled(struct regulator_dev *rdev); 798cbf811dSJeffrey Carlyle static int _regulator_disable(struct regulator_dev *rdev, 808cbf811dSJeffrey Carlyle struct regulator_dev **supply_rdev_ptr); 81414c70cbSLiam Girdwood static int _regulator_get_voltage(struct regulator_dev *rdev); 82414c70cbSLiam Girdwood static int _regulator_get_current_limit(struct regulator_dev *rdev); 83414c70cbSLiam Girdwood static unsigned int _regulator_get_mode(struct regulator_dev *rdev); 84414c70cbSLiam Girdwood static void _notifier_call_chain(struct regulator_dev *rdev, 85414c70cbSLiam Girdwood unsigned long event, void *data); 86414c70cbSLiam Girdwood 871083c393SMark Brown static const char *rdev_get_name(struct regulator_dev *rdev) 881083c393SMark Brown { 891083c393SMark Brown if (rdev->constraints && rdev->constraints->name) 901083c393SMark Brown return rdev->constraints->name; 911083c393SMark Brown else if (rdev->desc->name) 921083c393SMark Brown return rdev->desc->name; 931083c393SMark Brown else 941083c393SMark Brown return ""; 951083c393SMark Brown } 961083c393SMark Brown 97414c70cbSLiam Girdwood /* gets the regulator for a given consumer device */ 98414c70cbSLiam Girdwood static struct regulator *get_device_regulator(struct device *dev) 99414c70cbSLiam Girdwood { 100414c70cbSLiam Girdwood struct regulator *regulator = NULL; 101414c70cbSLiam Girdwood struct regulator_dev *rdev; 102414c70cbSLiam Girdwood 103414c70cbSLiam Girdwood mutex_lock(®ulator_list_mutex); 104414c70cbSLiam Girdwood list_for_each_entry(rdev, ®ulator_list, list) { 105414c70cbSLiam Girdwood mutex_lock(&rdev->mutex); 106414c70cbSLiam Girdwood list_for_each_entry(regulator, &rdev->consumer_list, list) { 107414c70cbSLiam Girdwood if (regulator->dev == dev) { 108414c70cbSLiam Girdwood mutex_unlock(&rdev->mutex); 109414c70cbSLiam Girdwood mutex_unlock(®ulator_list_mutex); 110414c70cbSLiam Girdwood return regulator; 111414c70cbSLiam Girdwood } 112414c70cbSLiam Girdwood } 113414c70cbSLiam Girdwood mutex_unlock(&rdev->mutex); 114414c70cbSLiam Girdwood } 115414c70cbSLiam Girdwood mutex_unlock(®ulator_list_mutex); 116414c70cbSLiam Girdwood return NULL; 117414c70cbSLiam Girdwood } 118414c70cbSLiam Girdwood 119414c70cbSLiam Girdwood /* Platform voltage constraint check */ 120414c70cbSLiam Girdwood static int regulator_check_voltage(struct regulator_dev *rdev, 121414c70cbSLiam Girdwood int *min_uV, int *max_uV) 122414c70cbSLiam Girdwood { 123414c70cbSLiam Girdwood BUG_ON(*min_uV > *max_uV); 124414c70cbSLiam Girdwood 125414c70cbSLiam Girdwood if (!rdev->constraints) { 1265da84fd9SJoe Perches rdev_err(rdev, "no constraints\n"); 127414c70cbSLiam Girdwood return -ENODEV; 128414c70cbSLiam Girdwood } 129414c70cbSLiam Girdwood if (!(rdev->constraints->valid_ops_mask & REGULATOR_CHANGE_VOLTAGE)) { 1305da84fd9SJoe Perches rdev_err(rdev, "operation not allowed\n"); 131414c70cbSLiam Girdwood return -EPERM; 132414c70cbSLiam Girdwood } 133414c70cbSLiam Girdwood 134414c70cbSLiam Girdwood if (*max_uV > rdev->constraints->max_uV) 135414c70cbSLiam Girdwood *max_uV = rdev->constraints->max_uV; 136414c70cbSLiam Girdwood if (*min_uV < rdev->constraints->min_uV) 137414c70cbSLiam Girdwood *min_uV = rdev->constraints->min_uV; 138414c70cbSLiam Girdwood 139414c70cbSLiam Girdwood if (*min_uV > *max_uV) 140414c70cbSLiam Girdwood return -EINVAL; 141414c70cbSLiam Girdwood 142414c70cbSLiam Girdwood return 0; 143414c70cbSLiam Girdwood } 144414c70cbSLiam Girdwood 14505fda3b1SThomas Petazzoni /* Make sure we select a voltage that suits the needs of all 14605fda3b1SThomas Petazzoni * regulator consumers 14705fda3b1SThomas Petazzoni */ 14805fda3b1SThomas Petazzoni static int regulator_check_consumers(struct regulator_dev *rdev, 14905fda3b1SThomas Petazzoni int *min_uV, int *max_uV) 15005fda3b1SThomas Petazzoni { 15105fda3b1SThomas Petazzoni struct regulator *regulator; 15205fda3b1SThomas Petazzoni 15305fda3b1SThomas Petazzoni list_for_each_entry(regulator, &rdev->consumer_list, list) { 15405fda3b1SThomas Petazzoni if (*max_uV > regulator->max_uV) 15505fda3b1SThomas Petazzoni *max_uV = regulator->max_uV; 15605fda3b1SThomas Petazzoni if (*min_uV < regulator->min_uV) 15705fda3b1SThomas Petazzoni *min_uV = regulator->min_uV; 15805fda3b1SThomas Petazzoni } 15905fda3b1SThomas Petazzoni 16005fda3b1SThomas Petazzoni if (*min_uV > *max_uV) 16105fda3b1SThomas Petazzoni return -EINVAL; 16205fda3b1SThomas Petazzoni 16305fda3b1SThomas Petazzoni return 0; 16405fda3b1SThomas Petazzoni } 16505fda3b1SThomas Petazzoni 166414c70cbSLiam Girdwood /* current constraint check */ 167414c70cbSLiam Girdwood static int regulator_check_current_limit(struct regulator_dev *rdev, 168414c70cbSLiam Girdwood int *min_uA, int *max_uA) 169414c70cbSLiam Girdwood { 170414c70cbSLiam Girdwood BUG_ON(*min_uA > *max_uA); 171414c70cbSLiam Girdwood 172414c70cbSLiam Girdwood if (!rdev->constraints) { 1735da84fd9SJoe Perches rdev_err(rdev, "no constraints\n"); 174414c70cbSLiam Girdwood return -ENODEV; 175414c70cbSLiam Girdwood } 176414c70cbSLiam Girdwood if (!(rdev->constraints->valid_ops_mask & REGULATOR_CHANGE_CURRENT)) { 1775da84fd9SJoe Perches rdev_err(rdev, "operation not allowed\n"); 178414c70cbSLiam Girdwood return -EPERM; 179414c70cbSLiam Girdwood } 180414c70cbSLiam Girdwood 181414c70cbSLiam Girdwood if (*max_uA > rdev->constraints->max_uA) 182414c70cbSLiam Girdwood *max_uA = rdev->constraints->max_uA; 183414c70cbSLiam Girdwood if (*min_uA < rdev->constraints->min_uA) 184414c70cbSLiam Girdwood *min_uA = rdev->constraints->min_uA; 185414c70cbSLiam Girdwood 186414c70cbSLiam Girdwood if (*min_uA > *max_uA) 187414c70cbSLiam Girdwood return -EINVAL; 188414c70cbSLiam Girdwood 189414c70cbSLiam Girdwood return 0; 190414c70cbSLiam Girdwood } 191414c70cbSLiam Girdwood 192414c70cbSLiam Girdwood /* operating mode constraint check */ 193414c70cbSLiam Girdwood static int regulator_check_mode(struct regulator_dev *rdev, int mode) 194414c70cbSLiam Girdwood { 195e573520bSDavid Brownell switch (mode) { 196e573520bSDavid Brownell case REGULATOR_MODE_FAST: 197e573520bSDavid Brownell case REGULATOR_MODE_NORMAL: 198e573520bSDavid Brownell case REGULATOR_MODE_IDLE: 199e573520bSDavid Brownell case REGULATOR_MODE_STANDBY: 200e573520bSDavid Brownell break; 201e573520bSDavid Brownell default: 202e573520bSDavid Brownell return -EINVAL; 203e573520bSDavid Brownell } 204e573520bSDavid Brownell 205414c70cbSLiam Girdwood if (!rdev->constraints) { 2065da84fd9SJoe Perches rdev_err(rdev, "no constraints\n"); 207414c70cbSLiam Girdwood return -ENODEV; 208414c70cbSLiam Girdwood } 209414c70cbSLiam Girdwood if (!(rdev->constraints->valid_ops_mask & REGULATOR_CHANGE_MODE)) { 2105da84fd9SJoe Perches rdev_err(rdev, "operation not allowed\n"); 211414c70cbSLiam Girdwood return -EPERM; 212414c70cbSLiam Girdwood } 213414c70cbSLiam Girdwood if (!(rdev->constraints->valid_modes_mask & mode)) { 2145da84fd9SJoe Perches rdev_err(rdev, "invalid mode %x\n", mode); 215414c70cbSLiam Girdwood return -EINVAL; 216414c70cbSLiam Girdwood } 217414c70cbSLiam Girdwood return 0; 218414c70cbSLiam Girdwood } 219414c70cbSLiam Girdwood 220414c70cbSLiam Girdwood /* dynamic regulator mode switching constraint check */ 221414c70cbSLiam Girdwood static int regulator_check_drms(struct regulator_dev *rdev) 222414c70cbSLiam Girdwood { 223414c70cbSLiam Girdwood if (!rdev->constraints) { 2245da84fd9SJoe Perches rdev_err(rdev, "no constraints\n"); 225414c70cbSLiam Girdwood return -ENODEV; 226414c70cbSLiam Girdwood } 227414c70cbSLiam Girdwood if (!(rdev->constraints->valid_ops_mask & REGULATOR_CHANGE_DRMS)) { 2285da84fd9SJoe Perches rdev_err(rdev, "operation not allowed\n"); 229414c70cbSLiam Girdwood return -EPERM; 230414c70cbSLiam Girdwood } 231414c70cbSLiam Girdwood return 0; 232414c70cbSLiam Girdwood } 233414c70cbSLiam Girdwood 234414c70cbSLiam Girdwood static ssize_t device_requested_uA_show(struct device *dev, 235414c70cbSLiam Girdwood struct device_attribute *attr, char *buf) 236414c70cbSLiam Girdwood { 237414c70cbSLiam Girdwood struct regulator *regulator; 238414c70cbSLiam Girdwood 239414c70cbSLiam Girdwood regulator = get_device_regulator(dev); 240414c70cbSLiam Girdwood if (regulator == NULL) 241414c70cbSLiam Girdwood return 0; 242414c70cbSLiam Girdwood 243414c70cbSLiam Girdwood return sprintf(buf, "%d\n", regulator->uA_load); 244414c70cbSLiam Girdwood } 245414c70cbSLiam Girdwood 246414c70cbSLiam Girdwood static ssize_t regulator_uV_show(struct device *dev, 247414c70cbSLiam Girdwood struct device_attribute *attr, char *buf) 248414c70cbSLiam Girdwood { 249a5766f11SLiam Girdwood struct regulator_dev *rdev = dev_get_drvdata(dev); 250414c70cbSLiam Girdwood ssize_t ret; 251414c70cbSLiam Girdwood 252414c70cbSLiam Girdwood mutex_lock(&rdev->mutex); 253414c70cbSLiam Girdwood ret = sprintf(buf, "%d\n", _regulator_get_voltage(rdev)); 254414c70cbSLiam Girdwood mutex_unlock(&rdev->mutex); 255414c70cbSLiam Girdwood 256414c70cbSLiam Girdwood return ret; 257414c70cbSLiam Girdwood } 2587ad68e2fSDavid Brownell static DEVICE_ATTR(microvolts, 0444, regulator_uV_show, NULL); 259414c70cbSLiam Girdwood 260414c70cbSLiam Girdwood static ssize_t regulator_uA_show(struct device *dev, 261414c70cbSLiam Girdwood struct device_attribute *attr, char *buf) 262414c70cbSLiam Girdwood { 263a5766f11SLiam Girdwood struct regulator_dev *rdev = dev_get_drvdata(dev); 264414c70cbSLiam Girdwood 265414c70cbSLiam Girdwood return sprintf(buf, "%d\n", _regulator_get_current_limit(rdev)); 266414c70cbSLiam Girdwood } 2677ad68e2fSDavid Brownell static DEVICE_ATTR(microamps, 0444, regulator_uA_show, NULL); 268414c70cbSLiam Girdwood 269bc558a60SMark Brown static ssize_t regulator_name_show(struct device *dev, 270bc558a60SMark Brown struct device_attribute *attr, char *buf) 271bc558a60SMark Brown { 272bc558a60SMark Brown struct regulator_dev *rdev = dev_get_drvdata(dev); 273bc558a60SMark Brown 2741083c393SMark Brown return sprintf(buf, "%s\n", rdev_get_name(rdev)); 275bc558a60SMark Brown } 276bc558a60SMark Brown 2774fca9545SDavid Brownell static ssize_t regulator_print_opmode(char *buf, int mode) 278414c70cbSLiam Girdwood { 279414c70cbSLiam Girdwood switch (mode) { 280414c70cbSLiam Girdwood case REGULATOR_MODE_FAST: 281414c70cbSLiam Girdwood return sprintf(buf, "fast\n"); 282414c70cbSLiam Girdwood case REGULATOR_MODE_NORMAL: 283414c70cbSLiam Girdwood return sprintf(buf, "normal\n"); 284414c70cbSLiam Girdwood case REGULATOR_MODE_IDLE: 285414c70cbSLiam Girdwood return sprintf(buf, "idle\n"); 286414c70cbSLiam Girdwood case REGULATOR_MODE_STANDBY: 287414c70cbSLiam Girdwood return sprintf(buf, "standby\n"); 288414c70cbSLiam Girdwood } 289414c70cbSLiam Girdwood return sprintf(buf, "unknown\n"); 290414c70cbSLiam Girdwood } 291414c70cbSLiam Girdwood 2924fca9545SDavid Brownell static ssize_t regulator_opmode_show(struct device *dev, 293414c70cbSLiam Girdwood struct device_attribute *attr, char *buf) 294414c70cbSLiam Girdwood { 295a5766f11SLiam Girdwood struct regulator_dev *rdev = dev_get_drvdata(dev); 296414c70cbSLiam Girdwood 2974fca9545SDavid Brownell return regulator_print_opmode(buf, _regulator_get_mode(rdev)); 2984fca9545SDavid Brownell } 2997ad68e2fSDavid Brownell static DEVICE_ATTR(opmode, 0444, regulator_opmode_show, NULL); 3004fca9545SDavid Brownell 3014fca9545SDavid Brownell static ssize_t regulator_print_state(char *buf, int state) 3024fca9545SDavid Brownell { 303414c70cbSLiam Girdwood if (state > 0) 304414c70cbSLiam Girdwood return sprintf(buf, "enabled\n"); 305414c70cbSLiam Girdwood else if (state == 0) 306414c70cbSLiam Girdwood return sprintf(buf, "disabled\n"); 307414c70cbSLiam Girdwood else 308414c70cbSLiam Girdwood return sprintf(buf, "unknown\n"); 309414c70cbSLiam Girdwood } 310414c70cbSLiam Girdwood 3114fca9545SDavid Brownell static ssize_t regulator_state_show(struct device *dev, 3124fca9545SDavid Brownell struct device_attribute *attr, char *buf) 3134fca9545SDavid Brownell { 3144fca9545SDavid Brownell struct regulator_dev *rdev = dev_get_drvdata(dev); 3159332546fSMark Brown ssize_t ret; 3164fca9545SDavid Brownell 3179332546fSMark Brown mutex_lock(&rdev->mutex); 3189332546fSMark Brown ret = regulator_print_state(buf, _regulator_is_enabled(rdev)); 3199332546fSMark Brown mutex_unlock(&rdev->mutex); 3209332546fSMark Brown 3219332546fSMark Brown return ret; 3224fca9545SDavid Brownell } 3237ad68e2fSDavid Brownell static DEVICE_ATTR(state, 0444, regulator_state_show, NULL); 3244fca9545SDavid Brownell 325853116a1SDavid Brownell static ssize_t regulator_status_show(struct device *dev, 326853116a1SDavid Brownell struct device_attribute *attr, char *buf) 327853116a1SDavid Brownell { 328853116a1SDavid Brownell struct regulator_dev *rdev = dev_get_drvdata(dev); 329853116a1SDavid Brownell int status; 330853116a1SDavid Brownell char *label; 331853116a1SDavid Brownell 332853116a1SDavid Brownell status = rdev->desc->ops->get_status(rdev); 333853116a1SDavid Brownell if (status < 0) 334853116a1SDavid Brownell return status; 335853116a1SDavid Brownell 336853116a1SDavid Brownell switch (status) { 337853116a1SDavid Brownell case REGULATOR_STATUS_OFF: 338853116a1SDavid Brownell label = "off"; 339853116a1SDavid Brownell break; 340853116a1SDavid Brownell case REGULATOR_STATUS_ON: 341853116a1SDavid Brownell label = "on"; 342853116a1SDavid Brownell break; 343853116a1SDavid Brownell case REGULATOR_STATUS_ERROR: 344853116a1SDavid Brownell label = "error"; 345853116a1SDavid Brownell break; 346853116a1SDavid Brownell case REGULATOR_STATUS_FAST: 347853116a1SDavid Brownell label = "fast"; 348853116a1SDavid Brownell break; 349853116a1SDavid Brownell case REGULATOR_STATUS_NORMAL: 350853116a1SDavid Brownell label = "normal"; 351853116a1SDavid Brownell break; 352853116a1SDavid Brownell case REGULATOR_STATUS_IDLE: 353853116a1SDavid Brownell label = "idle"; 354853116a1SDavid Brownell break; 355853116a1SDavid Brownell case REGULATOR_STATUS_STANDBY: 356853116a1SDavid Brownell label = "standby"; 357853116a1SDavid Brownell break; 358853116a1SDavid Brownell default: 359853116a1SDavid Brownell return -ERANGE; 360853116a1SDavid Brownell } 361853116a1SDavid Brownell 362853116a1SDavid Brownell return sprintf(buf, "%s\n", label); 363853116a1SDavid Brownell } 364853116a1SDavid Brownell static DEVICE_ATTR(status, 0444, regulator_status_show, NULL); 365853116a1SDavid Brownell 366414c70cbSLiam Girdwood static ssize_t regulator_min_uA_show(struct device *dev, 367414c70cbSLiam Girdwood struct device_attribute *attr, char *buf) 368414c70cbSLiam Girdwood { 369a5766f11SLiam Girdwood struct regulator_dev *rdev = dev_get_drvdata(dev); 370414c70cbSLiam Girdwood 371414c70cbSLiam Girdwood if (!rdev->constraints) 372414c70cbSLiam Girdwood return sprintf(buf, "constraint not defined\n"); 373414c70cbSLiam Girdwood 374414c70cbSLiam Girdwood return sprintf(buf, "%d\n", rdev->constraints->min_uA); 375414c70cbSLiam Girdwood } 3767ad68e2fSDavid Brownell static DEVICE_ATTR(min_microamps, 0444, regulator_min_uA_show, NULL); 377414c70cbSLiam Girdwood 378414c70cbSLiam Girdwood static ssize_t regulator_max_uA_show(struct device *dev, 379414c70cbSLiam Girdwood struct device_attribute *attr, char *buf) 380414c70cbSLiam Girdwood { 381a5766f11SLiam Girdwood struct regulator_dev *rdev = dev_get_drvdata(dev); 382414c70cbSLiam Girdwood 383414c70cbSLiam Girdwood if (!rdev->constraints) 384414c70cbSLiam Girdwood return sprintf(buf, "constraint not defined\n"); 385414c70cbSLiam Girdwood 386414c70cbSLiam Girdwood return sprintf(buf, "%d\n", rdev->constraints->max_uA); 387414c70cbSLiam Girdwood } 3887ad68e2fSDavid Brownell static DEVICE_ATTR(max_microamps, 0444, regulator_max_uA_show, NULL); 389414c70cbSLiam Girdwood 390414c70cbSLiam Girdwood static ssize_t regulator_min_uV_show(struct device *dev, 391414c70cbSLiam Girdwood struct device_attribute *attr, char *buf) 392414c70cbSLiam Girdwood { 393a5766f11SLiam Girdwood struct regulator_dev *rdev = dev_get_drvdata(dev); 394414c70cbSLiam Girdwood 395414c70cbSLiam Girdwood if (!rdev->constraints) 396414c70cbSLiam Girdwood return sprintf(buf, "constraint not defined\n"); 397414c70cbSLiam Girdwood 398414c70cbSLiam Girdwood return sprintf(buf, "%d\n", rdev->constraints->min_uV); 399414c70cbSLiam Girdwood } 4007ad68e2fSDavid Brownell static DEVICE_ATTR(min_microvolts, 0444, regulator_min_uV_show, NULL); 401414c70cbSLiam Girdwood 402414c70cbSLiam Girdwood static ssize_t regulator_max_uV_show(struct device *dev, 403414c70cbSLiam Girdwood struct device_attribute *attr, char *buf) 404414c70cbSLiam Girdwood { 405a5766f11SLiam Girdwood struct regulator_dev *rdev = dev_get_drvdata(dev); 406414c70cbSLiam Girdwood 407414c70cbSLiam Girdwood if (!rdev->constraints) 408414c70cbSLiam Girdwood return sprintf(buf, "constraint not defined\n"); 409414c70cbSLiam Girdwood 410414c70cbSLiam Girdwood return sprintf(buf, "%d\n", rdev->constraints->max_uV); 411414c70cbSLiam Girdwood } 4127ad68e2fSDavid Brownell static DEVICE_ATTR(max_microvolts, 0444, regulator_max_uV_show, NULL); 413414c70cbSLiam Girdwood 414414c70cbSLiam Girdwood static ssize_t regulator_total_uA_show(struct device *dev, 415414c70cbSLiam Girdwood struct device_attribute *attr, char *buf) 416414c70cbSLiam Girdwood { 417a5766f11SLiam Girdwood struct regulator_dev *rdev = dev_get_drvdata(dev); 418414c70cbSLiam Girdwood struct regulator *regulator; 419414c70cbSLiam Girdwood int uA = 0; 420414c70cbSLiam Girdwood 421414c70cbSLiam Girdwood mutex_lock(&rdev->mutex); 422414c70cbSLiam Girdwood list_for_each_entry(regulator, &rdev->consumer_list, list) 423414c70cbSLiam Girdwood uA += regulator->uA_load; 424414c70cbSLiam Girdwood mutex_unlock(&rdev->mutex); 425414c70cbSLiam Girdwood return sprintf(buf, "%d\n", uA); 426414c70cbSLiam Girdwood } 4277ad68e2fSDavid Brownell static DEVICE_ATTR(requested_microamps, 0444, regulator_total_uA_show, NULL); 428414c70cbSLiam Girdwood 429414c70cbSLiam Girdwood static ssize_t regulator_num_users_show(struct device *dev, 430414c70cbSLiam Girdwood struct device_attribute *attr, char *buf) 431414c70cbSLiam Girdwood { 432a5766f11SLiam Girdwood struct regulator_dev *rdev = dev_get_drvdata(dev); 433414c70cbSLiam Girdwood return sprintf(buf, "%d\n", rdev->use_count); 434414c70cbSLiam Girdwood } 435414c70cbSLiam Girdwood 436414c70cbSLiam Girdwood static ssize_t regulator_type_show(struct device *dev, 437414c70cbSLiam Girdwood struct device_attribute *attr, char *buf) 438414c70cbSLiam Girdwood { 439a5766f11SLiam Girdwood struct regulator_dev *rdev = dev_get_drvdata(dev); 440414c70cbSLiam Girdwood 441414c70cbSLiam Girdwood switch (rdev->desc->type) { 442414c70cbSLiam Girdwood case REGULATOR_VOLTAGE: 443414c70cbSLiam Girdwood return sprintf(buf, "voltage\n"); 444414c70cbSLiam Girdwood case REGULATOR_CURRENT: 445414c70cbSLiam Girdwood return sprintf(buf, "current\n"); 446414c70cbSLiam Girdwood } 447414c70cbSLiam Girdwood return sprintf(buf, "unknown\n"); 448414c70cbSLiam Girdwood } 449414c70cbSLiam Girdwood 450414c70cbSLiam Girdwood static ssize_t regulator_suspend_mem_uV_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 455414c70cbSLiam Girdwood return sprintf(buf, "%d\n", rdev->constraints->state_mem.uV); 456414c70cbSLiam Girdwood } 4577ad68e2fSDavid Brownell static DEVICE_ATTR(suspend_mem_microvolts, 0444, 4587ad68e2fSDavid Brownell regulator_suspend_mem_uV_show, NULL); 459414c70cbSLiam Girdwood 460414c70cbSLiam Girdwood static ssize_t regulator_suspend_disk_uV_show(struct device *dev, 461414c70cbSLiam Girdwood struct device_attribute *attr, char *buf) 462414c70cbSLiam Girdwood { 463a5766f11SLiam Girdwood struct regulator_dev *rdev = dev_get_drvdata(dev); 464414c70cbSLiam Girdwood 465414c70cbSLiam Girdwood return sprintf(buf, "%d\n", rdev->constraints->state_disk.uV); 466414c70cbSLiam Girdwood } 4677ad68e2fSDavid Brownell static DEVICE_ATTR(suspend_disk_microvolts, 0444, 4687ad68e2fSDavid Brownell regulator_suspend_disk_uV_show, NULL); 469414c70cbSLiam Girdwood 470414c70cbSLiam Girdwood static ssize_t regulator_suspend_standby_uV_show(struct device *dev, 471414c70cbSLiam Girdwood struct device_attribute *attr, char *buf) 472414c70cbSLiam Girdwood { 473a5766f11SLiam Girdwood struct regulator_dev *rdev = dev_get_drvdata(dev); 474414c70cbSLiam Girdwood 475414c70cbSLiam Girdwood return sprintf(buf, "%d\n", rdev->constraints->state_standby.uV); 476414c70cbSLiam Girdwood } 4777ad68e2fSDavid Brownell static DEVICE_ATTR(suspend_standby_microvolts, 0444, 4787ad68e2fSDavid Brownell regulator_suspend_standby_uV_show, NULL); 479414c70cbSLiam Girdwood 480414c70cbSLiam Girdwood static ssize_t regulator_suspend_mem_mode_show(struct device *dev, 481414c70cbSLiam Girdwood struct device_attribute *attr, char *buf) 482414c70cbSLiam Girdwood { 483a5766f11SLiam Girdwood struct regulator_dev *rdev = dev_get_drvdata(dev); 484414c70cbSLiam Girdwood 4854fca9545SDavid Brownell return regulator_print_opmode(buf, 4864fca9545SDavid Brownell rdev->constraints->state_mem.mode); 487414c70cbSLiam Girdwood } 4887ad68e2fSDavid Brownell static DEVICE_ATTR(suspend_mem_mode, 0444, 4897ad68e2fSDavid Brownell regulator_suspend_mem_mode_show, NULL); 490414c70cbSLiam Girdwood 491414c70cbSLiam Girdwood static ssize_t regulator_suspend_disk_mode_show(struct device *dev, 492414c70cbSLiam Girdwood struct device_attribute *attr, char *buf) 493414c70cbSLiam Girdwood { 494a5766f11SLiam Girdwood struct regulator_dev *rdev = dev_get_drvdata(dev); 495414c70cbSLiam Girdwood 4964fca9545SDavid Brownell return regulator_print_opmode(buf, 4974fca9545SDavid Brownell rdev->constraints->state_disk.mode); 498414c70cbSLiam Girdwood } 4997ad68e2fSDavid Brownell static DEVICE_ATTR(suspend_disk_mode, 0444, 5007ad68e2fSDavid Brownell regulator_suspend_disk_mode_show, NULL); 501414c70cbSLiam Girdwood 502414c70cbSLiam Girdwood static ssize_t regulator_suspend_standby_mode_show(struct device *dev, 503414c70cbSLiam Girdwood struct device_attribute *attr, char *buf) 504414c70cbSLiam Girdwood { 505a5766f11SLiam Girdwood struct regulator_dev *rdev = dev_get_drvdata(dev); 506414c70cbSLiam Girdwood 5074fca9545SDavid Brownell return regulator_print_opmode(buf, 5084fca9545SDavid Brownell rdev->constraints->state_standby.mode); 509414c70cbSLiam Girdwood } 5107ad68e2fSDavid Brownell static DEVICE_ATTR(suspend_standby_mode, 0444, 5117ad68e2fSDavid Brownell regulator_suspend_standby_mode_show, NULL); 512414c70cbSLiam Girdwood 513414c70cbSLiam Girdwood static ssize_t regulator_suspend_mem_state_show(struct device *dev, 514414c70cbSLiam Girdwood struct device_attribute *attr, char *buf) 515414c70cbSLiam Girdwood { 516a5766f11SLiam Girdwood struct regulator_dev *rdev = dev_get_drvdata(dev); 517414c70cbSLiam Girdwood 5184fca9545SDavid Brownell return regulator_print_state(buf, 5194fca9545SDavid Brownell rdev->constraints->state_mem.enabled); 520414c70cbSLiam Girdwood } 5217ad68e2fSDavid Brownell static DEVICE_ATTR(suspend_mem_state, 0444, 5227ad68e2fSDavid Brownell regulator_suspend_mem_state_show, NULL); 523414c70cbSLiam Girdwood 524414c70cbSLiam Girdwood static ssize_t regulator_suspend_disk_state_show(struct device *dev, 525414c70cbSLiam Girdwood struct device_attribute *attr, char *buf) 526414c70cbSLiam Girdwood { 527a5766f11SLiam Girdwood struct regulator_dev *rdev = dev_get_drvdata(dev); 528414c70cbSLiam Girdwood 5294fca9545SDavid Brownell return regulator_print_state(buf, 5304fca9545SDavid Brownell rdev->constraints->state_disk.enabled); 531414c70cbSLiam Girdwood } 5327ad68e2fSDavid Brownell static DEVICE_ATTR(suspend_disk_state, 0444, 5337ad68e2fSDavid Brownell regulator_suspend_disk_state_show, NULL); 534414c70cbSLiam Girdwood 535414c70cbSLiam Girdwood static ssize_t regulator_suspend_standby_state_show(struct device *dev, 536414c70cbSLiam Girdwood struct device_attribute *attr, char *buf) 537414c70cbSLiam Girdwood { 538a5766f11SLiam Girdwood struct regulator_dev *rdev = dev_get_drvdata(dev); 539414c70cbSLiam Girdwood 5404fca9545SDavid Brownell return regulator_print_state(buf, 5414fca9545SDavid Brownell rdev->constraints->state_standby.enabled); 542414c70cbSLiam Girdwood } 5437ad68e2fSDavid Brownell static DEVICE_ATTR(suspend_standby_state, 0444, 5447ad68e2fSDavid Brownell regulator_suspend_standby_state_show, NULL); 545bc558a60SMark Brown 5467ad68e2fSDavid Brownell 5477ad68e2fSDavid Brownell /* 5487ad68e2fSDavid Brownell * These are the only attributes are present for all regulators. 5497ad68e2fSDavid Brownell * Other attributes are a function of regulator functionality. 5507ad68e2fSDavid Brownell */ 551414c70cbSLiam Girdwood static struct device_attribute regulator_dev_attrs[] = { 552bc558a60SMark Brown __ATTR(name, 0444, regulator_name_show, NULL), 553414c70cbSLiam Girdwood __ATTR(num_users, 0444, regulator_num_users_show, NULL), 554414c70cbSLiam Girdwood __ATTR(type, 0444, regulator_type_show, NULL), 555414c70cbSLiam Girdwood __ATTR_NULL, 556414c70cbSLiam Girdwood }; 557414c70cbSLiam Girdwood 558414c70cbSLiam Girdwood static void regulator_dev_release(struct device *dev) 559414c70cbSLiam Girdwood { 560a5766f11SLiam Girdwood struct regulator_dev *rdev = dev_get_drvdata(dev); 561414c70cbSLiam Girdwood kfree(rdev); 562414c70cbSLiam Girdwood } 563414c70cbSLiam Girdwood 564414c70cbSLiam Girdwood static struct class regulator_class = { 565414c70cbSLiam Girdwood .name = "regulator", 566414c70cbSLiam Girdwood .dev_release = regulator_dev_release, 567414c70cbSLiam Girdwood .dev_attrs = regulator_dev_attrs, 568414c70cbSLiam Girdwood }; 569414c70cbSLiam Girdwood 570414c70cbSLiam Girdwood /* Calculate the new optimum regulator operating mode based on the new total 571414c70cbSLiam Girdwood * consumer load. All locks held by caller */ 572414c70cbSLiam Girdwood static void drms_uA_update(struct regulator_dev *rdev) 573414c70cbSLiam Girdwood { 574414c70cbSLiam Girdwood struct regulator *sibling; 575414c70cbSLiam Girdwood int current_uA = 0, output_uV, input_uV, err; 576414c70cbSLiam Girdwood unsigned int mode; 577414c70cbSLiam Girdwood 578414c70cbSLiam Girdwood err = regulator_check_drms(rdev); 579414c70cbSLiam Girdwood if (err < 0 || !rdev->desc->ops->get_optimum_mode || 580036de8efSDan Carpenter !rdev->desc->ops->get_voltage || !rdev->desc->ops->set_mode) 581414c70cbSLiam Girdwood return; 582414c70cbSLiam Girdwood 583414c70cbSLiam Girdwood /* get output voltage */ 5841bf5a1f8SMark Brown output_uV = _regulator_get_voltage(rdev); 585414c70cbSLiam Girdwood if (output_uV <= 0) 586414c70cbSLiam Girdwood return; 587414c70cbSLiam Girdwood 588414c70cbSLiam Girdwood /* get input voltage */ 5891bf5a1f8SMark Brown input_uV = 0; 5901bf5a1f8SMark Brown if (rdev->supply) 5911bf5a1f8SMark Brown input_uV = _regulator_get_voltage(rdev); 5921bf5a1f8SMark Brown if (input_uV <= 0) 593414c70cbSLiam Girdwood input_uV = rdev->constraints->input_uV; 594414c70cbSLiam Girdwood if (input_uV <= 0) 595414c70cbSLiam Girdwood return; 596414c70cbSLiam Girdwood 597414c70cbSLiam Girdwood /* calc total requested load */ 598414c70cbSLiam Girdwood list_for_each_entry(sibling, &rdev->consumer_list, list) 599414c70cbSLiam Girdwood current_uA += sibling->uA_load; 600414c70cbSLiam Girdwood 601414c70cbSLiam Girdwood /* now get the optimum mode for our new total regulator load */ 602414c70cbSLiam Girdwood mode = rdev->desc->ops->get_optimum_mode(rdev, input_uV, 603414c70cbSLiam Girdwood output_uV, current_uA); 604414c70cbSLiam Girdwood 605414c70cbSLiam Girdwood /* check the new mode is allowed */ 606414c70cbSLiam Girdwood err = regulator_check_mode(rdev, mode); 607414c70cbSLiam Girdwood if (err == 0) 608414c70cbSLiam Girdwood rdev->desc->ops->set_mode(rdev, mode); 609414c70cbSLiam Girdwood } 610414c70cbSLiam Girdwood 611414c70cbSLiam Girdwood static int suspend_set_state(struct regulator_dev *rdev, 612414c70cbSLiam Girdwood struct regulator_state *rstate) 613414c70cbSLiam Girdwood { 614414c70cbSLiam Girdwood int ret = 0; 615638f85c5SMark Brown bool can_set_state; 616414c70cbSLiam Girdwood 617638f85c5SMark Brown can_set_state = rdev->desc->ops->set_suspend_enable && 618638f85c5SMark Brown rdev->desc->ops->set_suspend_disable; 619638f85c5SMark Brown 620638f85c5SMark Brown /* If we have no suspend mode configration don't set anything; 621638f85c5SMark Brown * only warn if the driver actually makes the suspend mode 622638f85c5SMark Brown * configurable. 623638f85c5SMark Brown */ 624638f85c5SMark Brown if (!rstate->enabled && !rstate->disabled) { 625638f85c5SMark Brown if (can_set_state) 6265da84fd9SJoe Perches rdev_warn(rdev, "No configuration\n"); 627638f85c5SMark Brown return 0; 628638f85c5SMark Brown } 629638f85c5SMark Brown 630638f85c5SMark Brown if (rstate->enabled && rstate->disabled) { 6315da84fd9SJoe Perches rdev_err(rdev, "invalid configuration\n"); 632638f85c5SMark Brown return -EINVAL; 633638f85c5SMark Brown } 634638f85c5SMark Brown 635638f85c5SMark Brown if (!can_set_state) { 6365da84fd9SJoe Perches rdev_err(rdev, "no way to set suspend state\n"); 637414c70cbSLiam Girdwood return -EINVAL; 638a5766f11SLiam Girdwood } 639414c70cbSLiam Girdwood 640414c70cbSLiam Girdwood if (rstate->enabled) 641414c70cbSLiam Girdwood ret = rdev->desc->ops->set_suspend_enable(rdev); 642414c70cbSLiam Girdwood else 643414c70cbSLiam Girdwood ret = rdev->desc->ops->set_suspend_disable(rdev); 644414c70cbSLiam Girdwood if (ret < 0) { 6455da84fd9SJoe Perches rdev_err(rdev, "failed to enabled/disable\n"); 646414c70cbSLiam Girdwood return ret; 647414c70cbSLiam Girdwood } 648414c70cbSLiam Girdwood 649414c70cbSLiam Girdwood if (rdev->desc->ops->set_suspend_voltage && rstate->uV > 0) { 650414c70cbSLiam Girdwood ret = rdev->desc->ops->set_suspend_voltage(rdev, rstate->uV); 651414c70cbSLiam Girdwood if (ret < 0) { 6525da84fd9SJoe Perches rdev_err(rdev, "failed to set voltage\n"); 653414c70cbSLiam Girdwood return ret; 654414c70cbSLiam Girdwood } 655414c70cbSLiam Girdwood } 656414c70cbSLiam Girdwood 657414c70cbSLiam Girdwood if (rdev->desc->ops->set_suspend_mode && rstate->mode > 0) { 658414c70cbSLiam Girdwood ret = rdev->desc->ops->set_suspend_mode(rdev, rstate->mode); 659414c70cbSLiam Girdwood if (ret < 0) { 6605da84fd9SJoe Perches rdev_err(rdev, "failed to set mode\n"); 661414c70cbSLiam Girdwood return ret; 662414c70cbSLiam Girdwood } 663414c70cbSLiam Girdwood } 664414c70cbSLiam Girdwood return ret; 665414c70cbSLiam Girdwood } 666414c70cbSLiam Girdwood 667414c70cbSLiam Girdwood /* locks held by caller */ 668414c70cbSLiam Girdwood static int suspend_prepare(struct regulator_dev *rdev, suspend_state_t state) 669414c70cbSLiam Girdwood { 670414c70cbSLiam Girdwood if (!rdev->constraints) 671414c70cbSLiam Girdwood return -EINVAL; 672414c70cbSLiam Girdwood 673414c70cbSLiam Girdwood switch (state) { 674414c70cbSLiam Girdwood case PM_SUSPEND_STANDBY: 675414c70cbSLiam Girdwood return suspend_set_state(rdev, 676414c70cbSLiam Girdwood &rdev->constraints->state_standby); 677414c70cbSLiam Girdwood case PM_SUSPEND_MEM: 678414c70cbSLiam Girdwood return suspend_set_state(rdev, 679414c70cbSLiam Girdwood &rdev->constraints->state_mem); 680414c70cbSLiam Girdwood case PM_SUSPEND_MAX: 681414c70cbSLiam Girdwood return suspend_set_state(rdev, 682414c70cbSLiam Girdwood &rdev->constraints->state_disk); 683414c70cbSLiam Girdwood default: 684414c70cbSLiam Girdwood return -EINVAL; 685414c70cbSLiam Girdwood } 686414c70cbSLiam Girdwood } 687414c70cbSLiam Girdwood 688414c70cbSLiam Girdwood static void print_constraints(struct regulator_dev *rdev) 689414c70cbSLiam Girdwood { 690414c70cbSLiam Girdwood struct regulation_constraints *constraints = rdev->constraints; 691973e9a27SMark Brown char buf[80] = ""; 6928f031b48SMark Brown int count = 0; 6938f031b48SMark Brown int ret; 694414c70cbSLiam Girdwood 6958f031b48SMark Brown if (constraints->min_uV && constraints->max_uV) { 696414c70cbSLiam Girdwood if (constraints->min_uV == constraints->max_uV) 6978f031b48SMark Brown count += sprintf(buf + count, "%d mV ", 698414c70cbSLiam Girdwood constraints->min_uV / 1000); 699414c70cbSLiam Girdwood else 7008f031b48SMark Brown count += sprintf(buf + count, "%d <--> %d mV ", 701414c70cbSLiam Girdwood constraints->min_uV / 1000, 702414c70cbSLiam Girdwood constraints->max_uV / 1000); 7038f031b48SMark Brown } 7048f031b48SMark Brown 7058f031b48SMark Brown if (!constraints->min_uV || 7068f031b48SMark Brown constraints->min_uV != constraints->max_uV) { 7078f031b48SMark Brown ret = _regulator_get_voltage(rdev); 7088f031b48SMark Brown if (ret > 0) 7098f031b48SMark Brown count += sprintf(buf + count, "at %d mV ", ret / 1000); 7108f031b48SMark Brown } 7118f031b48SMark Brown 7128f031b48SMark Brown if (constraints->min_uA && constraints->max_uA) { 713414c70cbSLiam Girdwood if (constraints->min_uA == constraints->max_uA) 7148f031b48SMark Brown count += sprintf(buf + count, "%d mA ", 715414c70cbSLiam Girdwood constraints->min_uA / 1000); 716414c70cbSLiam Girdwood else 7178f031b48SMark Brown count += sprintf(buf + count, "%d <--> %d mA ", 718414c70cbSLiam Girdwood constraints->min_uA / 1000, 719414c70cbSLiam Girdwood constraints->max_uA / 1000); 720414c70cbSLiam Girdwood } 7218f031b48SMark Brown 7228f031b48SMark Brown if (!constraints->min_uA || 7238f031b48SMark Brown constraints->min_uA != constraints->max_uA) { 7248f031b48SMark Brown ret = _regulator_get_current_limit(rdev); 7258f031b48SMark Brown if (ret > 0) 726e4a6376bSCyril Chemparathy count += sprintf(buf + count, "at %d mA ", ret / 1000); 7278f031b48SMark Brown } 7288f031b48SMark Brown 729414c70cbSLiam Girdwood if (constraints->valid_modes_mask & REGULATOR_MODE_FAST) 730414c70cbSLiam Girdwood count += sprintf(buf + count, "fast "); 731414c70cbSLiam Girdwood if (constraints->valid_modes_mask & REGULATOR_MODE_NORMAL) 732414c70cbSLiam Girdwood count += sprintf(buf + count, "normal "); 733414c70cbSLiam Girdwood if (constraints->valid_modes_mask & REGULATOR_MODE_IDLE) 734414c70cbSLiam Girdwood count += sprintf(buf + count, "idle "); 735414c70cbSLiam Girdwood if (constraints->valid_modes_mask & REGULATOR_MODE_STANDBY) 736414c70cbSLiam Girdwood count += sprintf(buf + count, "standby"); 737414c70cbSLiam Girdwood 7385da84fd9SJoe Perches rdev_info(rdev, "regulator: %s\n", buf); 739414c70cbSLiam Girdwood } 740414c70cbSLiam Girdwood 741e79055d6SMark Brown static int machine_constraints_voltage(struct regulator_dev *rdev, 7421083c393SMark Brown struct regulation_constraints *constraints) 743e79055d6SMark Brown { 744e79055d6SMark Brown struct regulator_ops *ops = rdev->desc->ops; 745af5866c9SMark Brown int ret; 7463a93f2a9SMark Brown unsigned selector; 747af5866c9SMark Brown 748af5866c9SMark Brown /* do we need to apply the constraint voltage */ 749af5866c9SMark Brown if (rdev->constraints->apply_uV && 750af5866c9SMark Brown rdev->constraints->min_uV == rdev->constraints->max_uV && 751af5866c9SMark Brown ops->set_voltage) { 752af5866c9SMark Brown ret = ops->set_voltage(rdev, 7533a93f2a9SMark Brown rdev->constraints->min_uV, 7543a93f2a9SMark Brown rdev->constraints->max_uV, 7553a93f2a9SMark Brown &selector); 756af5866c9SMark Brown if (ret < 0) { 7575da84fd9SJoe Perches rdev_err(rdev, "failed to apply %duV constraint\n", 7585da84fd9SJoe Perches rdev->constraints->min_uV); 759af5866c9SMark Brown rdev->constraints = NULL; 760af5866c9SMark Brown return ret; 761af5866c9SMark Brown } 762af5866c9SMark Brown } 763e79055d6SMark Brown 764e79055d6SMark Brown /* constrain machine-level voltage specs to fit 765e79055d6SMark Brown * the actual range supported by this regulator. 766e79055d6SMark Brown */ 767e79055d6SMark Brown if (ops->list_voltage && rdev->desc->n_voltages) { 768e79055d6SMark Brown int count = rdev->desc->n_voltages; 769e79055d6SMark Brown int i; 770e79055d6SMark Brown int min_uV = INT_MAX; 771e79055d6SMark Brown int max_uV = INT_MIN; 772e79055d6SMark Brown int cmin = constraints->min_uV; 773e79055d6SMark Brown int cmax = constraints->max_uV; 774e79055d6SMark Brown 775e79055d6SMark Brown /* it's safe to autoconfigure fixed-voltage supplies 776e79055d6SMark Brown and the constraints are used by list_voltage. */ 777e79055d6SMark Brown if (count == 1 && !cmin) { 778e79055d6SMark Brown cmin = 1; 779e79055d6SMark Brown cmax = INT_MAX; 780e79055d6SMark Brown constraints->min_uV = cmin; 781e79055d6SMark Brown constraints->max_uV = cmax; 782e79055d6SMark Brown } 783e79055d6SMark Brown 784e79055d6SMark Brown /* voltage constraints are optional */ 785e79055d6SMark Brown if ((cmin == 0) && (cmax == 0)) 786e79055d6SMark Brown return 0; 787e79055d6SMark Brown 788e79055d6SMark Brown /* else require explicit machine-level constraints */ 789e79055d6SMark Brown if (cmin <= 0 || cmax <= 0 || cmax < cmin) { 7905da84fd9SJoe Perches rdev_err(rdev, "invalid voltage constraints\n"); 791e79055d6SMark Brown return -EINVAL; 792e79055d6SMark Brown } 793e79055d6SMark Brown 794e79055d6SMark Brown /* initial: [cmin..cmax] valid, [min_uV..max_uV] not */ 795e79055d6SMark Brown for (i = 0; i < count; i++) { 796e79055d6SMark Brown int value; 797e79055d6SMark Brown 798e79055d6SMark Brown value = ops->list_voltage(rdev, i); 799e79055d6SMark Brown if (value <= 0) 800e79055d6SMark Brown continue; 801e79055d6SMark Brown 802e79055d6SMark Brown /* maybe adjust [min_uV..max_uV] */ 803e79055d6SMark Brown if (value >= cmin && value < min_uV) 804e79055d6SMark Brown min_uV = value; 805e79055d6SMark Brown if (value <= cmax && value > max_uV) 806e79055d6SMark Brown max_uV = value; 807e79055d6SMark Brown } 808e79055d6SMark Brown 809e79055d6SMark Brown /* final: [min_uV..max_uV] valid iff constraints valid */ 810e79055d6SMark Brown if (max_uV < min_uV) { 8115da84fd9SJoe Perches rdev_err(rdev, "unsupportable voltage constraints\n"); 812e79055d6SMark Brown return -EINVAL; 813e79055d6SMark Brown } 814e79055d6SMark Brown 815e79055d6SMark Brown /* use regulator's subset of machine constraints */ 816e79055d6SMark Brown if (constraints->min_uV < min_uV) { 8175da84fd9SJoe Perches rdev_dbg(rdev, "override min_uV, %d -> %d\n", 8185da84fd9SJoe Perches constraints->min_uV, min_uV); 819e79055d6SMark Brown constraints->min_uV = min_uV; 820e79055d6SMark Brown } 821e79055d6SMark Brown if (constraints->max_uV > max_uV) { 8225da84fd9SJoe Perches rdev_dbg(rdev, "override max_uV, %d -> %d\n", 8235da84fd9SJoe Perches constraints->max_uV, max_uV); 824e79055d6SMark Brown constraints->max_uV = max_uV; 825e79055d6SMark Brown } 826e79055d6SMark Brown } 827e79055d6SMark Brown 828e79055d6SMark Brown return 0; 829e79055d6SMark Brown } 830e79055d6SMark Brown 831a5766f11SLiam Girdwood /** 832a5766f11SLiam Girdwood * set_machine_constraints - sets regulator constraints 83369279fb9SMark Brown * @rdev: regulator source 834c8e7e464SMark Brown * @constraints: constraints to apply 835a5766f11SLiam Girdwood * 836a5766f11SLiam Girdwood * Allows platform initialisation code to define and constrain 837a5766f11SLiam Girdwood * regulator circuits e.g. valid voltage/current ranges, etc. NOTE: 838a5766f11SLiam Girdwood * Constraints *must* be set by platform code in order for some 839a5766f11SLiam Girdwood * regulator operations to proceed i.e. set_voltage, set_current_limit, 840a5766f11SLiam Girdwood * set_mode. 841a5766f11SLiam Girdwood */ 842a5766f11SLiam Girdwood static int set_machine_constraints(struct regulator_dev *rdev, 843f8c12fe3SMark Brown const struct regulation_constraints *constraints) 844a5766f11SLiam Girdwood { 845a5766f11SLiam Girdwood int ret = 0; 846e5fda26cSMark Brown struct regulator_ops *ops = rdev->desc->ops; 847e06f5b4fSMark Brown 848f8c12fe3SMark Brown rdev->constraints = kmemdup(constraints, sizeof(*constraints), 849f8c12fe3SMark Brown GFP_KERNEL); 850f8c12fe3SMark Brown if (!rdev->constraints) 851f8c12fe3SMark Brown return -ENOMEM; 852af5866c9SMark Brown 853f8c12fe3SMark Brown ret = machine_constraints_voltage(rdev, rdev->constraints); 854e79055d6SMark Brown if (ret != 0) 8553e2b9abdSMark Brown goto out; 8563e2b9abdSMark Brown 857a5766f11SLiam Girdwood /* do we need to setup our suspend state */ 858e06f5b4fSMark Brown if (constraints->initial_state) { 859f8c12fe3SMark Brown ret = suspend_prepare(rdev, rdev->constraints->initial_state); 860e06f5b4fSMark Brown if (ret < 0) { 8615da84fd9SJoe Perches rdev_err(rdev, "failed to set suspend state\n"); 862e06f5b4fSMark Brown rdev->constraints = NULL; 863e06f5b4fSMark Brown goto out; 864e06f5b4fSMark Brown } 865e06f5b4fSMark Brown } 866a5766f11SLiam Girdwood 867a308466cSMark Brown if (constraints->initial_mode) { 868a308466cSMark Brown if (!ops->set_mode) { 8695da84fd9SJoe Perches rdev_err(rdev, "no set_mode operation\n"); 870a308466cSMark Brown ret = -EINVAL; 871a308466cSMark Brown goto out; 872a308466cSMark Brown } 873a308466cSMark Brown 874f8c12fe3SMark Brown ret = ops->set_mode(rdev, rdev->constraints->initial_mode); 875a308466cSMark Brown if (ret < 0) { 8765da84fd9SJoe Perches rdev_err(rdev, "failed to set initial mode: %d\n", ret); 877a308466cSMark Brown goto out; 878a308466cSMark Brown } 879a308466cSMark Brown } 880a308466cSMark Brown 881cacf90f2SMark Brown /* If the constraints say the regulator should be on at this point 882cacf90f2SMark Brown * and we have control then make sure it is enabled. 883cacf90f2SMark Brown */ 884f8c12fe3SMark Brown if ((rdev->constraints->always_on || rdev->constraints->boot_on) && 885f8c12fe3SMark Brown ops->enable) { 886e5fda26cSMark Brown ret = ops->enable(rdev); 887e5fda26cSMark Brown if (ret < 0) { 8885da84fd9SJoe Perches rdev_err(rdev, "failed to enable\n"); 889e5fda26cSMark Brown rdev->constraints = NULL; 890e5fda26cSMark Brown goto out; 891e5fda26cSMark Brown } 892e5fda26cSMark Brown } 893e5fda26cSMark Brown 894a5766f11SLiam Girdwood print_constraints(rdev); 895a5766f11SLiam Girdwood out: 896a5766f11SLiam Girdwood return ret; 897a5766f11SLiam Girdwood } 898a5766f11SLiam Girdwood 899a5766f11SLiam Girdwood /** 900a5766f11SLiam Girdwood * set_supply - set regulator supply regulator 90169279fb9SMark Brown * @rdev: regulator name 90269279fb9SMark Brown * @supply_rdev: supply regulator name 903a5766f11SLiam Girdwood * 904a5766f11SLiam Girdwood * Called by platform initialisation code to set the supply regulator for this 905a5766f11SLiam Girdwood * regulator. This ensures that a regulators supply will also be enabled by the 906a5766f11SLiam Girdwood * core if it's child is enabled. 907a5766f11SLiam Girdwood */ 908a5766f11SLiam Girdwood static int set_supply(struct regulator_dev *rdev, 909a5766f11SLiam Girdwood struct regulator_dev *supply_rdev) 910a5766f11SLiam Girdwood { 911a5766f11SLiam Girdwood int err; 912a5766f11SLiam Girdwood 913a5766f11SLiam Girdwood err = sysfs_create_link(&rdev->dev.kobj, &supply_rdev->dev.kobj, 914a5766f11SLiam Girdwood "supply"); 915a5766f11SLiam Girdwood if (err) { 9165da84fd9SJoe Perches rdev_err(rdev, "could not add device link %s err %d\n", 9171d7372e1SDaniel Walker supply_rdev->dev.kobj.name, err); 918a5766f11SLiam Girdwood goto out; 919a5766f11SLiam Girdwood } 920a5766f11SLiam Girdwood rdev->supply = supply_rdev; 921a5766f11SLiam Girdwood list_add(&rdev->slist, &supply_rdev->supply_list); 922a5766f11SLiam Girdwood out: 923a5766f11SLiam Girdwood return err; 924a5766f11SLiam Girdwood } 925a5766f11SLiam Girdwood 926a5766f11SLiam Girdwood /** 92706c63f93SRandy Dunlap * set_consumer_device_supply - Bind a regulator to a symbolic supply 92869279fb9SMark Brown * @rdev: regulator source 92969279fb9SMark Brown * @consumer_dev: device the supply applies to 93040f9244fSMark Brown * @consumer_dev_name: dev_name() string for device supply applies to 931a5766f11SLiam Girdwood * @supply: symbolic name for supply 932a5766f11SLiam Girdwood * 933a5766f11SLiam Girdwood * Allows platform initialisation code to map physical regulator 934a5766f11SLiam Girdwood * sources to symbolic names for supplies for use by devices. Devices 935a5766f11SLiam Girdwood * should use these symbolic names to request regulators, avoiding the 936a5766f11SLiam Girdwood * need to provide board-specific regulator names as platform data. 93740f9244fSMark Brown * 93840f9244fSMark Brown * Only one of consumer_dev and consumer_dev_name may be specified. 939a5766f11SLiam Girdwood */ 940a5766f11SLiam Girdwood static int set_consumer_device_supply(struct regulator_dev *rdev, 94140f9244fSMark Brown struct device *consumer_dev, const char *consumer_dev_name, 94240f9244fSMark Brown const char *supply) 943a5766f11SLiam Girdwood { 944a5766f11SLiam Girdwood struct regulator_map *node; 9459ed2099eSMark Brown int has_dev; 946a5766f11SLiam Girdwood 94740f9244fSMark Brown if (consumer_dev && consumer_dev_name) 94840f9244fSMark Brown return -EINVAL; 94940f9244fSMark Brown 95040f9244fSMark Brown if (!consumer_dev_name && consumer_dev) 95140f9244fSMark Brown consumer_dev_name = dev_name(consumer_dev); 95240f9244fSMark Brown 953a5766f11SLiam Girdwood if (supply == NULL) 954a5766f11SLiam Girdwood return -EINVAL; 955a5766f11SLiam Girdwood 9569ed2099eSMark Brown if (consumer_dev_name != NULL) 9579ed2099eSMark Brown has_dev = 1; 9589ed2099eSMark Brown else 9599ed2099eSMark Brown has_dev = 0; 9609ed2099eSMark Brown 9616001e13cSDavid Brownell list_for_each_entry(node, ®ulator_map_list, list) { 96223b5cc2aSJani Nikula if (node->dev_name && consumer_dev_name) { 96323b5cc2aSJani Nikula if (strcmp(node->dev_name, consumer_dev_name) != 0) 9646001e13cSDavid Brownell continue; 96523b5cc2aSJani Nikula } else if (node->dev_name || consumer_dev_name) { 96623b5cc2aSJani Nikula continue; 96723b5cc2aSJani Nikula } 96823b5cc2aSJani Nikula 9696001e13cSDavid Brownell if (strcmp(node->supply, supply) != 0) 9706001e13cSDavid Brownell continue; 9716001e13cSDavid Brownell 9726001e13cSDavid Brownell dev_dbg(consumer_dev, "%s/%s is '%s' supply; fail %s/%s\n", 9736001e13cSDavid Brownell dev_name(&node->regulator->dev), 9746001e13cSDavid Brownell node->regulator->desc->name, 9756001e13cSDavid Brownell supply, 9761083c393SMark Brown dev_name(&rdev->dev), rdev_get_name(rdev)); 9776001e13cSDavid Brownell return -EBUSY; 9786001e13cSDavid Brownell } 9796001e13cSDavid Brownell 9809ed2099eSMark Brown node = kzalloc(sizeof(struct regulator_map), GFP_KERNEL); 981a5766f11SLiam Girdwood if (node == NULL) 982a5766f11SLiam Girdwood return -ENOMEM; 983a5766f11SLiam Girdwood 984a5766f11SLiam Girdwood node->regulator = rdev; 985a5766f11SLiam Girdwood node->supply = supply; 986a5766f11SLiam Girdwood 9879ed2099eSMark Brown if (has_dev) { 9889ed2099eSMark Brown node->dev_name = kstrdup(consumer_dev_name, GFP_KERNEL); 98940f9244fSMark Brown if (node->dev_name == NULL) { 99040f9244fSMark Brown kfree(node); 99140f9244fSMark Brown return -ENOMEM; 99240f9244fSMark Brown } 9939ed2099eSMark Brown } 99440f9244fSMark Brown 995a5766f11SLiam Girdwood list_add(&node->list, ®ulator_map_list); 996a5766f11SLiam Girdwood return 0; 997a5766f11SLiam Girdwood } 998a5766f11SLiam Girdwood 9990f1d747bSMike Rapoport static void unset_regulator_supplies(struct regulator_dev *rdev) 10000f1d747bSMike Rapoport { 10010f1d747bSMike Rapoport struct regulator_map *node, *n; 10020f1d747bSMike Rapoport 10030f1d747bSMike Rapoport list_for_each_entry_safe(node, n, ®ulator_map_list, list) { 10040f1d747bSMike Rapoport if (rdev == node->regulator) { 10050f1d747bSMike Rapoport list_del(&node->list); 100640f9244fSMark Brown kfree(node->dev_name); 10070f1d747bSMike Rapoport kfree(node); 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; 10384f26a2abSAmeya Palande sysfs_attr_init(®ulator->dev_attr.attr); 1039414c70cbSLiam Girdwood regulator->dev_attr.attr.name = kstrdup(buf, GFP_KERNEL); 1040414c70cbSLiam Girdwood if (regulator->dev_attr.attr.name == NULL) 1041414c70cbSLiam Girdwood goto attr_name_err; 1042414c70cbSLiam Girdwood 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) { 10475da84fd9SJoe Perches rdev_warn(rdev, "could not add regulator_dev requested microamps sysfs entry\n"); 1048414c70cbSLiam Girdwood goto attr_name_err; 1049414c70cbSLiam Girdwood } 1050414c70cbSLiam Girdwood 1051414c70cbSLiam Girdwood /* also add a link to the device sysfs entry */ 1052414c70cbSLiam Girdwood size = scnprintf(buf, REG_STR_SIZE, "%s-%s", 1053414c70cbSLiam Girdwood dev->kobj.name, supply_name); 1054414c70cbSLiam Girdwood if (size >= REG_STR_SIZE) 1055414c70cbSLiam Girdwood goto attr_err; 1056414c70cbSLiam Girdwood 1057414c70cbSLiam Girdwood regulator->supply_name = kstrdup(buf, GFP_KERNEL); 1058414c70cbSLiam Girdwood if (regulator->supply_name == NULL) 1059414c70cbSLiam Girdwood goto attr_err; 1060414c70cbSLiam Girdwood 1061414c70cbSLiam Girdwood err = sysfs_create_link(&rdev->dev.kobj, &dev->kobj, 1062414c70cbSLiam Girdwood buf); 1063414c70cbSLiam Girdwood if (err) { 10645da84fd9SJoe Perches rdev_warn(rdev, "could not add device link %s err %d\n", 10651d7372e1SDaniel Walker dev->kobj.name, err); 1066414c70cbSLiam Girdwood goto link_name_err; 1067414c70cbSLiam Girdwood } 1068414c70cbSLiam Girdwood } 1069414c70cbSLiam Girdwood mutex_unlock(&rdev->mutex); 1070414c70cbSLiam Girdwood return regulator; 1071414c70cbSLiam Girdwood link_name_err: 1072414c70cbSLiam Girdwood kfree(regulator->supply_name); 1073414c70cbSLiam Girdwood attr_err: 1074414c70cbSLiam Girdwood device_remove_file(regulator->dev, ®ulator->dev_attr); 1075414c70cbSLiam Girdwood attr_name_err: 1076414c70cbSLiam Girdwood kfree(regulator->dev_attr.attr.name); 1077414c70cbSLiam Girdwood overflow_err: 1078414c70cbSLiam Girdwood list_del(®ulator->list); 1079414c70cbSLiam Girdwood kfree(regulator); 1080414c70cbSLiam Girdwood mutex_unlock(&rdev->mutex); 1081414c70cbSLiam Girdwood return NULL; 1082414c70cbSLiam Girdwood } 1083414c70cbSLiam Girdwood 108431aae2beSMark Brown static int _regulator_get_enable_time(struct regulator_dev *rdev) 108531aae2beSMark Brown { 108631aae2beSMark Brown if (!rdev->desc->ops->enable_time) 108731aae2beSMark Brown return 0; 108831aae2beSMark Brown return rdev->desc->ops->enable_time(rdev); 108931aae2beSMark Brown } 109031aae2beSMark Brown 10915ffbd136SMark Brown /* Internal regulator request function */ 10925ffbd136SMark Brown static struct regulator *_regulator_get(struct device *dev, const char *id, 10935ffbd136SMark Brown int exclusive) 1094414c70cbSLiam Girdwood { 1095414c70cbSLiam Girdwood struct regulator_dev *rdev; 1096414c70cbSLiam Girdwood struct regulator_map *map; 1097414c70cbSLiam Girdwood struct regulator *regulator = ERR_PTR(-ENODEV); 109840f9244fSMark Brown const char *devname = NULL; 10995ffbd136SMark Brown int ret; 1100414c70cbSLiam Girdwood 1101414c70cbSLiam Girdwood if (id == NULL) { 11025da84fd9SJoe Perches pr_err("get() with no identifier\n"); 1103414c70cbSLiam Girdwood return regulator; 1104414c70cbSLiam Girdwood } 1105414c70cbSLiam Girdwood 110640f9244fSMark Brown if (dev) 110740f9244fSMark Brown devname = dev_name(dev); 110840f9244fSMark Brown 1109414c70cbSLiam Girdwood mutex_lock(®ulator_list_mutex); 1110414c70cbSLiam Girdwood 1111414c70cbSLiam Girdwood list_for_each_entry(map, ®ulator_map_list, list) { 111240f9244fSMark Brown /* If the mapping has a device set up it must match */ 111340f9244fSMark Brown if (map->dev_name && 111440f9244fSMark Brown (!devname || strcmp(map->dev_name, devname))) 111540f9244fSMark Brown continue; 111640f9244fSMark Brown 111740f9244fSMark Brown if (strcmp(map->supply, id) == 0) { 1118a5766f11SLiam Girdwood rdev = map->regulator; 1119414c70cbSLiam Girdwood goto found; 1120414c70cbSLiam Girdwood } 1121a5766f11SLiam Girdwood } 112234abbd68SMark Brown 1123688fe99aSMark Brown if (board_wants_dummy_regulator) { 1124688fe99aSMark Brown rdev = dummy_regulator_rdev; 1125688fe99aSMark Brown goto found; 1126688fe99aSMark Brown } 1127688fe99aSMark Brown 112834abbd68SMark Brown #ifdef CONFIG_REGULATOR_DUMMY 112934abbd68SMark Brown if (!devname) 113034abbd68SMark Brown devname = "deviceless"; 113134abbd68SMark Brown 113234abbd68SMark Brown /* If the board didn't flag that it was fully constrained then 113334abbd68SMark Brown * substitute in a dummy regulator so consumers can continue. 113434abbd68SMark Brown */ 113534abbd68SMark Brown if (!has_full_constraints) { 11365da84fd9SJoe Perches pr_warn("%s supply %s not found, using dummy regulator\n", 113734abbd68SMark Brown devname, id); 113834abbd68SMark Brown rdev = dummy_regulator_rdev; 113934abbd68SMark Brown goto found; 114034abbd68SMark Brown } 114134abbd68SMark Brown #endif 114234abbd68SMark Brown 1143414c70cbSLiam Girdwood mutex_unlock(®ulator_list_mutex); 1144414c70cbSLiam Girdwood return regulator; 1145414c70cbSLiam Girdwood 1146414c70cbSLiam Girdwood found: 11475ffbd136SMark Brown if (rdev->exclusive) { 11485ffbd136SMark Brown regulator = ERR_PTR(-EPERM); 11495ffbd136SMark Brown goto out; 11505ffbd136SMark Brown } 11515ffbd136SMark Brown 11525ffbd136SMark Brown if (exclusive && rdev->open_count) { 11535ffbd136SMark Brown regulator = ERR_PTR(-EBUSY); 11545ffbd136SMark Brown goto out; 11555ffbd136SMark Brown } 11565ffbd136SMark Brown 1157a5766f11SLiam Girdwood if (!try_module_get(rdev->owner)) 1158a5766f11SLiam Girdwood goto out; 1159a5766f11SLiam Girdwood 1160414c70cbSLiam Girdwood regulator = create_regulator(rdev, dev, id); 1161414c70cbSLiam Girdwood if (regulator == NULL) { 1162414c70cbSLiam Girdwood regulator = ERR_PTR(-ENOMEM); 1163414c70cbSLiam Girdwood module_put(rdev->owner); 1164414c70cbSLiam Girdwood } 1165414c70cbSLiam Girdwood 11665ffbd136SMark Brown rdev->open_count++; 11675ffbd136SMark Brown if (exclusive) { 11685ffbd136SMark Brown rdev->exclusive = 1; 11695ffbd136SMark Brown 11705ffbd136SMark Brown ret = _regulator_is_enabled(rdev); 11715ffbd136SMark Brown if (ret > 0) 11725ffbd136SMark Brown rdev->use_count = 1; 11735ffbd136SMark Brown else 11745ffbd136SMark Brown rdev->use_count = 0; 11755ffbd136SMark Brown } 11765ffbd136SMark Brown 1177a5766f11SLiam Girdwood out: 1178414c70cbSLiam Girdwood mutex_unlock(®ulator_list_mutex); 11795ffbd136SMark Brown 1180414c70cbSLiam Girdwood return regulator; 1181414c70cbSLiam Girdwood } 11825ffbd136SMark Brown 11835ffbd136SMark Brown /** 11845ffbd136SMark Brown * regulator_get - lookup and obtain a reference to a regulator. 11855ffbd136SMark Brown * @dev: device for regulator "consumer" 11865ffbd136SMark Brown * @id: Supply name or regulator ID. 11875ffbd136SMark Brown * 11885ffbd136SMark Brown * Returns a struct regulator corresponding to the regulator producer, 11895ffbd136SMark Brown * or IS_ERR() condition containing errno. 11905ffbd136SMark Brown * 11915ffbd136SMark Brown * Use of supply names configured via regulator_set_device_supply() is 11925ffbd136SMark Brown * strongly encouraged. It is recommended that the supply name used 11935ffbd136SMark Brown * should match the name used for the supply and/or the relevant 11945ffbd136SMark Brown * device pins in the datasheet. 11955ffbd136SMark Brown */ 11965ffbd136SMark Brown struct regulator *regulator_get(struct device *dev, const char *id) 11975ffbd136SMark Brown { 11985ffbd136SMark Brown return _regulator_get(dev, id, 0); 11995ffbd136SMark Brown } 1200414c70cbSLiam Girdwood EXPORT_SYMBOL_GPL(regulator_get); 1201414c70cbSLiam Girdwood 1202414c70cbSLiam Girdwood /** 12035ffbd136SMark Brown * regulator_get_exclusive - obtain exclusive access to a regulator. 12045ffbd136SMark Brown * @dev: device for regulator "consumer" 12055ffbd136SMark Brown * @id: Supply name or regulator ID. 12065ffbd136SMark Brown * 12075ffbd136SMark Brown * Returns a struct regulator corresponding to the regulator producer, 12085ffbd136SMark Brown * or IS_ERR() condition containing errno. Other consumers will be 12095ffbd136SMark Brown * unable to obtain this reference is held and the use count for the 12105ffbd136SMark Brown * regulator will be initialised to reflect the current state of the 12115ffbd136SMark Brown * regulator. 12125ffbd136SMark Brown * 12135ffbd136SMark Brown * This is intended for use by consumers which cannot tolerate shared 12145ffbd136SMark Brown * use of the regulator such as those which need to force the 12155ffbd136SMark Brown * regulator off for correct operation of the hardware they are 12165ffbd136SMark Brown * controlling. 12175ffbd136SMark Brown * 12185ffbd136SMark Brown * Use of supply names configured via regulator_set_device_supply() is 12195ffbd136SMark Brown * strongly encouraged. It is recommended that the supply name used 12205ffbd136SMark Brown * should match the name used for the supply and/or the relevant 12215ffbd136SMark Brown * device pins in the datasheet. 12225ffbd136SMark Brown */ 12235ffbd136SMark Brown struct regulator *regulator_get_exclusive(struct device *dev, const char *id) 12245ffbd136SMark Brown { 12255ffbd136SMark Brown return _regulator_get(dev, id, 1); 12265ffbd136SMark Brown } 12275ffbd136SMark Brown EXPORT_SYMBOL_GPL(regulator_get_exclusive); 12285ffbd136SMark Brown 12295ffbd136SMark Brown /** 1230414c70cbSLiam Girdwood * regulator_put - "free" the regulator source 1231414c70cbSLiam Girdwood * @regulator: regulator source 1232414c70cbSLiam Girdwood * 1233414c70cbSLiam Girdwood * Note: drivers must ensure that all regulator_enable calls made on this 1234414c70cbSLiam Girdwood * regulator source are balanced by regulator_disable calls prior to calling 1235414c70cbSLiam Girdwood * this function. 1236414c70cbSLiam Girdwood */ 1237414c70cbSLiam Girdwood void regulator_put(struct regulator *regulator) 1238414c70cbSLiam Girdwood { 1239414c70cbSLiam Girdwood struct regulator_dev *rdev; 1240414c70cbSLiam Girdwood 1241414c70cbSLiam Girdwood if (regulator == NULL || IS_ERR(regulator)) 1242414c70cbSLiam Girdwood return; 1243414c70cbSLiam Girdwood 1244414c70cbSLiam Girdwood mutex_lock(®ulator_list_mutex); 1245414c70cbSLiam Girdwood rdev = regulator->rdev; 1246414c70cbSLiam Girdwood 1247414c70cbSLiam Girdwood /* remove any sysfs entries */ 1248414c70cbSLiam Girdwood if (regulator->dev) { 1249414c70cbSLiam Girdwood sysfs_remove_link(&rdev->dev.kobj, regulator->supply_name); 1250414c70cbSLiam Girdwood kfree(regulator->supply_name); 1251414c70cbSLiam Girdwood device_remove_file(regulator->dev, ®ulator->dev_attr); 1252414c70cbSLiam Girdwood kfree(regulator->dev_attr.attr.name); 1253414c70cbSLiam Girdwood } 1254414c70cbSLiam Girdwood list_del(®ulator->list); 1255414c70cbSLiam Girdwood kfree(regulator); 1256414c70cbSLiam Girdwood 12575ffbd136SMark Brown rdev->open_count--; 12585ffbd136SMark Brown rdev->exclusive = 0; 12595ffbd136SMark Brown 1260414c70cbSLiam Girdwood module_put(rdev->owner); 1261414c70cbSLiam Girdwood mutex_unlock(®ulator_list_mutex); 1262414c70cbSLiam Girdwood } 1263414c70cbSLiam Girdwood EXPORT_SYMBOL_GPL(regulator_put); 1264414c70cbSLiam Girdwood 12659a2372faSMark Brown static int _regulator_can_change_status(struct regulator_dev *rdev) 12669a2372faSMark Brown { 12679a2372faSMark Brown if (!rdev->constraints) 12689a2372faSMark Brown return 0; 12699a2372faSMark Brown 12709a2372faSMark Brown if (rdev->constraints->valid_ops_mask & REGULATOR_CHANGE_STATUS) 12719a2372faSMark Brown return 1; 12729a2372faSMark Brown else 12739a2372faSMark Brown return 0; 12749a2372faSMark Brown } 12759a2372faSMark Brown 1276414c70cbSLiam Girdwood /* locks held by regulator_enable() */ 1277414c70cbSLiam Girdwood static int _regulator_enable(struct regulator_dev *rdev) 1278414c70cbSLiam Girdwood { 127931aae2beSMark Brown int ret, delay; 1280414c70cbSLiam Girdwood 1281acaf6ffeSBengt Jonsson if (rdev->use_count == 0) { 1282414c70cbSLiam Girdwood /* do we need to enable the supply regulator first */ 1283414c70cbSLiam Girdwood if (rdev->supply) { 12843aa713e7SMattias Wallin mutex_lock(&rdev->supply->mutex); 1285414c70cbSLiam Girdwood ret = _regulator_enable(rdev->supply); 12863aa713e7SMattias Wallin mutex_unlock(&rdev->supply->mutex); 1287414c70cbSLiam Girdwood if (ret < 0) { 12885da84fd9SJoe Perches rdev_err(rdev, "failed to enable: %d\n", ret); 1289414c70cbSLiam Girdwood return ret; 1290414c70cbSLiam Girdwood } 1291414c70cbSLiam Girdwood } 1292acaf6ffeSBengt Jonsson } 1293414c70cbSLiam Girdwood 1294414c70cbSLiam Girdwood /* check voltage and requested load before enabling */ 1295414c70cbSLiam Girdwood if (rdev->constraints && 12969a2372faSMark Brown (rdev->constraints->valid_ops_mask & REGULATOR_CHANGE_DRMS)) 1297414c70cbSLiam Girdwood drms_uA_update(rdev); 1298414c70cbSLiam Girdwood 12999a2372faSMark Brown if (rdev->use_count == 0) { 13009a2372faSMark Brown /* The regulator may on if it's not switchable or left on */ 13019a2372faSMark Brown ret = _regulator_is_enabled(rdev); 13029a2372faSMark Brown if (ret == -EINVAL || ret == 0) { 13039a2372faSMark Brown if (!_regulator_can_change_status(rdev)) 13049a2372faSMark Brown return -EPERM; 13059a2372faSMark Brown 130631aae2beSMark Brown if (!rdev->desc->ops->enable) 130731aae2beSMark Brown return -EINVAL; 130831aae2beSMark Brown 130931aae2beSMark Brown /* Query before enabling in case configuration 131031aae2beSMark Brown * dependant. */ 131131aae2beSMark Brown ret = _regulator_get_enable_time(rdev); 131231aae2beSMark Brown if (ret >= 0) { 131331aae2beSMark Brown delay = ret; 131431aae2beSMark Brown } else { 13155da84fd9SJoe Perches rdev_warn(rdev, "enable_time() failed: %d\n", 131631aae2beSMark Brown ret); 131731aae2beSMark Brown delay = 0; 131831aae2beSMark Brown } 131931aae2beSMark Brown 132002fa3ec0SMark Brown trace_regulator_enable(rdev_get_name(rdev)); 132102fa3ec0SMark Brown 132231aae2beSMark Brown /* Allow the regulator to ramp; it would be useful 132331aae2beSMark Brown * to extend this for bulk operations so that the 132431aae2beSMark Brown * regulators can ramp together. */ 1325414c70cbSLiam Girdwood ret = rdev->desc->ops->enable(rdev); 13269a2372faSMark Brown if (ret < 0) 13279a2372faSMark Brown return ret; 132831aae2beSMark Brown 132902fa3ec0SMark Brown trace_regulator_enable_delay(rdev_get_name(rdev)); 133002fa3ec0SMark Brown 1331e36c1df8SAxel Lin if (delay >= 1000) { 133231aae2beSMark Brown mdelay(delay / 1000); 1333e36c1df8SAxel Lin udelay(delay % 1000); 1334e36c1df8SAxel Lin } else if (delay) { 133531aae2beSMark Brown udelay(delay); 1336e36c1df8SAxel Lin } 133731aae2beSMark Brown 133802fa3ec0SMark Brown trace_regulator_enable_complete(rdev_get_name(rdev)); 133902fa3ec0SMark Brown 1340a7433cffSLinus Walleij } else if (ret < 0) { 13415da84fd9SJoe Perches rdev_err(rdev, "is_enabled() failed: %d\n", ret); 1342414c70cbSLiam Girdwood return ret; 1343414c70cbSLiam Girdwood } 1344a7433cffSLinus Walleij /* Fallthrough on positive return values - already enabled */ 1345414c70cbSLiam Girdwood } 1346414c70cbSLiam Girdwood 13479a2372faSMark Brown rdev->use_count++; 13489a2372faSMark Brown 13499a2372faSMark Brown return 0; 1350414c70cbSLiam Girdwood } 1351414c70cbSLiam Girdwood 1352414c70cbSLiam Girdwood /** 1353414c70cbSLiam Girdwood * regulator_enable - enable regulator output 1354414c70cbSLiam Girdwood * @regulator: regulator source 1355414c70cbSLiam Girdwood * 1356cf7bbcdfSMark Brown * Request that the regulator be enabled with the regulator output at 1357cf7bbcdfSMark Brown * the predefined voltage or current value. Calls to regulator_enable() 1358cf7bbcdfSMark Brown * must be balanced with calls to regulator_disable(). 1359cf7bbcdfSMark Brown * 1360414c70cbSLiam Girdwood * NOTE: the output value can be set by other drivers, boot loader or may be 1361cf7bbcdfSMark Brown * hardwired in the regulator. 1362414c70cbSLiam Girdwood */ 1363414c70cbSLiam Girdwood int regulator_enable(struct regulator *regulator) 1364414c70cbSLiam Girdwood { 1365412aec61SDavid Brownell struct regulator_dev *rdev = regulator->rdev; 1366412aec61SDavid Brownell int ret = 0; 1367414c70cbSLiam Girdwood 1368412aec61SDavid Brownell mutex_lock(&rdev->mutex); 1369412aec61SDavid Brownell ret = _regulator_enable(rdev); 1370412aec61SDavid Brownell mutex_unlock(&rdev->mutex); 1371414c70cbSLiam Girdwood return ret; 1372414c70cbSLiam Girdwood } 1373414c70cbSLiam Girdwood EXPORT_SYMBOL_GPL(regulator_enable); 1374414c70cbSLiam Girdwood 1375414c70cbSLiam Girdwood /* locks held by regulator_disable() */ 13768cbf811dSJeffrey Carlyle static int _regulator_disable(struct regulator_dev *rdev, 13778cbf811dSJeffrey Carlyle struct regulator_dev **supply_rdev_ptr) 1378414c70cbSLiam Girdwood { 1379414c70cbSLiam Girdwood int ret = 0; 1380b12a1e29SMattias Wallin *supply_rdev_ptr = NULL; 1381414c70cbSLiam Girdwood 1382cd94b505SDavid Brownell if (WARN(rdev->use_count <= 0, 138343e7ee33SJoe Perches "unbalanced disables for %s\n", rdev_get_name(rdev))) 1384cd94b505SDavid Brownell return -EIO; 1385cd94b505SDavid Brownell 1386414c70cbSLiam Girdwood /* are we the last user and permitted to disable ? */ 138760ef66fcSMark Brown if (rdev->use_count == 1 && 138860ef66fcSMark Brown (rdev->constraints && !rdev->constraints->always_on)) { 1389414c70cbSLiam Girdwood 1390414c70cbSLiam Girdwood /* we are last user */ 13919a2372faSMark Brown if (_regulator_can_change_status(rdev) && 13929a2372faSMark Brown rdev->desc->ops->disable) { 139302fa3ec0SMark Brown trace_regulator_disable(rdev_get_name(rdev)); 139402fa3ec0SMark Brown 1395414c70cbSLiam Girdwood ret = rdev->desc->ops->disable(rdev); 1396414c70cbSLiam Girdwood if (ret < 0) { 13975da84fd9SJoe Perches rdev_err(rdev, "failed to disable\n"); 1398414c70cbSLiam Girdwood return ret; 1399414c70cbSLiam Girdwood } 140084b68263SMark Brown 140102fa3ec0SMark Brown trace_regulator_disable_complete(rdev_get_name(rdev)); 140202fa3ec0SMark Brown 140384b68263SMark Brown _notifier_call_chain(rdev, REGULATOR_EVENT_DISABLE, 140484b68263SMark Brown NULL); 1405414c70cbSLiam Girdwood } 1406414c70cbSLiam Girdwood 1407414c70cbSLiam Girdwood /* decrease our supplies ref count and disable if required */ 14088cbf811dSJeffrey Carlyle *supply_rdev_ptr = rdev->supply; 1409414c70cbSLiam Girdwood 1410414c70cbSLiam Girdwood rdev->use_count = 0; 1411414c70cbSLiam Girdwood } else if (rdev->use_count > 1) { 1412414c70cbSLiam Girdwood 1413414c70cbSLiam Girdwood if (rdev->constraints && 1414414c70cbSLiam Girdwood (rdev->constraints->valid_ops_mask & 1415414c70cbSLiam Girdwood REGULATOR_CHANGE_DRMS)) 1416414c70cbSLiam Girdwood drms_uA_update(rdev); 1417414c70cbSLiam Girdwood 1418414c70cbSLiam Girdwood rdev->use_count--; 1419414c70cbSLiam Girdwood } 1420414c70cbSLiam Girdwood return ret; 1421414c70cbSLiam Girdwood } 1422414c70cbSLiam Girdwood 1423414c70cbSLiam Girdwood /** 1424414c70cbSLiam Girdwood * regulator_disable - disable regulator output 1425414c70cbSLiam Girdwood * @regulator: regulator source 1426414c70cbSLiam Girdwood * 1427cf7bbcdfSMark Brown * Disable the regulator output voltage or current. Calls to 1428cf7bbcdfSMark Brown * regulator_enable() must be balanced with calls to 1429cf7bbcdfSMark Brown * regulator_disable(). 143069279fb9SMark Brown * 1431414c70cbSLiam Girdwood * NOTE: this will only disable the regulator output if no other consumer 1432cf7bbcdfSMark Brown * devices have it enabled, the regulator device supports disabling and 1433cf7bbcdfSMark Brown * machine constraints permit this operation. 1434414c70cbSLiam Girdwood */ 1435414c70cbSLiam Girdwood int regulator_disable(struct regulator *regulator) 1436414c70cbSLiam Girdwood { 1437412aec61SDavid Brownell struct regulator_dev *rdev = regulator->rdev; 14388cbf811dSJeffrey Carlyle struct regulator_dev *supply_rdev = NULL; 1439412aec61SDavid Brownell int ret = 0; 1440414c70cbSLiam Girdwood 1441412aec61SDavid Brownell mutex_lock(&rdev->mutex); 14428cbf811dSJeffrey Carlyle ret = _regulator_disable(rdev, &supply_rdev); 1443412aec61SDavid Brownell mutex_unlock(&rdev->mutex); 14448cbf811dSJeffrey Carlyle 14458cbf811dSJeffrey Carlyle /* decrease our supplies ref count and disable if required */ 14468cbf811dSJeffrey Carlyle while (supply_rdev != NULL) { 14478cbf811dSJeffrey Carlyle rdev = supply_rdev; 14488cbf811dSJeffrey Carlyle 14498cbf811dSJeffrey Carlyle mutex_lock(&rdev->mutex); 14508cbf811dSJeffrey Carlyle _regulator_disable(rdev, &supply_rdev); 14518cbf811dSJeffrey Carlyle mutex_unlock(&rdev->mutex); 14528cbf811dSJeffrey Carlyle } 14538cbf811dSJeffrey Carlyle 1454414c70cbSLiam Girdwood return ret; 1455414c70cbSLiam Girdwood } 1456414c70cbSLiam Girdwood EXPORT_SYMBOL_GPL(regulator_disable); 1457414c70cbSLiam Girdwood 1458414c70cbSLiam Girdwood /* locks held by regulator_force_disable() */ 14598cbf811dSJeffrey Carlyle static int _regulator_force_disable(struct regulator_dev *rdev, 14608cbf811dSJeffrey Carlyle struct regulator_dev **supply_rdev_ptr) 1461414c70cbSLiam Girdwood { 1462414c70cbSLiam Girdwood int ret = 0; 1463414c70cbSLiam Girdwood 1464414c70cbSLiam Girdwood /* force disable */ 1465414c70cbSLiam Girdwood if (rdev->desc->ops->disable) { 1466414c70cbSLiam Girdwood /* ah well, who wants to live forever... */ 1467414c70cbSLiam Girdwood ret = rdev->desc->ops->disable(rdev); 1468414c70cbSLiam Girdwood if (ret < 0) { 14695da84fd9SJoe Perches rdev_err(rdev, "failed to force disable\n"); 1470414c70cbSLiam Girdwood return ret; 1471414c70cbSLiam Girdwood } 1472414c70cbSLiam Girdwood /* notify other consumers that power has been forced off */ 147384b68263SMark Brown _notifier_call_chain(rdev, REGULATOR_EVENT_FORCE_DISABLE | 147484b68263SMark Brown REGULATOR_EVENT_DISABLE, NULL); 1475414c70cbSLiam Girdwood } 1476414c70cbSLiam Girdwood 1477414c70cbSLiam Girdwood /* decrease our supplies ref count and disable if required */ 14788cbf811dSJeffrey Carlyle *supply_rdev_ptr = rdev->supply; 1479414c70cbSLiam Girdwood 1480414c70cbSLiam Girdwood rdev->use_count = 0; 1481414c70cbSLiam Girdwood return ret; 1482414c70cbSLiam Girdwood } 1483414c70cbSLiam Girdwood 1484414c70cbSLiam Girdwood /** 1485414c70cbSLiam Girdwood * regulator_force_disable - force disable regulator output 1486414c70cbSLiam Girdwood * @regulator: regulator source 1487414c70cbSLiam Girdwood * 1488414c70cbSLiam Girdwood * Forcibly disable the regulator output voltage or current. 1489414c70cbSLiam Girdwood * NOTE: this *will* disable the regulator output even if other consumer 1490414c70cbSLiam Girdwood * devices have it enabled. This should be used for situations when device 1491414c70cbSLiam Girdwood * damage will likely occur if the regulator is not disabled (e.g. over temp). 1492414c70cbSLiam Girdwood */ 1493414c70cbSLiam Girdwood int regulator_force_disable(struct regulator *regulator) 1494414c70cbSLiam Girdwood { 14958cbf811dSJeffrey Carlyle struct regulator_dev *supply_rdev = NULL; 1496414c70cbSLiam Girdwood int ret; 1497414c70cbSLiam Girdwood 1498414c70cbSLiam Girdwood mutex_lock(®ulator->rdev->mutex); 1499414c70cbSLiam Girdwood regulator->uA_load = 0; 15008cbf811dSJeffrey Carlyle ret = _regulator_force_disable(regulator->rdev, &supply_rdev); 1501414c70cbSLiam Girdwood mutex_unlock(®ulator->rdev->mutex); 15028cbf811dSJeffrey Carlyle 15038cbf811dSJeffrey Carlyle if (supply_rdev) 15048cbf811dSJeffrey Carlyle regulator_disable(get_device_regulator(rdev_get_dev(supply_rdev))); 15058cbf811dSJeffrey Carlyle 1506414c70cbSLiam Girdwood return ret; 1507414c70cbSLiam Girdwood } 1508414c70cbSLiam Girdwood EXPORT_SYMBOL_GPL(regulator_force_disable); 1509414c70cbSLiam Girdwood 1510414c70cbSLiam Girdwood static int _regulator_is_enabled(struct regulator_dev *rdev) 1511414c70cbSLiam Girdwood { 15129a7f6a4cSMark Brown /* If we don't know then assume that the regulator is always on */ 15139332546fSMark Brown if (!rdev->desc->ops->is_enabled) 15149a7f6a4cSMark Brown return 1; 1515414c70cbSLiam Girdwood 15169332546fSMark Brown return rdev->desc->ops->is_enabled(rdev); 1517414c70cbSLiam Girdwood } 1518414c70cbSLiam Girdwood 1519414c70cbSLiam Girdwood /** 1520414c70cbSLiam Girdwood * regulator_is_enabled - is the regulator output enabled 1521414c70cbSLiam Girdwood * @regulator: regulator source 1522414c70cbSLiam Girdwood * 1523412aec61SDavid Brownell * Returns positive if the regulator driver backing the source/client 1524412aec61SDavid Brownell * has requested that the device be enabled, zero if it hasn't, else a 1525412aec61SDavid Brownell * negative errno code. 1526412aec61SDavid Brownell * 1527412aec61SDavid Brownell * Note that the device backing this regulator handle can have multiple 1528412aec61SDavid Brownell * users, so it might be enabled even if regulator_enable() was never 1529412aec61SDavid Brownell * called for this particular source. 1530414c70cbSLiam Girdwood */ 1531414c70cbSLiam Girdwood int regulator_is_enabled(struct regulator *regulator) 1532414c70cbSLiam Girdwood { 15339332546fSMark Brown int ret; 15349332546fSMark Brown 15359332546fSMark Brown mutex_lock(®ulator->rdev->mutex); 15369332546fSMark Brown ret = _regulator_is_enabled(regulator->rdev); 15379332546fSMark Brown mutex_unlock(®ulator->rdev->mutex); 15389332546fSMark Brown 15399332546fSMark Brown return ret; 1540414c70cbSLiam Girdwood } 1541414c70cbSLiam Girdwood EXPORT_SYMBOL_GPL(regulator_is_enabled); 1542414c70cbSLiam Girdwood 1543414c70cbSLiam Girdwood /** 15444367cfdcSDavid Brownell * regulator_count_voltages - count regulator_list_voltage() selectors 15454367cfdcSDavid Brownell * @regulator: regulator source 15464367cfdcSDavid Brownell * 15474367cfdcSDavid Brownell * Returns number of selectors, or negative errno. Selectors are 15484367cfdcSDavid Brownell * numbered starting at zero, and typically correspond to bitfields 15494367cfdcSDavid Brownell * in hardware registers. 15504367cfdcSDavid Brownell */ 15514367cfdcSDavid Brownell int regulator_count_voltages(struct regulator *regulator) 15524367cfdcSDavid Brownell { 15534367cfdcSDavid Brownell struct regulator_dev *rdev = regulator->rdev; 15544367cfdcSDavid Brownell 15554367cfdcSDavid Brownell return rdev->desc->n_voltages ? : -EINVAL; 15564367cfdcSDavid Brownell } 15574367cfdcSDavid Brownell EXPORT_SYMBOL_GPL(regulator_count_voltages); 15584367cfdcSDavid Brownell 15594367cfdcSDavid Brownell /** 15604367cfdcSDavid Brownell * regulator_list_voltage - enumerate supported voltages 15614367cfdcSDavid Brownell * @regulator: regulator source 15624367cfdcSDavid Brownell * @selector: identify voltage to list 15634367cfdcSDavid Brownell * Context: can sleep 15644367cfdcSDavid Brownell * 15654367cfdcSDavid Brownell * Returns a voltage that can be passed to @regulator_set_voltage(), 156688393161SThomas Weber * zero if this selector code can't be used on this system, or a 15674367cfdcSDavid Brownell * negative errno. 15684367cfdcSDavid Brownell */ 15694367cfdcSDavid Brownell int regulator_list_voltage(struct regulator *regulator, unsigned selector) 15704367cfdcSDavid Brownell { 15714367cfdcSDavid Brownell struct regulator_dev *rdev = regulator->rdev; 15724367cfdcSDavid Brownell struct regulator_ops *ops = rdev->desc->ops; 15734367cfdcSDavid Brownell int ret; 15744367cfdcSDavid Brownell 15754367cfdcSDavid Brownell if (!ops->list_voltage || selector >= rdev->desc->n_voltages) 15764367cfdcSDavid Brownell return -EINVAL; 15774367cfdcSDavid Brownell 15784367cfdcSDavid Brownell mutex_lock(&rdev->mutex); 15794367cfdcSDavid Brownell ret = ops->list_voltage(rdev, selector); 15804367cfdcSDavid Brownell mutex_unlock(&rdev->mutex); 15814367cfdcSDavid Brownell 15824367cfdcSDavid Brownell if (ret > 0) { 15834367cfdcSDavid Brownell if (ret < rdev->constraints->min_uV) 15844367cfdcSDavid Brownell ret = 0; 15854367cfdcSDavid Brownell else if (ret > rdev->constraints->max_uV) 15864367cfdcSDavid Brownell ret = 0; 15874367cfdcSDavid Brownell } 15884367cfdcSDavid Brownell 15894367cfdcSDavid Brownell return ret; 15904367cfdcSDavid Brownell } 15914367cfdcSDavid Brownell EXPORT_SYMBOL_GPL(regulator_list_voltage); 15924367cfdcSDavid Brownell 15934367cfdcSDavid Brownell /** 1594a7a1ad90SMark Brown * regulator_is_supported_voltage - check if a voltage range can be supported 1595a7a1ad90SMark Brown * 1596a7a1ad90SMark Brown * @regulator: Regulator to check. 1597a7a1ad90SMark Brown * @min_uV: Minimum required voltage in uV. 1598a7a1ad90SMark Brown * @max_uV: Maximum required voltage in uV. 1599a7a1ad90SMark Brown * 1600a7a1ad90SMark Brown * Returns a boolean or a negative error code. 1601a7a1ad90SMark Brown */ 1602a7a1ad90SMark Brown int regulator_is_supported_voltage(struct regulator *regulator, 1603a7a1ad90SMark Brown int min_uV, int max_uV) 1604a7a1ad90SMark Brown { 1605a7a1ad90SMark Brown int i, voltages, ret; 1606a7a1ad90SMark Brown 1607a7a1ad90SMark Brown ret = regulator_count_voltages(regulator); 1608a7a1ad90SMark Brown if (ret < 0) 1609a7a1ad90SMark Brown return ret; 1610a7a1ad90SMark Brown voltages = ret; 1611a7a1ad90SMark Brown 1612a7a1ad90SMark Brown for (i = 0; i < voltages; i++) { 1613a7a1ad90SMark Brown ret = regulator_list_voltage(regulator, i); 1614a7a1ad90SMark Brown 1615a7a1ad90SMark Brown if (ret >= min_uV && ret <= max_uV) 1616a7a1ad90SMark Brown return 1; 1617a7a1ad90SMark Brown } 1618a7a1ad90SMark Brown 1619a7a1ad90SMark Brown return 0; 1620a7a1ad90SMark Brown } 1621a7a1ad90SMark Brown 1622a7a1ad90SMark Brown /** 1623414c70cbSLiam Girdwood * regulator_set_voltage - set regulator output voltage 1624414c70cbSLiam Girdwood * @regulator: regulator source 1625414c70cbSLiam Girdwood * @min_uV: Minimum required voltage in uV 1626414c70cbSLiam Girdwood * @max_uV: Maximum acceptable voltage in uV 1627414c70cbSLiam Girdwood * 1628414c70cbSLiam Girdwood * Sets a voltage regulator to the desired output voltage. This can be set 1629414c70cbSLiam Girdwood * during any regulator state. IOW, regulator can be disabled or enabled. 1630414c70cbSLiam Girdwood * 1631414c70cbSLiam Girdwood * If the regulator is enabled then the voltage will change to the new value 1632414c70cbSLiam Girdwood * immediately otherwise if the regulator is disabled the regulator will 1633414c70cbSLiam Girdwood * output at the new voltage when enabled. 1634414c70cbSLiam Girdwood * 1635414c70cbSLiam Girdwood * NOTE: If the regulator is shared between several devices then the lowest 1636414c70cbSLiam Girdwood * request voltage that meets the system constraints will be used. 163769279fb9SMark Brown * Regulator system constraints must be set for this regulator before 1638414c70cbSLiam Girdwood * calling this function otherwise this call will fail. 1639414c70cbSLiam Girdwood */ 1640414c70cbSLiam Girdwood int regulator_set_voltage(struct regulator *regulator, int min_uV, int max_uV) 1641414c70cbSLiam Girdwood { 1642414c70cbSLiam Girdwood struct regulator_dev *rdev = regulator->rdev; 1643414c70cbSLiam Girdwood int ret; 16443a93f2a9SMark Brown unsigned selector; 1645414c70cbSLiam Girdwood 1646414c70cbSLiam Girdwood mutex_lock(&rdev->mutex); 1647414c70cbSLiam Girdwood 1648414c70cbSLiam Girdwood /* sanity check */ 1649414c70cbSLiam Girdwood if (!rdev->desc->ops->set_voltage) { 1650414c70cbSLiam Girdwood ret = -EINVAL; 1651414c70cbSLiam Girdwood goto out; 1652414c70cbSLiam Girdwood } 1653414c70cbSLiam Girdwood 1654414c70cbSLiam Girdwood /* constraints check */ 1655414c70cbSLiam Girdwood ret = regulator_check_voltage(rdev, &min_uV, &max_uV); 1656414c70cbSLiam Girdwood if (ret < 0) 1657414c70cbSLiam Girdwood goto out; 1658414c70cbSLiam Girdwood regulator->min_uV = min_uV; 1659414c70cbSLiam Girdwood regulator->max_uV = max_uV; 16603a93f2a9SMark Brown 166105fda3b1SThomas Petazzoni ret = regulator_check_consumers(rdev, &min_uV, &max_uV); 166205fda3b1SThomas Petazzoni if (ret < 0) 166305fda3b1SThomas Petazzoni goto out; 166405fda3b1SThomas Petazzoni 166502fa3ec0SMark Brown trace_regulator_set_voltage(rdev_get_name(rdev), min_uV, max_uV); 166602fa3ec0SMark Brown 16673a93f2a9SMark Brown ret = rdev->desc->ops->set_voltage(rdev, min_uV, max_uV, &selector); 16683a93f2a9SMark Brown 16693a93f2a9SMark Brown if (rdev->desc->ops->list_voltage) 16703a93f2a9SMark Brown selector = rdev->desc->ops->list_voltage(rdev, selector); 16713a93f2a9SMark Brown else 16723a93f2a9SMark Brown selector = -1; 1673414c70cbSLiam Girdwood 167402fa3ec0SMark Brown trace_regulator_set_voltage_complete(rdev_get_name(rdev), selector); 167502fa3ec0SMark Brown 1676414c70cbSLiam Girdwood out: 1677b136fb44SJonathan Cameron _notifier_call_chain(rdev, REGULATOR_EVENT_VOLTAGE_CHANGE, NULL); 1678414c70cbSLiam Girdwood mutex_unlock(&rdev->mutex); 1679414c70cbSLiam Girdwood return ret; 1680414c70cbSLiam Girdwood } 1681414c70cbSLiam Girdwood EXPORT_SYMBOL_GPL(regulator_set_voltage); 1682414c70cbSLiam Girdwood 1683414c70cbSLiam Girdwood static int _regulator_get_voltage(struct regulator_dev *rdev) 1684414c70cbSLiam Girdwood { 1685414c70cbSLiam Girdwood /* sanity check */ 1686414c70cbSLiam Girdwood if (rdev->desc->ops->get_voltage) 1687414c70cbSLiam Girdwood return rdev->desc->ops->get_voltage(rdev); 1688414c70cbSLiam Girdwood else 1689414c70cbSLiam Girdwood return -EINVAL; 1690414c70cbSLiam Girdwood } 1691414c70cbSLiam Girdwood 1692414c70cbSLiam Girdwood /** 1693414c70cbSLiam Girdwood * regulator_get_voltage - get regulator output voltage 1694414c70cbSLiam Girdwood * @regulator: regulator source 1695414c70cbSLiam Girdwood * 1696414c70cbSLiam Girdwood * This returns the current regulator voltage in uV. 1697414c70cbSLiam Girdwood * 1698414c70cbSLiam Girdwood * NOTE: If the regulator is disabled it will return the voltage value. This 1699414c70cbSLiam Girdwood * function should not be used to determine regulator state. 1700414c70cbSLiam Girdwood */ 1701414c70cbSLiam Girdwood int regulator_get_voltage(struct regulator *regulator) 1702414c70cbSLiam Girdwood { 1703414c70cbSLiam Girdwood int ret; 1704414c70cbSLiam Girdwood 1705414c70cbSLiam Girdwood mutex_lock(®ulator->rdev->mutex); 1706414c70cbSLiam Girdwood 1707414c70cbSLiam Girdwood ret = _regulator_get_voltage(regulator->rdev); 1708414c70cbSLiam Girdwood 1709414c70cbSLiam Girdwood mutex_unlock(®ulator->rdev->mutex); 1710414c70cbSLiam Girdwood 1711414c70cbSLiam Girdwood return ret; 1712414c70cbSLiam Girdwood } 1713414c70cbSLiam Girdwood EXPORT_SYMBOL_GPL(regulator_get_voltage); 1714414c70cbSLiam Girdwood 1715414c70cbSLiam Girdwood /** 1716414c70cbSLiam Girdwood * regulator_set_current_limit - set regulator output current limit 1717414c70cbSLiam Girdwood * @regulator: regulator source 1718414c70cbSLiam Girdwood * @min_uA: Minimuum supported current in uA 1719414c70cbSLiam Girdwood * @max_uA: Maximum supported current in uA 1720414c70cbSLiam Girdwood * 1721414c70cbSLiam Girdwood * Sets current sink to the desired output current. This can be set during 1722414c70cbSLiam Girdwood * any regulator state. IOW, regulator can be disabled or enabled. 1723414c70cbSLiam Girdwood * 1724414c70cbSLiam Girdwood * If the regulator is enabled then the current will change to the new value 1725414c70cbSLiam Girdwood * immediately otherwise if the regulator is disabled the regulator will 1726414c70cbSLiam Girdwood * output at the new current when enabled. 1727414c70cbSLiam Girdwood * 1728414c70cbSLiam Girdwood * NOTE: Regulator system constraints must be set for this regulator before 1729414c70cbSLiam Girdwood * calling this function otherwise this call will fail. 1730414c70cbSLiam Girdwood */ 1731414c70cbSLiam Girdwood int regulator_set_current_limit(struct regulator *regulator, 1732414c70cbSLiam Girdwood int min_uA, int max_uA) 1733414c70cbSLiam Girdwood { 1734414c70cbSLiam Girdwood struct regulator_dev *rdev = regulator->rdev; 1735414c70cbSLiam Girdwood int ret; 1736414c70cbSLiam Girdwood 1737414c70cbSLiam Girdwood mutex_lock(&rdev->mutex); 1738414c70cbSLiam Girdwood 1739414c70cbSLiam Girdwood /* sanity check */ 1740414c70cbSLiam Girdwood if (!rdev->desc->ops->set_current_limit) { 1741414c70cbSLiam Girdwood ret = -EINVAL; 1742414c70cbSLiam Girdwood goto out; 1743414c70cbSLiam Girdwood } 1744414c70cbSLiam Girdwood 1745414c70cbSLiam Girdwood /* constraints check */ 1746414c70cbSLiam Girdwood ret = regulator_check_current_limit(rdev, &min_uA, &max_uA); 1747414c70cbSLiam Girdwood if (ret < 0) 1748414c70cbSLiam Girdwood goto out; 1749414c70cbSLiam Girdwood 1750414c70cbSLiam Girdwood ret = rdev->desc->ops->set_current_limit(rdev, min_uA, max_uA); 1751414c70cbSLiam Girdwood out: 1752414c70cbSLiam Girdwood mutex_unlock(&rdev->mutex); 1753414c70cbSLiam Girdwood return ret; 1754414c70cbSLiam Girdwood } 1755414c70cbSLiam Girdwood EXPORT_SYMBOL_GPL(regulator_set_current_limit); 1756414c70cbSLiam Girdwood 1757414c70cbSLiam Girdwood static int _regulator_get_current_limit(struct regulator_dev *rdev) 1758414c70cbSLiam Girdwood { 1759414c70cbSLiam Girdwood int ret; 1760414c70cbSLiam Girdwood 1761414c70cbSLiam Girdwood mutex_lock(&rdev->mutex); 1762414c70cbSLiam Girdwood 1763414c70cbSLiam Girdwood /* sanity check */ 1764414c70cbSLiam Girdwood if (!rdev->desc->ops->get_current_limit) { 1765414c70cbSLiam Girdwood ret = -EINVAL; 1766414c70cbSLiam Girdwood goto out; 1767414c70cbSLiam Girdwood } 1768414c70cbSLiam Girdwood 1769414c70cbSLiam Girdwood ret = rdev->desc->ops->get_current_limit(rdev); 1770414c70cbSLiam Girdwood out: 1771414c70cbSLiam Girdwood mutex_unlock(&rdev->mutex); 1772414c70cbSLiam Girdwood return ret; 1773414c70cbSLiam Girdwood } 1774414c70cbSLiam Girdwood 1775414c70cbSLiam Girdwood /** 1776414c70cbSLiam Girdwood * regulator_get_current_limit - get regulator output current 1777414c70cbSLiam Girdwood * @regulator: regulator source 1778414c70cbSLiam Girdwood * 1779414c70cbSLiam Girdwood * This returns the current supplied by the specified current sink in uA. 1780414c70cbSLiam Girdwood * 1781414c70cbSLiam Girdwood * NOTE: If the regulator is disabled it will return the current value. This 1782414c70cbSLiam Girdwood * function should not be used to determine regulator state. 1783414c70cbSLiam Girdwood */ 1784414c70cbSLiam Girdwood int regulator_get_current_limit(struct regulator *regulator) 1785414c70cbSLiam Girdwood { 1786414c70cbSLiam Girdwood return _regulator_get_current_limit(regulator->rdev); 1787414c70cbSLiam Girdwood } 1788414c70cbSLiam Girdwood EXPORT_SYMBOL_GPL(regulator_get_current_limit); 1789414c70cbSLiam Girdwood 1790414c70cbSLiam Girdwood /** 1791414c70cbSLiam Girdwood * regulator_set_mode - set regulator operating mode 1792414c70cbSLiam Girdwood * @regulator: regulator source 1793414c70cbSLiam Girdwood * @mode: operating mode - one of the REGULATOR_MODE constants 1794414c70cbSLiam Girdwood * 1795414c70cbSLiam Girdwood * Set regulator operating mode to increase regulator efficiency or improve 1796414c70cbSLiam Girdwood * regulation performance. 1797414c70cbSLiam Girdwood * 1798414c70cbSLiam Girdwood * NOTE: Regulator system constraints must be set for this regulator before 1799414c70cbSLiam Girdwood * calling this function otherwise this call will fail. 1800414c70cbSLiam Girdwood */ 1801414c70cbSLiam Girdwood int regulator_set_mode(struct regulator *regulator, unsigned int mode) 1802414c70cbSLiam Girdwood { 1803414c70cbSLiam Girdwood struct regulator_dev *rdev = regulator->rdev; 1804414c70cbSLiam Girdwood int ret; 1805500b4ac9SSundar R Iyer int regulator_curr_mode; 1806414c70cbSLiam Girdwood 1807414c70cbSLiam Girdwood mutex_lock(&rdev->mutex); 1808414c70cbSLiam Girdwood 1809414c70cbSLiam Girdwood /* sanity check */ 1810414c70cbSLiam Girdwood if (!rdev->desc->ops->set_mode) { 1811414c70cbSLiam Girdwood ret = -EINVAL; 1812414c70cbSLiam Girdwood goto out; 1813414c70cbSLiam Girdwood } 1814414c70cbSLiam Girdwood 1815500b4ac9SSundar R Iyer /* return if the same mode is requested */ 1816500b4ac9SSundar R Iyer if (rdev->desc->ops->get_mode) { 1817500b4ac9SSundar R Iyer regulator_curr_mode = rdev->desc->ops->get_mode(rdev); 1818500b4ac9SSundar R Iyer if (regulator_curr_mode == mode) { 1819500b4ac9SSundar R Iyer ret = 0; 1820500b4ac9SSundar R Iyer goto out; 1821500b4ac9SSundar R Iyer } 1822500b4ac9SSundar R Iyer } 1823500b4ac9SSundar R Iyer 1824414c70cbSLiam Girdwood /* constraints check */ 1825414c70cbSLiam Girdwood ret = regulator_check_mode(rdev, mode); 1826414c70cbSLiam Girdwood if (ret < 0) 1827414c70cbSLiam Girdwood goto out; 1828414c70cbSLiam Girdwood 1829414c70cbSLiam Girdwood ret = rdev->desc->ops->set_mode(rdev, mode); 1830414c70cbSLiam Girdwood out: 1831414c70cbSLiam Girdwood mutex_unlock(&rdev->mutex); 1832414c70cbSLiam Girdwood return ret; 1833414c70cbSLiam Girdwood } 1834414c70cbSLiam Girdwood EXPORT_SYMBOL_GPL(regulator_set_mode); 1835414c70cbSLiam Girdwood 1836414c70cbSLiam Girdwood static unsigned int _regulator_get_mode(struct regulator_dev *rdev) 1837414c70cbSLiam Girdwood { 1838414c70cbSLiam Girdwood int ret; 1839414c70cbSLiam Girdwood 1840414c70cbSLiam Girdwood mutex_lock(&rdev->mutex); 1841414c70cbSLiam Girdwood 1842414c70cbSLiam Girdwood /* sanity check */ 1843414c70cbSLiam Girdwood if (!rdev->desc->ops->get_mode) { 1844414c70cbSLiam Girdwood ret = -EINVAL; 1845414c70cbSLiam Girdwood goto out; 1846414c70cbSLiam Girdwood } 1847414c70cbSLiam Girdwood 1848414c70cbSLiam Girdwood ret = rdev->desc->ops->get_mode(rdev); 1849414c70cbSLiam Girdwood out: 1850414c70cbSLiam Girdwood mutex_unlock(&rdev->mutex); 1851414c70cbSLiam Girdwood return ret; 1852414c70cbSLiam Girdwood } 1853414c70cbSLiam Girdwood 1854414c70cbSLiam Girdwood /** 1855414c70cbSLiam Girdwood * regulator_get_mode - get regulator operating mode 1856414c70cbSLiam Girdwood * @regulator: regulator source 1857414c70cbSLiam Girdwood * 1858414c70cbSLiam Girdwood * Get the current regulator operating mode. 1859414c70cbSLiam Girdwood */ 1860414c70cbSLiam Girdwood unsigned int regulator_get_mode(struct regulator *regulator) 1861414c70cbSLiam Girdwood { 1862414c70cbSLiam Girdwood return _regulator_get_mode(regulator->rdev); 1863414c70cbSLiam Girdwood } 1864414c70cbSLiam Girdwood EXPORT_SYMBOL_GPL(regulator_get_mode); 1865414c70cbSLiam Girdwood 1866414c70cbSLiam Girdwood /** 1867414c70cbSLiam Girdwood * regulator_set_optimum_mode - set regulator optimum operating mode 1868414c70cbSLiam Girdwood * @regulator: regulator source 1869414c70cbSLiam Girdwood * @uA_load: load current 1870414c70cbSLiam Girdwood * 1871414c70cbSLiam Girdwood * Notifies the regulator core of a new device load. This is then used by 1872414c70cbSLiam Girdwood * DRMS (if enabled by constraints) to set the most efficient regulator 1873414c70cbSLiam Girdwood * operating mode for the new regulator loading. 1874414c70cbSLiam Girdwood * 1875414c70cbSLiam Girdwood * Consumer devices notify their supply regulator of the maximum power 1876414c70cbSLiam Girdwood * they will require (can be taken from device datasheet in the power 1877414c70cbSLiam Girdwood * consumption tables) when they change operational status and hence power 1878414c70cbSLiam Girdwood * state. Examples of operational state changes that can affect power 1879414c70cbSLiam Girdwood * consumption are :- 1880414c70cbSLiam Girdwood * 1881414c70cbSLiam Girdwood * o Device is opened / closed. 1882414c70cbSLiam Girdwood * o Device I/O is about to begin or has just finished. 1883414c70cbSLiam Girdwood * o Device is idling in between work. 1884414c70cbSLiam Girdwood * 1885414c70cbSLiam Girdwood * This information is also exported via sysfs to userspace. 1886414c70cbSLiam Girdwood * 1887414c70cbSLiam Girdwood * DRMS will sum the total requested load on the regulator and change 1888414c70cbSLiam Girdwood * to the most efficient operating mode if platform constraints allow. 1889414c70cbSLiam Girdwood * 1890414c70cbSLiam Girdwood * Returns the new regulator mode or error. 1891414c70cbSLiam Girdwood */ 1892414c70cbSLiam Girdwood int regulator_set_optimum_mode(struct regulator *regulator, int uA_load) 1893414c70cbSLiam Girdwood { 1894414c70cbSLiam Girdwood struct regulator_dev *rdev = regulator->rdev; 1895414c70cbSLiam Girdwood struct regulator *consumer; 1896414c70cbSLiam Girdwood int ret, output_uV, input_uV, total_uA_load = 0; 1897414c70cbSLiam Girdwood unsigned int mode; 1898414c70cbSLiam Girdwood 1899414c70cbSLiam Girdwood mutex_lock(&rdev->mutex); 1900414c70cbSLiam Girdwood 1901414c70cbSLiam Girdwood regulator->uA_load = uA_load; 1902414c70cbSLiam Girdwood ret = regulator_check_drms(rdev); 1903414c70cbSLiam Girdwood if (ret < 0) 1904414c70cbSLiam Girdwood goto out; 1905414c70cbSLiam Girdwood ret = -EINVAL; 1906414c70cbSLiam Girdwood 1907414c70cbSLiam Girdwood /* sanity check */ 1908414c70cbSLiam Girdwood if (!rdev->desc->ops->get_optimum_mode) 1909414c70cbSLiam Girdwood goto out; 1910414c70cbSLiam Girdwood 1911414c70cbSLiam Girdwood /* get output voltage */ 19121bf5a1f8SMark Brown output_uV = _regulator_get_voltage(rdev); 1913414c70cbSLiam Girdwood if (output_uV <= 0) { 19145da84fd9SJoe Perches rdev_err(rdev, "invalid output voltage found\n"); 1915414c70cbSLiam Girdwood goto out; 1916414c70cbSLiam Girdwood } 1917414c70cbSLiam Girdwood 1918414c70cbSLiam Girdwood /* get input voltage */ 19191bf5a1f8SMark Brown input_uV = 0; 19201bf5a1f8SMark Brown if (rdev->supply) 19211bf5a1f8SMark Brown input_uV = _regulator_get_voltage(rdev->supply); 19221bf5a1f8SMark Brown if (input_uV <= 0) 1923414c70cbSLiam Girdwood input_uV = rdev->constraints->input_uV; 1924414c70cbSLiam Girdwood if (input_uV <= 0) { 19255da84fd9SJoe Perches rdev_err(rdev, "invalid input voltage found\n"); 1926414c70cbSLiam Girdwood goto out; 1927414c70cbSLiam Girdwood } 1928414c70cbSLiam Girdwood 1929414c70cbSLiam Girdwood /* calc total requested load for this regulator */ 1930414c70cbSLiam Girdwood list_for_each_entry(consumer, &rdev->consumer_list, list) 1931414c70cbSLiam Girdwood total_uA_load += consumer->uA_load; 1932414c70cbSLiam Girdwood 1933414c70cbSLiam Girdwood mode = rdev->desc->ops->get_optimum_mode(rdev, 1934414c70cbSLiam Girdwood input_uV, output_uV, 1935414c70cbSLiam Girdwood total_uA_load); 1936e573520bSDavid Brownell ret = regulator_check_mode(rdev, mode); 1937e573520bSDavid Brownell if (ret < 0) { 19385da84fd9SJoe Perches rdev_err(rdev, "failed to get optimum mode @ %d uA %d -> %d uV\n", 1939414c70cbSLiam Girdwood total_uA_load, input_uV, output_uV); 1940414c70cbSLiam Girdwood goto out; 1941414c70cbSLiam Girdwood } 1942414c70cbSLiam Girdwood 1943414c70cbSLiam Girdwood ret = rdev->desc->ops->set_mode(rdev, mode); 1944e573520bSDavid Brownell if (ret < 0) { 19455da84fd9SJoe Perches rdev_err(rdev, "failed to set optimum mode %x\n", mode); 1946414c70cbSLiam Girdwood goto out; 1947414c70cbSLiam Girdwood } 1948414c70cbSLiam Girdwood ret = mode; 1949414c70cbSLiam Girdwood out: 1950414c70cbSLiam Girdwood mutex_unlock(&rdev->mutex); 1951414c70cbSLiam Girdwood return ret; 1952414c70cbSLiam Girdwood } 1953414c70cbSLiam Girdwood EXPORT_SYMBOL_GPL(regulator_set_optimum_mode); 1954414c70cbSLiam Girdwood 1955414c70cbSLiam Girdwood /** 1956414c70cbSLiam Girdwood * regulator_register_notifier - register regulator event notifier 1957414c70cbSLiam Girdwood * @regulator: regulator source 195869279fb9SMark Brown * @nb: notifier block 1959414c70cbSLiam Girdwood * 1960414c70cbSLiam Girdwood * Register notifier block to receive regulator events. 1961414c70cbSLiam Girdwood */ 1962414c70cbSLiam Girdwood int regulator_register_notifier(struct regulator *regulator, 1963414c70cbSLiam Girdwood struct notifier_block *nb) 1964414c70cbSLiam Girdwood { 1965414c70cbSLiam Girdwood return blocking_notifier_chain_register(®ulator->rdev->notifier, 1966414c70cbSLiam Girdwood nb); 1967414c70cbSLiam Girdwood } 1968414c70cbSLiam Girdwood EXPORT_SYMBOL_GPL(regulator_register_notifier); 1969414c70cbSLiam Girdwood 1970414c70cbSLiam Girdwood /** 1971414c70cbSLiam Girdwood * regulator_unregister_notifier - unregister regulator event notifier 1972414c70cbSLiam Girdwood * @regulator: regulator source 197369279fb9SMark Brown * @nb: notifier block 1974414c70cbSLiam Girdwood * 1975414c70cbSLiam Girdwood * Unregister regulator event notifier block. 1976414c70cbSLiam Girdwood */ 1977414c70cbSLiam Girdwood int regulator_unregister_notifier(struct regulator *regulator, 1978414c70cbSLiam Girdwood struct notifier_block *nb) 1979414c70cbSLiam Girdwood { 1980414c70cbSLiam Girdwood return blocking_notifier_chain_unregister(®ulator->rdev->notifier, 1981414c70cbSLiam Girdwood nb); 1982414c70cbSLiam Girdwood } 1983414c70cbSLiam Girdwood EXPORT_SYMBOL_GPL(regulator_unregister_notifier); 1984414c70cbSLiam Girdwood 1985b136fb44SJonathan Cameron /* notify regulator consumers and downstream regulator consumers. 1986b136fb44SJonathan Cameron * Note mutex must be held by caller. 1987b136fb44SJonathan Cameron */ 1988414c70cbSLiam Girdwood static void _notifier_call_chain(struct regulator_dev *rdev, 1989414c70cbSLiam Girdwood unsigned long event, void *data) 1990414c70cbSLiam Girdwood { 1991414c70cbSLiam Girdwood struct regulator_dev *_rdev; 1992414c70cbSLiam Girdwood 1993414c70cbSLiam Girdwood /* call rdev chain first */ 1994414c70cbSLiam Girdwood blocking_notifier_call_chain(&rdev->notifier, event, NULL); 1995414c70cbSLiam Girdwood 1996414c70cbSLiam Girdwood /* now notify regulator we supply */ 1997b136fb44SJonathan Cameron list_for_each_entry(_rdev, &rdev->supply_list, slist) { 1998b136fb44SJonathan Cameron mutex_lock(&_rdev->mutex); 1999414c70cbSLiam Girdwood _notifier_call_chain(_rdev, event, data); 2000b136fb44SJonathan Cameron mutex_unlock(&_rdev->mutex); 2001b136fb44SJonathan Cameron } 2002414c70cbSLiam Girdwood } 2003414c70cbSLiam Girdwood 2004414c70cbSLiam Girdwood /** 2005414c70cbSLiam Girdwood * regulator_bulk_get - get multiple regulator consumers 2006414c70cbSLiam Girdwood * 2007414c70cbSLiam Girdwood * @dev: Device to supply 2008414c70cbSLiam Girdwood * @num_consumers: Number of consumers to register 2009414c70cbSLiam Girdwood * @consumers: Configuration of consumers; clients are stored here. 2010414c70cbSLiam Girdwood * 2011414c70cbSLiam Girdwood * @return 0 on success, an errno on failure. 2012414c70cbSLiam Girdwood * 2013414c70cbSLiam Girdwood * This helper function allows drivers to get several regulator 2014414c70cbSLiam Girdwood * consumers in one operation. If any of the regulators cannot be 2015414c70cbSLiam Girdwood * acquired then any regulators that were allocated will be freed 2016414c70cbSLiam Girdwood * before returning to the caller. 2017414c70cbSLiam Girdwood */ 2018414c70cbSLiam Girdwood int regulator_bulk_get(struct device *dev, int num_consumers, 2019414c70cbSLiam Girdwood struct regulator_bulk_data *consumers) 2020414c70cbSLiam Girdwood { 2021414c70cbSLiam Girdwood int i; 2022414c70cbSLiam Girdwood int ret; 2023414c70cbSLiam Girdwood 2024414c70cbSLiam Girdwood for (i = 0; i < num_consumers; i++) 2025414c70cbSLiam Girdwood consumers[i].consumer = NULL; 2026414c70cbSLiam Girdwood 2027414c70cbSLiam Girdwood for (i = 0; i < num_consumers; i++) { 2028414c70cbSLiam Girdwood consumers[i].consumer = regulator_get(dev, 2029414c70cbSLiam Girdwood consumers[i].supply); 2030414c70cbSLiam Girdwood if (IS_ERR(consumers[i].consumer)) { 2031414c70cbSLiam Girdwood ret = PTR_ERR(consumers[i].consumer); 20325b307627SMark Brown dev_err(dev, "Failed to get supply '%s': %d\n", 20335b307627SMark Brown consumers[i].supply, ret); 2034414c70cbSLiam Girdwood consumers[i].consumer = NULL; 2035414c70cbSLiam Girdwood goto err; 2036414c70cbSLiam Girdwood } 2037414c70cbSLiam Girdwood } 2038414c70cbSLiam Girdwood 2039414c70cbSLiam Girdwood return 0; 2040414c70cbSLiam Girdwood 2041414c70cbSLiam Girdwood err: 2042414c70cbSLiam Girdwood for (i = 0; i < num_consumers && consumers[i].consumer; i++) 2043414c70cbSLiam Girdwood regulator_put(consumers[i].consumer); 2044414c70cbSLiam Girdwood 2045414c70cbSLiam Girdwood return ret; 2046414c70cbSLiam Girdwood } 2047414c70cbSLiam Girdwood EXPORT_SYMBOL_GPL(regulator_bulk_get); 2048414c70cbSLiam Girdwood 2049414c70cbSLiam Girdwood /** 2050414c70cbSLiam Girdwood * regulator_bulk_enable - enable multiple regulator consumers 2051414c70cbSLiam Girdwood * 2052414c70cbSLiam Girdwood * @num_consumers: Number of consumers 2053414c70cbSLiam Girdwood * @consumers: Consumer data; clients are stored here. 2054414c70cbSLiam Girdwood * @return 0 on success, an errno on failure 2055414c70cbSLiam Girdwood * 2056414c70cbSLiam Girdwood * This convenience API allows consumers to enable multiple regulator 2057414c70cbSLiam Girdwood * clients in a single API call. If any consumers cannot be enabled 2058414c70cbSLiam Girdwood * then any others that were enabled will be disabled again prior to 2059414c70cbSLiam Girdwood * return. 2060414c70cbSLiam Girdwood */ 2061414c70cbSLiam Girdwood int regulator_bulk_enable(int num_consumers, 2062414c70cbSLiam Girdwood struct regulator_bulk_data *consumers) 2063414c70cbSLiam Girdwood { 2064414c70cbSLiam Girdwood int i; 2065414c70cbSLiam Girdwood int ret; 2066414c70cbSLiam Girdwood 2067414c70cbSLiam Girdwood for (i = 0; i < num_consumers; i++) { 2068414c70cbSLiam Girdwood ret = regulator_enable(consumers[i].consumer); 2069414c70cbSLiam Girdwood if (ret != 0) 2070414c70cbSLiam Girdwood goto err; 2071414c70cbSLiam Girdwood } 2072414c70cbSLiam Girdwood 2073414c70cbSLiam Girdwood return 0; 2074414c70cbSLiam Girdwood 2075414c70cbSLiam Girdwood err: 20765da84fd9SJoe Perches pr_err("Failed to enable %s: %d\n", consumers[i].supply, ret); 2077eb143ac1SLars-Peter Clausen for (--i; i >= 0; --i) 2078414c70cbSLiam Girdwood regulator_disable(consumers[i].consumer); 2079414c70cbSLiam Girdwood 2080414c70cbSLiam Girdwood return ret; 2081414c70cbSLiam Girdwood } 2082414c70cbSLiam Girdwood EXPORT_SYMBOL_GPL(regulator_bulk_enable); 2083414c70cbSLiam Girdwood 2084414c70cbSLiam Girdwood /** 2085414c70cbSLiam Girdwood * regulator_bulk_disable - disable multiple regulator consumers 2086414c70cbSLiam Girdwood * 2087414c70cbSLiam Girdwood * @num_consumers: Number of consumers 2088414c70cbSLiam Girdwood * @consumers: Consumer data; clients are stored here. 2089414c70cbSLiam Girdwood * @return 0 on success, an errno on failure 2090414c70cbSLiam Girdwood * 2091414c70cbSLiam Girdwood * This convenience API allows consumers to disable multiple regulator 2092414c70cbSLiam Girdwood * clients in a single API call. If any consumers cannot be enabled 2093414c70cbSLiam Girdwood * then any others that were disabled will be disabled again prior to 2094414c70cbSLiam Girdwood * return. 2095414c70cbSLiam Girdwood */ 2096414c70cbSLiam Girdwood int regulator_bulk_disable(int num_consumers, 2097414c70cbSLiam Girdwood struct regulator_bulk_data *consumers) 2098414c70cbSLiam Girdwood { 2099414c70cbSLiam Girdwood int i; 2100414c70cbSLiam Girdwood int ret; 2101414c70cbSLiam Girdwood 2102414c70cbSLiam Girdwood for (i = 0; i < num_consumers; i++) { 2103414c70cbSLiam Girdwood ret = regulator_disable(consumers[i].consumer); 2104414c70cbSLiam Girdwood if (ret != 0) 2105414c70cbSLiam Girdwood goto err; 2106414c70cbSLiam Girdwood } 2107414c70cbSLiam Girdwood 2108414c70cbSLiam Girdwood return 0; 2109414c70cbSLiam Girdwood 2110414c70cbSLiam Girdwood err: 21115da84fd9SJoe Perches pr_err("Failed to disable %s: %d\n", consumers[i].supply, ret); 2112eb143ac1SLars-Peter Clausen for (--i; i >= 0; --i) 2113414c70cbSLiam Girdwood regulator_enable(consumers[i].consumer); 2114414c70cbSLiam Girdwood 2115414c70cbSLiam Girdwood return ret; 2116414c70cbSLiam Girdwood } 2117414c70cbSLiam Girdwood EXPORT_SYMBOL_GPL(regulator_bulk_disable); 2118414c70cbSLiam Girdwood 2119414c70cbSLiam Girdwood /** 2120414c70cbSLiam Girdwood * regulator_bulk_free - free multiple regulator consumers 2121414c70cbSLiam Girdwood * 2122414c70cbSLiam Girdwood * @num_consumers: Number of consumers 2123414c70cbSLiam Girdwood * @consumers: Consumer data; clients are stored here. 2124414c70cbSLiam Girdwood * 2125414c70cbSLiam Girdwood * This convenience API allows consumers to free multiple regulator 2126414c70cbSLiam Girdwood * clients in a single API call. 2127414c70cbSLiam Girdwood */ 2128414c70cbSLiam Girdwood void regulator_bulk_free(int num_consumers, 2129414c70cbSLiam Girdwood struct regulator_bulk_data *consumers) 2130414c70cbSLiam Girdwood { 2131414c70cbSLiam Girdwood int i; 2132414c70cbSLiam Girdwood 2133414c70cbSLiam Girdwood for (i = 0; i < num_consumers; i++) { 2134414c70cbSLiam Girdwood regulator_put(consumers[i].consumer); 2135414c70cbSLiam Girdwood consumers[i].consumer = NULL; 2136414c70cbSLiam Girdwood } 2137414c70cbSLiam Girdwood } 2138414c70cbSLiam Girdwood EXPORT_SYMBOL_GPL(regulator_bulk_free); 2139414c70cbSLiam Girdwood 2140414c70cbSLiam Girdwood /** 2141414c70cbSLiam Girdwood * regulator_notifier_call_chain - call regulator event notifier 214269279fb9SMark Brown * @rdev: regulator source 2143414c70cbSLiam Girdwood * @event: notifier block 214469279fb9SMark Brown * @data: callback-specific data. 2145414c70cbSLiam Girdwood * 2146414c70cbSLiam Girdwood * Called by regulator drivers to notify clients a regulator event has 2147414c70cbSLiam Girdwood * occurred. We also notify regulator clients downstream. 2148b136fb44SJonathan Cameron * Note lock must be held by caller. 2149414c70cbSLiam Girdwood */ 2150414c70cbSLiam Girdwood int regulator_notifier_call_chain(struct regulator_dev *rdev, 2151414c70cbSLiam Girdwood unsigned long event, void *data) 2152414c70cbSLiam Girdwood { 2153414c70cbSLiam Girdwood _notifier_call_chain(rdev, event, data); 2154414c70cbSLiam Girdwood return NOTIFY_DONE; 2155414c70cbSLiam Girdwood 2156414c70cbSLiam Girdwood } 2157414c70cbSLiam Girdwood EXPORT_SYMBOL_GPL(regulator_notifier_call_chain); 2158414c70cbSLiam Girdwood 2159be721979SMark Brown /** 2160be721979SMark Brown * regulator_mode_to_status - convert a regulator mode into a status 2161be721979SMark Brown * 2162be721979SMark Brown * @mode: Mode to convert 2163be721979SMark Brown * 2164be721979SMark Brown * Convert a regulator mode into a status. 2165be721979SMark Brown */ 2166be721979SMark Brown int regulator_mode_to_status(unsigned int mode) 2167be721979SMark Brown { 2168be721979SMark Brown switch (mode) { 2169be721979SMark Brown case REGULATOR_MODE_FAST: 2170be721979SMark Brown return REGULATOR_STATUS_FAST; 2171be721979SMark Brown case REGULATOR_MODE_NORMAL: 2172be721979SMark Brown return REGULATOR_STATUS_NORMAL; 2173be721979SMark Brown case REGULATOR_MODE_IDLE: 2174be721979SMark Brown return REGULATOR_STATUS_IDLE; 2175be721979SMark Brown case REGULATOR_STATUS_STANDBY: 2176be721979SMark Brown return REGULATOR_STATUS_STANDBY; 2177be721979SMark Brown default: 2178be721979SMark Brown return 0; 2179be721979SMark Brown } 2180be721979SMark Brown } 2181be721979SMark Brown EXPORT_SYMBOL_GPL(regulator_mode_to_status); 2182be721979SMark Brown 21837ad68e2fSDavid Brownell /* 21847ad68e2fSDavid Brownell * To avoid cluttering sysfs (and memory) with useless state, only 21857ad68e2fSDavid Brownell * create attributes that can be meaningfully displayed. 21867ad68e2fSDavid Brownell */ 21877ad68e2fSDavid Brownell static int add_regulator_attributes(struct regulator_dev *rdev) 21887ad68e2fSDavid Brownell { 21897ad68e2fSDavid Brownell struct device *dev = &rdev->dev; 21907ad68e2fSDavid Brownell struct regulator_ops *ops = rdev->desc->ops; 21917ad68e2fSDavid Brownell int status = 0; 21927ad68e2fSDavid Brownell 21937ad68e2fSDavid Brownell /* some attributes need specific methods to be displayed */ 21947ad68e2fSDavid Brownell if (ops->get_voltage) { 21957ad68e2fSDavid Brownell status = device_create_file(dev, &dev_attr_microvolts); 21967ad68e2fSDavid Brownell if (status < 0) 21977ad68e2fSDavid Brownell return status; 21987ad68e2fSDavid Brownell } 21997ad68e2fSDavid Brownell if (ops->get_current_limit) { 22007ad68e2fSDavid Brownell status = device_create_file(dev, &dev_attr_microamps); 22017ad68e2fSDavid Brownell if (status < 0) 22027ad68e2fSDavid Brownell return status; 22037ad68e2fSDavid Brownell } 22047ad68e2fSDavid Brownell if (ops->get_mode) { 22057ad68e2fSDavid Brownell status = device_create_file(dev, &dev_attr_opmode); 22067ad68e2fSDavid Brownell if (status < 0) 22077ad68e2fSDavid Brownell return status; 22087ad68e2fSDavid Brownell } 22097ad68e2fSDavid Brownell if (ops->is_enabled) { 22107ad68e2fSDavid Brownell status = device_create_file(dev, &dev_attr_state); 22117ad68e2fSDavid Brownell if (status < 0) 22127ad68e2fSDavid Brownell return status; 22137ad68e2fSDavid Brownell } 2214853116a1SDavid Brownell if (ops->get_status) { 2215853116a1SDavid Brownell status = device_create_file(dev, &dev_attr_status); 2216853116a1SDavid Brownell if (status < 0) 2217853116a1SDavid Brownell return status; 2218853116a1SDavid Brownell } 22197ad68e2fSDavid Brownell 22207ad68e2fSDavid Brownell /* some attributes are type-specific */ 22217ad68e2fSDavid Brownell if (rdev->desc->type == REGULATOR_CURRENT) { 22227ad68e2fSDavid Brownell status = device_create_file(dev, &dev_attr_requested_microamps); 22237ad68e2fSDavid Brownell if (status < 0) 22247ad68e2fSDavid Brownell return status; 22257ad68e2fSDavid Brownell } 22267ad68e2fSDavid Brownell 22277ad68e2fSDavid Brownell /* all the other attributes exist to support constraints; 22287ad68e2fSDavid Brownell * don't show them if there are no constraints, or if the 22297ad68e2fSDavid Brownell * relevant supporting methods are missing. 22307ad68e2fSDavid Brownell */ 22317ad68e2fSDavid Brownell if (!rdev->constraints) 22327ad68e2fSDavid Brownell return status; 22337ad68e2fSDavid Brownell 22347ad68e2fSDavid Brownell /* constraints need specific supporting methods */ 22357ad68e2fSDavid Brownell if (ops->set_voltage) { 22367ad68e2fSDavid Brownell status = device_create_file(dev, &dev_attr_min_microvolts); 22377ad68e2fSDavid Brownell if (status < 0) 22387ad68e2fSDavid Brownell return status; 22397ad68e2fSDavid Brownell status = device_create_file(dev, &dev_attr_max_microvolts); 22407ad68e2fSDavid Brownell if (status < 0) 22417ad68e2fSDavid Brownell return status; 22427ad68e2fSDavid Brownell } 22437ad68e2fSDavid Brownell if (ops->set_current_limit) { 22447ad68e2fSDavid Brownell status = device_create_file(dev, &dev_attr_min_microamps); 22457ad68e2fSDavid Brownell if (status < 0) 22467ad68e2fSDavid Brownell return status; 22477ad68e2fSDavid Brownell status = device_create_file(dev, &dev_attr_max_microamps); 22487ad68e2fSDavid Brownell if (status < 0) 22497ad68e2fSDavid Brownell return status; 22507ad68e2fSDavid Brownell } 22517ad68e2fSDavid Brownell 22527ad68e2fSDavid Brownell /* suspend mode constraints need multiple supporting methods */ 22537ad68e2fSDavid Brownell if (!(ops->set_suspend_enable && ops->set_suspend_disable)) 22547ad68e2fSDavid Brownell return status; 22557ad68e2fSDavid Brownell 22567ad68e2fSDavid Brownell status = device_create_file(dev, &dev_attr_suspend_standby_state); 22577ad68e2fSDavid Brownell if (status < 0) 22587ad68e2fSDavid Brownell return status; 22597ad68e2fSDavid Brownell status = device_create_file(dev, &dev_attr_suspend_mem_state); 22607ad68e2fSDavid Brownell if (status < 0) 22617ad68e2fSDavid Brownell return status; 22627ad68e2fSDavid Brownell status = device_create_file(dev, &dev_attr_suspend_disk_state); 22637ad68e2fSDavid Brownell if (status < 0) 22647ad68e2fSDavid Brownell return status; 22657ad68e2fSDavid Brownell 22667ad68e2fSDavid Brownell if (ops->set_suspend_voltage) { 22677ad68e2fSDavid Brownell status = device_create_file(dev, 22687ad68e2fSDavid Brownell &dev_attr_suspend_standby_microvolts); 22697ad68e2fSDavid Brownell if (status < 0) 22707ad68e2fSDavid Brownell return status; 22717ad68e2fSDavid Brownell status = device_create_file(dev, 22727ad68e2fSDavid Brownell &dev_attr_suspend_mem_microvolts); 22737ad68e2fSDavid Brownell if (status < 0) 22747ad68e2fSDavid Brownell return status; 22757ad68e2fSDavid Brownell status = device_create_file(dev, 22767ad68e2fSDavid Brownell &dev_attr_suspend_disk_microvolts); 22777ad68e2fSDavid Brownell if (status < 0) 22787ad68e2fSDavid Brownell return status; 22797ad68e2fSDavid Brownell } 22807ad68e2fSDavid Brownell 22817ad68e2fSDavid Brownell if (ops->set_suspend_mode) { 22827ad68e2fSDavid Brownell status = device_create_file(dev, 22837ad68e2fSDavid Brownell &dev_attr_suspend_standby_mode); 22847ad68e2fSDavid Brownell if (status < 0) 22857ad68e2fSDavid Brownell return status; 22867ad68e2fSDavid Brownell status = device_create_file(dev, 22877ad68e2fSDavid Brownell &dev_attr_suspend_mem_mode); 22887ad68e2fSDavid Brownell if (status < 0) 22897ad68e2fSDavid Brownell return status; 22907ad68e2fSDavid Brownell status = device_create_file(dev, 22917ad68e2fSDavid Brownell &dev_attr_suspend_disk_mode); 22927ad68e2fSDavid Brownell if (status < 0) 22937ad68e2fSDavid Brownell return status; 22947ad68e2fSDavid Brownell } 22957ad68e2fSDavid Brownell 22967ad68e2fSDavid Brownell return status; 22977ad68e2fSDavid Brownell } 22987ad68e2fSDavid Brownell 2299414c70cbSLiam Girdwood /** 2300414c70cbSLiam Girdwood * regulator_register - register regulator 230169279fb9SMark Brown * @regulator_desc: regulator to register 230269279fb9SMark Brown * @dev: struct device for the regulator 23030527100fSMark Brown * @init_data: platform provided init data, passed through by driver 230469279fb9SMark Brown * @driver_data: private regulator data 2305414c70cbSLiam Girdwood * 2306414c70cbSLiam Girdwood * Called by regulator drivers to register a regulator. 2307414c70cbSLiam Girdwood * Returns 0 on success. 2308414c70cbSLiam Girdwood */ 2309414c70cbSLiam Girdwood struct regulator_dev *regulator_register(struct regulator_desc *regulator_desc, 2310f8c12fe3SMark Brown struct device *dev, const struct regulator_init_data *init_data, 23110527100fSMark Brown void *driver_data) 2312414c70cbSLiam Girdwood { 2313414c70cbSLiam Girdwood static atomic_t regulator_no = ATOMIC_INIT(0); 2314414c70cbSLiam Girdwood struct regulator_dev *rdev; 2315a5766f11SLiam Girdwood int ret, i; 2316414c70cbSLiam Girdwood 2317414c70cbSLiam Girdwood if (regulator_desc == NULL) 2318414c70cbSLiam Girdwood return ERR_PTR(-EINVAL); 2319414c70cbSLiam Girdwood 2320414c70cbSLiam Girdwood if (regulator_desc->name == NULL || regulator_desc->ops == NULL) 2321414c70cbSLiam Girdwood return ERR_PTR(-EINVAL); 2322414c70cbSLiam Girdwood 2323cd78dfc6SDiego Liziero if (regulator_desc->type != REGULATOR_VOLTAGE && 2324cd78dfc6SDiego Liziero regulator_desc->type != REGULATOR_CURRENT) 2325414c70cbSLiam Girdwood return ERR_PTR(-EINVAL); 2326414c70cbSLiam Girdwood 232746fabe1eSMark Brown if (!init_data) 232846fabe1eSMark Brown return ERR_PTR(-EINVAL); 232946fabe1eSMark Brown 2330414c70cbSLiam Girdwood rdev = kzalloc(sizeof(struct regulator_dev), GFP_KERNEL); 2331414c70cbSLiam Girdwood if (rdev == NULL) 2332414c70cbSLiam Girdwood return ERR_PTR(-ENOMEM); 2333414c70cbSLiam Girdwood 2334414c70cbSLiam Girdwood mutex_lock(®ulator_list_mutex); 2335414c70cbSLiam Girdwood 2336414c70cbSLiam Girdwood mutex_init(&rdev->mutex); 2337a5766f11SLiam Girdwood rdev->reg_data = driver_data; 2338414c70cbSLiam Girdwood rdev->owner = regulator_desc->owner; 2339414c70cbSLiam Girdwood rdev->desc = regulator_desc; 2340414c70cbSLiam Girdwood INIT_LIST_HEAD(&rdev->consumer_list); 2341414c70cbSLiam Girdwood INIT_LIST_HEAD(&rdev->supply_list); 2342414c70cbSLiam Girdwood INIT_LIST_HEAD(&rdev->list); 2343414c70cbSLiam Girdwood INIT_LIST_HEAD(&rdev->slist); 2344414c70cbSLiam Girdwood BLOCKING_INIT_NOTIFIER_HEAD(&rdev->notifier); 2345414c70cbSLiam Girdwood 2346a5766f11SLiam Girdwood /* preform any regulator specific init */ 2347a5766f11SLiam Girdwood if (init_data->regulator_init) { 2348a5766f11SLiam Girdwood ret = init_data->regulator_init(rdev->reg_data); 23494fca9545SDavid Brownell if (ret < 0) 23504fca9545SDavid Brownell goto clean; 2351a5766f11SLiam Girdwood } 2352a5766f11SLiam Girdwood 2353a5766f11SLiam Girdwood /* register with sysfs */ 2354a5766f11SLiam Girdwood rdev->dev.class = ®ulator_class; 2355a5766f11SLiam Girdwood rdev->dev.parent = dev; 2356812460a9SKay Sievers dev_set_name(&rdev->dev, "regulator.%d", 2357812460a9SKay Sievers atomic_inc_return(®ulator_no) - 1); 2358a5766f11SLiam Girdwood ret = device_register(&rdev->dev); 2359ad7725cbSVasiliy Kulikov if (ret != 0) { 2360ad7725cbSVasiliy Kulikov put_device(&rdev->dev); 23614fca9545SDavid Brownell goto clean; 2362ad7725cbSVasiliy Kulikov } 2363a5766f11SLiam Girdwood 2364a5766f11SLiam Girdwood dev_set_drvdata(&rdev->dev, rdev); 2365a5766f11SLiam Girdwood 236674f544c1SMike Rapoport /* set regulator constraints */ 236774f544c1SMike Rapoport ret = set_machine_constraints(rdev, &init_data->constraints); 236874f544c1SMike Rapoport if (ret < 0) 236974f544c1SMike Rapoport goto scrub; 237074f544c1SMike Rapoport 23717ad68e2fSDavid Brownell /* add attributes supported by this regulator */ 23727ad68e2fSDavid Brownell ret = add_regulator_attributes(rdev); 23737ad68e2fSDavid Brownell if (ret < 0) 23747ad68e2fSDavid Brownell goto scrub; 23757ad68e2fSDavid Brownell 2376a5766f11SLiam Girdwood /* set supply regulator if it exists */ 23770178f3e2SMark Brown if (init_data->supply_regulator && init_data->supply_regulator_dev) { 23780178f3e2SMark Brown dev_err(dev, 23790178f3e2SMark Brown "Supply regulator specified by both name and dev\n"); 23807727da22SAxel Lin ret = -EINVAL; 23810178f3e2SMark Brown goto scrub; 23820178f3e2SMark Brown } 23830178f3e2SMark Brown 23840178f3e2SMark Brown if (init_data->supply_regulator) { 23850178f3e2SMark Brown struct regulator_dev *r; 23860178f3e2SMark Brown int found = 0; 23870178f3e2SMark Brown 23880178f3e2SMark Brown list_for_each_entry(r, ®ulator_list, list) { 23890178f3e2SMark Brown if (strcmp(rdev_get_name(r), 23900178f3e2SMark Brown init_data->supply_regulator) == 0) { 23910178f3e2SMark Brown found = 1; 23920178f3e2SMark Brown break; 23930178f3e2SMark Brown } 23940178f3e2SMark Brown } 23950178f3e2SMark Brown 23960178f3e2SMark Brown if (!found) { 23970178f3e2SMark Brown dev_err(dev, "Failed to find supply %s\n", 23980178f3e2SMark Brown init_data->supply_regulator); 23997727da22SAxel Lin ret = -ENODEV; 24000178f3e2SMark Brown goto scrub; 24010178f3e2SMark Brown } 24020178f3e2SMark Brown 24030178f3e2SMark Brown ret = set_supply(rdev, r); 24040178f3e2SMark Brown if (ret < 0) 24050178f3e2SMark Brown goto scrub; 24060178f3e2SMark Brown } 24070178f3e2SMark Brown 2408a5766f11SLiam Girdwood if (init_data->supply_regulator_dev) { 24090178f3e2SMark Brown dev_warn(dev, "Uses supply_regulator_dev instead of regulator_supply\n"); 2410a5766f11SLiam Girdwood ret = set_supply(rdev, 2411a5766f11SLiam Girdwood dev_get_drvdata(init_data->supply_regulator_dev)); 24124fca9545SDavid Brownell if (ret < 0) 24134fca9545SDavid Brownell goto scrub; 2414a5766f11SLiam Girdwood } 2415a5766f11SLiam Girdwood 2416a5766f11SLiam Girdwood /* add consumers devices */ 2417a5766f11SLiam Girdwood for (i = 0; i < init_data->num_consumer_supplies; i++) { 2418a5766f11SLiam Girdwood ret = set_consumer_device_supply(rdev, 2419a5766f11SLiam Girdwood init_data->consumer_supplies[i].dev, 242040f9244fSMark Brown init_data->consumer_supplies[i].dev_name, 2421a5766f11SLiam Girdwood init_data->consumer_supplies[i].supply); 2422d4033b54SJani Nikula if (ret < 0) 2423d4033b54SJani Nikula goto unset_supplies; 2424a5766f11SLiam Girdwood } 2425a5766f11SLiam Girdwood 2426a5766f11SLiam Girdwood list_add(&rdev->list, ®ulator_list); 2427a5766f11SLiam Girdwood out: 2428414c70cbSLiam Girdwood mutex_unlock(®ulator_list_mutex); 2429414c70cbSLiam Girdwood return rdev; 24304fca9545SDavid Brownell 2431d4033b54SJani Nikula unset_supplies: 2432d4033b54SJani Nikula unset_regulator_supplies(rdev); 2433d4033b54SJani Nikula 24344fca9545SDavid Brownell scrub: 24354fca9545SDavid Brownell device_unregister(&rdev->dev); 243653032dafSPaul Walmsley /* device core frees rdev */ 243753032dafSPaul Walmsley rdev = ERR_PTR(ret); 243853032dafSPaul Walmsley goto out; 243953032dafSPaul Walmsley 24404fca9545SDavid Brownell clean: 24414fca9545SDavid Brownell kfree(rdev); 24424fca9545SDavid Brownell rdev = ERR_PTR(ret); 24434fca9545SDavid Brownell goto out; 2444414c70cbSLiam Girdwood } 2445414c70cbSLiam Girdwood EXPORT_SYMBOL_GPL(regulator_register); 2446414c70cbSLiam Girdwood 2447414c70cbSLiam Girdwood /** 2448414c70cbSLiam Girdwood * regulator_unregister - unregister regulator 244969279fb9SMark Brown * @rdev: regulator to unregister 2450414c70cbSLiam Girdwood * 2451414c70cbSLiam Girdwood * Called by regulator drivers to unregister a regulator. 2452414c70cbSLiam Girdwood */ 2453414c70cbSLiam Girdwood void regulator_unregister(struct regulator_dev *rdev) 2454414c70cbSLiam Girdwood { 2455414c70cbSLiam Girdwood if (rdev == NULL) 2456414c70cbSLiam Girdwood return; 2457414c70cbSLiam Girdwood 2458414c70cbSLiam Girdwood mutex_lock(®ulator_list_mutex); 24596bf87d17SMark Brown WARN_ON(rdev->open_count); 24600f1d747bSMike Rapoport unset_regulator_supplies(rdev); 2461414c70cbSLiam Girdwood list_del(&rdev->list); 2462414c70cbSLiam Girdwood if (rdev->supply) 2463414c70cbSLiam Girdwood sysfs_remove_link(&rdev->dev.kobj, "supply"); 2464414c70cbSLiam Girdwood device_unregister(&rdev->dev); 2465f8c12fe3SMark Brown kfree(rdev->constraints); 2466414c70cbSLiam Girdwood mutex_unlock(®ulator_list_mutex); 2467414c70cbSLiam Girdwood } 2468414c70cbSLiam Girdwood EXPORT_SYMBOL_GPL(regulator_unregister); 2469414c70cbSLiam Girdwood 2470414c70cbSLiam Girdwood /** 2471cf7bbcdfSMark Brown * regulator_suspend_prepare - prepare regulators for system wide suspend 2472414c70cbSLiam Girdwood * @state: system suspend state 2473414c70cbSLiam Girdwood * 2474414c70cbSLiam Girdwood * Configure each regulator with it's suspend operating parameters for state. 2475414c70cbSLiam Girdwood * This will usually be called by machine suspend code prior to supending. 2476414c70cbSLiam Girdwood */ 2477414c70cbSLiam Girdwood int regulator_suspend_prepare(suspend_state_t state) 2478414c70cbSLiam Girdwood { 2479414c70cbSLiam Girdwood struct regulator_dev *rdev; 2480414c70cbSLiam Girdwood int ret = 0; 2481414c70cbSLiam Girdwood 2482414c70cbSLiam Girdwood /* ON is handled by regulator active state */ 2483414c70cbSLiam Girdwood if (state == PM_SUSPEND_ON) 2484414c70cbSLiam Girdwood return -EINVAL; 2485414c70cbSLiam Girdwood 2486414c70cbSLiam Girdwood mutex_lock(®ulator_list_mutex); 2487414c70cbSLiam Girdwood list_for_each_entry(rdev, ®ulator_list, list) { 2488414c70cbSLiam Girdwood 2489414c70cbSLiam Girdwood mutex_lock(&rdev->mutex); 2490414c70cbSLiam Girdwood ret = suspend_prepare(rdev, state); 2491414c70cbSLiam Girdwood mutex_unlock(&rdev->mutex); 2492414c70cbSLiam Girdwood 2493414c70cbSLiam Girdwood if (ret < 0) { 24945da84fd9SJoe Perches rdev_err(rdev, "failed to prepare\n"); 2495414c70cbSLiam Girdwood goto out; 2496414c70cbSLiam Girdwood } 2497414c70cbSLiam Girdwood } 2498414c70cbSLiam Girdwood out: 2499414c70cbSLiam Girdwood mutex_unlock(®ulator_list_mutex); 2500414c70cbSLiam Girdwood return ret; 2501414c70cbSLiam Girdwood } 2502414c70cbSLiam Girdwood EXPORT_SYMBOL_GPL(regulator_suspend_prepare); 2503414c70cbSLiam Girdwood 2504414c70cbSLiam Girdwood /** 2505ca725561SMark Brown * regulator_has_full_constraints - the system has fully specified constraints 2506ca725561SMark Brown * 2507ca725561SMark Brown * Calling this function will cause the regulator API to disable all 2508ca725561SMark Brown * regulators which have a zero use count and don't have an always_on 2509ca725561SMark Brown * constraint in a late_initcall. 2510ca725561SMark Brown * 2511ca725561SMark Brown * The intention is that this will become the default behaviour in a 2512ca725561SMark Brown * future kernel release so users are encouraged to use this facility 2513ca725561SMark Brown * now. 2514ca725561SMark Brown */ 2515ca725561SMark Brown void regulator_has_full_constraints(void) 2516ca725561SMark Brown { 2517ca725561SMark Brown has_full_constraints = 1; 2518ca725561SMark Brown } 2519ca725561SMark Brown EXPORT_SYMBOL_GPL(regulator_has_full_constraints); 2520ca725561SMark Brown 2521ca725561SMark Brown /** 2522688fe99aSMark Brown * regulator_use_dummy_regulator - Provide a dummy regulator when none is found 2523688fe99aSMark Brown * 2524688fe99aSMark Brown * Calling this function will cause the regulator API to provide a 2525688fe99aSMark Brown * dummy regulator to consumers if no physical regulator is found, 2526688fe99aSMark Brown * allowing most consumers to proceed as though a regulator were 2527688fe99aSMark Brown * configured. This allows systems such as those with software 2528688fe99aSMark Brown * controllable regulators for the CPU core only to be brought up more 2529688fe99aSMark Brown * readily. 2530688fe99aSMark Brown */ 2531688fe99aSMark Brown void regulator_use_dummy_regulator(void) 2532688fe99aSMark Brown { 2533688fe99aSMark Brown board_wants_dummy_regulator = true; 2534688fe99aSMark Brown } 2535688fe99aSMark Brown EXPORT_SYMBOL_GPL(regulator_use_dummy_regulator); 2536688fe99aSMark Brown 2537688fe99aSMark Brown /** 2538414c70cbSLiam Girdwood * rdev_get_drvdata - get rdev regulator driver data 253969279fb9SMark Brown * @rdev: regulator 2540414c70cbSLiam Girdwood * 2541414c70cbSLiam Girdwood * Get rdev regulator driver private data. This call can be used in the 2542414c70cbSLiam Girdwood * regulator driver context. 2543414c70cbSLiam Girdwood */ 2544414c70cbSLiam Girdwood void *rdev_get_drvdata(struct regulator_dev *rdev) 2545414c70cbSLiam Girdwood { 2546414c70cbSLiam Girdwood return rdev->reg_data; 2547414c70cbSLiam Girdwood } 2548414c70cbSLiam Girdwood EXPORT_SYMBOL_GPL(rdev_get_drvdata); 2549414c70cbSLiam Girdwood 2550414c70cbSLiam Girdwood /** 2551414c70cbSLiam Girdwood * regulator_get_drvdata - get regulator driver data 2552414c70cbSLiam Girdwood * @regulator: regulator 2553414c70cbSLiam Girdwood * 2554414c70cbSLiam Girdwood * Get regulator driver private data. This call can be used in the consumer 2555414c70cbSLiam Girdwood * driver context when non API regulator specific functions need to be called. 2556414c70cbSLiam Girdwood */ 2557414c70cbSLiam Girdwood void *regulator_get_drvdata(struct regulator *regulator) 2558414c70cbSLiam Girdwood { 2559414c70cbSLiam Girdwood return regulator->rdev->reg_data; 2560414c70cbSLiam Girdwood } 2561414c70cbSLiam Girdwood EXPORT_SYMBOL_GPL(regulator_get_drvdata); 2562414c70cbSLiam Girdwood 2563414c70cbSLiam Girdwood /** 2564414c70cbSLiam Girdwood * regulator_set_drvdata - set regulator driver data 2565414c70cbSLiam Girdwood * @regulator: regulator 2566414c70cbSLiam Girdwood * @data: data 2567414c70cbSLiam Girdwood */ 2568414c70cbSLiam Girdwood void regulator_set_drvdata(struct regulator *regulator, void *data) 2569414c70cbSLiam Girdwood { 2570414c70cbSLiam Girdwood regulator->rdev->reg_data = data; 2571414c70cbSLiam Girdwood } 2572414c70cbSLiam Girdwood EXPORT_SYMBOL_GPL(regulator_set_drvdata); 2573414c70cbSLiam Girdwood 2574414c70cbSLiam Girdwood /** 2575414c70cbSLiam Girdwood * regulator_get_id - get regulator ID 257669279fb9SMark Brown * @rdev: regulator 2577414c70cbSLiam Girdwood */ 2578414c70cbSLiam Girdwood int rdev_get_id(struct regulator_dev *rdev) 2579414c70cbSLiam Girdwood { 2580414c70cbSLiam Girdwood return rdev->desc->id; 2581414c70cbSLiam Girdwood } 2582414c70cbSLiam Girdwood EXPORT_SYMBOL_GPL(rdev_get_id); 2583414c70cbSLiam Girdwood 2584a5766f11SLiam Girdwood struct device *rdev_get_dev(struct regulator_dev *rdev) 2585a5766f11SLiam Girdwood { 2586a5766f11SLiam Girdwood return &rdev->dev; 2587a5766f11SLiam Girdwood } 2588a5766f11SLiam Girdwood EXPORT_SYMBOL_GPL(rdev_get_dev); 2589a5766f11SLiam Girdwood 2590a5766f11SLiam Girdwood void *regulator_get_init_drvdata(struct regulator_init_data *reg_init_data) 2591a5766f11SLiam Girdwood { 2592a5766f11SLiam Girdwood return reg_init_data->driver_data; 2593a5766f11SLiam Girdwood } 2594a5766f11SLiam Girdwood EXPORT_SYMBOL_GPL(regulator_get_init_drvdata); 2595a5766f11SLiam Girdwood 2596414c70cbSLiam Girdwood static int __init regulator_init(void) 2597414c70cbSLiam Girdwood { 259834abbd68SMark Brown int ret; 259934abbd68SMark Brown 260034abbd68SMark Brown ret = class_register(®ulator_class); 260134abbd68SMark Brown 260234abbd68SMark Brown regulator_dummy_init(); 260334abbd68SMark Brown 260434abbd68SMark Brown return ret; 2605414c70cbSLiam Girdwood } 2606414c70cbSLiam Girdwood 2607414c70cbSLiam Girdwood /* init early to allow our consumers to complete system booting */ 2608414c70cbSLiam Girdwood core_initcall(regulator_init); 2609ca725561SMark Brown 2610ca725561SMark Brown static int __init regulator_init_complete(void) 2611ca725561SMark Brown { 2612ca725561SMark Brown struct regulator_dev *rdev; 2613ca725561SMark Brown struct regulator_ops *ops; 2614ca725561SMark Brown struct regulation_constraints *c; 2615ca725561SMark Brown int enabled, ret; 2616ca725561SMark Brown 2617ca725561SMark Brown mutex_lock(®ulator_list_mutex); 2618ca725561SMark Brown 2619ca725561SMark Brown /* If we have a full configuration then disable any regulators 2620ca725561SMark Brown * which are not in use or always_on. This will become the 2621ca725561SMark Brown * default behaviour in the future. 2622ca725561SMark Brown */ 2623ca725561SMark Brown list_for_each_entry(rdev, ®ulator_list, list) { 2624ca725561SMark Brown ops = rdev->desc->ops; 2625ca725561SMark Brown c = rdev->constraints; 2626ca725561SMark Brown 2627f25e0b4fSMark Brown if (!ops->disable || (c && c->always_on)) 2628ca725561SMark Brown continue; 2629ca725561SMark Brown 2630ca725561SMark Brown mutex_lock(&rdev->mutex); 2631ca725561SMark Brown 2632ca725561SMark Brown if (rdev->use_count) 2633ca725561SMark Brown goto unlock; 2634ca725561SMark Brown 2635ca725561SMark Brown /* If we can't read the status assume it's on. */ 2636ca725561SMark Brown if (ops->is_enabled) 2637ca725561SMark Brown enabled = ops->is_enabled(rdev); 2638ca725561SMark Brown else 2639ca725561SMark Brown enabled = 1; 2640ca725561SMark Brown 2641ca725561SMark Brown if (!enabled) 2642ca725561SMark Brown goto unlock; 2643ca725561SMark Brown 2644ca725561SMark Brown if (has_full_constraints) { 2645ca725561SMark Brown /* We log since this may kill the system if it 2646ca725561SMark Brown * goes wrong. */ 26475da84fd9SJoe Perches rdev_info(rdev, "disabling\n"); 2648ca725561SMark Brown ret = ops->disable(rdev); 2649ca725561SMark Brown if (ret != 0) { 26505da84fd9SJoe Perches rdev_err(rdev, "couldn't disable: %d\n", ret); 2651ca725561SMark Brown } 2652ca725561SMark Brown } else { 2653ca725561SMark Brown /* The intention is that in future we will 2654ca725561SMark Brown * assume that full constraints are provided 2655ca725561SMark Brown * so warn even if we aren't going to do 2656ca725561SMark Brown * anything here. 2657ca725561SMark Brown */ 26585da84fd9SJoe Perches rdev_warn(rdev, "incomplete constraints, leaving on\n"); 2659ca725561SMark Brown } 2660ca725561SMark Brown 2661ca725561SMark Brown unlock: 2662ca725561SMark Brown mutex_unlock(&rdev->mutex); 2663ca725561SMark Brown } 2664ca725561SMark Brown 2665ca725561SMark Brown mutex_unlock(®ulator_list_mutex); 2666ca725561SMark Brown 2667ca725561SMark Brown return 0; 2668ca725561SMark Brown } 2669ca725561SMark Brown late_initcall(regulator_init_complete); 2670