linux/drivers/regulator/max8973-regulator.c
<<
>>
Prefs
   1/*
   2 * max8973-regulator.c -- Maxim max8973
   3 *
   4 * Regulator driver for MAXIM 8973 DC-DC step-down switching regulator.
   5 *
   6 * Copyright (c) 2012, NVIDIA Corporation.
   7 *
   8 * Author: Laxman Dewangan <ldewangan@nvidia.com>
   9 *
  10 * This program is free software; you can redistribute it and/or
  11 * modify it under the terms of the GNU General Public License as
  12 * published by the Free Software Foundation version 2.
  13 *
  14 * This program is distributed "as is" WITHOUT ANY WARRANTY of any kind,
  15 * whether express or implied; without even the implied warranty of
  16 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  17 * General Public License for more details.
  18 *
  19 * You should have received a copy of the GNU General Public License
  20 * along with this program; if not, write to the Free Software
  21 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA
  22 * 02111-1307, USA
  23 */
  24
  25#include <linux/kernel.h>
  26#include <linux/module.h>
  27#include <linux/init.h>
  28#include <linux/err.h>
  29#include <linux/of.h>
  30#include <linux/platform_device.h>
  31#include <linux/regulator/driver.h>
  32#include <linux/regulator/machine.h>
  33#include <linux/regulator/max8973-regulator.h>
  34#include <linux/regulator/of_regulator.h>
  35#include <linux/gpio.h>
  36#include <linux/i2c.h>
  37#include <linux/slab.h>
  38#include <linux/regmap.h>
  39
  40/* Register definitions */
  41#define MAX8973_VOUT                                    0x0
  42#define MAX8973_VOUT_DVS                                0x1
  43#define MAX8973_CONTROL1                                0x2
  44#define MAX8973_CONTROL2                                0x3
  45#define MAX8973_CHIPID1                                 0x4
  46#define MAX8973_CHIPID2                                 0x5
  47
  48#define MAX8973_MAX_VOUT_REG                            2
  49
  50/* MAX8973_VOUT */
  51#define MAX8973_VOUT_ENABLE                             BIT(7)
  52#define MAX8973_VOUT_MASK                               0x7F
  53
  54/* MAX8973_VOUT_DVS */
  55#define MAX8973_DVS_VOUT_MASK                           0x7F
  56
  57/* MAX8973_CONTROL1 */
  58#define MAX8973_SNS_ENABLE                              BIT(7)
  59#define MAX8973_FPWM_EN_M                               BIT(6)
  60#define MAX8973_NFSR_ENABLE                             BIT(5)
  61#define MAX8973_AD_ENABLE                               BIT(4)
  62#define MAX8973_BIAS_ENABLE                             BIT(3)
  63#define MAX8973_FREQSHIFT_9PER                          BIT(2)
  64
  65#define MAX8973_RAMP_12mV_PER_US                        0x0
  66#define MAX8973_RAMP_25mV_PER_US                        0x1
  67#define MAX8973_RAMP_50mV_PER_US                        0x2
  68#define MAX8973_RAMP_200mV_PER_US                       0x3
  69
  70/* MAX8973_CONTROL2 */
  71#define MAX8973_WDTMR_ENABLE                            BIT(6)
  72#define MAX8973_DISCH_ENBABLE                           BIT(5)
  73#define MAX8973_FT_ENABLE                               BIT(4)
  74
  75#define MAX8973_CKKADV_TRIP_DISABLE                     0xC
  76#define MAX8973_CKKADV_TRIP_75mV_PER_US                 0x0
  77#define MAX8973_CKKADV_TRIP_150mV_PER_US                0x4
  78#define MAX8973_CKKADV_TRIP_75mV_PER_US_HIST_DIS        0x8
  79#define MAX8973_CONTROL_CLKADV_TRIP_MASK                0x00030000
  80
  81#define MAX8973_INDUCTOR_MIN_30_PER                     0x0
  82#define MAX8973_INDUCTOR_NOMINAL                        0x1
  83#define MAX8973_INDUCTOR_PLUS_30_PER                    0x2
  84#define MAX8973_INDUCTOR_PLUS_60_PER                    0x3
  85#define MAX8973_CONTROL_INDUCTOR_VALUE_MASK             0x00300000
  86
  87#define MAX8973_MIN_VOLATGE                             606250
  88#define MAX8973_MAX_VOLATGE                             1400000
  89#define MAX8973_VOLATGE_STEP                            6250
  90#define MAX8973_BUCK_N_VOLTAGE                          0x80
  91
  92/* Maxim 8973 chip information */
  93struct max8973_chip {
  94        struct device *dev;
  95        struct regulator_desc desc;
  96        struct regulator_dev *rdev;
  97        struct regmap *regmap;
  98        bool enable_external_control;
  99        int dvs_gpio;
 100        int lru_index[MAX8973_MAX_VOUT_REG];
 101        int curr_vout_val[MAX8973_MAX_VOUT_REG];
 102        int curr_vout_reg;
 103        int curr_gpio_val;
 104        bool valid_dvs_gpio;
 105        struct regulator_ops ops;
 106};
 107
 108/*
 109 * find_voltage_set_register: Find new voltage configuration register (VOUT).
 110 * The finding of the new VOUT register will be based on the LRU mechanism.
 111 * Each VOUT register will have different voltage configured . This
 112 * Function will look if any of the VOUT register have requested voltage set
 113 * or not.
 114 *     - If it is already there then it will make that register as most
 115 *       recently used and return as found so that caller need not to set
 116 *       the VOUT register but need to set the proper gpios to select this
 117 *       VOUT register.
 118 *     - If requested voltage is not found then it will use the least
 119 *       recently mechanism to get new VOUT register for new configuration
 120 *       and will return not_found so that caller need to set new VOUT
 121 *       register and then gpios (both).
 122 */
 123static bool find_voltage_set_register(struct max8973_chip *tps,
 124                int req_vsel, int *vout_reg, int *gpio_val)
 125{
 126        int i;
 127        bool found = false;
 128        int new_vout_reg = tps->lru_index[MAX8973_MAX_VOUT_REG - 1];
 129        int found_index = MAX8973_MAX_VOUT_REG - 1;
 130
 131        for (i = 0; i < MAX8973_MAX_VOUT_REG; ++i) {
 132                if (tps->curr_vout_val[tps->lru_index[i]] == req_vsel) {
 133                        new_vout_reg = tps->lru_index[i];
 134                        found_index = i;
 135                        found = true;
 136                        goto update_lru_index;
 137                }
 138        }
 139
 140update_lru_index:
 141        for (i = found_index; i > 0; i--)
 142                tps->lru_index[i] = tps->lru_index[i - 1];
 143
 144        tps->lru_index[0] = new_vout_reg;
 145        *gpio_val = new_vout_reg;
 146        *vout_reg = MAX8973_VOUT + new_vout_reg;
 147        return found;
 148}
 149
 150static int max8973_dcdc_get_voltage_sel(struct regulator_dev *rdev)
 151{
 152        struct max8973_chip *max = rdev_get_drvdata(rdev);
 153        unsigned int data;
 154        int ret;
 155
 156        ret = regmap_read(max->regmap, max->curr_vout_reg, &data);
 157        if (ret < 0) {
 158                dev_err(max->dev, "register %d read failed, err = %d\n",
 159                        max->curr_vout_reg, ret);
 160                return ret;
 161        }
 162        return data & MAX8973_VOUT_MASK;
 163}
 164
 165static int max8973_dcdc_set_voltage_sel(struct regulator_dev *rdev,
 166             unsigned vsel)
 167{
 168        struct max8973_chip *max = rdev_get_drvdata(rdev);
 169        int ret;
 170        bool found = false;
 171        int vout_reg = max->curr_vout_reg;
 172        int gpio_val = max->curr_gpio_val;
 173
 174        /*
 175         * If gpios are available to select the VOUT register then least
 176         * recently used register for new configuration.
 177         */
 178        if (max->valid_dvs_gpio)
 179                found = find_voltage_set_register(max, vsel,
 180                                        &vout_reg, &gpio_val);
 181
 182        if (!found) {
 183                ret = regmap_update_bits(max->regmap, vout_reg,
 184                                        MAX8973_VOUT_MASK, vsel);
 185                if (ret < 0) {
 186                        dev_err(max->dev, "register %d update failed, err %d\n",
 187                                 vout_reg, ret);
 188                        return ret;
 189                }
 190                max->curr_vout_reg = vout_reg;
 191                max->curr_vout_val[gpio_val] = vsel;
 192        }
 193
 194        /* Select proper VOUT register vio gpios */
 195        if (max->valid_dvs_gpio) {
 196                gpio_set_value_cansleep(max->dvs_gpio, gpio_val & 0x1);
 197                max->curr_gpio_val = gpio_val;
 198        }
 199        return 0;
 200}
 201
 202static int max8973_dcdc_set_mode(struct regulator_dev *rdev, unsigned int mode)
 203{
 204        struct max8973_chip *max = rdev_get_drvdata(rdev);
 205        int ret;
 206        int pwm;
 207
 208        /* Enable force PWM mode in FAST mode only. */
 209        switch (mode) {
 210        case REGULATOR_MODE_FAST:
 211                pwm = MAX8973_FPWM_EN_M;
 212                break;
 213
 214        case REGULATOR_MODE_NORMAL:
 215                pwm = 0;
 216                break;
 217
 218        default:
 219                return -EINVAL;
 220        }
 221
 222        ret = regmap_update_bits(max->regmap, MAX8973_CONTROL1,
 223                                MAX8973_FPWM_EN_M, pwm);
 224        if (ret < 0)
 225                dev_err(max->dev, "register %d update failed, err %d\n",
 226                                MAX8973_CONTROL1, ret);
 227        return ret;
 228}
 229
 230static unsigned int max8973_dcdc_get_mode(struct regulator_dev *rdev)
 231{
 232        struct max8973_chip *max = rdev_get_drvdata(rdev);
 233        unsigned int data;
 234        int ret;
 235
 236        ret = regmap_read(max->regmap, MAX8973_CONTROL1, &data);
 237        if (ret < 0) {
 238                dev_err(max->dev, "register %d read failed, err %d\n",
 239                                MAX8973_CONTROL1, ret);
 240                return ret;
 241        }
 242        return (data & MAX8973_FPWM_EN_M) ?
 243                REGULATOR_MODE_FAST : REGULATOR_MODE_NORMAL;
 244}
 245
 246static const struct regulator_ops max8973_dcdc_ops = {
 247        .get_voltage_sel        = max8973_dcdc_get_voltage_sel,
 248        .set_voltage_sel        = max8973_dcdc_set_voltage_sel,
 249        .list_voltage           = regulator_list_voltage_linear,
 250        .set_mode               = max8973_dcdc_set_mode,
 251        .get_mode               = max8973_dcdc_get_mode,
 252};
 253
 254static int max8973_init_dcdc(struct max8973_chip *max,
 255                             struct max8973_regulator_platform_data *pdata)
 256{
 257        int ret;
 258        uint8_t control1 = 0;
 259        uint8_t control2 = 0;
 260
 261        if (pdata->control_flags & MAX8973_CONTROL_REMOTE_SENSE_ENABLE)
 262                control1 |= MAX8973_SNS_ENABLE;
 263
 264        if (!(pdata->control_flags & MAX8973_CONTROL_FALLING_SLEW_RATE_ENABLE))
 265                control1 |= MAX8973_NFSR_ENABLE;
 266
 267        if (pdata->control_flags & MAX8973_CONTROL_OUTPUT_ACTIVE_DISCH_ENABLE)
 268                control1 |= MAX8973_AD_ENABLE;
 269
 270        if (pdata->control_flags & MAX8973_CONTROL_BIAS_ENABLE)
 271                control1 |= MAX8973_BIAS_ENABLE;
 272
 273        if (pdata->control_flags & MAX8973_CONTROL_FREQ_SHIFT_9PER_ENABLE)
 274                control1 |= MAX8973_FREQSHIFT_9PER;
 275
 276        /* Set ramp delay */
 277        if (pdata->reg_init_data &&
 278                        pdata->reg_init_data->constraints.ramp_delay) {
 279                if (pdata->reg_init_data->constraints.ramp_delay < 25000)
 280                        control1 |= MAX8973_RAMP_12mV_PER_US;
 281                else if (pdata->reg_init_data->constraints.ramp_delay < 50000)
 282                        control1 |= MAX8973_RAMP_25mV_PER_US;
 283                else if (pdata->reg_init_data->constraints.ramp_delay < 200000)
 284                        control1 |= MAX8973_RAMP_50mV_PER_US;
 285                else
 286                        control1 |= MAX8973_RAMP_200mV_PER_US;
 287        } else {
 288                control1 |= MAX8973_RAMP_12mV_PER_US;
 289                max->desc.ramp_delay = 12500;
 290        }
 291
 292        if (!(pdata->control_flags & MAX8973_CONTROL_PULL_DOWN_ENABLE))
 293                control2 |= MAX8973_DISCH_ENBABLE;
 294
 295        /*  Clock advance trip configuration */
 296        switch (pdata->control_flags & MAX8973_CONTROL_CLKADV_TRIP_MASK) {
 297        case MAX8973_CONTROL_CLKADV_TRIP_DISABLED:
 298                control2 |= MAX8973_CKKADV_TRIP_DISABLE;
 299                break;
 300
 301        case MAX8973_CONTROL_CLKADV_TRIP_75mV_PER_US:
 302                control2 |= MAX8973_CKKADV_TRIP_75mV_PER_US;
 303                break;
 304
 305        case MAX8973_CONTROL_CLKADV_TRIP_150mV_PER_US:
 306                control2 |= MAX8973_CKKADV_TRIP_150mV_PER_US;
 307                break;
 308
 309        case MAX8973_CONTROL_CLKADV_TRIP_75mV_PER_US_HIST_DIS:
 310                control2 |= MAX8973_CKKADV_TRIP_75mV_PER_US_HIST_DIS;
 311                break;
 312        }
 313
 314        /* Configure inductor value */
 315        switch (pdata->control_flags & MAX8973_CONTROL_INDUCTOR_VALUE_MASK) {
 316        case MAX8973_CONTROL_INDUCTOR_VALUE_NOMINAL:
 317                control2 |= MAX8973_INDUCTOR_NOMINAL;
 318                break;
 319
 320        case MAX8973_CONTROL_INDUCTOR_VALUE_MINUS_30_PER:
 321                control2 |= MAX8973_INDUCTOR_MIN_30_PER;
 322                break;
 323
 324        case MAX8973_CONTROL_INDUCTOR_VALUE_PLUS_30_PER:
 325                control2 |= MAX8973_INDUCTOR_PLUS_30_PER;
 326                break;
 327
 328        case MAX8973_CONTROL_INDUCTOR_VALUE_PLUS_60_PER:
 329                control2 |= MAX8973_INDUCTOR_PLUS_60_PER;
 330                break;
 331        }
 332
 333        ret = regmap_write(max->regmap, MAX8973_CONTROL1, control1);
 334        if (ret < 0) {
 335                dev_err(max->dev, "register %d write failed, err = %d",
 336                                MAX8973_CONTROL1, ret);
 337                return ret;
 338        }
 339
 340        ret = regmap_write(max->regmap, MAX8973_CONTROL2, control2);
 341        if (ret < 0) {
 342                dev_err(max->dev, "register %d write failed, err = %d",
 343                                MAX8973_CONTROL2, ret);
 344                return ret;
 345        }
 346
 347        /* If external control is enabled then disable EN bit */
 348        if (max->enable_external_control) {
 349                ret = regmap_update_bits(max->regmap, MAX8973_VOUT,
 350                                                MAX8973_VOUT_ENABLE, 0);
 351                if (ret < 0)
 352                        dev_err(max->dev, "register %d update failed, err = %d",
 353                                MAX8973_VOUT, ret);
 354        }
 355        return ret;
 356}
 357
 358static const struct regmap_config max8973_regmap_config = {
 359        .reg_bits               = 8,
 360        .val_bits               = 8,
 361        .max_register           = MAX8973_CHIPID2,
 362        .cache_type             = REGCACHE_RBTREE,
 363};
 364
 365static int max8973_probe(struct i2c_client *client,
 366                         const struct i2c_device_id *id)
 367{
 368        struct max8973_regulator_platform_data *pdata;
 369        struct regulator_config config = { };
 370        struct regulator_dev *rdev;
 371        struct max8973_chip *max;
 372        int ret;
 373
 374        pdata = client->dev.platform_data;
 375
 376        if (!pdata && !client->dev.of_node) {
 377                dev_err(&client->dev, "No Platform data");
 378                return -EIO;
 379        }
 380
 381        max = devm_kzalloc(&client->dev, sizeof(*max), GFP_KERNEL);
 382        if (!max) {
 383                dev_err(&client->dev, "Memory allocation for max failed\n");
 384                return -ENOMEM;
 385        }
 386
 387        max->regmap = devm_regmap_init_i2c(client, &max8973_regmap_config);
 388        if (IS_ERR(max->regmap)) {
 389                ret = PTR_ERR(max->regmap);
 390                dev_err(&client->dev, "regmap init failed, err %d\n", ret);
 391                return ret;
 392        }
 393
 394        i2c_set_clientdata(client, max);
 395        max->ops = max8973_dcdc_ops;
 396        max->dev = &client->dev;
 397        max->desc.name = id->name;
 398        max->desc.id = 0;
 399        max->desc.ops = &max->ops;
 400        max->desc.type = REGULATOR_VOLTAGE;
 401        max->desc.owner = THIS_MODULE;
 402        max->desc.min_uV = MAX8973_MIN_VOLATGE;
 403        max->desc.uV_step = MAX8973_VOLATGE_STEP;
 404        max->desc.n_voltages = MAX8973_BUCK_N_VOLTAGE;
 405
 406        if (!pdata || !pdata->enable_ext_control) {
 407                max->desc.enable_reg = MAX8973_VOUT;
 408                max->desc.enable_mask = MAX8973_VOUT_ENABLE;
 409                max->ops.enable = regulator_enable_regmap;
 410                max->ops.disable = regulator_disable_regmap;
 411                max->ops.is_enabled = regulator_is_enabled_regmap;
 412        }
 413
 414        if (pdata) {
 415                max->dvs_gpio = pdata->dvs_gpio;
 416                max->enable_external_control = pdata->enable_ext_control;
 417                max->curr_gpio_val = pdata->dvs_def_state;
 418                max->curr_vout_reg = MAX8973_VOUT + pdata->dvs_def_state;
 419        } else {
 420                max->dvs_gpio = -EINVAL;
 421                max->curr_vout_reg = MAX8973_VOUT;
 422        }
 423
 424        max->lru_index[0] = max->curr_vout_reg;
 425
 426        if (gpio_is_valid(max->dvs_gpio)) {
 427                int gpio_flags;
 428                int i;
 429
 430                gpio_flags = (pdata->dvs_def_state) ?
 431                                GPIOF_OUT_INIT_HIGH : GPIOF_OUT_INIT_LOW;
 432                ret = devm_gpio_request_one(&client->dev, max->dvs_gpio,
 433                                gpio_flags, "max8973-dvs");
 434                if (ret) {
 435                        dev_err(&client->dev,
 436                                "gpio_request for gpio %d failed, err = %d\n",
 437                                max->dvs_gpio, ret);
 438                        return ret;
 439                }
 440                max->valid_dvs_gpio = true;
 441
 442                /*
 443                 * Initialize the lru index with vout_reg id
 444                 * The index 0 will be most recently used and
 445                 * set with the max->curr_vout_reg */
 446                for (i = 0; i < MAX8973_MAX_VOUT_REG; ++i)
 447                        max->lru_index[i] = i;
 448                max->lru_index[0] = max->curr_vout_reg;
 449                max->lru_index[max->curr_vout_reg] = 0;
 450        } else {
 451                max->valid_dvs_gpio = false;
 452        }
 453
 454        if (pdata) {
 455                ret = max8973_init_dcdc(max, pdata);
 456                if (ret < 0) {
 457                        dev_err(max->dev, "Max8973 Init failed, err = %d\n", ret);
 458                        return ret;
 459                }
 460        }
 461
 462        config.dev = &client->dev;
 463        config.init_data = pdata ? pdata->reg_init_data :
 464                of_get_regulator_init_data(&client->dev, client->dev.of_node);
 465        config.driver_data = max;
 466        config.of_node = client->dev.of_node;
 467        config.regmap = max->regmap;
 468
 469        /* Register the regulators */
 470        rdev = regulator_register(&max->desc, &config);
 471        if (IS_ERR(rdev)) {
 472                ret = PTR_ERR(rdev);
 473                dev_err(max->dev, "regulator register failed, err %d\n", ret);
 474                return ret;
 475        }
 476
 477        max->rdev = rdev;
 478        return 0;
 479}
 480
 481static int max8973_remove(struct i2c_client *client)
 482{
 483        struct max8973_chip *max = i2c_get_clientdata(client);
 484
 485        regulator_unregister(max->rdev);
 486        return 0;
 487}
 488
 489static const struct i2c_device_id max8973_id[] = {
 490        {.name = "max8973",},
 491        {},
 492};
 493
 494MODULE_DEVICE_TABLE(i2c, max8973_id);
 495
 496static struct i2c_driver max8973_i2c_driver = {
 497        .driver = {
 498                .name = "max8973",
 499                .owner = THIS_MODULE,
 500        },
 501        .probe = max8973_probe,
 502        .remove = max8973_remove,
 503        .id_table = max8973_id,
 504};
 505
 506static int __init max8973_init(void)
 507{
 508        return i2c_add_driver(&max8973_i2c_driver);
 509}
 510subsys_initcall(max8973_init);
 511
 512static void __exit max8973_cleanup(void)
 513{
 514        i2c_del_driver(&max8973_i2c_driver);
 515}
 516module_exit(max8973_cleanup);
 517
 518MODULE_AUTHOR("Laxman Dewangan <ldewangan@nvidia.com>");
 519MODULE_DESCRIPTION("MAX8973 voltage regulator driver");
 520MODULE_LICENSE("GPL v2");
 521