drivers/regulator/pwm-regulator.c

   1 /*
   2  * Regulator driver for PWM Regulators
   3  *
   4  * Copyright (C) 2014 - STMicroelectronics Inc.
   5  *
   6  * Author: Lee Jones <lee.jones@linaro.org>
   7  *
   8  * This program is free software; you can redistribute it and/or modify
   9  * it under the terms of the GNU General Public License version 2 as
  10  * published by the Free Software Foundation.
  11  */
  12
  13 #include <linux/delay.h>
  14 #include <linux/module.h>
  15 #include <linux/init.h>
  16 #include <linux/err.h>
  17 #include <linux/regulator/driver.h>
  18 #include <linux/regulator/machine.h>
  19 #include <linux/regulator/of_regulator.h>
  20 #include <linux/of.h>
  21 #include <linux/of_device.h>
  22 #include <linux/pwm.h>
  23
  24 struct pwm_regulator_data {
  25         /*  Shared */
  26         struct pwm_device *pwm;
  27
  28         /* Voltage table */
  29         struct pwm_voltages *duty_cycle_table;
  30
  31         /* regulator descriptor */
  32         struct regulator_desc desc;
  33
  34         /* Regulator ops */
  35         struct regulator_ops ops;
  36
  37         int state;
  38
  39         /* Continuous voltage */
  40         int volt_uV;
  41 };
  42
  43 struct pwm_voltages {
  44         unsigned int uV;
  45         unsigned int dutycycle;
  46 };
  47
  48 /**
  49  * Voltage table call-backs
  50  */
  51 static int pwm_regulator_get_voltage_sel(struct regulator_dev *rdev)
  52 {
  53         struct pwm_regulator_data *drvdata = rdev_get_drvdata(rdev);
  54
  55         return drvdata->state;
  56 }
  57
  58 static int pwm_regulator_set_voltage_sel(struct regulator_dev *rdev,
  59                                          unsigned selector)
  60 {
  61         struct pwm_regulator_data *drvdata = rdev_get_drvdata(rdev);
  62         struct pwm_args pargs;
  63         int dutycycle;
  64         int ret;
  65
  66         pwm_get_args(drvdata->pwm, &pargs);
  67
  68         dutycycle = (pargs.period *
  69                     drvdata->duty_cycle_table[selector].dutycycle) / 100;
  70
  71         ret = pwm_config(drvdata->pwm, dutycycle, pargs.period);
  72         if (ret) {
  73                 dev_err(&rdev->dev, "Failed to configure PWM: %d\n", ret);
  74                 return ret;
  75         }
  76
  77         drvdata->state = selector;
  78
  79         return 0;
  80 }
  81
  82 static int pwm_regulator_list_voltage(struct regulator_dev *rdev,
  83                                       unsigned selector)
  84 {
  85         struct pwm_regulator_data *drvdata = rdev_get_drvdata(rdev);
  86
  87         if (selector >= rdev->desc->n_voltages)
  88                 return -EINVAL;
  89
  90         return drvdata->duty_cycle_table[selector].uV;
  91 }
  92
  93 static int pwm_regulator_enable(struct regulator_dev *dev)
  94 {
  95         struct pwm_regulator_data *drvdata = rdev_get_drvdata(dev);
  96
  97         return pwm_enable(drvdata->pwm);
  98 }
  99
 100 static int pwm_regulator_disable(struct regulator_dev *dev)
 101 {
 102         struct pwm_regulator_data *drvdata = rdev_get_drvdata(dev);
 103
 104         pwm_disable(drvdata->pwm);
 105
 106         return 0;
 107 }
 108
 109 static int pwm_regulator_is_enabled(struct regulator_dev *dev)
 110 {
 111         struct pwm_regulator_data *drvdata = rdev_get_drvdata(dev);
 112
 113         return pwm_is_enabled(drvdata->pwm);
 114 }
 115
 116 static int pwm_regulator_get_voltage(struct regulator_dev *rdev)
 117 {
 118         struct pwm_regulator_data *drvdata = rdev_get_drvdata(rdev);
 119
 120         return drvdata->volt_uV;
 121 }
 122
 123 static int pwm_regulator_set_voltage(struct regulator_dev *rdev,
 124                                         int min_uV, int max_uV,
 125                                         unsigned *selector)
 126 {
 127         struct pwm_regulator_data *drvdata = rdev_get_drvdata(rdev);
 128         unsigned int ramp_delay = rdev->constraints->ramp_delay;
 129         struct pwm_args pargs;
 130         unsigned int req_diff = min_uV - rdev->constraints->min_uV;
 131         unsigned int diff;
 132         unsigned int duty_pulse;
 133         u64 req_period;
 134         u32 rem;
 135         int ret;
 136
 137         pwm_get_args(drvdata->pwm, &pargs);
 138         diff = rdev->constraints->max_uV - rdev->constraints->min_uV;
 139
 140         /* First try to find out if we get the iduty cycle time which is
 141          * factor of PWM period time. If (request_diff_to_min * pwm_period)
 142          * is perfect divided by voltage_range_diff then it is possible to
 143          * get duty cycle time which is factor of PWM period. This will help
 144          * to get output voltage nearer to requested value as there is no
 145          * calculation loss.
 146          */
 147         req_period = req_diff * pargs.period;
 148         div_u64_rem(req_period, diff, &rem);
 149         if (!rem) {
 150                 do_div(req_period, diff);
 151                 duty_pulse = (unsigned int)req_period;
 152         } else {
 153                 duty_pulse = (pargs.period / 100) * ((req_diff * 100) / diff);
 154         }
 155
 156         ret = pwm_config(drvdata->pwm, duty_pulse, pargs.period);
 157         if (ret) {
 158                 dev_err(&rdev->dev, "Failed to configure PWM: %d\n", ret);
 159                 return ret;
 160         }
 161
 162         drvdata->volt_uV = min_uV;
 163
 164         /* Delay required by PWM regulator to settle to the new voltage */
 165         usleep_range(ramp_delay, ramp_delay + 1000);
 166
 167         return 0;
 168 }
 169
 170 static struct regulator_ops pwm_regulator_voltage_table_ops = {
 171         .set_voltage_sel = pwm_regulator_set_voltage_sel,
 172         .get_voltage_sel = pwm_regulator_get_voltage_sel,
 173         .list_voltage    = pwm_regulator_list_voltage,
 174         .map_voltage     = regulator_map_voltage_iterate,
 175         .enable          = pwm_regulator_enable,
 176         .disable         = pwm_regulator_disable,
 177         .is_enabled      = pwm_regulator_is_enabled,
 178 };
 179
 180 static struct regulator_ops pwm_regulator_voltage_continuous_ops = {
 181         .get_voltage = pwm_regulator_get_voltage,
 182         .set_voltage = pwm_regulator_set_voltage,
 183         .enable          = pwm_regulator_enable,
 184         .disable         = pwm_regulator_disable,
 185         .is_enabled      = pwm_regulator_is_enabled,
 186 };
 187
 188 static struct regulator_desc pwm_regulator_desc = {
 189         .name           = "pwm-regulator",
 190         .type           = REGULATOR_VOLTAGE,
 191         .owner          = THIS_MODULE,
 192         .supply_name    = "pwm",
 193 };
 194
 195 static int pwm_regulator_init_table(struct platform_device *pdev,
 196                                     struct pwm_regulator_data *drvdata)
 197 {
 198         struct device_node *np = pdev->dev.of_node;
 199         struct pwm_voltages *duty_cycle_table;
 200         unsigned int length = 0;
 201         int ret;
 202
 203         of_find_property(np, "voltage-table", &length);
 204
 205         if ((length < sizeof(*duty_cycle_table)) ||
 206             (length % sizeof(*duty_cycle_table))) {
 207                 dev_err(&pdev->dev, "voltage-table length(%d) is invalid\n",
 208                         length);
 209                 return -EINVAL;
 210         }
 211
 212         duty_cycle_table = devm_kzalloc(&pdev->dev, length, GFP_KERNEL);
 213         if (!duty_cycle_table)
 214                 return -ENOMEM;
 215
 216         ret = of_property_read_u32_array(np, "voltage-table",
 217                                          (u32 *)duty_cycle_table,
 218                                          length / sizeof(u32));
 219         if (ret) {
 220                 dev_err(&pdev->dev, "Failed to read voltage-table: %d\n", ret);
 221                 return ret;
 222         }
 223
 224         drvdata->duty_cycle_table       = duty_cycle_table;
 225         memcpy(&drvdata->ops, &pwm_regulator_voltage_table_ops,
 226                sizeof(drvdata->ops));
 227         drvdata->desc.ops = &drvdata->ops;
 228         drvdata->desc.n_voltages        = length / sizeof(*duty_cycle_table);
 229
 230         return 0;
 231 }
 232
 233 static int pwm_regulator_init_continuous(struct platform_device *pdev,
 234                                          struct pwm_regulator_data *drvdata)
 235 {
 236         memcpy(&drvdata->ops, &pwm_regulator_voltage_continuous_ops,
 237                sizeof(drvdata->ops));
 238         drvdata->desc.ops = &drvdata->ops;
 239         drvdata->desc.continuous_voltage_range = true;
 240
 241         return 0;
 242 }
 243
 244 static int pwm_regulator_probe(struct platform_device *pdev)
 245 {
 246         const struct regulator_init_data *init_data;
 247         struct pwm_regulator_data *drvdata;
 248         struct regulator_dev *regulator;
 249         struct regulator_config config = { };
 250         struct device_node *np = pdev->dev.of_node;
 251         int ret;
 252
 253         if (!np) {
 254                 dev_err(&pdev->dev, "Device Tree node missing\n");
 255                 return -EINVAL;
 256         }
 257
 258         drvdata = devm_kzalloc(&pdev->dev, sizeof(*drvdata), GFP_KERNEL);
 259         if (!drvdata)
 260                 return -ENOMEM;
 261
 262         memcpy(&drvdata->desc, &pwm_regulator_desc, sizeof(drvdata->desc));
 263
 264         if (of_find_property(np, "voltage-table", NULL))
 265                 ret = pwm_regulator_init_table(pdev, drvdata);
 266         else
 267                 ret = pwm_regulator_init_continuous(pdev, drvdata);
 268         if (ret)
 269                 return ret;
 270
 271         init_data = of_get_regulator_init_data(&pdev->dev, np,
 272                                                &drvdata->desc);
 273         if (!init_data)
 274                 return -ENOMEM;
 275
 276         config.of_node = np;
 277         config.dev = &pdev->dev;
 278         config.driver_data = drvdata;
 279         config.init_data = init_data;
 280
 281         drvdata->pwm = devm_pwm_get(&pdev->dev, NULL);
 282         if (IS_ERR(drvdata->pwm)) {
 283                 ret = PTR_ERR(drvdata->pwm);
 284                 dev_err(&pdev->dev, "Failed to get PWM: %d\n", ret);
 285                 return ret;
 286         }
 287
 288         /*
 289          * FIXME: pwm_apply_args() should be removed when switching to the
 290          * atomic PWM API.
 291          */
 292         pwm_apply_args(drvdata->pwm);
 293
 294         regulator = devm_regulator_register(&pdev->dev,
 295                                             &drvdata->desc, &config);
 296         if (IS_ERR(regulator)) {
 297                 ret = PTR_ERR(regulator);
 298                 dev_err(&pdev->dev, "Failed to register regulator %s: %d\n",
 299                         drvdata->desc.name, ret);
 300                 return ret;
 301         }
 302
 303         return 0;
 304 }
 305
 306 static const struct of_device_id pwm_of_match[] = {
 307         { .compatible = "pwm-regulator" },
 308         { },
 309 };
 310 MODULE_DEVICE_TABLE(of, pwm_of_match);
 311
 312 static struct platform_driver pwm_regulator_driver = {
 313         .driver = {
 314                 .name           = "pwm-regulator",
 315                 .of_match_table = of_match_ptr(pwm_of_match),
 316         },
 317         .probe = pwm_regulator_probe,
 318 };
 319
 320 module_platform_driver(pwm_regulator_driver);
 321
 322 MODULE_LICENSE("GPL");
 323 MODULE_AUTHOR("Lee Jones <lee.jones@linaro.org>");
 324 MODULE_DESCRIPTION("PWM Regulator Driver");
 325 MODULE_ALIAS("platform:pwm-regulator");