1414c70cbSLiam Girdwood /* 2414c70cbSLiam Girdwood * core.c -- Voltage/Current Regulator framework. 3414c70cbSLiam Girdwood * 4414c70cbSLiam Girdwood * Copyright 2007, 2008 Wolfson Microelectronics PLC. 5a5766f11SLiam Girdwood * Copyright 2008 SlimLogic Ltd. 6414c70cbSLiam Girdwood * 7a5766f11SLiam Girdwood * Author: Liam Girdwood <lrg@slimlogic.co.uk> 8414c70cbSLiam Girdwood * 9414c70cbSLiam Girdwood * This program is free software; you can redistribute it and/or modify it 10414c70cbSLiam Girdwood * under the terms of the GNU General Public License as published by the 11414c70cbSLiam Girdwood * Free Software Foundation; either version 2 of the License, or (at your 12414c70cbSLiam Girdwood * option) any later version. 13414c70cbSLiam Girdwood * 14414c70cbSLiam Girdwood */ 15414c70cbSLiam Girdwood 16414c70cbSLiam Girdwood #include <linux/kernel.h> 17414c70cbSLiam Girdwood #include <linux/init.h> 18414c70cbSLiam Girdwood #include <linux/device.h> 19414c70cbSLiam Girdwood #include <linux/err.h> 20414c70cbSLiam Girdwood #include <linux/mutex.h> 21414c70cbSLiam Girdwood #include <linux/suspend.h> 22414c70cbSLiam Girdwood #include <linux/regulator/consumer.h> 23414c70cbSLiam Girdwood #include <linux/regulator/driver.h> 24414c70cbSLiam Girdwood #include <linux/regulator/machine.h> 25414c70cbSLiam Girdwood 26414c70cbSLiam Girdwood #define REGULATOR_VERSION "0.5" 27414c70cbSLiam Girdwood 28414c70cbSLiam Girdwood static DEFINE_MUTEX(regulator_list_mutex); 29414c70cbSLiam Girdwood static LIST_HEAD(regulator_list); 30414c70cbSLiam Girdwood static LIST_HEAD(regulator_map_list); 31414c70cbSLiam Girdwood 328dc5390dSMark Brown /* 33414c70cbSLiam Girdwood * struct regulator_dev 34414c70cbSLiam Girdwood * 35414c70cbSLiam Girdwood * Voltage / Current regulator class device. One for each regulator. 36414c70cbSLiam Girdwood */ 37414c70cbSLiam Girdwood struct regulator_dev { 38414c70cbSLiam Girdwood struct regulator_desc *desc; 39414c70cbSLiam Girdwood int use_count; 40414c70cbSLiam Girdwood 41414c70cbSLiam Girdwood /* lists we belong to */ 42414c70cbSLiam Girdwood struct list_head list; /* list of all regulators */ 43414c70cbSLiam Girdwood struct list_head slist; /* list of supplied regulators */ 44414c70cbSLiam Girdwood 45414c70cbSLiam Girdwood /* lists we own */ 46414c70cbSLiam Girdwood struct list_head consumer_list; /* consumers we supply */ 47414c70cbSLiam Girdwood struct list_head supply_list; /* regulators we supply */ 48414c70cbSLiam Girdwood 49414c70cbSLiam Girdwood struct blocking_notifier_head notifier; 50414c70cbSLiam Girdwood struct mutex mutex; /* consumer lock */ 51414c70cbSLiam Girdwood struct module *owner; 52414c70cbSLiam Girdwood struct device dev; 53414c70cbSLiam Girdwood struct regulation_constraints *constraints; 54414c70cbSLiam Girdwood struct regulator_dev *supply; /* for tree */ 55414c70cbSLiam Girdwood 56414c70cbSLiam Girdwood void *reg_data; /* regulator_dev data */ 57414c70cbSLiam Girdwood }; 58414c70cbSLiam Girdwood 598dc5390dSMark Brown /* 60414c70cbSLiam Girdwood * struct regulator_map 61414c70cbSLiam Girdwood * 62414c70cbSLiam Girdwood * Used to provide symbolic supply names to devices. 63414c70cbSLiam Girdwood */ 64414c70cbSLiam Girdwood struct regulator_map { 65414c70cbSLiam Girdwood struct list_head list; 66414c70cbSLiam Girdwood struct device *dev; 67414c70cbSLiam Girdwood const char *supply; 68a5766f11SLiam Girdwood struct regulator_dev *regulator; 69414c70cbSLiam Girdwood }; 70414c70cbSLiam Girdwood 71414c70cbSLiam Girdwood /* 72414c70cbSLiam Girdwood * struct regulator 73414c70cbSLiam Girdwood * 74414c70cbSLiam Girdwood * One for each consumer device. 75414c70cbSLiam Girdwood */ 76414c70cbSLiam Girdwood struct regulator { 77414c70cbSLiam Girdwood struct device *dev; 78414c70cbSLiam Girdwood struct list_head list; 79414c70cbSLiam Girdwood int uA_load; 80414c70cbSLiam Girdwood int min_uV; 81414c70cbSLiam Girdwood int max_uV; 82412aec61SDavid Brownell int enabled; /* count of client enables */ 83414c70cbSLiam Girdwood char *supply_name; 84414c70cbSLiam Girdwood struct device_attribute dev_attr; 85414c70cbSLiam Girdwood struct regulator_dev *rdev; 86414c70cbSLiam Girdwood }; 87414c70cbSLiam Girdwood 88414c70cbSLiam Girdwood static int _regulator_is_enabled(struct regulator_dev *rdev); 89414c70cbSLiam Girdwood static int _regulator_disable(struct regulator_dev *rdev); 90414c70cbSLiam Girdwood static int _regulator_get_voltage(struct regulator_dev *rdev); 91414c70cbSLiam Girdwood static int _regulator_get_current_limit(struct regulator_dev *rdev); 92414c70cbSLiam Girdwood static unsigned int _regulator_get_mode(struct regulator_dev *rdev); 93414c70cbSLiam Girdwood static void _notifier_call_chain(struct regulator_dev *rdev, 94414c70cbSLiam Girdwood unsigned long event, void *data); 95414c70cbSLiam Girdwood 96414c70cbSLiam Girdwood /* gets the regulator for a given consumer device */ 97414c70cbSLiam Girdwood static struct regulator *get_device_regulator(struct device *dev) 98414c70cbSLiam Girdwood { 99414c70cbSLiam Girdwood struct regulator *regulator = NULL; 100414c70cbSLiam Girdwood struct regulator_dev *rdev; 101414c70cbSLiam Girdwood 102414c70cbSLiam Girdwood mutex_lock(®ulator_list_mutex); 103414c70cbSLiam Girdwood list_for_each_entry(rdev, ®ulator_list, list) { 104414c70cbSLiam Girdwood mutex_lock(&rdev->mutex); 105414c70cbSLiam Girdwood list_for_each_entry(regulator, &rdev->consumer_list, list) { 106414c70cbSLiam Girdwood if (regulator->dev == dev) { 107414c70cbSLiam Girdwood mutex_unlock(&rdev->mutex); 108414c70cbSLiam Girdwood mutex_unlock(®ulator_list_mutex); 109414c70cbSLiam Girdwood return regulator; 110414c70cbSLiam Girdwood } 111414c70cbSLiam Girdwood } 112414c70cbSLiam Girdwood mutex_unlock(&rdev->mutex); 113414c70cbSLiam Girdwood } 114414c70cbSLiam Girdwood mutex_unlock(®ulator_list_mutex); 115414c70cbSLiam Girdwood return NULL; 116414c70cbSLiam Girdwood } 117414c70cbSLiam Girdwood 118414c70cbSLiam Girdwood /* Platform voltage constraint check */ 119414c70cbSLiam Girdwood static int regulator_check_voltage(struct regulator_dev *rdev, 120414c70cbSLiam Girdwood int *min_uV, int *max_uV) 121414c70cbSLiam Girdwood { 122414c70cbSLiam Girdwood BUG_ON(*min_uV > *max_uV); 123414c70cbSLiam Girdwood 124414c70cbSLiam Girdwood if (!rdev->constraints) { 125414c70cbSLiam Girdwood printk(KERN_ERR "%s: no constraints for %s\n", __func__, 126414c70cbSLiam Girdwood rdev->desc->name); 127414c70cbSLiam Girdwood return -ENODEV; 128414c70cbSLiam Girdwood } 129414c70cbSLiam Girdwood if (!(rdev->constraints->valid_ops_mask & REGULATOR_CHANGE_VOLTAGE)) { 130414c70cbSLiam Girdwood printk(KERN_ERR "%s: operation not allowed for %s\n", 131414c70cbSLiam Girdwood __func__, rdev->desc->name); 132414c70cbSLiam Girdwood return -EPERM; 133414c70cbSLiam Girdwood } 134414c70cbSLiam Girdwood 135414c70cbSLiam Girdwood if (*max_uV > rdev->constraints->max_uV) 136414c70cbSLiam Girdwood *max_uV = rdev->constraints->max_uV; 137414c70cbSLiam Girdwood if (*min_uV < rdev->constraints->min_uV) 138414c70cbSLiam Girdwood *min_uV = rdev->constraints->min_uV; 139414c70cbSLiam Girdwood 140414c70cbSLiam Girdwood if (*min_uV > *max_uV) 141414c70cbSLiam Girdwood return -EINVAL; 142414c70cbSLiam Girdwood 143414c70cbSLiam Girdwood return 0; 144414c70cbSLiam Girdwood } 145414c70cbSLiam Girdwood 146414c70cbSLiam Girdwood /* current constraint check */ 147414c70cbSLiam Girdwood static int regulator_check_current_limit(struct regulator_dev *rdev, 148414c70cbSLiam Girdwood int *min_uA, int *max_uA) 149414c70cbSLiam Girdwood { 150414c70cbSLiam Girdwood BUG_ON(*min_uA > *max_uA); 151414c70cbSLiam Girdwood 152414c70cbSLiam Girdwood if (!rdev->constraints) { 153414c70cbSLiam Girdwood printk(KERN_ERR "%s: no constraints for %s\n", __func__, 154414c70cbSLiam Girdwood rdev->desc->name); 155414c70cbSLiam Girdwood return -ENODEV; 156414c70cbSLiam Girdwood } 157414c70cbSLiam Girdwood if (!(rdev->constraints->valid_ops_mask & REGULATOR_CHANGE_CURRENT)) { 158414c70cbSLiam Girdwood printk(KERN_ERR "%s: operation not allowed for %s\n", 159414c70cbSLiam Girdwood __func__, rdev->desc->name); 160414c70cbSLiam Girdwood return -EPERM; 161414c70cbSLiam Girdwood } 162414c70cbSLiam Girdwood 163414c70cbSLiam Girdwood if (*max_uA > rdev->constraints->max_uA) 164414c70cbSLiam Girdwood *max_uA = rdev->constraints->max_uA; 165414c70cbSLiam Girdwood if (*min_uA < rdev->constraints->min_uA) 166414c70cbSLiam Girdwood *min_uA = rdev->constraints->min_uA; 167414c70cbSLiam Girdwood 168414c70cbSLiam Girdwood if (*min_uA > *max_uA) 169414c70cbSLiam Girdwood return -EINVAL; 170414c70cbSLiam Girdwood 171414c70cbSLiam Girdwood return 0; 172414c70cbSLiam Girdwood } 173414c70cbSLiam Girdwood 174414c70cbSLiam Girdwood /* operating mode constraint check */ 175414c70cbSLiam Girdwood static int regulator_check_mode(struct regulator_dev *rdev, int mode) 176414c70cbSLiam Girdwood { 177e573520bSDavid Brownell switch (mode) { 178e573520bSDavid Brownell case REGULATOR_MODE_FAST: 179e573520bSDavid Brownell case REGULATOR_MODE_NORMAL: 180e573520bSDavid Brownell case REGULATOR_MODE_IDLE: 181e573520bSDavid Brownell case REGULATOR_MODE_STANDBY: 182e573520bSDavid Brownell break; 183e573520bSDavid Brownell default: 184e573520bSDavid Brownell return -EINVAL; 185e573520bSDavid Brownell } 186e573520bSDavid Brownell 187414c70cbSLiam Girdwood if (!rdev->constraints) { 188414c70cbSLiam Girdwood printk(KERN_ERR "%s: no constraints for %s\n", __func__, 189414c70cbSLiam Girdwood rdev->desc->name); 190414c70cbSLiam Girdwood return -ENODEV; 191414c70cbSLiam Girdwood } 192414c70cbSLiam Girdwood if (!(rdev->constraints->valid_ops_mask & REGULATOR_CHANGE_MODE)) { 193414c70cbSLiam Girdwood printk(KERN_ERR "%s: operation not allowed for %s\n", 194414c70cbSLiam Girdwood __func__, rdev->desc->name); 195414c70cbSLiam Girdwood return -EPERM; 196414c70cbSLiam Girdwood } 197414c70cbSLiam Girdwood if (!(rdev->constraints->valid_modes_mask & mode)) { 198414c70cbSLiam Girdwood printk(KERN_ERR "%s: invalid mode %x for %s\n", 199414c70cbSLiam Girdwood __func__, mode, rdev->desc->name); 200414c70cbSLiam Girdwood return -EINVAL; 201414c70cbSLiam Girdwood } 202414c70cbSLiam Girdwood return 0; 203414c70cbSLiam Girdwood } 204414c70cbSLiam Girdwood 205414c70cbSLiam Girdwood /* dynamic regulator mode switching constraint check */ 206414c70cbSLiam Girdwood static int regulator_check_drms(struct regulator_dev *rdev) 207414c70cbSLiam Girdwood { 208414c70cbSLiam Girdwood if (!rdev->constraints) { 209414c70cbSLiam Girdwood printk(KERN_ERR "%s: no constraints for %s\n", __func__, 210414c70cbSLiam Girdwood rdev->desc->name); 211414c70cbSLiam Girdwood return -ENODEV; 212414c70cbSLiam Girdwood } 213414c70cbSLiam Girdwood if (!(rdev->constraints->valid_ops_mask & REGULATOR_CHANGE_DRMS)) { 214414c70cbSLiam Girdwood printk(KERN_ERR "%s: operation not allowed for %s\n", 215414c70cbSLiam Girdwood __func__, rdev->desc->name); 216414c70cbSLiam Girdwood return -EPERM; 217414c70cbSLiam Girdwood } 218414c70cbSLiam Girdwood return 0; 219414c70cbSLiam Girdwood } 220414c70cbSLiam Girdwood 221414c70cbSLiam Girdwood static ssize_t device_requested_uA_show(struct device *dev, 222414c70cbSLiam Girdwood struct device_attribute *attr, char *buf) 223414c70cbSLiam Girdwood { 224414c70cbSLiam Girdwood struct regulator *regulator; 225414c70cbSLiam Girdwood 226414c70cbSLiam Girdwood regulator = get_device_regulator(dev); 227414c70cbSLiam Girdwood if (regulator == NULL) 228414c70cbSLiam Girdwood return 0; 229414c70cbSLiam Girdwood 230414c70cbSLiam Girdwood return sprintf(buf, "%d\n", regulator->uA_load); 231414c70cbSLiam Girdwood } 232414c70cbSLiam Girdwood 233414c70cbSLiam Girdwood static ssize_t regulator_uV_show(struct device *dev, 234414c70cbSLiam Girdwood struct device_attribute *attr, char *buf) 235414c70cbSLiam Girdwood { 236a5766f11SLiam Girdwood struct regulator_dev *rdev = dev_get_drvdata(dev); 237414c70cbSLiam Girdwood ssize_t ret; 238414c70cbSLiam Girdwood 239414c70cbSLiam Girdwood mutex_lock(&rdev->mutex); 240414c70cbSLiam Girdwood ret = sprintf(buf, "%d\n", _regulator_get_voltage(rdev)); 241414c70cbSLiam Girdwood mutex_unlock(&rdev->mutex); 242414c70cbSLiam Girdwood 243414c70cbSLiam Girdwood return ret; 244414c70cbSLiam Girdwood } 2457ad68e2fSDavid Brownell static DEVICE_ATTR(microvolts, 0444, regulator_uV_show, NULL); 246414c70cbSLiam Girdwood 247414c70cbSLiam Girdwood static ssize_t regulator_uA_show(struct device *dev, 248414c70cbSLiam Girdwood struct device_attribute *attr, char *buf) 249414c70cbSLiam Girdwood { 250a5766f11SLiam Girdwood struct regulator_dev *rdev = dev_get_drvdata(dev); 251414c70cbSLiam Girdwood 252414c70cbSLiam Girdwood return sprintf(buf, "%d\n", _regulator_get_current_limit(rdev)); 253414c70cbSLiam Girdwood } 2547ad68e2fSDavid Brownell static DEVICE_ATTR(microamps, 0444, regulator_uA_show, NULL); 255414c70cbSLiam Girdwood 256bc558a60SMark Brown static ssize_t regulator_name_show(struct device *dev, 257bc558a60SMark Brown struct device_attribute *attr, char *buf) 258bc558a60SMark Brown { 259bc558a60SMark Brown struct regulator_dev *rdev = dev_get_drvdata(dev); 260bc558a60SMark Brown const char *name; 261bc558a60SMark Brown 262bc558a60SMark Brown if (rdev->constraints->name) 263bc558a60SMark Brown name = rdev->constraints->name; 264bc558a60SMark Brown else if (rdev->desc->name) 265bc558a60SMark Brown name = rdev->desc->name; 266bc558a60SMark Brown else 267bc558a60SMark Brown name = ""; 268bc558a60SMark Brown 269bc558a60SMark Brown return sprintf(buf, "%s\n", name); 270bc558a60SMark Brown } 271bc558a60SMark Brown 2724fca9545SDavid Brownell static ssize_t regulator_print_opmode(char *buf, int mode) 273414c70cbSLiam Girdwood { 274414c70cbSLiam Girdwood switch (mode) { 275414c70cbSLiam Girdwood case REGULATOR_MODE_FAST: 276414c70cbSLiam Girdwood return sprintf(buf, "fast\n"); 277414c70cbSLiam Girdwood case REGULATOR_MODE_NORMAL: 278414c70cbSLiam Girdwood return sprintf(buf, "normal\n"); 279414c70cbSLiam Girdwood case REGULATOR_MODE_IDLE: 280414c70cbSLiam Girdwood return sprintf(buf, "idle\n"); 281414c70cbSLiam Girdwood case REGULATOR_MODE_STANDBY: 282414c70cbSLiam Girdwood return sprintf(buf, "standby\n"); 283414c70cbSLiam Girdwood } 284414c70cbSLiam Girdwood return sprintf(buf, "unknown\n"); 285414c70cbSLiam Girdwood } 286414c70cbSLiam Girdwood 2874fca9545SDavid Brownell static ssize_t regulator_opmode_show(struct device *dev, 288414c70cbSLiam Girdwood struct device_attribute *attr, char *buf) 289414c70cbSLiam Girdwood { 290a5766f11SLiam Girdwood struct regulator_dev *rdev = dev_get_drvdata(dev); 291414c70cbSLiam Girdwood 2924fca9545SDavid Brownell return regulator_print_opmode(buf, _regulator_get_mode(rdev)); 2934fca9545SDavid Brownell } 2947ad68e2fSDavid Brownell static DEVICE_ATTR(opmode, 0444, regulator_opmode_show, NULL); 2954fca9545SDavid Brownell 2964fca9545SDavid Brownell static ssize_t regulator_print_state(char *buf, int state) 2974fca9545SDavid Brownell { 298414c70cbSLiam Girdwood if (state > 0) 299414c70cbSLiam Girdwood return sprintf(buf, "enabled\n"); 300414c70cbSLiam Girdwood else if (state == 0) 301414c70cbSLiam Girdwood return sprintf(buf, "disabled\n"); 302414c70cbSLiam Girdwood else 303414c70cbSLiam Girdwood return sprintf(buf, "unknown\n"); 304414c70cbSLiam Girdwood } 305414c70cbSLiam Girdwood 3064fca9545SDavid Brownell static ssize_t regulator_state_show(struct device *dev, 3074fca9545SDavid Brownell struct device_attribute *attr, char *buf) 3084fca9545SDavid Brownell { 3094fca9545SDavid Brownell struct regulator_dev *rdev = dev_get_drvdata(dev); 3104fca9545SDavid Brownell 3114fca9545SDavid Brownell return regulator_print_state(buf, _regulator_is_enabled(rdev)); 3124fca9545SDavid Brownell } 3137ad68e2fSDavid Brownell static DEVICE_ATTR(state, 0444, regulator_state_show, NULL); 3144fca9545SDavid Brownell 315853116a1SDavid Brownell static ssize_t regulator_status_show(struct device *dev, 316853116a1SDavid Brownell struct device_attribute *attr, char *buf) 317853116a1SDavid Brownell { 318853116a1SDavid Brownell struct regulator_dev *rdev = dev_get_drvdata(dev); 319853116a1SDavid Brownell int status; 320853116a1SDavid Brownell char *label; 321853116a1SDavid Brownell 322853116a1SDavid Brownell status = rdev->desc->ops->get_status(rdev); 323853116a1SDavid Brownell if (status < 0) 324853116a1SDavid Brownell return status; 325853116a1SDavid Brownell 326853116a1SDavid Brownell switch (status) { 327853116a1SDavid Brownell case REGULATOR_STATUS_OFF: 328853116a1SDavid Brownell label = "off"; 329853116a1SDavid Brownell break; 330853116a1SDavid Brownell case REGULATOR_STATUS_ON: 331853116a1SDavid Brownell label = "on"; 332853116a1SDavid Brownell break; 333853116a1SDavid Brownell case REGULATOR_STATUS_ERROR: 334853116a1SDavid Brownell label = "error"; 335853116a1SDavid Brownell break; 336853116a1SDavid Brownell case REGULATOR_STATUS_FAST: 337853116a1SDavid Brownell label = "fast"; 338853116a1SDavid Brownell break; 339853116a1SDavid Brownell case REGULATOR_STATUS_NORMAL: 340853116a1SDavid Brownell label = "normal"; 341853116a1SDavid Brownell break; 342853116a1SDavid Brownell case REGULATOR_STATUS_IDLE: 343853116a1SDavid Brownell label = "idle"; 344853116a1SDavid Brownell break; 345853116a1SDavid Brownell case REGULATOR_STATUS_STANDBY: 346853116a1SDavid Brownell label = "standby"; 347853116a1SDavid Brownell break; 348853116a1SDavid Brownell default: 349853116a1SDavid Brownell return -ERANGE; 350853116a1SDavid Brownell } 351853116a1SDavid Brownell 352853116a1SDavid Brownell return sprintf(buf, "%s\n", label); 353853116a1SDavid Brownell } 354853116a1SDavid Brownell static DEVICE_ATTR(status, 0444, regulator_status_show, NULL); 355853116a1SDavid Brownell 356414c70cbSLiam Girdwood static ssize_t regulator_min_uA_show(struct device *dev, 357414c70cbSLiam Girdwood struct device_attribute *attr, char *buf) 358414c70cbSLiam Girdwood { 359a5766f11SLiam Girdwood struct regulator_dev *rdev = dev_get_drvdata(dev); 360414c70cbSLiam Girdwood 361414c70cbSLiam Girdwood if (!rdev->constraints) 362414c70cbSLiam Girdwood return sprintf(buf, "constraint not defined\n"); 363414c70cbSLiam Girdwood 364414c70cbSLiam Girdwood return sprintf(buf, "%d\n", rdev->constraints->min_uA); 365414c70cbSLiam Girdwood } 3667ad68e2fSDavid Brownell static DEVICE_ATTR(min_microamps, 0444, regulator_min_uA_show, NULL); 367414c70cbSLiam Girdwood 368414c70cbSLiam Girdwood static ssize_t regulator_max_uA_show(struct device *dev, 369414c70cbSLiam Girdwood struct device_attribute *attr, char *buf) 370414c70cbSLiam Girdwood { 371a5766f11SLiam Girdwood struct regulator_dev *rdev = dev_get_drvdata(dev); 372414c70cbSLiam Girdwood 373414c70cbSLiam Girdwood if (!rdev->constraints) 374414c70cbSLiam Girdwood return sprintf(buf, "constraint not defined\n"); 375414c70cbSLiam Girdwood 376414c70cbSLiam Girdwood return sprintf(buf, "%d\n", rdev->constraints->max_uA); 377414c70cbSLiam Girdwood } 3787ad68e2fSDavid Brownell static DEVICE_ATTR(max_microamps, 0444, regulator_max_uA_show, NULL); 379414c70cbSLiam Girdwood 380414c70cbSLiam Girdwood static ssize_t regulator_min_uV_show(struct device *dev, 381414c70cbSLiam Girdwood struct device_attribute *attr, char *buf) 382414c70cbSLiam Girdwood { 383a5766f11SLiam Girdwood struct regulator_dev *rdev = dev_get_drvdata(dev); 384414c70cbSLiam Girdwood 385414c70cbSLiam Girdwood if (!rdev->constraints) 386414c70cbSLiam Girdwood return sprintf(buf, "constraint not defined\n"); 387414c70cbSLiam Girdwood 388414c70cbSLiam Girdwood return sprintf(buf, "%d\n", rdev->constraints->min_uV); 389414c70cbSLiam Girdwood } 3907ad68e2fSDavid Brownell static DEVICE_ATTR(min_microvolts, 0444, regulator_min_uV_show, NULL); 391414c70cbSLiam Girdwood 392414c70cbSLiam Girdwood static ssize_t regulator_max_uV_show(struct device *dev, 393414c70cbSLiam Girdwood struct device_attribute *attr, char *buf) 394414c70cbSLiam Girdwood { 395a5766f11SLiam Girdwood struct regulator_dev *rdev = dev_get_drvdata(dev); 396414c70cbSLiam Girdwood 397414c70cbSLiam Girdwood if (!rdev->constraints) 398414c70cbSLiam Girdwood return sprintf(buf, "constraint not defined\n"); 399414c70cbSLiam Girdwood 400414c70cbSLiam Girdwood return sprintf(buf, "%d\n", rdev->constraints->max_uV); 401414c70cbSLiam Girdwood } 4027ad68e2fSDavid Brownell static DEVICE_ATTR(max_microvolts, 0444, regulator_max_uV_show, NULL); 403414c70cbSLiam Girdwood 404414c70cbSLiam Girdwood static ssize_t regulator_total_uA_show(struct device *dev, 405414c70cbSLiam Girdwood struct device_attribute *attr, char *buf) 406414c70cbSLiam Girdwood { 407a5766f11SLiam Girdwood struct regulator_dev *rdev = dev_get_drvdata(dev); 408414c70cbSLiam Girdwood struct regulator *regulator; 409414c70cbSLiam Girdwood int uA = 0; 410414c70cbSLiam Girdwood 411414c70cbSLiam Girdwood mutex_lock(&rdev->mutex); 412414c70cbSLiam Girdwood list_for_each_entry(regulator, &rdev->consumer_list, list) 413414c70cbSLiam Girdwood uA += regulator->uA_load; 414414c70cbSLiam Girdwood mutex_unlock(&rdev->mutex); 415414c70cbSLiam Girdwood return sprintf(buf, "%d\n", uA); 416414c70cbSLiam Girdwood } 4177ad68e2fSDavid Brownell static DEVICE_ATTR(requested_microamps, 0444, regulator_total_uA_show, NULL); 418414c70cbSLiam Girdwood 419414c70cbSLiam Girdwood static ssize_t regulator_num_users_show(struct device *dev, 420414c70cbSLiam Girdwood struct device_attribute *attr, char *buf) 421414c70cbSLiam Girdwood { 422a5766f11SLiam Girdwood struct regulator_dev *rdev = dev_get_drvdata(dev); 423414c70cbSLiam Girdwood return sprintf(buf, "%d\n", rdev->use_count); 424414c70cbSLiam Girdwood } 425414c70cbSLiam Girdwood 426414c70cbSLiam Girdwood static ssize_t regulator_type_show(struct device *dev, 427414c70cbSLiam Girdwood struct device_attribute *attr, char *buf) 428414c70cbSLiam Girdwood { 429a5766f11SLiam Girdwood struct regulator_dev *rdev = dev_get_drvdata(dev); 430414c70cbSLiam Girdwood 431414c70cbSLiam Girdwood switch (rdev->desc->type) { 432414c70cbSLiam Girdwood case REGULATOR_VOLTAGE: 433414c70cbSLiam Girdwood return sprintf(buf, "voltage\n"); 434414c70cbSLiam Girdwood case REGULATOR_CURRENT: 435414c70cbSLiam Girdwood return sprintf(buf, "current\n"); 436414c70cbSLiam Girdwood } 437414c70cbSLiam Girdwood return sprintf(buf, "unknown\n"); 438414c70cbSLiam Girdwood } 439414c70cbSLiam Girdwood 440414c70cbSLiam Girdwood static ssize_t regulator_suspend_mem_uV_show(struct device *dev, 441414c70cbSLiam Girdwood struct device_attribute *attr, char *buf) 442414c70cbSLiam Girdwood { 443a5766f11SLiam Girdwood struct regulator_dev *rdev = dev_get_drvdata(dev); 444414c70cbSLiam Girdwood 445414c70cbSLiam Girdwood return sprintf(buf, "%d\n", rdev->constraints->state_mem.uV); 446414c70cbSLiam Girdwood } 4477ad68e2fSDavid Brownell static DEVICE_ATTR(suspend_mem_microvolts, 0444, 4487ad68e2fSDavid Brownell regulator_suspend_mem_uV_show, NULL); 449414c70cbSLiam Girdwood 450414c70cbSLiam Girdwood static ssize_t regulator_suspend_disk_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_disk.uV); 456414c70cbSLiam Girdwood } 4577ad68e2fSDavid Brownell static DEVICE_ATTR(suspend_disk_microvolts, 0444, 4587ad68e2fSDavid Brownell regulator_suspend_disk_uV_show, NULL); 459414c70cbSLiam Girdwood 460414c70cbSLiam Girdwood static ssize_t regulator_suspend_standby_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_standby.uV); 466414c70cbSLiam Girdwood } 4677ad68e2fSDavid Brownell static DEVICE_ATTR(suspend_standby_microvolts, 0444, 4687ad68e2fSDavid Brownell regulator_suspend_standby_uV_show, NULL); 469414c70cbSLiam Girdwood 470414c70cbSLiam Girdwood static ssize_t regulator_suspend_mem_mode_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 4754fca9545SDavid Brownell return regulator_print_opmode(buf, 4764fca9545SDavid Brownell rdev->constraints->state_mem.mode); 477414c70cbSLiam Girdwood } 4787ad68e2fSDavid Brownell static DEVICE_ATTR(suspend_mem_mode, 0444, 4797ad68e2fSDavid Brownell regulator_suspend_mem_mode_show, NULL); 480414c70cbSLiam Girdwood 481414c70cbSLiam Girdwood static ssize_t regulator_suspend_disk_mode_show(struct device *dev, 482414c70cbSLiam Girdwood struct device_attribute *attr, char *buf) 483414c70cbSLiam Girdwood { 484a5766f11SLiam Girdwood struct regulator_dev *rdev = dev_get_drvdata(dev); 485414c70cbSLiam Girdwood 4864fca9545SDavid Brownell return regulator_print_opmode(buf, 4874fca9545SDavid Brownell rdev->constraints->state_disk.mode); 488414c70cbSLiam Girdwood } 4897ad68e2fSDavid Brownell static DEVICE_ATTR(suspend_disk_mode, 0444, 4907ad68e2fSDavid Brownell regulator_suspend_disk_mode_show, NULL); 491414c70cbSLiam Girdwood 492414c70cbSLiam Girdwood static ssize_t regulator_suspend_standby_mode_show(struct device *dev, 493414c70cbSLiam Girdwood struct device_attribute *attr, char *buf) 494414c70cbSLiam Girdwood { 495a5766f11SLiam Girdwood struct regulator_dev *rdev = dev_get_drvdata(dev); 496414c70cbSLiam Girdwood 4974fca9545SDavid Brownell return regulator_print_opmode(buf, 4984fca9545SDavid Brownell rdev->constraints->state_standby.mode); 499414c70cbSLiam Girdwood } 5007ad68e2fSDavid Brownell static DEVICE_ATTR(suspend_standby_mode, 0444, 5017ad68e2fSDavid Brownell regulator_suspend_standby_mode_show, NULL); 502414c70cbSLiam Girdwood 503414c70cbSLiam Girdwood static ssize_t regulator_suspend_mem_state_show(struct device *dev, 504414c70cbSLiam Girdwood struct device_attribute *attr, char *buf) 505414c70cbSLiam Girdwood { 506a5766f11SLiam Girdwood struct regulator_dev *rdev = dev_get_drvdata(dev); 507414c70cbSLiam Girdwood 5084fca9545SDavid Brownell return regulator_print_state(buf, 5094fca9545SDavid Brownell rdev->constraints->state_mem.enabled); 510414c70cbSLiam Girdwood } 5117ad68e2fSDavid Brownell static DEVICE_ATTR(suspend_mem_state, 0444, 5127ad68e2fSDavid Brownell regulator_suspend_mem_state_show, NULL); 513414c70cbSLiam Girdwood 514414c70cbSLiam Girdwood static ssize_t regulator_suspend_disk_state_show(struct device *dev, 515414c70cbSLiam Girdwood struct device_attribute *attr, char *buf) 516414c70cbSLiam Girdwood { 517a5766f11SLiam Girdwood struct regulator_dev *rdev = dev_get_drvdata(dev); 518414c70cbSLiam Girdwood 5194fca9545SDavid Brownell return regulator_print_state(buf, 5204fca9545SDavid Brownell rdev->constraints->state_disk.enabled); 521414c70cbSLiam Girdwood } 5227ad68e2fSDavid Brownell static DEVICE_ATTR(suspend_disk_state, 0444, 5237ad68e2fSDavid Brownell regulator_suspend_disk_state_show, NULL); 524414c70cbSLiam Girdwood 525414c70cbSLiam Girdwood static ssize_t regulator_suspend_standby_state_show(struct device *dev, 526414c70cbSLiam Girdwood struct device_attribute *attr, char *buf) 527414c70cbSLiam Girdwood { 528a5766f11SLiam Girdwood struct regulator_dev *rdev = dev_get_drvdata(dev); 529414c70cbSLiam Girdwood 5304fca9545SDavid Brownell return regulator_print_state(buf, 5314fca9545SDavid Brownell rdev->constraints->state_standby.enabled); 532414c70cbSLiam Girdwood } 5337ad68e2fSDavid Brownell static DEVICE_ATTR(suspend_standby_state, 0444, 5347ad68e2fSDavid Brownell regulator_suspend_standby_state_show, NULL); 535bc558a60SMark Brown 5367ad68e2fSDavid Brownell 5377ad68e2fSDavid Brownell /* 5387ad68e2fSDavid Brownell * These are the only attributes are present for all regulators. 5397ad68e2fSDavid Brownell * Other attributes are a function of regulator functionality. 5407ad68e2fSDavid Brownell */ 541414c70cbSLiam Girdwood static struct device_attribute regulator_dev_attrs[] = { 542bc558a60SMark Brown __ATTR(name, 0444, regulator_name_show, NULL), 543414c70cbSLiam Girdwood __ATTR(num_users, 0444, regulator_num_users_show, NULL), 544414c70cbSLiam Girdwood __ATTR(type, 0444, regulator_type_show, NULL), 545414c70cbSLiam Girdwood __ATTR_NULL, 546414c70cbSLiam Girdwood }; 547414c70cbSLiam Girdwood 548414c70cbSLiam Girdwood static void regulator_dev_release(struct device *dev) 549414c70cbSLiam Girdwood { 550a5766f11SLiam Girdwood struct regulator_dev *rdev = dev_get_drvdata(dev); 551414c70cbSLiam Girdwood kfree(rdev); 552414c70cbSLiam Girdwood } 553414c70cbSLiam Girdwood 554414c70cbSLiam Girdwood static struct class regulator_class = { 555414c70cbSLiam Girdwood .name = "regulator", 556414c70cbSLiam Girdwood .dev_release = regulator_dev_release, 557414c70cbSLiam Girdwood .dev_attrs = regulator_dev_attrs, 558414c70cbSLiam Girdwood }; 559414c70cbSLiam Girdwood 560414c70cbSLiam Girdwood /* Calculate the new optimum regulator operating mode based on the new total 561414c70cbSLiam Girdwood * consumer load. All locks held by caller */ 562414c70cbSLiam Girdwood static void drms_uA_update(struct regulator_dev *rdev) 563414c70cbSLiam Girdwood { 564414c70cbSLiam Girdwood struct regulator *sibling; 565414c70cbSLiam Girdwood int current_uA = 0, output_uV, input_uV, err; 566414c70cbSLiam Girdwood unsigned int mode; 567414c70cbSLiam Girdwood 568414c70cbSLiam Girdwood err = regulator_check_drms(rdev); 569414c70cbSLiam Girdwood if (err < 0 || !rdev->desc->ops->get_optimum_mode || 570414c70cbSLiam Girdwood !rdev->desc->ops->get_voltage || !rdev->desc->ops->set_mode); 571414c70cbSLiam Girdwood return; 572414c70cbSLiam Girdwood 573414c70cbSLiam Girdwood /* get output voltage */ 574414c70cbSLiam Girdwood output_uV = rdev->desc->ops->get_voltage(rdev); 575414c70cbSLiam Girdwood if (output_uV <= 0) 576414c70cbSLiam Girdwood return; 577414c70cbSLiam Girdwood 578414c70cbSLiam Girdwood /* get input voltage */ 579414c70cbSLiam Girdwood if (rdev->supply && rdev->supply->desc->ops->get_voltage) 580414c70cbSLiam Girdwood input_uV = rdev->supply->desc->ops->get_voltage(rdev->supply); 581414c70cbSLiam Girdwood else 582414c70cbSLiam Girdwood input_uV = rdev->constraints->input_uV; 583414c70cbSLiam Girdwood if (input_uV <= 0) 584414c70cbSLiam Girdwood return; 585414c70cbSLiam Girdwood 586414c70cbSLiam Girdwood /* calc total requested load */ 587414c70cbSLiam Girdwood list_for_each_entry(sibling, &rdev->consumer_list, list) 588414c70cbSLiam Girdwood current_uA += sibling->uA_load; 589414c70cbSLiam Girdwood 590414c70cbSLiam Girdwood /* now get the optimum mode for our new total regulator load */ 591414c70cbSLiam Girdwood mode = rdev->desc->ops->get_optimum_mode(rdev, input_uV, 592414c70cbSLiam Girdwood output_uV, current_uA); 593414c70cbSLiam Girdwood 594414c70cbSLiam Girdwood /* check the new mode is allowed */ 595414c70cbSLiam Girdwood err = regulator_check_mode(rdev, mode); 596414c70cbSLiam Girdwood if (err == 0) 597414c70cbSLiam Girdwood rdev->desc->ops->set_mode(rdev, mode); 598414c70cbSLiam Girdwood } 599414c70cbSLiam Girdwood 600414c70cbSLiam Girdwood static int suspend_set_state(struct regulator_dev *rdev, 601414c70cbSLiam Girdwood struct regulator_state *rstate) 602414c70cbSLiam Girdwood { 603414c70cbSLiam Girdwood int ret = 0; 604414c70cbSLiam Girdwood 605414c70cbSLiam Girdwood /* enable & disable are mandatory for suspend control */ 606414c70cbSLiam Girdwood if (!rdev->desc->ops->set_suspend_enable || 607a5766f11SLiam Girdwood !rdev->desc->ops->set_suspend_disable) { 608a5766f11SLiam Girdwood printk(KERN_ERR "%s: no way to set suspend state\n", 609a5766f11SLiam Girdwood __func__); 610414c70cbSLiam Girdwood return -EINVAL; 611a5766f11SLiam Girdwood } 612414c70cbSLiam Girdwood 613414c70cbSLiam Girdwood if (rstate->enabled) 614414c70cbSLiam Girdwood ret = rdev->desc->ops->set_suspend_enable(rdev); 615414c70cbSLiam Girdwood else 616414c70cbSLiam Girdwood ret = rdev->desc->ops->set_suspend_disable(rdev); 617414c70cbSLiam Girdwood if (ret < 0) { 618414c70cbSLiam Girdwood printk(KERN_ERR "%s: failed to enabled/disable\n", __func__); 619414c70cbSLiam Girdwood return ret; 620414c70cbSLiam Girdwood } 621414c70cbSLiam Girdwood 622414c70cbSLiam Girdwood if (rdev->desc->ops->set_suspend_voltage && rstate->uV > 0) { 623414c70cbSLiam Girdwood ret = rdev->desc->ops->set_suspend_voltage(rdev, rstate->uV); 624414c70cbSLiam Girdwood if (ret < 0) { 625414c70cbSLiam Girdwood printk(KERN_ERR "%s: failed to set voltage\n", 626414c70cbSLiam Girdwood __func__); 627414c70cbSLiam Girdwood return ret; 628414c70cbSLiam Girdwood } 629414c70cbSLiam Girdwood } 630414c70cbSLiam Girdwood 631414c70cbSLiam Girdwood if (rdev->desc->ops->set_suspend_mode && rstate->mode > 0) { 632414c70cbSLiam Girdwood ret = rdev->desc->ops->set_suspend_mode(rdev, rstate->mode); 633414c70cbSLiam Girdwood if (ret < 0) { 634414c70cbSLiam Girdwood printk(KERN_ERR "%s: failed to set mode\n", __func__); 635414c70cbSLiam Girdwood return ret; 636414c70cbSLiam Girdwood } 637414c70cbSLiam Girdwood } 638414c70cbSLiam Girdwood return ret; 639414c70cbSLiam Girdwood } 640414c70cbSLiam Girdwood 641414c70cbSLiam Girdwood /* locks held by caller */ 642414c70cbSLiam Girdwood static int suspend_prepare(struct regulator_dev *rdev, suspend_state_t state) 643414c70cbSLiam Girdwood { 644414c70cbSLiam Girdwood if (!rdev->constraints) 645414c70cbSLiam Girdwood return -EINVAL; 646414c70cbSLiam Girdwood 647414c70cbSLiam Girdwood switch (state) { 648414c70cbSLiam Girdwood case PM_SUSPEND_STANDBY: 649414c70cbSLiam Girdwood return suspend_set_state(rdev, 650414c70cbSLiam Girdwood &rdev->constraints->state_standby); 651414c70cbSLiam Girdwood case PM_SUSPEND_MEM: 652414c70cbSLiam Girdwood return suspend_set_state(rdev, 653414c70cbSLiam Girdwood &rdev->constraints->state_mem); 654414c70cbSLiam Girdwood case PM_SUSPEND_MAX: 655414c70cbSLiam Girdwood return suspend_set_state(rdev, 656414c70cbSLiam Girdwood &rdev->constraints->state_disk); 657414c70cbSLiam Girdwood default: 658414c70cbSLiam Girdwood return -EINVAL; 659414c70cbSLiam Girdwood } 660414c70cbSLiam Girdwood } 661414c70cbSLiam Girdwood 662414c70cbSLiam Girdwood static void print_constraints(struct regulator_dev *rdev) 663414c70cbSLiam Girdwood { 664414c70cbSLiam Girdwood struct regulation_constraints *constraints = rdev->constraints; 665414c70cbSLiam Girdwood char buf[80]; 666414c70cbSLiam Girdwood int count; 667414c70cbSLiam Girdwood 668414c70cbSLiam Girdwood if (rdev->desc->type == REGULATOR_VOLTAGE) { 669414c70cbSLiam Girdwood if (constraints->min_uV == constraints->max_uV) 670414c70cbSLiam Girdwood count = sprintf(buf, "%d mV ", 671414c70cbSLiam Girdwood constraints->min_uV / 1000); 672414c70cbSLiam Girdwood else 673414c70cbSLiam Girdwood count = sprintf(buf, "%d <--> %d mV ", 674414c70cbSLiam Girdwood constraints->min_uV / 1000, 675414c70cbSLiam Girdwood constraints->max_uV / 1000); 676414c70cbSLiam Girdwood } else { 677414c70cbSLiam Girdwood if (constraints->min_uA == constraints->max_uA) 678414c70cbSLiam Girdwood count = sprintf(buf, "%d mA ", 679414c70cbSLiam Girdwood constraints->min_uA / 1000); 680414c70cbSLiam Girdwood else 681414c70cbSLiam Girdwood count = sprintf(buf, "%d <--> %d mA ", 682414c70cbSLiam Girdwood constraints->min_uA / 1000, 683414c70cbSLiam Girdwood constraints->max_uA / 1000); 684414c70cbSLiam Girdwood } 685414c70cbSLiam Girdwood if (constraints->valid_modes_mask & REGULATOR_MODE_FAST) 686414c70cbSLiam Girdwood count += sprintf(buf + count, "fast "); 687414c70cbSLiam Girdwood if (constraints->valid_modes_mask & REGULATOR_MODE_NORMAL) 688414c70cbSLiam Girdwood count += sprintf(buf + count, "normal "); 689414c70cbSLiam Girdwood if (constraints->valid_modes_mask & REGULATOR_MODE_IDLE) 690414c70cbSLiam Girdwood count += sprintf(buf + count, "idle "); 691414c70cbSLiam Girdwood if (constraints->valid_modes_mask & REGULATOR_MODE_STANDBY) 692414c70cbSLiam Girdwood count += sprintf(buf + count, "standby"); 693414c70cbSLiam Girdwood 694414c70cbSLiam Girdwood printk(KERN_INFO "regulator: %s: %s\n", rdev->desc->name, buf); 695414c70cbSLiam Girdwood } 696414c70cbSLiam Girdwood 697a5766f11SLiam Girdwood /** 698a5766f11SLiam Girdwood * set_machine_constraints - sets regulator constraints 69969279fb9SMark Brown * @rdev: regulator source 700c8e7e464SMark Brown * @constraints: constraints to apply 701a5766f11SLiam Girdwood * 702a5766f11SLiam Girdwood * Allows platform initialisation code to define and constrain 703a5766f11SLiam Girdwood * regulator circuits e.g. valid voltage/current ranges, etc. NOTE: 704a5766f11SLiam Girdwood * Constraints *must* be set by platform code in order for some 705a5766f11SLiam Girdwood * regulator operations to proceed i.e. set_voltage, set_current_limit, 706a5766f11SLiam Girdwood * set_mode. 707a5766f11SLiam Girdwood */ 708a5766f11SLiam Girdwood static int set_machine_constraints(struct regulator_dev *rdev, 709a5766f11SLiam Girdwood struct regulation_constraints *constraints) 710a5766f11SLiam Girdwood { 711a5766f11SLiam Girdwood int ret = 0; 712e06f5b4fSMark Brown const char *name; 713e5fda26cSMark Brown struct regulator_ops *ops = rdev->desc->ops; 714e06f5b4fSMark Brown 715e06f5b4fSMark Brown if (constraints->name) 716e06f5b4fSMark Brown name = constraints->name; 717e06f5b4fSMark Brown else if (rdev->desc->name) 718e06f5b4fSMark Brown name = rdev->desc->name; 719e06f5b4fSMark Brown else 720e06f5b4fSMark Brown name = "regulator"; 721a5766f11SLiam Girdwood 722a5766f11SLiam Girdwood rdev->constraints = constraints; 723a5766f11SLiam Girdwood 724a5766f11SLiam Girdwood /* do we need to apply the constraint voltage */ 725a5766f11SLiam Girdwood if (rdev->constraints->apply_uV && 726a5766f11SLiam Girdwood rdev->constraints->min_uV == rdev->constraints->max_uV && 727e5fda26cSMark Brown ops->set_voltage) { 728e5fda26cSMark Brown ret = ops->set_voltage(rdev, 729a5766f11SLiam Girdwood rdev->constraints->min_uV, rdev->constraints->max_uV); 730a5766f11SLiam Girdwood if (ret < 0) { 731e06f5b4fSMark Brown printk(KERN_ERR "%s: failed to apply %duV constraint to %s\n", 732e06f5b4fSMark Brown __func__, 733e06f5b4fSMark Brown rdev->constraints->min_uV, name); 734a5766f11SLiam Girdwood rdev->constraints = NULL; 735a5766f11SLiam Girdwood goto out; 736a5766f11SLiam Girdwood } 737a5766f11SLiam Girdwood } 738a5766f11SLiam Girdwood 739a5766f11SLiam Girdwood /* are we enabled at boot time by firmware / bootloader */ 740a5766f11SLiam Girdwood if (rdev->constraints->boot_on) 741a5766f11SLiam Girdwood rdev->use_count = 1; 742a5766f11SLiam Girdwood 743a5766f11SLiam Girdwood /* do we need to setup our suspend state */ 744e06f5b4fSMark Brown if (constraints->initial_state) { 745a5766f11SLiam Girdwood ret = suspend_prepare(rdev, constraints->initial_state); 746e06f5b4fSMark Brown if (ret < 0) { 747e06f5b4fSMark Brown printk(KERN_ERR "%s: failed to set suspend state for %s\n", 748e06f5b4fSMark Brown __func__, name); 749e06f5b4fSMark Brown rdev->constraints = NULL; 750e06f5b4fSMark Brown goto out; 751e06f5b4fSMark Brown } 752e06f5b4fSMark Brown } 753a5766f11SLiam Girdwood 754e5fda26cSMark Brown /* if always_on is set then turn the regulator on if it's not 755e5fda26cSMark Brown * already on. */ 756e5fda26cSMark Brown if (constraints->always_on && ops->enable && 757e5fda26cSMark Brown ((ops->is_enabled && !ops->is_enabled(rdev)) || 758e5fda26cSMark Brown (!ops->is_enabled && !constraints->boot_on))) { 759e5fda26cSMark Brown ret = ops->enable(rdev); 760e5fda26cSMark Brown if (ret < 0) { 761e5fda26cSMark Brown printk(KERN_ERR "%s: failed to enable %s\n", 762e5fda26cSMark Brown __func__, name); 763e5fda26cSMark Brown rdev->constraints = NULL; 764e5fda26cSMark Brown goto out; 765e5fda26cSMark Brown } 766e5fda26cSMark Brown } 767e5fda26cSMark Brown 768a5766f11SLiam Girdwood print_constraints(rdev); 769a5766f11SLiam Girdwood out: 770a5766f11SLiam Girdwood return ret; 771a5766f11SLiam Girdwood } 772a5766f11SLiam Girdwood 773a5766f11SLiam Girdwood /** 774a5766f11SLiam Girdwood * set_supply - set regulator supply regulator 77569279fb9SMark Brown * @rdev: regulator name 77669279fb9SMark Brown * @supply_rdev: supply regulator name 777a5766f11SLiam Girdwood * 778a5766f11SLiam Girdwood * Called by platform initialisation code to set the supply regulator for this 779a5766f11SLiam Girdwood * regulator. This ensures that a regulators supply will also be enabled by the 780a5766f11SLiam Girdwood * core if it's child is enabled. 781a5766f11SLiam Girdwood */ 782a5766f11SLiam Girdwood static int set_supply(struct regulator_dev *rdev, 783a5766f11SLiam Girdwood struct regulator_dev *supply_rdev) 784a5766f11SLiam Girdwood { 785a5766f11SLiam Girdwood int err; 786a5766f11SLiam Girdwood 787a5766f11SLiam Girdwood err = sysfs_create_link(&rdev->dev.kobj, &supply_rdev->dev.kobj, 788a5766f11SLiam Girdwood "supply"); 789a5766f11SLiam Girdwood if (err) { 790a5766f11SLiam Girdwood printk(KERN_ERR 791a5766f11SLiam Girdwood "%s: could not add device link %s err %d\n", 792a5766f11SLiam Girdwood __func__, supply_rdev->dev.kobj.name, err); 793a5766f11SLiam Girdwood goto out; 794a5766f11SLiam Girdwood } 795a5766f11SLiam Girdwood rdev->supply = supply_rdev; 796a5766f11SLiam Girdwood list_add(&rdev->slist, &supply_rdev->supply_list); 797a5766f11SLiam Girdwood out: 798a5766f11SLiam Girdwood return err; 799a5766f11SLiam Girdwood } 800a5766f11SLiam Girdwood 801a5766f11SLiam Girdwood /** 802a5766f11SLiam Girdwood * set_consumer_device_supply: Bind a regulator to a symbolic supply 80369279fb9SMark Brown * @rdev: regulator source 80469279fb9SMark Brown * @consumer_dev: device the supply applies to 805a5766f11SLiam Girdwood * @supply: symbolic name for supply 806a5766f11SLiam Girdwood * 807a5766f11SLiam Girdwood * Allows platform initialisation code to map physical regulator 808a5766f11SLiam Girdwood * sources to symbolic names for supplies for use by devices. Devices 809a5766f11SLiam Girdwood * should use these symbolic names to request regulators, avoiding the 810a5766f11SLiam Girdwood * need to provide board-specific regulator names as platform data. 811a5766f11SLiam Girdwood */ 812a5766f11SLiam Girdwood static int set_consumer_device_supply(struct regulator_dev *rdev, 813a5766f11SLiam Girdwood struct device *consumer_dev, const char *supply) 814a5766f11SLiam Girdwood { 815a5766f11SLiam Girdwood struct regulator_map *node; 816a5766f11SLiam Girdwood 817a5766f11SLiam Girdwood if (supply == NULL) 818a5766f11SLiam Girdwood return -EINVAL; 819a5766f11SLiam Girdwood 8206001e13cSDavid Brownell list_for_each_entry(node, ®ulator_map_list, list) { 8216001e13cSDavid Brownell if (consumer_dev != node->dev) 8226001e13cSDavid Brownell continue; 8236001e13cSDavid Brownell if (strcmp(node->supply, supply) != 0) 8246001e13cSDavid Brownell continue; 8256001e13cSDavid Brownell 8266001e13cSDavid Brownell dev_dbg(consumer_dev, "%s/%s is '%s' supply; fail %s/%s\n", 8276001e13cSDavid Brownell dev_name(&node->regulator->dev), 8286001e13cSDavid Brownell node->regulator->desc->name, 8296001e13cSDavid Brownell supply, 8306001e13cSDavid Brownell dev_name(&rdev->dev), rdev->desc->name); 8316001e13cSDavid Brownell return -EBUSY; 8326001e13cSDavid Brownell } 8336001e13cSDavid Brownell 834a5766f11SLiam Girdwood node = kmalloc(sizeof(struct regulator_map), GFP_KERNEL); 835a5766f11SLiam Girdwood if (node == NULL) 836a5766f11SLiam Girdwood return -ENOMEM; 837a5766f11SLiam Girdwood 838a5766f11SLiam Girdwood node->regulator = rdev; 839a5766f11SLiam Girdwood node->dev = consumer_dev; 840a5766f11SLiam Girdwood node->supply = supply; 841a5766f11SLiam Girdwood 842a5766f11SLiam Girdwood list_add(&node->list, ®ulator_map_list); 843a5766f11SLiam Girdwood return 0; 844a5766f11SLiam Girdwood } 845a5766f11SLiam Girdwood 846a5766f11SLiam Girdwood static void unset_consumer_device_supply(struct regulator_dev *rdev, 847a5766f11SLiam Girdwood struct device *consumer_dev) 848a5766f11SLiam Girdwood { 849a5766f11SLiam Girdwood struct regulator_map *node, *n; 850a5766f11SLiam Girdwood 851a5766f11SLiam Girdwood list_for_each_entry_safe(node, n, ®ulator_map_list, list) { 852a5766f11SLiam Girdwood if (rdev == node->regulator && 853a5766f11SLiam Girdwood consumer_dev == node->dev) { 854a5766f11SLiam Girdwood list_del(&node->list); 855a5766f11SLiam Girdwood kfree(node); 856a5766f11SLiam Girdwood return; 857a5766f11SLiam Girdwood } 858a5766f11SLiam Girdwood } 859a5766f11SLiam Girdwood } 860a5766f11SLiam Girdwood 861414c70cbSLiam Girdwood #define REG_STR_SIZE 32 862414c70cbSLiam Girdwood 863414c70cbSLiam Girdwood static struct regulator *create_regulator(struct regulator_dev *rdev, 864414c70cbSLiam Girdwood struct device *dev, 865414c70cbSLiam Girdwood const char *supply_name) 866414c70cbSLiam Girdwood { 867414c70cbSLiam Girdwood struct regulator *regulator; 868414c70cbSLiam Girdwood char buf[REG_STR_SIZE]; 869414c70cbSLiam Girdwood int err, size; 870414c70cbSLiam Girdwood 871414c70cbSLiam Girdwood regulator = kzalloc(sizeof(*regulator), GFP_KERNEL); 872414c70cbSLiam Girdwood if (regulator == NULL) 873414c70cbSLiam Girdwood return NULL; 874414c70cbSLiam Girdwood 875414c70cbSLiam Girdwood mutex_lock(&rdev->mutex); 876414c70cbSLiam Girdwood regulator->rdev = rdev; 877414c70cbSLiam Girdwood list_add(®ulator->list, &rdev->consumer_list); 878414c70cbSLiam Girdwood 879414c70cbSLiam Girdwood if (dev) { 880414c70cbSLiam Girdwood /* create a 'requested_microamps_name' sysfs entry */ 881414c70cbSLiam Girdwood size = scnprintf(buf, REG_STR_SIZE, "microamps_requested_%s", 882414c70cbSLiam Girdwood supply_name); 883414c70cbSLiam Girdwood if (size >= REG_STR_SIZE) 884414c70cbSLiam Girdwood goto overflow_err; 885414c70cbSLiam Girdwood 886414c70cbSLiam Girdwood regulator->dev = dev; 887414c70cbSLiam Girdwood regulator->dev_attr.attr.name = kstrdup(buf, GFP_KERNEL); 888414c70cbSLiam Girdwood if (regulator->dev_attr.attr.name == NULL) 889414c70cbSLiam Girdwood goto attr_name_err; 890414c70cbSLiam Girdwood 891414c70cbSLiam Girdwood regulator->dev_attr.attr.owner = THIS_MODULE; 892414c70cbSLiam Girdwood regulator->dev_attr.attr.mode = 0444; 893414c70cbSLiam Girdwood regulator->dev_attr.show = device_requested_uA_show; 894414c70cbSLiam Girdwood err = device_create_file(dev, ®ulator->dev_attr); 895414c70cbSLiam Girdwood if (err < 0) { 896414c70cbSLiam Girdwood printk(KERN_WARNING "%s: could not add regulator_dev" 897414c70cbSLiam Girdwood " load sysfs\n", __func__); 898414c70cbSLiam Girdwood goto attr_name_err; 899414c70cbSLiam Girdwood } 900414c70cbSLiam Girdwood 901414c70cbSLiam Girdwood /* also add a link to the device sysfs entry */ 902414c70cbSLiam Girdwood size = scnprintf(buf, REG_STR_SIZE, "%s-%s", 903414c70cbSLiam Girdwood dev->kobj.name, supply_name); 904414c70cbSLiam Girdwood if (size >= REG_STR_SIZE) 905414c70cbSLiam Girdwood goto attr_err; 906414c70cbSLiam Girdwood 907414c70cbSLiam Girdwood regulator->supply_name = kstrdup(buf, GFP_KERNEL); 908414c70cbSLiam Girdwood if (regulator->supply_name == NULL) 909414c70cbSLiam Girdwood goto attr_err; 910414c70cbSLiam Girdwood 911414c70cbSLiam Girdwood err = sysfs_create_link(&rdev->dev.kobj, &dev->kobj, 912414c70cbSLiam Girdwood buf); 913414c70cbSLiam Girdwood if (err) { 914414c70cbSLiam Girdwood printk(KERN_WARNING 915414c70cbSLiam Girdwood "%s: could not add device link %s err %d\n", 916414c70cbSLiam Girdwood __func__, dev->kobj.name, err); 917414c70cbSLiam Girdwood device_remove_file(dev, ®ulator->dev_attr); 918414c70cbSLiam Girdwood goto link_name_err; 919414c70cbSLiam Girdwood } 920414c70cbSLiam Girdwood } 921414c70cbSLiam Girdwood mutex_unlock(&rdev->mutex); 922414c70cbSLiam Girdwood return regulator; 923414c70cbSLiam Girdwood link_name_err: 924414c70cbSLiam Girdwood kfree(regulator->supply_name); 925414c70cbSLiam Girdwood attr_err: 926414c70cbSLiam Girdwood device_remove_file(regulator->dev, ®ulator->dev_attr); 927414c70cbSLiam Girdwood attr_name_err: 928414c70cbSLiam Girdwood kfree(regulator->dev_attr.attr.name); 929414c70cbSLiam Girdwood overflow_err: 930414c70cbSLiam Girdwood list_del(®ulator->list); 931414c70cbSLiam Girdwood kfree(regulator); 932414c70cbSLiam Girdwood mutex_unlock(&rdev->mutex); 933414c70cbSLiam Girdwood return NULL; 934414c70cbSLiam Girdwood } 935414c70cbSLiam Girdwood 936414c70cbSLiam Girdwood /** 937414c70cbSLiam Girdwood * regulator_get - lookup and obtain a reference to a regulator. 938414c70cbSLiam Girdwood * @dev: device for regulator "consumer" 939414c70cbSLiam Girdwood * @id: Supply name or regulator ID. 940414c70cbSLiam Girdwood * 941414c70cbSLiam Girdwood * Returns a struct regulator corresponding to the regulator producer, 942414c70cbSLiam Girdwood * or IS_ERR() condition containing errno. Use of supply names 943414c70cbSLiam Girdwood * configured via regulator_set_device_supply() is strongly 944414c70cbSLiam Girdwood * encouraged. 945414c70cbSLiam Girdwood */ 946414c70cbSLiam Girdwood struct regulator *regulator_get(struct device *dev, const char *id) 947414c70cbSLiam Girdwood { 948414c70cbSLiam Girdwood struct regulator_dev *rdev; 949414c70cbSLiam Girdwood struct regulator_map *map; 950414c70cbSLiam Girdwood struct regulator *regulator = ERR_PTR(-ENODEV); 951414c70cbSLiam Girdwood 952414c70cbSLiam Girdwood if (id == NULL) { 953414c70cbSLiam Girdwood printk(KERN_ERR "regulator: get() with no identifier\n"); 954414c70cbSLiam Girdwood return regulator; 955414c70cbSLiam Girdwood } 956414c70cbSLiam Girdwood 957414c70cbSLiam Girdwood mutex_lock(®ulator_list_mutex); 958414c70cbSLiam Girdwood 959414c70cbSLiam Girdwood list_for_each_entry(map, ®ulator_map_list, list) { 960414c70cbSLiam Girdwood if (dev == map->dev && 961414c70cbSLiam Girdwood strcmp(map->supply, id) == 0) { 962a5766f11SLiam Girdwood rdev = map->regulator; 963414c70cbSLiam Girdwood goto found; 964414c70cbSLiam Girdwood } 965a5766f11SLiam Girdwood } 966414c70cbSLiam Girdwood printk(KERN_ERR "regulator: Unable to get requested regulator: %s\n", 967414c70cbSLiam Girdwood id); 968414c70cbSLiam Girdwood mutex_unlock(®ulator_list_mutex); 969414c70cbSLiam Girdwood return regulator; 970414c70cbSLiam Girdwood 971414c70cbSLiam Girdwood found: 972a5766f11SLiam Girdwood if (!try_module_get(rdev->owner)) 973a5766f11SLiam Girdwood goto out; 974a5766f11SLiam Girdwood 975414c70cbSLiam Girdwood regulator = create_regulator(rdev, dev, id); 976414c70cbSLiam Girdwood if (regulator == NULL) { 977414c70cbSLiam Girdwood regulator = ERR_PTR(-ENOMEM); 978414c70cbSLiam Girdwood module_put(rdev->owner); 979414c70cbSLiam Girdwood } 980414c70cbSLiam Girdwood 981a5766f11SLiam Girdwood out: 982414c70cbSLiam Girdwood mutex_unlock(®ulator_list_mutex); 983414c70cbSLiam Girdwood return regulator; 984414c70cbSLiam Girdwood } 985414c70cbSLiam Girdwood EXPORT_SYMBOL_GPL(regulator_get); 986414c70cbSLiam Girdwood 987414c70cbSLiam Girdwood /** 988414c70cbSLiam Girdwood * regulator_put - "free" the regulator source 989414c70cbSLiam Girdwood * @regulator: regulator source 990414c70cbSLiam Girdwood * 991414c70cbSLiam Girdwood * Note: drivers must ensure that all regulator_enable calls made on this 992414c70cbSLiam Girdwood * regulator source are balanced by regulator_disable calls prior to calling 993414c70cbSLiam Girdwood * this function. 994414c70cbSLiam Girdwood */ 995414c70cbSLiam Girdwood void regulator_put(struct regulator *regulator) 996414c70cbSLiam Girdwood { 997414c70cbSLiam Girdwood struct regulator_dev *rdev; 998414c70cbSLiam Girdwood 999414c70cbSLiam Girdwood if (regulator == NULL || IS_ERR(regulator)) 1000414c70cbSLiam Girdwood return; 1001414c70cbSLiam Girdwood 1002414c70cbSLiam Girdwood mutex_lock(®ulator_list_mutex); 1003414c70cbSLiam Girdwood rdev = regulator->rdev; 1004414c70cbSLiam Girdwood 1005412aec61SDavid Brownell if (WARN(regulator->enabled, "Releasing supply %s while enabled\n", 1006412aec61SDavid Brownell regulator->supply_name)) 1007412aec61SDavid Brownell _regulator_disable(rdev); 1008412aec61SDavid Brownell 1009414c70cbSLiam Girdwood /* remove any sysfs entries */ 1010414c70cbSLiam Girdwood if (regulator->dev) { 1011414c70cbSLiam Girdwood sysfs_remove_link(&rdev->dev.kobj, regulator->supply_name); 1012414c70cbSLiam Girdwood kfree(regulator->supply_name); 1013414c70cbSLiam Girdwood device_remove_file(regulator->dev, ®ulator->dev_attr); 1014414c70cbSLiam Girdwood kfree(regulator->dev_attr.attr.name); 1015414c70cbSLiam Girdwood } 1016414c70cbSLiam Girdwood list_del(®ulator->list); 1017414c70cbSLiam Girdwood kfree(regulator); 1018414c70cbSLiam Girdwood 1019414c70cbSLiam Girdwood module_put(rdev->owner); 1020414c70cbSLiam Girdwood mutex_unlock(®ulator_list_mutex); 1021414c70cbSLiam Girdwood } 1022414c70cbSLiam Girdwood EXPORT_SYMBOL_GPL(regulator_put); 1023414c70cbSLiam Girdwood 1024414c70cbSLiam Girdwood /* locks held by regulator_enable() */ 1025414c70cbSLiam Girdwood static int _regulator_enable(struct regulator_dev *rdev) 1026414c70cbSLiam Girdwood { 1027414c70cbSLiam Girdwood int ret = -EINVAL; 1028414c70cbSLiam Girdwood 1029414c70cbSLiam Girdwood if (!rdev->constraints) { 1030414c70cbSLiam Girdwood printk(KERN_ERR "%s: %s has no constraints\n", 1031414c70cbSLiam Girdwood __func__, rdev->desc->name); 1032414c70cbSLiam Girdwood return ret; 1033414c70cbSLiam Girdwood } 1034414c70cbSLiam Girdwood 1035414c70cbSLiam Girdwood /* do we need to enable the supply regulator first */ 1036414c70cbSLiam Girdwood if (rdev->supply) { 1037414c70cbSLiam Girdwood ret = _regulator_enable(rdev->supply); 1038414c70cbSLiam Girdwood if (ret < 0) { 1039414c70cbSLiam Girdwood printk(KERN_ERR "%s: failed to enable %s: %d\n", 1040414c70cbSLiam Girdwood __func__, rdev->desc->name, ret); 1041414c70cbSLiam Girdwood return ret; 1042414c70cbSLiam Girdwood } 1043414c70cbSLiam Girdwood } 1044414c70cbSLiam Girdwood 1045414c70cbSLiam Girdwood /* check voltage and requested load before enabling */ 1046414c70cbSLiam Girdwood if (rdev->desc->ops->enable) { 1047414c70cbSLiam Girdwood 1048414c70cbSLiam Girdwood if (rdev->constraints && 1049414c70cbSLiam Girdwood (rdev->constraints->valid_ops_mask & 1050414c70cbSLiam Girdwood REGULATOR_CHANGE_DRMS)) 1051414c70cbSLiam Girdwood drms_uA_update(rdev); 1052414c70cbSLiam Girdwood 1053414c70cbSLiam Girdwood ret = rdev->desc->ops->enable(rdev); 1054414c70cbSLiam Girdwood if (ret < 0) { 1055414c70cbSLiam Girdwood printk(KERN_ERR "%s: failed to enable %s: %d\n", 1056414c70cbSLiam Girdwood __func__, rdev->desc->name, ret); 1057414c70cbSLiam Girdwood return ret; 1058414c70cbSLiam Girdwood } 1059414c70cbSLiam Girdwood rdev->use_count++; 1060414c70cbSLiam Girdwood return ret; 1061414c70cbSLiam Girdwood } 1062414c70cbSLiam Girdwood 1063414c70cbSLiam Girdwood return ret; 1064414c70cbSLiam Girdwood } 1065414c70cbSLiam Girdwood 1066414c70cbSLiam Girdwood /** 1067414c70cbSLiam Girdwood * regulator_enable - enable regulator output 1068414c70cbSLiam Girdwood * @regulator: regulator source 1069414c70cbSLiam Girdwood * 1070cf7bbcdfSMark Brown * Request that the regulator be enabled with the regulator output at 1071cf7bbcdfSMark Brown * the predefined voltage or current value. Calls to regulator_enable() 1072cf7bbcdfSMark Brown * must be balanced with calls to regulator_disable(). 1073cf7bbcdfSMark Brown * 1074414c70cbSLiam Girdwood * NOTE: the output value can be set by other drivers, boot loader or may be 1075cf7bbcdfSMark Brown * hardwired in the regulator. 1076414c70cbSLiam Girdwood */ 1077414c70cbSLiam Girdwood int regulator_enable(struct regulator *regulator) 1078414c70cbSLiam Girdwood { 1079412aec61SDavid Brownell struct regulator_dev *rdev = regulator->rdev; 1080412aec61SDavid Brownell int ret = 0; 1081414c70cbSLiam Girdwood 1082412aec61SDavid Brownell mutex_lock(&rdev->mutex); 1083412aec61SDavid Brownell if (regulator->enabled == 0) 1084412aec61SDavid Brownell ret = _regulator_enable(rdev); 1085412aec61SDavid Brownell else if (regulator->enabled < 0) 1086412aec61SDavid Brownell ret = -EIO; 1087412aec61SDavid Brownell if (ret == 0) 1088412aec61SDavid Brownell regulator->enabled++; 1089412aec61SDavid Brownell mutex_unlock(&rdev->mutex); 1090414c70cbSLiam Girdwood return ret; 1091414c70cbSLiam Girdwood } 1092414c70cbSLiam Girdwood EXPORT_SYMBOL_GPL(regulator_enable); 1093414c70cbSLiam Girdwood 1094414c70cbSLiam Girdwood /* locks held by regulator_disable() */ 1095414c70cbSLiam Girdwood static int _regulator_disable(struct regulator_dev *rdev) 1096414c70cbSLiam Girdwood { 1097414c70cbSLiam Girdwood int ret = 0; 1098414c70cbSLiam Girdwood 1099414c70cbSLiam Girdwood /* are we the last user and permitted to disable ? */ 1100414c70cbSLiam Girdwood if (rdev->use_count == 1 && !rdev->constraints->always_on) { 1101414c70cbSLiam Girdwood 1102414c70cbSLiam Girdwood /* we are last user */ 1103414c70cbSLiam Girdwood if (rdev->desc->ops->disable) { 1104414c70cbSLiam Girdwood ret = rdev->desc->ops->disable(rdev); 1105414c70cbSLiam Girdwood if (ret < 0) { 1106414c70cbSLiam Girdwood printk(KERN_ERR "%s: failed to disable %s\n", 1107414c70cbSLiam Girdwood __func__, rdev->desc->name); 1108414c70cbSLiam Girdwood return ret; 1109414c70cbSLiam Girdwood } 1110414c70cbSLiam Girdwood } 1111414c70cbSLiam Girdwood 1112414c70cbSLiam Girdwood /* decrease our supplies ref count and disable if required */ 1113414c70cbSLiam Girdwood if (rdev->supply) 1114414c70cbSLiam Girdwood _regulator_disable(rdev->supply); 1115414c70cbSLiam Girdwood 1116414c70cbSLiam Girdwood rdev->use_count = 0; 1117414c70cbSLiam Girdwood } else if (rdev->use_count > 1) { 1118414c70cbSLiam Girdwood 1119414c70cbSLiam Girdwood if (rdev->constraints && 1120414c70cbSLiam Girdwood (rdev->constraints->valid_ops_mask & 1121414c70cbSLiam Girdwood REGULATOR_CHANGE_DRMS)) 1122414c70cbSLiam Girdwood drms_uA_update(rdev); 1123414c70cbSLiam Girdwood 1124414c70cbSLiam Girdwood rdev->use_count--; 1125414c70cbSLiam Girdwood } 1126414c70cbSLiam Girdwood return ret; 1127414c70cbSLiam Girdwood } 1128414c70cbSLiam Girdwood 1129414c70cbSLiam Girdwood /** 1130414c70cbSLiam Girdwood * regulator_disable - disable regulator output 1131414c70cbSLiam Girdwood * @regulator: regulator source 1132414c70cbSLiam Girdwood * 1133cf7bbcdfSMark Brown * Disable the regulator output voltage or current. Calls to 1134cf7bbcdfSMark Brown * regulator_enable() must be balanced with calls to 1135cf7bbcdfSMark Brown * regulator_disable(). 113669279fb9SMark Brown * 1137414c70cbSLiam Girdwood * NOTE: this will only disable the regulator output if no other consumer 1138cf7bbcdfSMark Brown * devices have it enabled, the regulator device supports disabling and 1139cf7bbcdfSMark Brown * machine constraints permit this operation. 1140414c70cbSLiam Girdwood */ 1141414c70cbSLiam Girdwood int regulator_disable(struct regulator *regulator) 1142414c70cbSLiam Girdwood { 1143412aec61SDavid Brownell struct regulator_dev *rdev = regulator->rdev; 1144412aec61SDavid Brownell int ret = 0; 1145414c70cbSLiam Girdwood 1146412aec61SDavid Brownell mutex_lock(&rdev->mutex); 1147412aec61SDavid Brownell if (regulator->enabled == 1) { 1148412aec61SDavid Brownell ret = _regulator_disable(rdev); 1149412aec61SDavid Brownell if (ret == 0) 1150414c70cbSLiam Girdwood regulator->uA_load = 0; 1151412aec61SDavid Brownell } else if (WARN(regulator->enabled <= 0, 1152412aec61SDavid Brownell "unbalanced disables for supply %s\n", 1153412aec61SDavid Brownell regulator->supply_name)) 1154412aec61SDavid Brownell ret = -EIO; 1155412aec61SDavid Brownell if (ret == 0) 1156412aec61SDavid Brownell regulator->enabled--; 1157412aec61SDavid Brownell mutex_unlock(&rdev->mutex); 1158414c70cbSLiam Girdwood return ret; 1159414c70cbSLiam Girdwood } 1160414c70cbSLiam Girdwood EXPORT_SYMBOL_GPL(regulator_disable); 1161414c70cbSLiam Girdwood 1162414c70cbSLiam Girdwood /* locks held by regulator_force_disable() */ 1163414c70cbSLiam Girdwood static int _regulator_force_disable(struct regulator_dev *rdev) 1164414c70cbSLiam Girdwood { 1165414c70cbSLiam Girdwood int ret = 0; 1166414c70cbSLiam Girdwood 1167414c70cbSLiam Girdwood /* force disable */ 1168414c70cbSLiam Girdwood if (rdev->desc->ops->disable) { 1169414c70cbSLiam Girdwood /* ah well, who wants to live forever... */ 1170414c70cbSLiam Girdwood ret = rdev->desc->ops->disable(rdev); 1171414c70cbSLiam Girdwood if (ret < 0) { 1172414c70cbSLiam Girdwood printk(KERN_ERR "%s: failed to force disable %s\n", 1173414c70cbSLiam Girdwood __func__, rdev->desc->name); 1174414c70cbSLiam Girdwood return ret; 1175414c70cbSLiam Girdwood } 1176414c70cbSLiam Girdwood /* notify other consumers that power has been forced off */ 1177414c70cbSLiam Girdwood _notifier_call_chain(rdev, REGULATOR_EVENT_FORCE_DISABLE, 1178414c70cbSLiam Girdwood NULL); 1179414c70cbSLiam Girdwood } 1180414c70cbSLiam Girdwood 1181414c70cbSLiam Girdwood /* decrease our supplies ref count and disable if required */ 1182414c70cbSLiam Girdwood if (rdev->supply) 1183414c70cbSLiam Girdwood _regulator_disable(rdev->supply); 1184414c70cbSLiam Girdwood 1185414c70cbSLiam Girdwood rdev->use_count = 0; 1186414c70cbSLiam Girdwood return ret; 1187414c70cbSLiam Girdwood } 1188414c70cbSLiam Girdwood 1189414c70cbSLiam Girdwood /** 1190414c70cbSLiam Girdwood * regulator_force_disable - force disable regulator output 1191414c70cbSLiam Girdwood * @regulator: regulator source 1192414c70cbSLiam Girdwood * 1193414c70cbSLiam Girdwood * Forcibly disable the regulator output voltage or current. 1194414c70cbSLiam Girdwood * NOTE: this *will* disable the regulator output even if other consumer 1195414c70cbSLiam Girdwood * devices have it enabled. This should be used for situations when device 1196414c70cbSLiam Girdwood * damage will likely occur if the regulator is not disabled (e.g. over temp). 1197414c70cbSLiam Girdwood */ 1198414c70cbSLiam Girdwood int regulator_force_disable(struct regulator *regulator) 1199414c70cbSLiam Girdwood { 1200414c70cbSLiam Girdwood int ret; 1201414c70cbSLiam Girdwood 1202414c70cbSLiam Girdwood mutex_lock(®ulator->rdev->mutex); 1203414c70cbSLiam Girdwood regulator->enabled = 0; 1204414c70cbSLiam Girdwood regulator->uA_load = 0; 1205414c70cbSLiam Girdwood ret = _regulator_force_disable(regulator->rdev); 1206414c70cbSLiam Girdwood mutex_unlock(®ulator->rdev->mutex); 1207414c70cbSLiam Girdwood return ret; 1208414c70cbSLiam Girdwood } 1209414c70cbSLiam Girdwood EXPORT_SYMBOL_GPL(regulator_force_disable); 1210414c70cbSLiam Girdwood 1211414c70cbSLiam Girdwood static int _regulator_is_enabled(struct regulator_dev *rdev) 1212414c70cbSLiam Girdwood { 1213414c70cbSLiam Girdwood int ret; 1214414c70cbSLiam Girdwood 1215414c70cbSLiam Girdwood mutex_lock(&rdev->mutex); 1216414c70cbSLiam Girdwood 1217414c70cbSLiam Girdwood /* sanity check */ 1218414c70cbSLiam Girdwood if (!rdev->desc->ops->is_enabled) { 1219414c70cbSLiam Girdwood ret = -EINVAL; 1220414c70cbSLiam Girdwood goto out; 1221414c70cbSLiam Girdwood } 1222414c70cbSLiam Girdwood 1223414c70cbSLiam Girdwood ret = rdev->desc->ops->is_enabled(rdev); 1224414c70cbSLiam Girdwood out: 1225414c70cbSLiam Girdwood mutex_unlock(&rdev->mutex); 1226414c70cbSLiam Girdwood return ret; 1227414c70cbSLiam Girdwood } 1228414c70cbSLiam Girdwood 1229414c70cbSLiam Girdwood /** 1230414c70cbSLiam Girdwood * regulator_is_enabled - is the regulator output enabled 1231414c70cbSLiam Girdwood * @regulator: regulator source 1232414c70cbSLiam Girdwood * 1233412aec61SDavid Brownell * Returns positive if the regulator driver backing the source/client 1234412aec61SDavid Brownell * has requested that the device be enabled, zero if it hasn't, else a 1235412aec61SDavid Brownell * negative errno code. 1236412aec61SDavid Brownell * 1237412aec61SDavid Brownell * Note that the device backing this regulator handle can have multiple 1238412aec61SDavid Brownell * users, so it might be enabled even if regulator_enable() was never 1239412aec61SDavid Brownell * called for this particular source. 1240414c70cbSLiam Girdwood */ 1241414c70cbSLiam Girdwood int regulator_is_enabled(struct regulator *regulator) 1242414c70cbSLiam Girdwood { 1243414c70cbSLiam Girdwood return _regulator_is_enabled(regulator->rdev); 1244414c70cbSLiam Girdwood } 1245414c70cbSLiam Girdwood EXPORT_SYMBOL_GPL(regulator_is_enabled); 1246414c70cbSLiam Girdwood 1247414c70cbSLiam Girdwood /** 1248414c70cbSLiam Girdwood * regulator_set_voltage - set regulator output voltage 1249414c70cbSLiam Girdwood * @regulator: regulator source 1250414c70cbSLiam Girdwood * @min_uV: Minimum required voltage in uV 1251414c70cbSLiam Girdwood * @max_uV: Maximum acceptable voltage in uV 1252414c70cbSLiam Girdwood * 1253414c70cbSLiam Girdwood * Sets a voltage regulator to the desired output voltage. This can be set 1254414c70cbSLiam Girdwood * during any regulator state. IOW, regulator can be disabled or enabled. 1255414c70cbSLiam Girdwood * 1256414c70cbSLiam Girdwood * If the regulator is enabled then the voltage will change to the new value 1257414c70cbSLiam Girdwood * immediately otherwise if the regulator is disabled the regulator will 1258414c70cbSLiam Girdwood * output at the new voltage when enabled. 1259414c70cbSLiam Girdwood * 1260414c70cbSLiam Girdwood * NOTE: If the regulator is shared between several devices then the lowest 1261414c70cbSLiam Girdwood * request voltage that meets the system constraints will be used. 126269279fb9SMark Brown * Regulator system constraints must be set for this regulator before 1263414c70cbSLiam Girdwood * calling this function otherwise this call will fail. 1264414c70cbSLiam Girdwood */ 1265414c70cbSLiam Girdwood int regulator_set_voltage(struct regulator *regulator, int min_uV, int max_uV) 1266414c70cbSLiam Girdwood { 1267414c70cbSLiam Girdwood struct regulator_dev *rdev = regulator->rdev; 1268414c70cbSLiam Girdwood int ret; 1269414c70cbSLiam Girdwood 1270414c70cbSLiam Girdwood mutex_lock(&rdev->mutex); 1271414c70cbSLiam Girdwood 1272414c70cbSLiam Girdwood /* sanity check */ 1273414c70cbSLiam Girdwood if (!rdev->desc->ops->set_voltage) { 1274414c70cbSLiam Girdwood ret = -EINVAL; 1275414c70cbSLiam Girdwood goto out; 1276414c70cbSLiam Girdwood } 1277414c70cbSLiam Girdwood 1278414c70cbSLiam Girdwood /* constraints check */ 1279414c70cbSLiam Girdwood ret = regulator_check_voltage(rdev, &min_uV, &max_uV); 1280414c70cbSLiam Girdwood if (ret < 0) 1281414c70cbSLiam Girdwood goto out; 1282414c70cbSLiam Girdwood regulator->min_uV = min_uV; 1283414c70cbSLiam Girdwood regulator->max_uV = max_uV; 1284414c70cbSLiam Girdwood ret = rdev->desc->ops->set_voltage(rdev, min_uV, max_uV); 1285414c70cbSLiam Girdwood 1286414c70cbSLiam Girdwood out: 1287b136fb44SJonathan Cameron _notifier_call_chain(rdev, REGULATOR_EVENT_VOLTAGE_CHANGE, NULL); 1288414c70cbSLiam Girdwood mutex_unlock(&rdev->mutex); 1289414c70cbSLiam Girdwood return ret; 1290414c70cbSLiam Girdwood } 1291414c70cbSLiam Girdwood EXPORT_SYMBOL_GPL(regulator_set_voltage); 1292414c70cbSLiam Girdwood 1293414c70cbSLiam Girdwood static int _regulator_get_voltage(struct regulator_dev *rdev) 1294414c70cbSLiam Girdwood { 1295414c70cbSLiam Girdwood /* sanity check */ 1296414c70cbSLiam Girdwood if (rdev->desc->ops->get_voltage) 1297414c70cbSLiam Girdwood return rdev->desc->ops->get_voltage(rdev); 1298414c70cbSLiam Girdwood else 1299414c70cbSLiam Girdwood return -EINVAL; 1300414c70cbSLiam Girdwood } 1301414c70cbSLiam Girdwood 1302414c70cbSLiam Girdwood /** 1303414c70cbSLiam Girdwood * regulator_get_voltage - get regulator output voltage 1304414c70cbSLiam Girdwood * @regulator: regulator source 1305414c70cbSLiam Girdwood * 1306414c70cbSLiam Girdwood * This returns the current regulator voltage in uV. 1307414c70cbSLiam Girdwood * 1308414c70cbSLiam Girdwood * NOTE: If the regulator is disabled it will return the voltage value. This 1309414c70cbSLiam Girdwood * function should not be used to determine regulator state. 1310414c70cbSLiam Girdwood */ 1311414c70cbSLiam Girdwood int regulator_get_voltage(struct regulator *regulator) 1312414c70cbSLiam Girdwood { 1313414c70cbSLiam Girdwood int ret; 1314414c70cbSLiam Girdwood 1315414c70cbSLiam Girdwood mutex_lock(®ulator->rdev->mutex); 1316414c70cbSLiam Girdwood 1317414c70cbSLiam Girdwood ret = _regulator_get_voltage(regulator->rdev); 1318414c70cbSLiam Girdwood 1319414c70cbSLiam Girdwood mutex_unlock(®ulator->rdev->mutex); 1320414c70cbSLiam Girdwood 1321414c70cbSLiam Girdwood return ret; 1322414c70cbSLiam Girdwood } 1323414c70cbSLiam Girdwood EXPORT_SYMBOL_GPL(regulator_get_voltage); 1324414c70cbSLiam Girdwood 1325414c70cbSLiam Girdwood /** 1326414c70cbSLiam Girdwood * regulator_set_current_limit - set regulator output current limit 1327414c70cbSLiam Girdwood * @regulator: regulator source 1328414c70cbSLiam Girdwood * @min_uA: Minimuum supported current in uA 1329414c70cbSLiam Girdwood * @max_uA: Maximum supported current in uA 1330414c70cbSLiam Girdwood * 1331414c70cbSLiam Girdwood * Sets current sink to the desired output current. This can be set during 1332414c70cbSLiam Girdwood * any regulator state. IOW, regulator can be disabled or enabled. 1333414c70cbSLiam Girdwood * 1334414c70cbSLiam Girdwood * If the regulator is enabled then the current will change to the new value 1335414c70cbSLiam Girdwood * immediately otherwise if the regulator is disabled the regulator will 1336414c70cbSLiam Girdwood * output at the new current when enabled. 1337414c70cbSLiam Girdwood * 1338414c70cbSLiam Girdwood * NOTE: Regulator system constraints must be set for this regulator before 1339414c70cbSLiam Girdwood * calling this function otherwise this call will fail. 1340414c70cbSLiam Girdwood */ 1341414c70cbSLiam Girdwood int regulator_set_current_limit(struct regulator *regulator, 1342414c70cbSLiam Girdwood int min_uA, int max_uA) 1343414c70cbSLiam Girdwood { 1344414c70cbSLiam Girdwood struct regulator_dev *rdev = regulator->rdev; 1345414c70cbSLiam Girdwood int ret; 1346414c70cbSLiam Girdwood 1347414c70cbSLiam Girdwood mutex_lock(&rdev->mutex); 1348414c70cbSLiam Girdwood 1349414c70cbSLiam Girdwood /* sanity check */ 1350414c70cbSLiam Girdwood if (!rdev->desc->ops->set_current_limit) { 1351414c70cbSLiam Girdwood ret = -EINVAL; 1352414c70cbSLiam Girdwood goto out; 1353414c70cbSLiam Girdwood } 1354414c70cbSLiam Girdwood 1355414c70cbSLiam Girdwood /* constraints check */ 1356414c70cbSLiam Girdwood ret = regulator_check_current_limit(rdev, &min_uA, &max_uA); 1357414c70cbSLiam Girdwood if (ret < 0) 1358414c70cbSLiam Girdwood goto out; 1359414c70cbSLiam Girdwood 1360414c70cbSLiam Girdwood ret = rdev->desc->ops->set_current_limit(rdev, min_uA, max_uA); 1361414c70cbSLiam Girdwood out: 1362414c70cbSLiam Girdwood mutex_unlock(&rdev->mutex); 1363414c70cbSLiam Girdwood return ret; 1364414c70cbSLiam Girdwood } 1365414c70cbSLiam Girdwood EXPORT_SYMBOL_GPL(regulator_set_current_limit); 1366414c70cbSLiam Girdwood 1367414c70cbSLiam Girdwood static int _regulator_get_current_limit(struct regulator_dev *rdev) 1368414c70cbSLiam Girdwood { 1369414c70cbSLiam Girdwood int ret; 1370414c70cbSLiam Girdwood 1371414c70cbSLiam Girdwood mutex_lock(&rdev->mutex); 1372414c70cbSLiam Girdwood 1373414c70cbSLiam Girdwood /* sanity check */ 1374414c70cbSLiam Girdwood if (!rdev->desc->ops->get_current_limit) { 1375414c70cbSLiam Girdwood ret = -EINVAL; 1376414c70cbSLiam Girdwood goto out; 1377414c70cbSLiam Girdwood } 1378414c70cbSLiam Girdwood 1379414c70cbSLiam Girdwood ret = rdev->desc->ops->get_current_limit(rdev); 1380414c70cbSLiam Girdwood out: 1381414c70cbSLiam Girdwood mutex_unlock(&rdev->mutex); 1382414c70cbSLiam Girdwood return ret; 1383414c70cbSLiam Girdwood } 1384414c70cbSLiam Girdwood 1385414c70cbSLiam Girdwood /** 1386414c70cbSLiam Girdwood * regulator_get_current_limit - get regulator output current 1387414c70cbSLiam Girdwood * @regulator: regulator source 1388414c70cbSLiam Girdwood * 1389414c70cbSLiam Girdwood * This returns the current supplied by the specified current sink in uA. 1390414c70cbSLiam Girdwood * 1391414c70cbSLiam Girdwood * NOTE: If the regulator is disabled it will return the current value. This 1392414c70cbSLiam Girdwood * function should not be used to determine regulator state. 1393414c70cbSLiam Girdwood */ 1394414c70cbSLiam Girdwood int regulator_get_current_limit(struct regulator *regulator) 1395414c70cbSLiam Girdwood { 1396414c70cbSLiam Girdwood return _regulator_get_current_limit(regulator->rdev); 1397414c70cbSLiam Girdwood } 1398414c70cbSLiam Girdwood EXPORT_SYMBOL_GPL(regulator_get_current_limit); 1399414c70cbSLiam Girdwood 1400414c70cbSLiam Girdwood /** 1401414c70cbSLiam Girdwood * regulator_set_mode - set regulator operating mode 1402414c70cbSLiam Girdwood * @regulator: regulator source 1403414c70cbSLiam Girdwood * @mode: operating mode - one of the REGULATOR_MODE constants 1404414c70cbSLiam Girdwood * 1405414c70cbSLiam Girdwood * Set regulator operating mode to increase regulator efficiency or improve 1406414c70cbSLiam Girdwood * regulation performance. 1407414c70cbSLiam Girdwood * 1408414c70cbSLiam Girdwood * NOTE: Regulator system constraints must be set for this regulator before 1409414c70cbSLiam Girdwood * calling this function otherwise this call will fail. 1410414c70cbSLiam Girdwood */ 1411414c70cbSLiam Girdwood int regulator_set_mode(struct regulator *regulator, unsigned int mode) 1412414c70cbSLiam Girdwood { 1413414c70cbSLiam Girdwood struct regulator_dev *rdev = regulator->rdev; 1414414c70cbSLiam Girdwood int ret; 1415414c70cbSLiam Girdwood 1416414c70cbSLiam Girdwood mutex_lock(&rdev->mutex); 1417414c70cbSLiam Girdwood 1418414c70cbSLiam Girdwood /* sanity check */ 1419414c70cbSLiam Girdwood if (!rdev->desc->ops->set_mode) { 1420414c70cbSLiam Girdwood ret = -EINVAL; 1421414c70cbSLiam Girdwood goto out; 1422414c70cbSLiam Girdwood } 1423414c70cbSLiam Girdwood 1424414c70cbSLiam Girdwood /* constraints check */ 1425414c70cbSLiam Girdwood ret = regulator_check_mode(rdev, mode); 1426414c70cbSLiam Girdwood if (ret < 0) 1427414c70cbSLiam Girdwood goto out; 1428414c70cbSLiam Girdwood 1429414c70cbSLiam Girdwood ret = rdev->desc->ops->set_mode(rdev, mode); 1430414c70cbSLiam Girdwood out: 1431414c70cbSLiam Girdwood mutex_unlock(&rdev->mutex); 1432414c70cbSLiam Girdwood return ret; 1433414c70cbSLiam Girdwood } 1434414c70cbSLiam Girdwood EXPORT_SYMBOL_GPL(regulator_set_mode); 1435414c70cbSLiam Girdwood 1436414c70cbSLiam Girdwood static unsigned int _regulator_get_mode(struct regulator_dev *rdev) 1437414c70cbSLiam Girdwood { 1438414c70cbSLiam Girdwood int ret; 1439414c70cbSLiam Girdwood 1440414c70cbSLiam Girdwood mutex_lock(&rdev->mutex); 1441414c70cbSLiam Girdwood 1442414c70cbSLiam Girdwood /* sanity check */ 1443414c70cbSLiam Girdwood if (!rdev->desc->ops->get_mode) { 1444414c70cbSLiam Girdwood ret = -EINVAL; 1445414c70cbSLiam Girdwood goto out; 1446414c70cbSLiam Girdwood } 1447414c70cbSLiam Girdwood 1448414c70cbSLiam Girdwood ret = rdev->desc->ops->get_mode(rdev); 1449414c70cbSLiam Girdwood out: 1450414c70cbSLiam Girdwood mutex_unlock(&rdev->mutex); 1451414c70cbSLiam Girdwood return ret; 1452414c70cbSLiam Girdwood } 1453414c70cbSLiam Girdwood 1454414c70cbSLiam Girdwood /** 1455414c70cbSLiam Girdwood * regulator_get_mode - get regulator operating mode 1456414c70cbSLiam Girdwood * @regulator: regulator source 1457414c70cbSLiam Girdwood * 1458414c70cbSLiam Girdwood * Get the current regulator operating mode. 1459414c70cbSLiam Girdwood */ 1460414c70cbSLiam Girdwood unsigned int regulator_get_mode(struct regulator *regulator) 1461414c70cbSLiam Girdwood { 1462414c70cbSLiam Girdwood return _regulator_get_mode(regulator->rdev); 1463414c70cbSLiam Girdwood } 1464414c70cbSLiam Girdwood EXPORT_SYMBOL_GPL(regulator_get_mode); 1465414c70cbSLiam Girdwood 1466414c70cbSLiam Girdwood /** 1467414c70cbSLiam Girdwood * regulator_set_optimum_mode - set regulator optimum operating mode 1468414c70cbSLiam Girdwood * @regulator: regulator source 1469414c70cbSLiam Girdwood * @uA_load: load current 1470414c70cbSLiam Girdwood * 1471414c70cbSLiam Girdwood * Notifies the regulator core of a new device load. This is then used by 1472414c70cbSLiam Girdwood * DRMS (if enabled by constraints) to set the most efficient regulator 1473414c70cbSLiam Girdwood * operating mode for the new regulator loading. 1474414c70cbSLiam Girdwood * 1475414c70cbSLiam Girdwood * Consumer devices notify their supply regulator of the maximum power 1476414c70cbSLiam Girdwood * they will require (can be taken from device datasheet in the power 1477414c70cbSLiam Girdwood * consumption tables) when they change operational status and hence power 1478414c70cbSLiam Girdwood * state. Examples of operational state changes that can affect power 1479414c70cbSLiam Girdwood * consumption are :- 1480414c70cbSLiam Girdwood * 1481414c70cbSLiam Girdwood * o Device is opened / closed. 1482414c70cbSLiam Girdwood * o Device I/O is about to begin or has just finished. 1483414c70cbSLiam Girdwood * o Device is idling in between work. 1484414c70cbSLiam Girdwood * 1485414c70cbSLiam Girdwood * This information is also exported via sysfs to userspace. 1486414c70cbSLiam Girdwood * 1487414c70cbSLiam Girdwood * DRMS will sum the total requested load on the regulator and change 1488414c70cbSLiam Girdwood * to the most efficient operating mode if platform constraints allow. 1489414c70cbSLiam Girdwood * 1490414c70cbSLiam Girdwood * Returns the new regulator mode or error. 1491414c70cbSLiam Girdwood */ 1492414c70cbSLiam Girdwood int regulator_set_optimum_mode(struct regulator *regulator, int uA_load) 1493414c70cbSLiam Girdwood { 1494414c70cbSLiam Girdwood struct regulator_dev *rdev = regulator->rdev; 1495414c70cbSLiam Girdwood struct regulator *consumer; 1496414c70cbSLiam Girdwood int ret, output_uV, input_uV, total_uA_load = 0; 1497414c70cbSLiam Girdwood unsigned int mode; 1498414c70cbSLiam Girdwood 1499414c70cbSLiam Girdwood mutex_lock(&rdev->mutex); 1500414c70cbSLiam Girdwood 1501414c70cbSLiam Girdwood regulator->uA_load = uA_load; 1502414c70cbSLiam Girdwood ret = regulator_check_drms(rdev); 1503414c70cbSLiam Girdwood if (ret < 0) 1504414c70cbSLiam Girdwood goto out; 1505414c70cbSLiam Girdwood ret = -EINVAL; 1506414c70cbSLiam Girdwood 1507414c70cbSLiam Girdwood /* sanity check */ 1508414c70cbSLiam Girdwood if (!rdev->desc->ops->get_optimum_mode) 1509414c70cbSLiam Girdwood goto out; 1510414c70cbSLiam Girdwood 1511414c70cbSLiam Girdwood /* get output voltage */ 1512414c70cbSLiam Girdwood output_uV = rdev->desc->ops->get_voltage(rdev); 1513414c70cbSLiam Girdwood if (output_uV <= 0) { 1514414c70cbSLiam Girdwood printk(KERN_ERR "%s: invalid output voltage found for %s\n", 1515414c70cbSLiam Girdwood __func__, rdev->desc->name); 1516414c70cbSLiam Girdwood goto out; 1517414c70cbSLiam Girdwood } 1518414c70cbSLiam Girdwood 1519414c70cbSLiam Girdwood /* get input voltage */ 1520414c70cbSLiam Girdwood if (rdev->supply && rdev->supply->desc->ops->get_voltage) 1521414c70cbSLiam Girdwood input_uV = rdev->supply->desc->ops->get_voltage(rdev->supply); 1522414c70cbSLiam Girdwood else 1523414c70cbSLiam Girdwood input_uV = rdev->constraints->input_uV; 1524414c70cbSLiam Girdwood if (input_uV <= 0) { 1525414c70cbSLiam Girdwood printk(KERN_ERR "%s: invalid input voltage found for %s\n", 1526414c70cbSLiam Girdwood __func__, rdev->desc->name); 1527414c70cbSLiam Girdwood goto out; 1528414c70cbSLiam Girdwood } 1529414c70cbSLiam Girdwood 1530414c70cbSLiam Girdwood /* calc total requested load for this regulator */ 1531414c70cbSLiam Girdwood list_for_each_entry(consumer, &rdev->consumer_list, list) 1532414c70cbSLiam Girdwood total_uA_load += consumer->uA_load; 1533414c70cbSLiam Girdwood 1534414c70cbSLiam Girdwood mode = rdev->desc->ops->get_optimum_mode(rdev, 1535414c70cbSLiam Girdwood input_uV, output_uV, 1536414c70cbSLiam Girdwood total_uA_load); 1537e573520bSDavid Brownell ret = regulator_check_mode(rdev, mode); 1538e573520bSDavid Brownell if (ret < 0) { 1539414c70cbSLiam Girdwood printk(KERN_ERR "%s: failed to get optimum mode for %s @" 1540414c70cbSLiam Girdwood " %d uA %d -> %d uV\n", __func__, rdev->desc->name, 1541414c70cbSLiam Girdwood total_uA_load, input_uV, output_uV); 1542414c70cbSLiam Girdwood goto out; 1543414c70cbSLiam Girdwood } 1544414c70cbSLiam Girdwood 1545414c70cbSLiam Girdwood ret = rdev->desc->ops->set_mode(rdev, mode); 1546e573520bSDavid Brownell if (ret < 0) { 1547414c70cbSLiam Girdwood printk(KERN_ERR "%s: failed to set optimum mode %x for %s\n", 1548414c70cbSLiam Girdwood __func__, mode, rdev->desc->name); 1549414c70cbSLiam Girdwood goto out; 1550414c70cbSLiam Girdwood } 1551414c70cbSLiam Girdwood ret = mode; 1552414c70cbSLiam Girdwood out: 1553414c70cbSLiam Girdwood mutex_unlock(&rdev->mutex); 1554414c70cbSLiam Girdwood return ret; 1555414c70cbSLiam Girdwood } 1556414c70cbSLiam Girdwood EXPORT_SYMBOL_GPL(regulator_set_optimum_mode); 1557414c70cbSLiam Girdwood 1558414c70cbSLiam Girdwood /** 1559414c70cbSLiam Girdwood * regulator_register_notifier - register regulator event notifier 1560414c70cbSLiam Girdwood * @regulator: regulator source 156169279fb9SMark Brown * @nb: notifier block 1562414c70cbSLiam Girdwood * 1563414c70cbSLiam Girdwood * Register notifier block to receive regulator events. 1564414c70cbSLiam Girdwood */ 1565414c70cbSLiam Girdwood int regulator_register_notifier(struct regulator *regulator, 1566414c70cbSLiam Girdwood struct notifier_block *nb) 1567414c70cbSLiam Girdwood { 1568414c70cbSLiam Girdwood return blocking_notifier_chain_register(®ulator->rdev->notifier, 1569414c70cbSLiam Girdwood nb); 1570414c70cbSLiam Girdwood } 1571414c70cbSLiam Girdwood EXPORT_SYMBOL_GPL(regulator_register_notifier); 1572414c70cbSLiam Girdwood 1573414c70cbSLiam Girdwood /** 1574414c70cbSLiam Girdwood * regulator_unregister_notifier - unregister regulator event notifier 1575414c70cbSLiam Girdwood * @regulator: regulator source 157669279fb9SMark Brown * @nb: notifier block 1577414c70cbSLiam Girdwood * 1578414c70cbSLiam Girdwood * Unregister regulator event notifier block. 1579414c70cbSLiam Girdwood */ 1580414c70cbSLiam Girdwood int regulator_unregister_notifier(struct regulator *regulator, 1581414c70cbSLiam Girdwood struct notifier_block *nb) 1582414c70cbSLiam Girdwood { 1583414c70cbSLiam Girdwood return blocking_notifier_chain_unregister(®ulator->rdev->notifier, 1584414c70cbSLiam Girdwood nb); 1585414c70cbSLiam Girdwood } 1586414c70cbSLiam Girdwood EXPORT_SYMBOL_GPL(regulator_unregister_notifier); 1587414c70cbSLiam Girdwood 1588b136fb44SJonathan Cameron /* notify regulator consumers and downstream regulator consumers. 1589b136fb44SJonathan Cameron * Note mutex must be held by caller. 1590b136fb44SJonathan Cameron */ 1591414c70cbSLiam Girdwood static void _notifier_call_chain(struct regulator_dev *rdev, 1592414c70cbSLiam Girdwood unsigned long event, void *data) 1593414c70cbSLiam Girdwood { 1594414c70cbSLiam Girdwood struct regulator_dev *_rdev; 1595414c70cbSLiam Girdwood 1596414c70cbSLiam Girdwood /* call rdev chain first */ 1597414c70cbSLiam Girdwood blocking_notifier_call_chain(&rdev->notifier, event, NULL); 1598414c70cbSLiam Girdwood 1599414c70cbSLiam Girdwood /* now notify regulator we supply */ 1600b136fb44SJonathan Cameron list_for_each_entry(_rdev, &rdev->supply_list, slist) { 1601b136fb44SJonathan Cameron mutex_lock(&_rdev->mutex); 1602414c70cbSLiam Girdwood _notifier_call_chain(_rdev, event, data); 1603b136fb44SJonathan Cameron mutex_unlock(&_rdev->mutex); 1604b136fb44SJonathan Cameron } 1605414c70cbSLiam Girdwood } 1606414c70cbSLiam Girdwood 1607414c70cbSLiam Girdwood /** 1608414c70cbSLiam Girdwood * regulator_bulk_get - get multiple regulator consumers 1609414c70cbSLiam Girdwood * 1610414c70cbSLiam Girdwood * @dev: Device to supply 1611414c70cbSLiam Girdwood * @num_consumers: Number of consumers to register 1612414c70cbSLiam Girdwood * @consumers: Configuration of consumers; clients are stored here. 1613414c70cbSLiam Girdwood * 1614414c70cbSLiam Girdwood * @return 0 on success, an errno on failure. 1615414c70cbSLiam Girdwood * 1616414c70cbSLiam Girdwood * This helper function allows drivers to get several regulator 1617414c70cbSLiam Girdwood * consumers in one operation. If any of the regulators cannot be 1618414c70cbSLiam Girdwood * acquired then any regulators that were allocated will be freed 1619414c70cbSLiam Girdwood * before returning to the caller. 1620414c70cbSLiam Girdwood */ 1621414c70cbSLiam Girdwood int regulator_bulk_get(struct device *dev, int num_consumers, 1622414c70cbSLiam Girdwood struct regulator_bulk_data *consumers) 1623414c70cbSLiam Girdwood { 1624414c70cbSLiam Girdwood int i; 1625414c70cbSLiam Girdwood int ret; 1626414c70cbSLiam Girdwood 1627414c70cbSLiam Girdwood for (i = 0; i < num_consumers; i++) 1628414c70cbSLiam Girdwood consumers[i].consumer = NULL; 1629414c70cbSLiam Girdwood 1630414c70cbSLiam Girdwood for (i = 0; i < num_consumers; i++) { 1631414c70cbSLiam Girdwood consumers[i].consumer = regulator_get(dev, 1632414c70cbSLiam Girdwood consumers[i].supply); 1633414c70cbSLiam Girdwood if (IS_ERR(consumers[i].consumer)) { 1634414c70cbSLiam Girdwood dev_err(dev, "Failed to get supply '%s'\n", 1635414c70cbSLiam Girdwood consumers[i].supply); 1636414c70cbSLiam Girdwood ret = PTR_ERR(consumers[i].consumer); 1637414c70cbSLiam Girdwood consumers[i].consumer = NULL; 1638414c70cbSLiam Girdwood goto err; 1639414c70cbSLiam Girdwood } 1640414c70cbSLiam Girdwood } 1641414c70cbSLiam Girdwood 1642414c70cbSLiam Girdwood return 0; 1643414c70cbSLiam Girdwood 1644414c70cbSLiam Girdwood err: 1645414c70cbSLiam Girdwood for (i = 0; i < num_consumers && consumers[i].consumer; i++) 1646414c70cbSLiam Girdwood regulator_put(consumers[i].consumer); 1647414c70cbSLiam Girdwood 1648414c70cbSLiam Girdwood return ret; 1649414c70cbSLiam Girdwood } 1650414c70cbSLiam Girdwood EXPORT_SYMBOL_GPL(regulator_bulk_get); 1651414c70cbSLiam Girdwood 1652414c70cbSLiam Girdwood /** 1653414c70cbSLiam Girdwood * regulator_bulk_enable - enable multiple regulator consumers 1654414c70cbSLiam Girdwood * 1655414c70cbSLiam Girdwood * @num_consumers: Number of consumers 1656414c70cbSLiam Girdwood * @consumers: Consumer data; clients are stored here. 1657414c70cbSLiam Girdwood * @return 0 on success, an errno on failure 1658414c70cbSLiam Girdwood * 1659414c70cbSLiam Girdwood * This convenience API allows consumers to enable multiple regulator 1660414c70cbSLiam Girdwood * clients in a single API call. If any consumers cannot be enabled 1661414c70cbSLiam Girdwood * then any others that were enabled will be disabled again prior to 1662414c70cbSLiam Girdwood * return. 1663414c70cbSLiam Girdwood */ 1664414c70cbSLiam Girdwood int regulator_bulk_enable(int num_consumers, 1665414c70cbSLiam Girdwood struct regulator_bulk_data *consumers) 1666414c70cbSLiam Girdwood { 1667414c70cbSLiam Girdwood int i; 1668414c70cbSLiam Girdwood int ret; 1669414c70cbSLiam Girdwood 1670414c70cbSLiam Girdwood for (i = 0; i < num_consumers; i++) { 1671414c70cbSLiam Girdwood ret = regulator_enable(consumers[i].consumer); 1672414c70cbSLiam Girdwood if (ret != 0) 1673414c70cbSLiam Girdwood goto err; 1674414c70cbSLiam Girdwood } 1675414c70cbSLiam Girdwood 1676414c70cbSLiam Girdwood return 0; 1677414c70cbSLiam Girdwood 1678414c70cbSLiam Girdwood err: 1679414c70cbSLiam Girdwood printk(KERN_ERR "Failed to enable %s\n", consumers[i].supply); 1680414c70cbSLiam Girdwood for (i = 0; i < num_consumers; i++) 1681414c70cbSLiam Girdwood regulator_disable(consumers[i].consumer); 1682414c70cbSLiam Girdwood 1683414c70cbSLiam Girdwood return ret; 1684414c70cbSLiam Girdwood } 1685414c70cbSLiam Girdwood EXPORT_SYMBOL_GPL(regulator_bulk_enable); 1686414c70cbSLiam Girdwood 1687414c70cbSLiam Girdwood /** 1688414c70cbSLiam Girdwood * regulator_bulk_disable - disable multiple regulator consumers 1689414c70cbSLiam Girdwood * 1690414c70cbSLiam Girdwood * @num_consumers: Number of consumers 1691414c70cbSLiam Girdwood * @consumers: Consumer data; clients are stored here. 1692414c70cbSLiam Girdwood * @return 0 on success, an errno on failure 1693414c70cbSLiam Girdwood * 1694414c70cbSLiam Girdwood * This convenience API allows consumers to disable multiple regulator 1695414c70cbSLiam Girdwood * clients in a single API call. If any consumers cannot be enabled 1696414c70cbSLiam Girdwood * then any others that were disabled will be disabled again prior to 1697414c70cbSLiam Girdwood * return. 1698414c70cbSLiam Girdwood */ 1699414c70cbSLiam Girdwood int regulator_bulk_disable(int num_consumers, 1700414c70cbSLiam Girdwood struct regulator_bulk_data *consumers) 1701414c70cbSLiam Girdwood { 1702414c70cbSLiam Girdwood int i; 1703414c70cbSLiam Girdwood int ret; 1704414c70cbSLiam Girdwood 1705414c70cbSLiam Girdwood for (i = 0; i < num_consumers; i++) { 1706414c70cbSLiam Girdwood ret = regulator_disable(consumers[i].consumer); 1707414c70cbSLiam Girdwood if (ret != 0) 1708414c70cbSLiam Girdwood goto err; 1709414c70cbSLiam Girdwood } 1710414c70cbSLiam Girdwood 1711414c70cbSLiam Girdwood return 0; 1712414c70cbSLiam Girdwood 1713414c70cbSLiam Girdwood err: 1714414c70cbSLiam Girdwood printk(KERN_ERR "Failed to disable %s\n", consumers[i].supply); 1715414c70cbSLiam Girdwood for (i = 0; i < num_consumers; i++) 1716414c70cbSLiam Girdwood regulator_enable(consumers[i].consumer); 1717414c70cbSLiam Girdwood 1718414c70cbSLiam Girdwood return ret; 1719414c70cbSLiam Girdwood } 1720414c70cbSLiam Girdwood EXPORT_SYMBOL_GPL(regulator_bulk_disable); 1721414c70cbSLiam Girdwood 1722414c70cbSLiam Girdwood /** 1723414c70cbSLiam Girdwood * regulator_bulk_free - free multiple regulator consumers 1724414c70cbSLiam Girdwood * 1725414c70cbSLiam Girdwood * @num_consumers: Number of consumers 1726414c70cbSLiam Girdwood * @consumers: Consumer data; clients are stored here. 1727414c70cbSLiam Girdwood * 1728414c70cbSLiam Girdwood * This convenience API allows consumers to free multiple regulator 1729414c70cbSLiam Girdwood * clients in a single API call. 1730414c70cbSLiam Girdwood */ 1731414c70cbSLiam Girdwood void regulator_bulk_free(int num_consumers, 1732414c70cbSLiam Girdwood struct regulator_bulk_data *consumers) 1733414c70cbSLiam Girdwood { 1734414c70cbSLiam Girdwood int i; 1735414c70cbSLiam Girdwood 1736414c70cbSLiam Girdwood for (i = 0; i < num_consumers; i++) { 1737414c70cbSLiam Girdwood regulator_put(consumers[i].consumer); 1738414c70cbSLiam Girdwood consumers[i].consumer = NULL; 1739414c70cbSLiam Girdwood } 1740414c70cbSLiam Girdwood } 1741414c70cbSLiam Girdwood EXPORT_SYMBOL_GPL(regulator_bulk_free); 1742414c70cbSLiam Girdwood 1743414c70cbSLiam Girdwood /** 1744414c70cbSLiam Girdwood * regulator_notifier_call_chain - call regulator event notifier 174569279fb9SMark Brown * @rdev: regulator source 1746414c70cbSLiam Girdwood * @event: notifier block 174769279fb9SMark Brown * @data: callback-specific data. 1748414c70cbSLiam Girdwood * 1749414c70cbSLiam Girdwood * Called by regulator drivers to notify clients a regulator event has 1750414c70cbSLiam Girdwood * occurred. We also notify regulator clients downstream. 1751b136fb44SJonathan Cameron * Note lock must be held by caller. 1752414c70cbSLiam Girdwood */ 1753414c70cbSLiam Girdwood int regulator_notifier_call_chain(struct regulator_dev *rdev, 1754414c70cbSLiam Girdwood unsigned long event, void *data) 1755414c70cbSLiam Girdwood { 1756414c70cbSLiam Girdwood _notifier_call_chain(rdev, event, data); 1757414c70cbSLiam Girdwood return NOTIFY_DONE; 1758414c70cbSLiam Girdwood 1759414c70cbSLiam Girdwood } 1760414c70cbSLiam Girdwood EXPORT_SYMBOL_GPL(regulator_notifier_call_chain); 1761414c70cbSLiam Girdwood 17627ad68e2fSDavid Brownell /* 17637ad68e2fSDavid Brownell * To avoid cluttering sysfs (and memory) with useless state, only 17647ad68e2fSDavid Brownell * create attributes that can be meaningfully displayed. 17657ad68e2fSDavid Brownell */ 17667ad68e2fSDavid Brownell static int add_regulator_attributes(struct regulator_dev *rdev) 17677ad68e2fSDavid Brownell { 17687ad68e2fSDavid Brownell struct device *dev = &rdev->dev; 17697ad68e2fSDavid Brownell struct regulator_ops *ops = rdev->desc->ops; 17707ad68e2fSDavid Brownell int status = 0; 17717ad68e2fSDavid Brownell 17727ad68e2fSDavid Brownell /* some attributes need specific methods to be displayed */ 17737ad68e2fSDavid Brownell if (ops->get_voltage) { 17747ad68e2fSDavid Brownell status = device_create_file(dev, &dev_attr_microvolts); 17757ad68e2fSDavid Brownell if (status < 0) 17767ad68e2fSDavid Brownell return status; 17777ad68e2fSDavid Brownell } 17787ad68e2fSDavid Brownell if (ops->get_current_limit) { 17797ad68e2fSDavid Brownell status = device_create_file(dev, &dev_attr_microamps); 17807ad68e2fSDavid Brownell if (status < 0) 17817ad68e2fSDavid Brownell return status; 17827ad68e2fSDavid Brownell } 17837ad68e2fSDavid Brownell if (ops->get_mode) { 17847ad68e2fSDavid Brownell status = device_create_file(dev, &dev_attr_opmode); 17857ad68e2fSDavid Brownell if (status < 0) 17867ad68e2fSDavid Brownell return status; 17877ad68e2fSDavid Brownell } 17887ad68e2fSDavid Brownell if (ops->is_enabled) { 17897ad68e2fSDavid Brownell status = device_create_file(dev, &dev_attr_state); 17907ad68e2fSDavid Brownell if (status < 0) 17917ad68e2fSDavid Brownell return status; 17927ad68e2fSDavid Brownell } 1793853116a1SDavid Brownell if (ops->get_status) { 1794853116a1SDavid Brownell status = device_create_file(dev, &dev_attr_status); 1795853116a1SDavid Brownell if (status < 0) 1796853116a1SDavid Brownell return status; 1797853116a1SDavid Brownell } 17987ad68e2fSDavid Brownell 17997ad68e2fSDavid Brownell /* some attributes are type-specific */ 18007ad68e2fSDavid Brownell if (rdev->desc->type == REGULATOR_CURRENT) { 18017ad68e2fSDavid Brownell status = device_create_file(dev, &dev_attr_requested_microamps); 18027ad68e2fSDavid Brownell if (status < 0) 18037ad68e2fSDavid Brownell return status; 18047ad68e2fSDavid Brownell } 18057ad68e2fSDavid Brownell 18067ad68e2fSDavid Brownell /* all the other attributes exist to support constraints; 18077ad68e2fSDavid Brownell * don't show them if there are no constraints, or if the 18087ad68e2fSDavid Brownell * relevant supporting methods are missing. 18097ad68e2fSDavid Brownell */ 18107ad68e2fSDavid Brownell if (!rdev->constraints) 18117ad68e2fSDavid Brownell return status; 18127ad68e2fSDavid Brownell 18137ad68e2fSDavid Brownell /* constraints need specific supporting methods */ 18147ad68e2fSDavid Brownell if (ops->set_voltage) { 18157ad68e2fSDavid Brownell status = device_create_file(dev, &dev_attr_min_microvolts); 18167ad68e2fSDavid Brownell if (status < 0) 18177ad68e2fSDavid Brownell return status; 18187ad68e2fSDavid Brownell status = device_create_file(dev, &dev_attr_max_microvolts); 18197ad68e2fSDavid Brownell if (status < 0) 18207ad68e2fSDavid Brownell return status; 18217ad68e2fSDavid Brownell } 18227ad68e2fSDavid Brownell if (ops->set_current_limit) { 18237ad68e2fSDavid Brownell status = device_create_file(dev, &dev_attr_min_microamps); 18247ad68e2fSDavid Brownell if (status < 0) 18257ad68e2fSDavid Brownell return status; 18267ad68e2fSDavid Brownell status = device_create_file(dev, &dev_attr_max_microamps); 18277ad68e2fSDavid Brownell if (status < 0) 18287ad68e2fSDavid Brownell return status; 18297ad68e2fSDavid Brownell } 18307ad68e2fSDavid Brownell 18317ad68e2fSDavid Brownell /* suspend mode constraints need multiple supporting methods */ 18327ad68e2fSDavid Brownell if (!(ops->set_suspend_enable && ops->set_suspend_disable)) 18337ad68e2fSDavid Brownell return status; 18347ad68e2fSDavid Brownell 18357ad68e2fSDavid Brownell status = device_create_file(dev, &dev_attr_suspend_standby_state); 18367ad68e2fSDavid Brownell if (status < 0) 18377ad68e2fSDavid Brownell return status; 18387ad68e2fSDavid Brownell status = device_create_file(dev, &dev_attr_suspend_mem_state); 18397ad68e2fSDavid Brownell if (status < 0) 18407ad68e2fSDavid Brownell return status; 18417ad68e2fSDavid Brownell status = device_create_file(dev, &dev_attr_suspend_disk_state); 18427ad68e2fSDavid Brownell if (status < 0) 18437ad68e2fSDavid Brownell return status; 18447ad68e2fSDavid Brownell 18457ad68e2fSDavid Brownell if (ops->set_suspend_voltage) { 18467ad68e2fSDavid Brownell status = device_create_file(dev, 18477ad68e2fSDavid Brownell &dev_attr_suspend_standby_microvolts); 18487ad68e2fSDavid Brownell if (status < 0) 18497ad68e2fSDavid Brownell return status; 18507ad68e2fSDavid Brownell status = device_create_file(dev, 18517ad68e2fSDavid Brownell &dev_attr_suspend_mem_microvolts); 18527ad68e2fSDavid Brownell if (status < 0) 18537ad68e2fSDavid Brownell return status; 18547ad68e2fSDavid Brownell status = device_create_file(dev, 18557ad68e2fSDavid Brownell &dev_attr_suspend_disk_microvolts); 18567ad68e2fSDavid Brownell if (status < 0) 18577ad68e2fSDavid Brownell return status; 18587ad68e2fSDavid Brownell } 18597ad68e2fSDavid Brownell 18607ad68e2fSDavid Brownell if (ops->set_suspend_mode) { 18617ad68e2fSDavid Brownell status = device_create_file(dev, 18627ad68e2fSDavid Brownell &dev_attr_suspend_standby_mode); 18637ad68e2fSDavid Brownell if (status < 0) 18647ad68e2fSDavid Brownell return status; 18657ad68e2fSDavid Brownell status = device_create_file(dev, 18667ad68e2fSDavid Brownell &dev_attr_suspend_mem_mode); 18677ad68e2fSDavid Brownell if (status < 0) 18687ad68e2fSDavid Brownell return status; 18697ad68e2fSDavid Brownell status = device_create_file(dev, 18707ad68e2fSDavid Brownell &dev_attr_suspend_disk_mode); 18717ad68e2fSDavid Brownell if (status < 0) 18727ad68e2fSDavid Brownell return status; 18737ad68e2fSDavid Brownell } 18747ad68e2fSDavid Brownell 18757ad68e2fSDavid Brownell return status; 18767ad68e2fSDavid Brownell } 18777ad68e2fSDavid Brownell 1878414c70cbSLiam Girdwood /** 1879414c70cbSLiam Girdwood * regulator_register - register regulator 188069279fb9SMark Brown * @regulator_desc: regulator to register 188169279fb9SMark Brown * @dev: struct device for the regulator 18820527100fSMark Brown * @init_data: platform provided init data, passed through by driver 188369279fb9SMark Brown * @driver_data: private regulator data 1884414c70cbSLiam Girdwood * 1885414c70cbSLiam Girdwood * Called by regulator drivers to register a regulator. 1886414c70cbSLiam Girdwood * Returns 0 on success. 1887414c70cbSLiam Girdwood */ 1888414c70cbSLiam Girdwood struct regulator_dev *regulator_register(struct regulator_desc *regulator_desc, 18890527100fSMark Brown struct device *dev, struct regulator_init_data *init_data, 18900527100fSMark Brown void *driver_data) 1891414c70cbSLiam Girdwood { 1892414c70cbSLiam Girdwood static atomic_t regulator_no = ATOMIC_INIT(0); 1893414c70cbSLiam Girdwood struct regulator_dev *rdev; 1894a5766f11SLiam Girdwood int ret, i; 1895414c70cbSLiam Girdwood 1896414c70cbSLiam Girdwood if (regulator_desc == NULL) 1897414c70cbSLiam Girdwood return ERR_PTR(-EINVAL); 1898414c70cbSLiam Girdwood 1899414c70cbSLiam Girdwood if (regulator_desc->name == NULL || regulator_desc->ops == NULL) 1900414c70cbSLiam Girdwood return ERR_PTR(-EINVAL); 1901414c70cbSLiam Girdwood 1902414c70cbSLiam Girdwood if (!regulator_desc->type == REGULATOR_VOLTAGE && 1903414c70cbSLiam Girdwood !regulator_desc->type == REGULATOR_CURRENT) 1904414c70cbSLiam Girdwood return ERR_PTR(-EINVAL); 1905414c70cbSLiam Girdwood 190646fabe1eSMark Brown if (!init_data) 190746fabe1eSMark Brown return ERR_PTR(-EINVAL); 190846fabe1eSMark Brown 1909414c70cbSLiam Girdwood rdev = kzalloc(sizeof(struct regulator_dev), GFP_KERNEL); 1910414c70cbSLiam Girdwood if (rdev == NULL) 1911414c70cbSLiam Girdwood return ERR_PTR(-ENOMEM); 1912414c70cbSLiam Girdwood 1913414c70cbSLiam Girdwood mutex_lock(®ulator_list_mutex); 1914414c70cbSLiam Girdwood 1915414c70cbSLiam Girdwood mutex_init(&rdev->mutex); 1916a5766f11SLiam Girdwood rdev->reg_data = driver_data; 1917414c70cbSLiam Girdwood rdev->owner = regulator_desc->owner; 1918414c70cbSLiam Girdwood rdev->desc = regulator_desc; 1919414c70cbSLiam Girdwood INIT_LIST_HEAD(&rdev->consumer_list); 1920414c70cbSLiam Girdwood INIT_LIST_HEAD(&rdev->supply_list); 1921414c70cbSLiam Girdwood INIT_LIST_HEAD(&rdev->list); 1922414c70cbSLiam Girdwood INIT_LIST_HEAD(&rdev->slist); 1923414c70cbSLiam Girdwood BLOCKING_INIT_NOTIFIER_HEAD(&rdev->notifier); 1924414c70cbSLiam Girdwood 1925a5766f11SLiam Girdwood /* preform any regulator specific init */ 1926a5766f11SLiam Girdwood if (init_data->regulator_init) { 1927a5766f11SLiam Girdwood ret = init_data->regulator_init(rdev->reg_data); 19284fca9545SDavid Brownell if (ret < 0) 19294fca9545SDavid Brownell goto clean; 1930a5766f11SLiam Girdwood } 1931a5766f11SLiam Girdwood 1932a5766f11SLiam Girdwood /* register with sysfs */ 1933a5766f11SLiam Girdwood rdev->dev.class = ®ulator_class; 1934a5766f11SLiam Girdwood rdev->dev.parent = dev; 1935812460a9SKay Sievers dev_set_name(&rdev->dev, "regulator.%d", 1936812460a9SKay Sievers atomic_inc_return(®ulator_no) - 1); 1937a5766f11SLiam Girdwood ret = device_register(&rdev->dev); 19384fca9545SDavid Brownell if (ret != 0) 19394fca9545SDavid Brownell goto clean; 1940a5766f11SLiam Girdwood 1941a5766f11SLiam Girdwood dev_set_drvdata(&rdev->dev, rdev); 1942a5766f11SLiam Girdwood 194374f544c1SMike Rapoport /* set regulator constraints */ 194474f544c1SMike Rapoport ret = set_machine_constraints(rdev, &init_data->constraints); 194574f544c1SMike Rapoport if (ret < 0) 194674f544c1SMike Rapoport goto scrub; 194774f544c1SMike Rapoport 19487ad68e2fSDavid Brownell /* add attributes supported by this regulator */ 19497ad68e2fSDavid Brownell ret = add_regulator_attributes(rdev); 19507ad68e2fSDavid Brownell if (ret < 0) 19517ad68e2fSDavid Brownell goto scrub; 19527ad68e2fSDavid Brownell 1953a5766f11SLiam Girdwood /* set supply regulator if it exists */ 1954a5766f11SLiam Girdwood if (init_data->supply_regulator_dev) { 1955a5766f11SLiam Girdwood ret = set_supply(rdev, 1956a5766f11SLiam Girdwood dev_get_drvdata(init_data->supply_regulator_dev)); 19574fca9545SDavid Brownell if (ret < 0) 19584fca9545SDavid Brownell goto scrub; 1959a5766f11SLiam Girdwood } 1960a5766f11SLiam Girdwood 1961a5766f11SLiam Girdwood /* add consumers devices */ 1962a5766f11SLiam Girdwood for (i = 0; i < init_data->num_consumer_supplies; i++) { 1963a5766f11SLiam Girdwood ret = set_consumer_device_supply(rdev, 1964a5766f11SLiam Girdwood init_data->consumer_supplies[i].dev, 1965a5766f11SLiam Girdwood init_data->consumer_supplies[i].supply); 1966a5766f11SLiam Girdwood if (ret < 0) { 1967a5766f11SLiam Girdwood for (--i; i >= 0; i--) 1968a5766f11SLiam Girdwood unset_consumer_device_supply(rdev, 1969a5766f11SLiam Girdwood init_data->consumer_supplies[i].dev); 19704fca9545SDavid Brownell goto scrub; 1971a5766f11SLiam Girdwood } 1972a5766f11SLiam Girdwood } 1973a5766f11SLiam Girdwood 1974a5766f11SLiam Girdwood list_add(&rdev->list, ®ulator_list); 1975a5766f11SLiam Girdwood out: 1976414c70cbSLiam Girdwood mutex_unlock(®ulator_list_mutex); 1977414c70cbSLiam Girdwood return rdev; 19784fca9545SDavid Brownell 19794fca9545SDavid Brownell scrub: 19804fca9545SDavid Brownell device_unregister(&rdev->dev); 19814fca9545SDavid Brownell clean: 19824fca9545SDavid Brownell kfree(rdev); 19834fca9545SDavid Brownell rdev = ERR_PTR(ret); 19844fca9545SDavid Brownell goto out; 1985414c70cbSLiam Girdwood } 1986414c70cbSLiam Girdwood EXPORT_SYMBOL_GPL(regulator_register); 1987414c70cbSLiam Girdwood 1988414c70cbSLiam Girdwood /** 1989414c70cbSLiam Girdwood * regulator_unregister - unregister regulator 199069279fb9SMark Brown * @rdev: regulator to unregister 1991414c70cbSLiam Girdwood * 1992414c70cbSLiam Girdwood * Called by regulator drivers to unregister a regulator. 1993414c70cbSLiam Girdwood */ 1994414c70cbSLiam Girdwood void regulator_unregister(struct regulator_dev *rdev) 1995414c70cbSLiam Girdwood { 1996414c70cbSLiam Girdwood if (rdev == NULL) 1997414c70cbSLiam Girdwood return; 1998414c70cbSLiam Girdwood 1999414c70cbSLiam Girdwood mutex_lock(®ulator_list_mutex); 2000414c70cbSLiam Girdwood list_del(&rdev->list); 2001414c70cbSLiam Girdwood if (rdev->supply) 2002414c70cbSLiam Girdwood sysfs_remove_link(&rdev->dev.kobj, "supply"); 2003414c70cbSLiam Girdwood device_unregister(&rdev->dev); 2004414c70cbSLiam Girdwood mutex_unlock(®ulator_list_mutex); 2005414c70cbSLiam Girdwood } 2006414c70cbSLiam Girdwood EXPORT_SYMBOL_GPL(regulator_unregister); 2007414c70cbSLiam Girdwood 2008414c70cbSLiam Girdwood /** 2009cf7bbcdfSMark Brown * regulator_suspend_prepare - prepare regulators for system wide suspend 2010414c70cbSLiam Girdwood * @state: system suspend state 2011414c70cbSLiam Girdwood * 2012414c70cbSLiam Girdwood * Configure each regulator with it's suspend operating parameters for state. 2013414c70cbSLiam Girdwood * This will usually be called by machine suspend code prior to supending. 2014414c70cbSLiam Girdwood */ 2015414c70cbSLiam Girdwood int regulator_suspend_prepare(suspend_state_t state) 2016414c70cbSLiam Girdwood { 2017414c70cbSLiam Girdwood struct regulator_dev *rdev; 2018414c70cbSLiam Girdwood int ret = 0; 2019414c70cbSLiam Girdwood 2020414c70cbSLiam Girdwood /* ON is handled by regulator active state */ 2021414c70cbSLiam Girdwood if (state == PM_SUSPEND_ON) 2022414c70cbSLiam Girdwood return -EINVAL; 2023414c70cbSLiam Girdwood 2024414c70cbSLiam Girdwood mutex_lock(®ulator_list_mutex); 2025414c70cbSLiam Girdwood list_for_each_entry(rdev, ®ulator_list, list) { 2026414c70cbSLiam Girdwood 2027414c70cbSLiam Girdwood mutex_lock(&rdev->mutex); 2028414c70cbSLiam Girdwood ret = suspend_prepare(rdev, state); 2029414c70cbSLiam Girdwood mutex_unlock(&rdev->mutex); 2030414c70cbSLiam Girdwood 2031414c70cbSLiam Girdwood if (ret < 0) { 2032414c70cbSLiam Girdwood printk(KERN_ERR "%s: failed to prepare %s\n", 2033414c70cbSLiam Girdwood __func__, rdev->desc->name); 2034414c70cbSLiam Girdwood goto out; 2035414c70cbSLiam Girdwood } 2036414c70cbSLiam Girdwood } 2037414c70cbSLiam Girdwood out: 2038414c70cbSLiam Girdwood mutex_unlock(®ulator_list_mutex); 2039414c70cbSLiam Girdwood return ret; 2040414c70cbSLiam Girdwood } 2041414c70cbSLiam Girdwood EXPORT_SYMBOL_GPL(regulator_suspend_prepare); 2042414c70cbSLiam Girdwood 2043414c70cbSLiam Girdwood /** 2044414c70cbSLiam Girdwood * rdev_get_drvdata - get rdev regulator driver data 204569279fb9SMark Brown * @rdev: regulator 2046414c70cbSLiam Girdwood * 2047414c70cbSLiam Girdwood * Get rdev regulator driver private data. This call can be used in the 2048414c70cbSLiam Girdwood * regulator driver context. 2049414c70cbSLiam Girdwood */ 2050414c70cbSLiam Girdwood void *rdev_get_drvdata(struct regulator_dev *rdev) 2051414c70cbSLiam Girdwood { 2052414c70cbSLiam Girdwood return rdev->reg_data; 2053414c70cbSLiam Girdwood } 2054414c70cbSLiam Girdwood EXPORT_SYMBOL_GPL(rdev_get_drvdata); 2055414c70cbSLiam Girdwood 2056414c70cbSLiam Girdwood /** 2057414c70cbSLiam Girdwood * regulator_get_drvdata - get regulator driver data 2058414c70cbSLiam Girdwood * @regulator: regulator 2059414c70cbSLiam Girdwood * 2060414c70cbSLiam Girdwood * Get regulator driver private data. This call can be used in the consumer 2061414c70cbSLiam Girdwood * driver context when non API regulator specific functions need to be called. 2062414c70cbSLiam Girdwood */ 2063414c70cbSLiam Girdwood void *regulator_get_drvdata(struct regulator *regulator) 2064414c70cbSLiam Girdwood { 2065414c70cbSLiam Girdwood return regulator->rdev->reg_data; 2066414c70cbSLiam Girdwood } 2067414c70cbSLiam Girdwood EXPORT_SYMBOL_GPL(regulator_get_drvdata); 2068414c70cbSLiam Girdwood 2069414c70cbSLiam Girdwood /** 2070414c70cbSLiam Girdwood * regulator_set_drvdata - set regulator driver data 2071414c70cbSLiam Girdwood * @regulator: regulator 2072414c70cbSLiam Girdwood * @data: data 2073414c70cbSLiam Girdwood */ 2074414c70cbSLiam Girdwood void regulator_set_drvdata(struct regulator *regulator, void *data) 2075414c70cbSLiam Girdwood { 2076414c70cbSLiam Girdwood regulator->rdev->reg_data = data; 2077414c70cbSLiam Girdwood } 2078414c70cbSLiam Girdwood EXPORT_SYMBOL_GPL(regulator_set_drvdata); 2079414c70cbSLiam Girdwood 2080414c70cbSLiam Girdwood /** 2081414c70cbSLiam Girdwood * regulator_get_id - get regulator ID 208269279fb9SMark Brown * @rdev: regulator 2083414c70cbSLiam Girdwood */ 2084414c70cbSLiam Girdwood int rdev_get_id(struct regulator_dev *rdev) 2085414c70cbSLiam Girdwood { 2086414c70cbSLiam Girdwood return rdev->desc->id; 2087414c70cbSLiam Girdwood } 2088414c70cbSLiam Girdwood EXPORT_SYMBOL_GPL(rdev_get_id); 2089414c70cbSLiam Girdwood 2090a5766f11SLiam Girdwood struct device *rdev_get_dev(struct regulator_dev *rdev) 2091a5766f11SLiam Girdwood { 2092a5766f11SLiam Girdwood return &rdev->dev; 2093a5766f11SLiam Girdwood } 2094a5766f11SLiam Girdwood EXPORT_SYMBOL_GPL(rdev_get_dev); 2095a5766f11SLiam Girdwood 2096a5766f11SLiam Girdwood void *regulator_get_init_drvdata(struct regulator_init_data *reg_init_data) 2097a5766f11SLiam Girdwood { 2098a5766f11SLiam Girdwood return reg_init_data->driver_data; 2099a5766f11SLiam Girdwood } 2100a5766f11SLiam Girdwood EXPORT_SYMBOL_GPL(regulator_get_init_drvdata); 2101a5766f11SLiam Girdwood 2102414c70cbSLiam Girdwood static int __init regulator_init(void) 2103414c70cbSLiam Girdwood { 2104414c70cbSLiam Girdwood printk(KERN_INFO "regulator: core version %s\n", REGULATOR_VERSION); 2105414c70cbSLiam Girdwood return class_register(®ulator_class); 2106414c70cbSLiam Girdwood } 2107414c70cbSLiam Girdwood 2108414c70cbSLiam Girdwood /* init early to allow our consumers to complete system booting */ 2109414c70cbSLiam Girdwood core_initcall(regulator_init); 2110