2 * max8973-regulator.c -- Maxim max8973
4 * Regulator driver for MAXIM 8973 DC-DC step-down switching regulator.
6 * Copyright (c) 2012, NVIDIA Corporation.
8 * Author: Laxman Dewangan <ldewangan@nvidia.com>
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.
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.
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
25 #include <linux/kernel.h>
26 #include <linux/module.h>
27 #include <linux/init.h>
28 #include <linux/err.h>
30 #include <linux/of_device.h>
31 #include <linux/platform_device.h>
32 #include <linux/regulator/driver.h>
33 #include <linux/regulator/machine.h>
34 #include <linux/regulator/max8973-regulator.h>
35 #include <linux/regulator/of_regulator.h>
36 #include <linux/gpio.h>
37 #include <linux/of_gpio.h>
38 #include <linux/i2c.h>
39 #include <linux/slab.h>
40 #include <linux/regmap.h>
42 /* Register definitions */
43 #define MAX8973_VOUT 0x0
44 #define MAX8973_VOUT_DVS 0x1
45 #define MAX8973_CONTROL1 0x2
46 #define MAX8973_CONTROL2 0x3
47 #define MAX8973_CHIPID1 0x4
48 #define MAX8973_CHIPID2 0x5
50 #define MAX8973_MAX_VOUT_REG 2
53 #define MAX8973_VOUT_ENABLE BIT(7)
54 #define MAX8973_VOUT_MASK 0x7F
56 /* MAX8973_VOUT_DVS */
57 #define MAX8973_DVS_VOUT_MASK 0x7F
59 /* MAX8973_CONTROL1 */
60 #define MAX8973_SNS_ENABLE BIT(7)
61 #define MAX8973_FPWM_EN_M BIT(6)
62 #define MAX8973_NFSR_ENABLE BIT(5)
63 #define MAX8973_AD_ENABLE BIT(4)
64 #define MAX8973_BIAS_ENABLE BIT(3)
65 #define MAX8973_FREQSHIFT_9PER BIT(2)
67 #define MAX8973_RAMP_12mV_PER_US 0x0
68 #define MAX8973_RAMP_25mV_PER_US 0x1
69 #define MAX8973_RAMP_50mV_PER_US 0x2
70 #define MAX8973_RAMP_200mV_PER_US 0x3
71 #define MAX8973_RAMP_MASK 0x3
73 /* MAX8973_CONTROL2 */
74 #define MAX8973_WDTMR_ENABLE BIT(6)
75 #define MAX8973_DISCH_ENBABLE BIT(5)
76 #define MAX8973_FT_ENABLE BIT(4)
78 #define MAX8973_CKKADV_TRIP_DISABLE 0xC
79 #define MAX8973_CKKADV_TRIP_75mV_PER_US 0x0
80 #define MAX8973_CKKADV_TRIP_150mV_PER_US 0x4
81 #define MAX8973_CKKADV_TRIP_75mV_PER_US_HIST_DIS 0x8
82 #define MAX8973_CONTROL_CLKADV_TRIP_MASK 0x00030000
84 #define MAX8973_INDUCTOR_MIN_30_PER 0x0
85 #define MAX8973_INDUCTOR_NOMINAL 0x1
86 #define MAX8973_INDUCTOR_PLUS_30_PER 0x2
87 #define MAX8973_INDUCTOR_PLUS_60_PER 0x3
88 #define MAX8973_CONTROL_INDUCTOR_VALUE_MASK 0x00300000
90 #define MAX8973_MIN_VOLATGE 606250
91 #define MAX8973_MAX_VOLATGE 1400000
92 #define MAX8973_VOLATGE_STEP 6250
93 #define MAX8973_BUCK_N_VOLTAGE 0x80
100 /* Maxim 8973 chip information */
101 struct max8973_chip {
103 struct regulator_desc desc;
104 struct regmap *regmap;
105 bool enable_external_control;
108 int lru_index[MAX8973_MAX_VOUT_REG];
109 int curr_vout_val[MAX8973_MAX_VOUT_REG];
112 struct regulator_ops ops;
117 * find_voltage_set_register: Find new voltage configuration register (VOUT).
118 * The finding of the new VOUT register will be based on the LRU mechanism.
119 * Each VOUT register will have different voltage configured . This
120 * Function will look if any of the VOUT register have requested voltage set
122 * - If it is already there then it will make that register as most
123 * recently used and return as found so that caller need not to set
124 * the VOUT register but need to set the proper gpios to select this
126 * - If requested voltage is not found then it will use the least
127 * recently mechanism to get new VOUT register for new configuration
128 * and will return not_found so that caller need to set new VOUT
129 * register and then gpios (both).
131 static bool find_voltage_set_register(struct max8973_chip *tps,
132 int req_vsel, int *vout_reg, int *gpio_val)
136 int new_vout_reg = tps->lru_index[MAX8973_MAX_VOUT_REG - 1];
137 int found_index = MAX8973_MAX_VOUT_REG - 1;
139 for (i = 0; i < MAX8973_MAX_VOUT_REG; ++i) {
140 if (tps->curr_vout_val[tps->lru_index[i]] == req_vsel) {
141 new_vout_reg = tps->lru_index[i];
144 goto update_lru_index;
149 for (i = found_index; i > 0; i--)
150 tps->lru_index[i] = tps->lru_index[i - 1];
152 tps->lru_index[0] = new_vout_reg;
153 *gpio_val = new_vout_reg;
154 *vout_reg = MAX8973_VOUT + new_vout_reg;
158 static int max8973_dcdc_get_voltage_sel(struct regulator_dev *rdev)
160 struct max8973_chip *max = rdev_get_drvdata(rdev);
164 ret = regmap_read(max->regmap, max->curr_vout_reg, &data);
166 dev_err(max->dev, "register %d read failed, err = %d\n",
167 max->curr_vout_reg, ret);
170 return data & MAX8973_VOUT_MASK;
173 static int max8973_dcdc_set_voltage_sel(struct regulator_dev *rdev,
176 struct max8973_chip *max = rdev_get_drvdata(rdev);
179 int vout_reg = max->curr_vout_reg;
180 int gpio_val = max->curr_gpio_val;
183 * If gpios are available to select the VOUT register then least
184 * recently used register for new configuration.
186 if (gpio_is_valid(max->dvs_gpio))
187 found = find_voltage_set_register(max, vsel,
188 &vout_reg, &gpio_val);
191 ret = regmap_update_bits(max->regmap, vout_reg,
192 MAX8973_VOUT_MASK, vsel);
194 dev_err(max->dev, "register %d update failed, err %d\n",
198 max->curr_vout_reg = vout_reg;
199 max->curr_vout_val[gpio_val] = vsel;
202 /* Select proper VOUT register vio gpios */
203 if (gpio_is_valid(max->dvs_gpio)) {
204 gpio_set_value_cansleep(max->dvs_gpio, gpio_val & 0x1);
205 max->curr_gpio_val = gpio_val;
210 static int max8973_dcdc_set_mode(struct regulator_dev *rdev, unsigned int mode)
212 struct max8973_chip *max = rdev_get_drvdata(rdev);
216 /* Enable force PWM mode in FAST mode only. */
218 case REGULATOR_MODE_FAST:
219 pwm = MAX8973_FPWM_EN_M;
222 case REGULATOR_MODE_NORMAL:
230 ret = regmap_update_bits(max->regmap, MAX8973_CONTROL1,
231 MAX8973_FPWM_EN_M, pwm);
233 dev_err(max->dev, "register %d update failed, err %d\n",
234 MAX8973_CONTROL1, ret);
238 static unsigned int max8973_dcdc_get_mode(struct regulator_dev *rdev)
240 struct max8973_chip *max = rdev_get_drvdata(rdev);
244 ret = regmap_read(max->regmap, MAX8973_CONTROL1, &data);
246 dev_err(max->dev, "register %d read failed, err %d\n",
247 MAX8973_CONTROL1, ret);
250 return (data & MAX8973_FPWM_EN_M) ?
251 REGULATOR_MODE_FAST : REGULATOR_MODE_NORMAL;
254 static int max8973_set_ramp_delay(struct regulator_dev *rdev,
257 struct max8973_chip *max = rdev_get_drvdata(rdev);
258 unsigned int control;
263 if (ramp_delay < 25000) {
264 control = MAX8973_RAMP_12mV_PER_US;
266 } else if (ramp_delay < 50000) {
267 control = MAX8973_RAMP_25mV_PER_US;
269 } else if (ramp_delay < 200000) {
270 control = MAX8973_RAMP_50mV_PER_US;
273 control = MAX8973_RAMP_200mV_PER_US;
277 ret = regmap_update_bits(max->regmap, MAX8973_CONTROL1,
278 MAX8973_RAMP_MASK, control);
280 dev_err(max->dev, "register %d update failed, %d",
281 MAX8973_CONTROL1, ret);
285 static const struct regulator_ops max8973_dcdc_ops = {
286 .get_voltage_sel = max8973_dcdc_get_voltage_sel,
287 .set_voltage_sel = max8973_dcdc_set_voltage_sel,
288 .list_voltage = regulator_list_voltage_linear,
289 .set_mode = max8973_dcdc_set_mode,
290 .get_mode = max8973_dcdc_get_mode,
291 .set_voltage_time_sel = regulator_set_voltage_time_sel,
292 .set_ramp_delay = max8973_set_ramp_delay,
295 static int max8973_init_dcdc(struct max8973_chip *max,
296 struct max8973_regulator_platform_data *pdata)
299 uint8_t control1 = 0;
300 uint8_t control2 = 0;
303 ret = regmap_read(max->regmap, MAX8973_CONTROL1, &data);
305 dev_err(max->dev, "register %d read failed, err = %d",
306 MAX8973_CONTROL1, ret);
309 control1 = data & MAX8973_RAMP_MASK;
311 case MAX8973_RAMP_12mV_PER_US:
312 max->desc.ramp_delay = 12000;
314 case MAX8973_RAMP_25mV_PER_US:
315 max->desc.ramp_delay = 25000;
317 case MAX8973_RAMP_50mV_PER_US:
318 max->desc.ramp_delay = 50000;
320 case MAX8973_RAMP_200mV_PER_US:
321 max->desc.ramp_delay = 200000;
325 if (pdata->control_flags & MAX8973_CONTROL_REMOTE_SENSE_ENABLE)
326 control1 |= MAX8973_SNS_ENABLE;
328 if (!(pdata->control_flags & MAX8973_CONTROL_FALLING_SLEW_RATE_ENABLE))
329 control1 |= MAX8973_NFSR_ENABLE;
331 if (pdata->control_flags & MAX8973_CONTROL_OUTPUT_ACTIVE_DISCH_ENABLE)
332 control1 |= MAX8973_AD_ENABLE;
334 if (pdata->control_flags & MAX8973_CONTROL_BIAS_ENABLE) {
335 control1 |= MAX8973_BIAS_ENABLE;
336 max->desc.enable_time = 20;
338 max->desc.enable_time = 240;
341 if (pdata->control_flags & MAX8973_CONTROL_FREQ_SHIFT_9PER_ENABLE)
342 control1 |= MAX8973_FREQSHIFT_9PER;
344 if (!(pdata->control_flags & MAX8973_CONTROL_PULL_DOWN_ENABLE))
345 control2 |= MAX8973_DISCH_ENBABLE;
347 /* Clock advance trip configuration */
348 switch (pdata->control_flags & MAX8973_CONTROL_CLKADV_TRIP_MASK) {
349 case MAX8973_CONTROL_CLKADV_TRIP_DISABLED:
350 control2 |= MAX8973_CKKADV_TRIP_DISABLE;
353 case MAX8973_CONTROL_CLKADV_TRIP_75mV_PER_US:
354 control2 |= MAX8973_CKKADV_TRIP_75mV_PER_US;
357 case MAX8973_CONTROL_CLKADV_TRIP_150mV_PER_US:
358 control2 |= MAX8973_CKKADV_TRIP_150mV_PER_US;
361 case MAX8973_CONTROL_CLKADV_TRIP_75mV_PER_US_HIST_DIS:
362 control2 |= MAX8973_CKKADV_TRIP_75mV_PER_US_HIST_DIS;
366 /* Configure inductor value */
367 switch (pdata->control_flags & MAX8973_CONTROL_INDUCTOR_VALUE_MASK) {
368 case MAX8973_CONTROL_INDUCTOR_VALUE_NOMINAL:
369 control2 |= MAX8973_INDUCTOR_NOMINAL;
372 case MAX8973_CONTROL_INDUCTOR_VALUE_MINUS_30_PER:
373 control2 |= MAX8973_INDUCTOR_MIN_30_PER;
376 case MAX8973_CONTROL_INDUCTOR_VALUE_PLUS_30_PER:
377 control2 |= MAX8973_INDUCTOR_PLUS_30_PER;
380 case MAX8973_CONTROL_INDUCTOR_VALUE_PLUS_60_PER:
381 control2 |= MAX8973_INDUCTOR_PLUS_60_PER;
385 ret = regmap_write(max->regmap, MAX8973_CONTROL1, control1);
387 dev_err(max->dev, "register %d write failed, err = %d",
388 MAX8973_CONTROL1, ret);
392 ret = regmap_write(max->regmap, MAX8973_CONTROL2, control2);
394 dev_err(max->dev, "register %d write failed, err = %d",
395 MAX8973_CONTROL2, ret);
399 /* If external control is enabled then disable EN bit */
400 if (max->enable_external_control && (max->id == MAX8973)) {
401 ret = regmap_update_bits(max->regmap, MAX8973_VOUT,
402 MAX8973_VOUT_ENABLE, 0);
404 dev_err(max->dev, "register %d update failed, err = %d",
410 static const struct regmap_config max8973_regmap_config = {
413 .max_register = MAX8973_CHIPID2,
414 .cache_type = REGCACHE_RBTREE,
417 static struct max8973_regulator_platform_data *max8973_parse_dt(
420 struct max8973_regulator_platform_data *pdata;
421 struct device_node *np = dev->of_node;
425 bool etr_sensitivity_high;
427 pdata = devm_kzalloc(dev, sizeof(*pdata), GFP_KERNEL);
431 pdata->enable_ext_control = of_property_read_bool(np,
432 "maxim,externally-enable");
433 pdata->enable_gpio = of_get_named_gpio(np, "maxim,enable-gpio", 0);
434 pdata->dvs_gpio = of_get_named_gpio(np, "maxim,dvs-gpio", 0);
436 ret = of_property_read_u32(np, "maxim,dvs-default-state", &pval);
438 pdata->dvs_def_state = pval;
440 if (of_property_read_bool(np, "maxim,enable-remote-sense"))
441 pdata->control_flags |= MAX8973_CONTROL_REMOTE_SENSE_ENABLE;
443 if (of_property_read_bool(np, "maxim,enable-falling-slew-rate"))
444 pdata->control_flags |=
445 MAX8973_CONTROL_FALLING_SLEW_RATE_ENABLE;
447 if (of_property_read_bool(np, "maxim,enable-active-discharge"))
448 pdata->control_flags |=
449 MAX8973_CONTROL_OUTPUT_ACTIVE_DISCH_ENABLE;
451 if (of_property_read_bool(np, "maxim,enable-frequency-shift"))
452 pdata->control_flags |= MAX8973_CONTROL_FREQ_SHIFT_9PER_ENABLE;
454 if (of_property_read_bool(np, "maxim,enable-bias-control"))
455 pdata->control_flags |= MAX8973_CONTROL_BIAS_ENABLE;
457 etr_enable = of_property_read_bool(np, "maxim,enable-etr");
458 etr_sensitivity_high = of_property_read_bool(np,
459 "maxim,enable-high-etr-sensitivity");
460 if (etr_sensitivity_high)
464 if (etr_sensitivity_high)
465 pdata->control_flags |=
466 MAX8973_CONTROL_CLKADV_TRIP_75mV_PER_US;
468 pdata->control_flags |=
469 MAX8973_CONTROL_CLKADV_TRIP_150mV_PER_US;
471 pdata->control_flags |= MAX8973_CONTROL_CLKADV_TRIP_DISABLED;
477 static const struct of_device_id of_max8973_match_tbl[] = {
478 { .compatible = "maxim,max8973", .data = (void *)MAX8973, },
479 { .compatible = "maxim,max77621", .data = (void *)MAX77621, },
482 MODULE_DEVICE_TABLE(of, of_max8973_match_tbl);
484 static int max8973_probe(struct i2c_client *client,
485 const struct i2c_device_id *id)
487 struct max8973_regulator_platform_data *pdata;
488 struct regulator_init_data *ridata;
489 struct regulator_config config = { };
490 struct regulator_dev *rdev;
491 struct max8973_chip *max;
492 bool pdata_from_dt = false;
493 unsigned int chip_id;
496 pdata = dev_get_platdata(&client->dev);
498 if (!pdata && client->dev.of_node) {
499 pdata = max8973_parse_dt(&client->dev);
500 pdata_from_dt = true;
504 dev_err(&client->dev, "No Platform data");
508 if ((pdata->dvs_gpio == -EPROBE_DEFER) ||
509 (pdata->enable_gpio == -EPROBE_DEFER))
510 return -EPROBE_DEFER;
512 max = devm_kzalloc(&client->dev, sizeof(*max), GFP_KERNEL);
516 max->regmap = devm_regmap_init_i2c(client, &max8973_regmap_config);
517 if (IS_ERR(max->regmap)) {
518 ret = PTR_ERR(max->regmap);
519 dev_err(&client->dev, "regmap init failed, err %d\n", ret);
523 if (client->dev.of_node) {
524 const struct of_device_id *match;
526 match = of_match_device(of_match_ptr(of_max8973_match_tbl),
530 max->id = (u32)((uintptr_t)match->data);
532 max->id = id->driver_data;
535 ret = regmap_read(max->regmap, MAX8973_CHIPID1, &chip_id);
537 dev_err(&client->dev, "register CHIPID1 read failed, %d", ret);
541 dev_info(&client->dev, "CHIP-ID OTP: 0x%02x ID_M: 0x%02x\n",
542 (chip_id >> 4) & 0xF, (chip_id >> 1) & 0x7);
544 i2c_set_clientdata(client, max);
545 max->ops = max8973_dcdc_ops;
546 max->dev = &client->dev;
547 max->desc.name = id->name;
549 max->desc.ops = &max->ops;
550 max->desc.type = REGULATOR_VOLTAGE;
551 max->desc.owner = THIS_MODULE;
552 max->desc.min_uV = MAX8973_MIN_VOLATGE;
553 max->desc.uV_step = MAX8973_VOLATGE_STEP;
554 max->desc.n_voltages = MAX8973_BUCK_N_VOLTAGE;
556 max->dvs_gpio = (pdata->dvs_gpio) ? pdata->dvs_gpio : -EINVAL;
557 max->enable_gpio = (pdata->enable_gpio) ? pdata->enable_gpio : -EINVAL;
558 max->enable_external_control = pdata->enable_ext_control;
559 max->curr_gpio_val = pdata->dvs_def_state;
560 max->curr_vout_reg = MAX8973_VOUT + pdata->dvs_def_state;
562 if (gpio_is_valid(max->enable_gpio))
563 max->enable_external_control = true;
565 max->lru_index[0] = max->curr_vout_reg;
567 if (gpio_is_valid(max->dvs_gpio)) {
571 gpio_flags = (pdata->dvs_def_state) ?
572 GPIOF_OUT_INIT_HIGH : GPIOF_OUT_INIT_LOW;
573 ret = devm_gpio_request_one(&client->dev, max->dvs_gpio,
574 gpio_flags, "max8973-dvs");
576 dev_err(&client->dev,
577 "gpio_request for gpio %d failed, err = %d\n",
583 * Initialize the lru index with vout_reg id
584 * The index 0 will be most recently used and
585 * set with the max->curr_vout_reg */
586 for (i = 0; i < MAX8973_MAX_VOUT_REG; ++i)
587 max->lru_index[i] = i;
588 max->lru_index[0] = max->curr_vout_reg;
589 max->lru_index[max->curr_vout_reg] = 0;
593 pdata->reg_init_data = of_get_regulator_init_data(&client->dev,
594 client->dev.of_node, &max->desc);
596 ridata = pdata->reg_init_data;
599 if (!pdata->enable_ext_control) {
600 max->desc.enable_reg = MAX8973_VOUT;
601 max->desc.enable_mask = MAX8973_VOUT_ENABLE;
602 max->ops.enable = regulator_enable_regmap;
603 max->ops.disable = regulator_disable_regmap;
604 max->ops.is_enabled = regulator_is_enabled_regmap;
608 if (gpio_is_valid(max->enable_gpio)) {
609 config.ena_gpio_flags = GPIOF_OUT_INIT_LOW;
610 if (ridata && (ridata->constraints.always_on ||
611 ridata->constraints.boot_on))
612 config.ena_gpio_flags = GPIOF_OUT_INIT_HIGH;
613 config.ena_gpio = max->enable_gpio;
618 if (gpio_is_valid(max->enable_gpio)) {
619 ret = devm_gpio_request_one(&client->dev,
620 max->enable_gpio, GPIOF_OUT_INIT_HIGH,
623 dev_err(&client->dev,
624 "gpio_request for gpio %d failed: %d\n",
625 max->enable_gpio, ret);
630 max->desc.enable_reg = MAX8973_VOUT;
631 max->desc.enable_mask = MAX8973_VOUT_ENABLE;
632 max->ops.enable = regulator_enable_regmap;
633 max->ops.disable = regulator_disable_regmap;
634 max->ops.is_enabled = regulator_is_enabled_regmap;
640 ret = max8973_init_dcdc(max, pdata);
642 dev_err(max->dev, "Max8973 Init failed, err = %d\n", ret);
646 config.dev = &client->dev;
647 config.init_data = pdata->reg_init_data;
648 config.driver_data = max;
649 config.of_node = client->dev.of_node;
650 config.regmap = max->regmap;
652 /* Register the regulators */
653 rdev = devm_regulator_register(&client->dev, &max->desc, &config);
656 dev_err(max->dev, "regulator register failed, err %d\n", ret);
663 static const struct i2c_device_id max8973_id[] = {
664 {.name = "max8973", .driver_data = MAX8973},
665 {.name = "max77621", .driver_data = MAX77621},
668 MODULE_DEVICE_TABLE(i2c, max8973_id);
670 static struct i2c_driver max8973_i2c_driver = {
673 .of_match_table = of_max8973_match_tbl,
674 .owner = THIS_MODULE,
676 .probe = max8973_probe,
677 .id_table = max8973_id,
680 static int __init max8973_init(void)
682 return i2c_add_driver(&max8973_i2c_driver);
684 subsys_initcall(max8973_init);
686 static void __exit max8973_cleanup(void)
688 i2c_del_driver(&max8973_i2c_driver);
690 module_exit(max8973_cleanup);
692 MODULE_AUTHOR("Laxman Dewangan <ldewangan@nvidia.com>");
693 MODULE_DESCRIPTION("MAX8973 voltage regulator driver");
694 MODULE_LICENSE("GPL v2");