1// SPDX-License-Identifier: GPL-2.0+
2//
3// max8997.c - Regulator driver for the Maxim 8997/8966
4//
5// Copyright (C) 2011 Samsung Electronics
6// MyungJoo Ham <myungjoo.ham@samsung.com>
7//
8// This driver is based on max8998.c
9
10#include <linux/bug.h>
11#include <linux/err.h>
12#include <linux/gpio/consumer.h>
13#include <linux/slab.h>
14#include <linux/module.h>
15#include <linux/platform_device.h>
16#include <linux/regulator/driver.h>
17#include <linux/regulator/machine.h>
18#include <linux/mfd/max8997.h>
19#include <linux/mfd/max8997-private.h>
20#include <linux/regulator/of_regulator.h>
21
22struct max8997_data {
23 struct device *dev;
24 struct max8997_dev *iodev;
25 int num_regulators;
26 int ramp_delay; /* in mV/us */
27
28 bool buck1_gpiodvs;
29 bool buck2_gpiodvs;
30 bool buck5_gpiodvs;
31 u8 buck1_vol[8];
32 u8 buck2_vol[8];
33 u8 buck5_vol[8];
34 struct gpio_desc *buck125_gpiods[3];
35 int buck125_gpioindex;
36 bool ignore_gpiodvs_side_effect;
37
38 u8 saved_states[MAX8997_REG_MAX];
39};
40
41static const unsigned int safeoutvolt[] = {
42 4850000,
43 4900000,
44 4950000,
45 3300000,
46};
47
48static inline void max8997_set_gpio(struct max8997_data *max8997)
49{
50 int set3 = (max8997->buck125_gpioindex) & 0x1;
51 int set2 = ((max8997->buck125_gpioindex) >> 1) & 0x1;
52 int set1 = ((max8997->buck125_gpioindex) >> 2) & 0x1;
53
54 gpiod_set_value(desc: max8997->buck125_gpiods[0], value: set1);
55 gpiod_set_value(desc: max8997->buck125_gpiods[1], value: set2);
56 gpiod_set_value(desc: max8997->buck125_gpiods[2], value: set3);
57}
58
59struct voltage_map_desc {
60 int min;
61 int max;
62 int step;
63};
64
65/* Voltage maps in uV */
66static const struct voltage_map_desc ldo_voltage_map_desc = {
67 .min = 800000, .max = 3950000, .step = 50000,
68}; /* LDO1 ~ 18, 21 all */
69
70static const struct voltage_map_desc buck1245_voltage_map_desc = {
71 .min = 650000, .max = 2225000, .step = 25000,
72}; /* Buck1, 2, 4, 5 */
73
74static const struct voltage_map_desc buck37_voltage_map_desc = {
75 .min = 750000, .max = 3900000, .step = 50000,
76}; /* Buck3, 7 */
77
78/* current map in uA */
79static const struct voltage_map_desc charger_current_map_desc = {
80 .min = 200000, .max = 950000, .step = 50000,
81};
82
83static const struct voltage_map_desc topoff_current_map_desc = {
84 .min = 50000, .max = 200000, .step = 10000,
85};
86
87static const struct voltage_map_desc *reg_voltage_map[] = {
88 [MAX8997_LDO1] = &ldo_voltage_map_desc,
89 [MAX8997_LDO2] = &ldo_voltage_map_desc,
90 [MAX8997_LDO3] = &ldo_voltage_map_desc,
91 [MAX8997_LDO4] = &ldo_voltage_map_desc,
92 [MAX8997_LDO5] = &ldo_voltage_map_desc,
93 [MAX8997_LDO6] = &ldo_voltage_map_desc,
94 [MAX8997_LDO7] = &ldo_voltage_map_desc,
95 [MAX8997_LDO8] = &ldo_voltage_map_desc,
96 [MAX8997_LDO9] = &ldo_voltage_map_desc,
97 [MAX8997_LDO10] = &ldo_voltage_map_desc,
98 [MAX8997_LDO11] = &ldo_voltage_map_desc,
99 [MAX8997_LDO12] = &ldo_voltage_map_desc,
100 [MAX8997_LDO13] = &ldo_voltage_map_desc,
101 [MAX8997_LDO14] = &ldo_voltage_map_desc,
102 [MAX8997_LDO15] = &ldo_voltage_map_desc,
103 [MAX8997_LDO16] = &ldo_voltage_map_desc,
104 [MAX8997_LDO17] = &ldo_voltage_map_desc,
105 [MAX8997_LDO18] = &ldo_voltage_map_desc,
106 [MAX8997_LDO21] = &ldo_voltage_map_desc,
107 [MAX8997_BUCK1] = &buck1245_voltage_map_desc,
108 [MAX8997_BUCK2] = &buck1245_voltage_map_desc,
109 [MAX8997_BUCK3] = &buck37_voltage_map_desc,
110 [MAX8997_BUCK4] = &buck1245_voltage_map_desc,
111 [MAX8997_BUCK5] = &buck1245_voltage_map_desc,
112 [MAX8997_BUCK6] = NULL,
113 [MAX8997_BUCK7] = &buck37_voltage_map_desc,
114 [MAX8997_EN32KHZ_AP] = NULL,
115 [MAX8997_EN32KHZ_CP] = NULL,
116 [MAX8997_ENVICHG] = NULL,
117 [MAX8997_ESAFEOUT1] = NULL,
118 [MAX8997_ESAFEOUT2] = NULL,
119 [MAX8997_CHARGER_CV] = NULL,
120 [MAX8997_CHARGER] = &charger_current_map_desc,
121 [MAX8997_CHARGER_TOPOFF] = &topoff_current_map_desc,
122};
123
124static int max8997_list_voltage_charger_cv(struct regulator_dev *rdev,
125 unsigned int selector)
126{
127 int rid = rdev_get_id(rdev);
128
129 if (rid != MAX8997_CHARGER_CV)
130 goto err;
131
132 switch (selector) {
133 case 0x00:
134 return 4200000;
135 case 0x01 ... 0x0E:
136 return 4000000 + 20000 * (selector - 0x01);
137 case 0x0F:
138 return 4350000;
139 default:
140 return -EINVAL;
141 }
142err:
143 return -EINVAL;
144}
145
146static int max8997_list_voltage(struct regulator_dev *rdev,
147 unsigned int selector)
148{
149 const struct voltage_map_desc *desc;
150 int rid = rdev_get_id(rdev);
151 int val;
152
153 if (rid < 0 || rid >= ARRAY_SIZE(reg_voltage_map))
154 return -EINVAL;
155
156 desc = reg_voltage_map[rid];
157 if (desc == NULL)
158 return -EINVAL;
159
160 val = desc->min + desc->step * selector;
161 if (val > desc->max)
162 return -EINVAL;
163
164 return val;
165}
166
167static int max8997_get_enable_register(struct regulator_dev *rdev,
168 int *reg, int *mask, int *pattern)
169{
170 int rid = rdev_get_id(rdev);
171
172 switch (rid) {
173 case MAX8997_LDO1 ... MAX8997_LDO21:
174 *reg = MAX8997_REG_LDO1CTRL + (rid - MAX8997_LDO1);
175 *mask = 0xC0;
176 *pattern = 0xC0;
177 break;
178 case MAX8997_BUCK1:
179 *reg = MAX8997_REG_BUCK1CTRL;
180 *mask = 0x01;
181 *pattern = 0x01;
182 break;
183 case MAX8997_BUCK2:
184 *reg = MAX8997_REG_BUCK2CTRL;
185 *mask = 0x01;
186 *pattern = 0x01;
187 break;
188 case MAX8997_BUCK3:
189 *reg = MAX8997_REG_BUCK3CTRL;
190 *mask = 0x01;
191 *pattern = 0x01;
192 break;
193 case MAX8997_BUCK4:
194 *reg = MAX8997_REG_BUCK4CTRL;
195 *mask = 0x01;
196 *pattern = 0x01;
197 break;
198 case MAX8997_BUCK5:
199 *reg = MAX8997_REG_BUCK5CTRL;
200 *mask = 0x01;
201 *pattern = 0x01;
202 break;
203 case MAX8997_BUCK6:
204 *reg = MAX8997_REG_BUCK6CTRL;
205 *mask = 0x01;
206 *pattern = 0x01;
207 break;
208 case MAX8997_BUCK7:
209 *reg = MAX8997_REG_BUCK7CTRL;
210 *mask = 0x01;
211 *pattern = 0x01;
212 break;
213 case MAX8997_EN32KHZ_AP ... MAX8997_EN32KHZ_CP:
214 *reg = MAX8997_REG_MAINCON1;
215 *mask = 0x01 << (rid - MAX8997_EN32KHZ_AP);
216 *pattern = 0x01 << (rid - MAX8997_EN32KHZ_AP);
217 break;
218 case MAX8997_ENVICHG:
219 *reg = MAX8997_REG_MBCCTRL1;
220 *mask = 0x80;
221 *pattern = 0x80;
222 break;
223 case MAX8997_ESAFEOUT1 ... MAX8997_ESAFEOUT2:
224 *reg = MAX8997_REG_SAFEOUTCTRL;
225 *mask = 0x40 << (rid - MAX8997_ESAFEOUT1);
226 *pattern = 0x40 << (rid - MAX8997_ESAFEOUT1);
227 break;
228 case MAX8997_CHARGER:
229 *reg = MAX8997_REG_MBCCTRL2;
230 *mask = 0x40;
231 *pattern = 0x40;
232 break;
233 default:
234 /* Not controllable or not exists */
235 return -EINVAL;
236 }
237
238 return 0;
239}
240
241static int max8997_reg_is_enabled(struct regulator_dev *rdev)
242{
243 struct max8997_data *max8997 = rdev_get_drvdata(rdev);
244 struct i2c_client *i2c = max8997->iodev->i2c;
245 int ret, reg, mask, pattern;
246 u8 val;
247
248 ret = max8997_get_enable_register(rdev, reg: &reg, mask: &mask, pattern: &pattern);
249 if (ret)
250 return ret;
251
252 ret = max8997_read_reg(i2c, reg, dest: &val);
253 if (ret)
254 return ret;
255
256 return (val & mask) == pattern;
257}
258
259static int max8997_reg_enable(struct regulator_dev *rdev)
260{
261 struct max8997_data *max8997 = rdev_get_drvdata(rdev);
262 struct i2c_client *i2c = max8997->iodev->i2c;
263 int ret, reg, mask, pattern;
264
265 ret = max8997_get_enable_register(rdev, reg: &reg, mask: &mask, pattern: &pattern);
266 if (ret)
267 return ret;
268
269 return max8997_update_reg(i2c, reg, val: pattern, mask);
270}
271
272static int max8997_reg_disable(struct regulator_dev *rdev)
273{
274 struct max8997_data *max8997 = rdev_get_drvdata(rdev);
275 struct i2c_client *i2c = max8997->iodev->i2c;
276 int ret, reg, mask, pattern;
277
278 ret = max8997_get_enable_register(rdev, reg: &reg, mask: &mask, pattern: &pattern);
279 if (ret)
280 return ret;
281
282 return max8997_update_reg(i2c, reg, val: ~pattern, mask);
283}
284
285static int max8997_get_voltage_register(struct regulator_dev *rdev,
286 int *_reg, int *_shift, int *_mask)
287{
288 struct max8997_data *max8997 = rdev_get_drvdata(rdev);
289 int rid = rdev_get_id(rdev);
290 int reg, shift = 0, mask = 0x3f;
291
292 switch (rid) {
293 case MAX8997_LDO1 ... MAX8997_LDO21:
294 reg = MAX8997_REG_LDO1CTRL + (rid - MAX8997_LDO1);
295 break;
296 case MAX8997_BUCK1:
297 reg = MAX8997_REG_BUCK1DVS1;
298 if (max8997->buck1_gpiodvs)
299 reg += max8997->buck125_gpioindex;
300 break;
301 case MAX8997_BUCK2:
302 reg = MAX8997_REG_BUCK2DVS1;
303 if (max8997->buck2_gpiodvs)
304 reg += max8997->buck125_gpioindex;
305 break;
306 case MAX8997_BUCK3:
307 reg = MAX8997_REG_BUCK3DVS;
308 break;
309 case MAX8997_BUCK4:
310 reg = MAX8997_REG_BUCK4DVS;
311 break;
312 case MAX8997_BUCK5:
313 reg = MAX8997_REG_BUCK5DVS1;
314 if (max8997->buck5_gpiodvs)
315 reg += max8997->buck125_gpioindex;
316 break;
317 case MAX8997_BUCK7:
318 reg = MAX8997_REG_BUCK7DVS;
319 break;
320 case MAX8997_ESAFEOUT1 ... MAX8997_ESAFEOUT2:
321 reg = MAX8997_REG_SAFEOUTCTRL;
322 shift = (rid == MAX8997_ESAFEOUT2) ? 2 : 0;
323 mask = 0x3;
324 break;
325 case MAX8997_CHARGER_CV:
326 reg = MAX8997_REG_MBCCTRL3;
327 shift = 0;
328 mask = 0xf;
329 break;
330 case MAX8997_CHARGER:
331 reg = MAX8997_REG_MBCCTRL4;
332 shift = 0;
333 mask = 0xf;
334 break;
335 case MAX8997_CHARGER_TOPOFF:
336 reg = MAX8997_REG_MBCCTRL5;
337 shift = 0;
338 mask = 0xf;
339 break;
340 default:
341 return -EINVAL;
342 }
343
344 *_reg = reg;
345 *_shift = shift;
346 *_mask = mask;
347
348 return 0;
349}
350
351static int max8997_get_voltage_sel(struct regulator_dev *rdev)
352{
353 struct max8997_data *max8997 = rdev_get_drvdata(rdev);
354 struct i2c_client *i2c = max8997->iodev->i2c;
355 int reg, shift, mask, ret;
356 u8 val;
357
358 ret = max8997_get_voltage_register(rdev, reg: &reg, shift: &shift, mask: &mask);
359 if (ret)
360 return ret;
361
362 ret = max8997_read_reg(i2c, reg, dest: &val);
363 if (ret)
364 return ret;
365
366 val >>= shift;
367 val &= mask;
368
369 return val;
370}
371
372static inline int max8997_get_voltage_proper_val(
373 const struct voltage_map_desc *desc,
374 int min_vol, int max_vol)
375{
376 int i;
377
378 if (desc == NULL)
379 return -EINVAL;
380
381 if (max_vol < desc->min || min_vol > desc->max)
382 return -EINVAL;
383
384 if (min_vol < desc->min)
385 min_vol = desc->min;
386
387 i = DIV_ROUND_UP(min_vol - desc->min, desc->step);
388
389 if (desc->min + desc->step * i > max_vol)
390 return -EINVAL;
391
392 return i;
393}
394
395static int max8997_set_voltage_charger_cv(struct regulator_dev *rdev,
396 int min_uV, int max_uV, unsigned *selector)
397{
398 struct max8997_data *max8997 = rdev_get_drvdata(rdev);
399 struct i2c_client *i2c = max8997->iodev->i2c;
400 int rid = rdev_get_id(rdev);
401 int lb, ub;
402 int reg, shift = 0, mask, ret = 0;
403 u8 val = 0x0;
404
405 if (rid != MAX8997_CHARGER_CV)
406 return -EINVAL;
407
408 ret = max8997_get_voltage_register(rdev, reg: &reg, shift: &shift, mask: &mask);
409 if (ret)
410 return ret;
411
412 if (max_uV < 4000000 || min_uV > 4350000)
413 return -EINVAL;
414
415 if (min_uV <= 4000000)
416 val = 0x1;
417 else if (min_uV <= 4200000 && max_uV >= 4200000)
418 val = 0x0;
419 else {
420 lb = (min_uV - 4000001) / 20000 + 2;
421 ub = (max_uV - 4000000) / 20000 + 1;
422
423 if (lb > ub)
424 return -EINVAL;
425
426 if (lb < 0xf)
427 val = lb;
428 else {
429 if (ub >= 0xf)
430 val = 0xf;
431 else
432 return -EINVAL;
433 }
434 }
435
436 *selector = val;
437
438 ret = max8997_update_reg(i2c, reg, val: val << shift, mask);
439
440 return ret;
441}
442
443/*
444 * For LDO1 ~ LDO21, BUCK1~5, BUCK7, CHARGER, CHARGER_TOPOFF
445 * BUCK1, 2, and 5 are available if they are not controlled by gpio
446 */
447static int max8997_set_voltage_ldobuck(struct regulator_dev *rdev,
448 int min_uV, int max_uV, unsigned *selector)
449{
450 struct max8997_data *max8997 = rdev_get_drvdata(rdev);
451 struct i2c_client *i2c = max8997->iodev->i2c;
452 const struct voltage_map_desc *desc;
453 int rid = rdev_get_id(rdev);
454 int i, reg, shift, mask, ret;
455
456 switch (rid) {
457 case MAX8997_LDO1 ... MAX8997_LDO21:
458 break;
459 case MAX8997_BUCK1 ... MAX8997_BUCK5:
460 break;
461 case MAX8997_BUCK6:
462 return -EINVAL;
463 case MAX8997_BUCK7:
464 break;
465 case MAX8997_CHARGER:
466 break;
467 case MAX8997_CHARGER_TOPOFF:
468 break;
469 default:
470 return -EINVAL;
471 }
472
473 desc = reg_voltage_map[rid];
474
475 i = max8997_get_voltage_proper_val(desc, min_vol: min_uV, max_vol: max_uV);
476 if (i < 0)
477 return i;
478
479 ret = max8997_get_voltage_register(rdev, reg: &reg, shift: &shift, mask: &mask);
480 if (ret)
481 return ret;
482
483 ret = max8997_update_reg(i2c, reg, val: i << shift, mask: mask << shift);
484 *selector = i;
485
486 return ret;
487}
488
489static int max8997_set_voltage_buck_time_sel(struct regulator_dev *rdev,
490 unsigned int old_selector,
491 unsigned int new_selector)
492{
493 struct max8997_data *max8997 = rdev_get_drvdata(rdev);
494 int rid = rdev_get_id(rdev);
495 const struct voltage_map_desc *desc = reg_voltage_map[rid];
496
497 /* Delay is required only if the voltage is increasing */
498 if (old_selector >= new_selector)
499 return 0;
500
501 /* No need to delay if gpio_dvs_mode */
502 switch (rid) {
503 case MAX8997_BUCK1:
504 if (max8997->buck1_gpiodvs)
505 return 0;
506 break;
507 case MAX8997_BUCK2:
508 if (max8997->buck2_gpiodvs)
509 return 0;
510 break;
511 case MAX8997_BUCK5:
512 if (max8997->buck5_gpiodvs)
513 return 0;
514 break;
515 }
516
517 switch (rid) {
518 case MAX8997_BUCK1:
519 case MAX8997_BUCK2:
520 case MAX8997_BUCK4:
521 case MAX8997_BUCK5:
522 return DIV_ROUND_UP(desc->step * (new_selector - old_selector),
523 max8997->ramp_delay * 1000);
524 }
525
526 return 0;
527}
528
529/*
530 * Assess the damage on the voltage setting of BUCK1,2,5 by the change.
531 *
532 * When GPIO-DVS mode is used for multiple bucks, changing the voltage value
533 * of one of the bucks may affect that of another buck, which is the side
534 * effect of the change (set_voltage). This function examines the GPIO-DVS
535 * configurations and checks whether such side-effect exists.
536 */
537static int max8997_assess_side_effect(struct regulator_dev *rdev,
538 u8 new_val, int *best)
539{
540 struct max8997_data *max8997 = rdev_get_drvdata(rdev);
541 int rid = rdev_get_id(rdev);
542 u8 *buckx_val[3];
543 bool buckx_gpiodvs[3];
544 int side_effect[8];
545 int min_side_effect = INT_MAX;
546 int i;
547
548 *best = -1;
549
550 switch (rid) {
551 case MAX8997_BUCK1:
552 rid = 0;
553 break;
554 case MAX8997_BUCK2:
555 rid = 1;
556 break;
557 case MAX8997_BUCK5:
558 rid = 2;
559 break;
560 default:
561 return -EINVAL;
562 }
563
564 buckx_val[0] = max8997->buck1_vol;
565 buckx_val[1] = max8997->buck2_vol;
566 buckx_val[2] = max8997->buck5_vol;
567 buckx_gpiodvs[0] = max8997->buck1_gpiodvs;
568 buckx_gpiodvs[1] = max8997->buck2_gpiodvs;
569 buckx_gpiodvs[2] = max8997->buck5_gpiodvs;
570
571 for (i = 0; i < 8; i++) {
572 int others;
573
574 if (new_val != (buckx_val[rid])[i]) {
575 side_effect[i] = -1;
576 continue;
577 }
578
579 side_effect[i] = 0;
580 for (others = 0; others < 3; others++) {
581 int diff;
582
583 if (others == rid)
584 continue;
585 if (buckx_gpiodvs[others] == false)
586 continue; /* Not affected */
587 diff = (buckx_val[others])[i] -
588 (buckx_val[others])[max8997->buck125_gpioindex];
589 if (diff > 0)
590 side_effect[i] += diff;
591 else if (diff < 0)
592 side_effect[i] -= diff;
593 }
594 if (side_effect[i] == 0) {
595 *best = i;
596 return 0; /* NO SIDE EFFECT! Use This! */
597 }
598 if (side_effect[i] < min_side_effect) {
599 min_side_effect = side_effect[i];
600 *best = i;
601 }
602 }
603
604 if (*best == -1)
605 return -EINVAL;
606
607 return side_effect[*best];
608}
609
610/*
611 * For Buck 1 ~ 5 and 7. If it is not controlled by GPIO, this calls
612 * max8997_set_voltage_ldobuck to do the job.
613 */
614static int max8997_set_voltage_buck(struct regulator_dev *rdev,
615 int min_uV, int max_uV, unsigned *selector)
616{
617 struct max8997_data *max8997 = rdev_get_drvdata(rdev);
618 int rid = rdev_get_id(rdev);
619 const struct voltage_map_desc *desc;
620 int new_val, new_idx, damage, tmp_val, tmp_idx, tmp_dmg;
621 bool gpio_dvs_mode = false;
622
623 if (rid < MAX8997_BUCK1 || rid > MAX8997_BUCK7)
624 return -EINVAL;
625
626 switch (rid) {
627 case MAX8997_BUCK1:
628 if (max8997->buck1_gpiodvs)
629 gpio_dvs_mode = true;
630 break;
631 case MAX8997_BUCK2:
632 if (max8997->buck2_gpiodvs)
633 gpio_dvs_mode = true;
634 break;
635 case MAX8997_BUCK5:
636 if (max8997->buck5_gpiodvs)
637 gpio_dvs_mode = true;
638 break;
639 }
640
641 if (!gpio_dvs_mode)
642 return max8997_set_voltage_ldobuck(rdev, min_uV, max_uV,
643 selector);
644
645 desc = reg_voltage_map[rid];
646 new_val = max8997_get_voltage_proper_val(desc, min_vol: min_uV, max_vol: max_uV);
647 if (new_val < 0)
648 return new_val;
649
650 tmp_dmg = INT_MAX;
651 tmp_idx = -1;
652 tmp_val = -1;
653 do {
654 damage = max8997_assess_side_effect(rdev, new_val, best: &new_idx);
655 if (damage == 0)
656 goto out;
657
658 if (tmp_dmg > damage) {
659 tmp_idx = new_idx;
660 tmp_val = new_val;
661 tmp_dmg = damage;
662 }
663
664 new_val++;
665 } while (desc->min + desc->step * new_val <= desc->max);
666
667 new_idx = tmp_idx;
668 new_val = tmp_val;
669
670 if (max8997->ignore_gpiodvs_side_effect == false)
671 return -EINVAL;
672
673 dev_warn(&rdev->dev,
674 "MAX8997 GPIO-DVS Side Effect Warning: GPIO SET: %d -> %d\n",
675 max8997->buck125_gpioindex, tmp_idx);
676
677out:
678 if (new_idx < 0 || new_val < 0)
679 return -EINVAL;
680
681 max8997->buck125_gpioindex = new_idx;
682 max8997_set_gpio(max8997);
683 *selector = new_val;
684
685 return 0;
686}
687
688/* For SAFEOUT1 and SAFEOUT2 */
689static int max8997_set_voltage_safeout_sel(struct regulator_dev *rdev,
690 unsigned selector)
691{
692 struct max8997_data *max8997 = rdev_get_drvdata(rdev);
693 struct i2c_client *i2c = max8997->iodev->i2c;
694 int rid = rdev_get_id(rdev);
695 int reg, shift = 0, mask, ret;
696
697 if (rid != MAX8997_ESAFEOUT1 && rid != MAX8997_ESAFEOUT2)
698 return -EINVAL;
699
700 ret = max8997_get_voltage_register(rdev, reg: &reg, shift: &shift, mask: &mask);
701 if (ret)
702 return ret;
703
704 return max8997_update_reg(i2c, reg, val: selector << shift, mask: mask << shift);
705}
706
707static int max8997_reg_disable_suspend(struct regulator_dev *rdev)
708{
709 struct max8997_data *max8997 = rdev_get_drvdata(rdev);
710 struct i2c_client *i2c = max8997->iodev->i2c;
711 int ret, reg, mask, pattern;
712 int rid = rdev_get_id(rdev);
713
714 ret = max8997_get_enable_register(rdev, reg: &reg, mask: &mask, pattern: &pattern);
715 if (ret)
716 return ret;
717
718 max8997_read_reg(i2c, reg, dest: &max8997->saved_states[rid]);
719
720 if (rid == MAX8997_LDO1 ||
721 rid == MAX8997_LDO10 ||
722 rid == MAX8997_LDO21) {
723 dev_dbg(&rdev->dev, "Conditional Power-Off for %s\n",
724 rdev->desc->name);
725 return max8997_update_reg(i2c, reg, val: 0x40, mask);
726 }
727
728 dev_dbg(&rdev->dev, "Full Power-Off for %s (%xh -> %xh)\n",
729 rdev->desc->name, max8997->saved_states[rid] & mask,
730 (~pattern) & mask);
731 return max8997_update_reg(i2c, reg, val: ~pattern, mask);
732}
733
734static const struct regulator_ops max8997_ldo_ops = {
735 .list_voltage = max8997_list_voltage,
736 .is_enabled = max8997_reg_is_enabled,
737 .enable = max8997_reg_enable,
738 .disable = max8997_reg_disable,
739 .get_voltage_sel = max8997_get_voltage_sel,
740 .set_voltage = max8997_set_voltage_ldobuck,
741 .set_suspend_disable = max8997_reg_disable_suspend,
742};
743
744static const struct regulator_ops max8997_buck_ops = {
745 .list_voltage = max8997_list_voltage,
746 .is_enabled = max8997_reg_is_enabled,
747 .enable = max8997_reg_enable,
748 .disable = max8997_reg_disable,
749 .get_voltage_sel = max8997_get_voltage_sel,
750 .set_voltage = max8997_set_voltage_buck,
751 .set_voltage_time_sel = max8997_set_voltage_buck_time_sel,
752 .set_suspend_disable = max8997_reg_disable_suspend,
753};
754
755static const struct regulator_ops max8997_fixedvolt_ops = {
756 .list_voltage = max8997_list_voltage,
757 .is_enabled = max8997_reg_is_enabled,
758 .enable = max8997_reg_enable,
759 .disable = max8997_reg_disable,
760 .set_suspend_disable = max8997_reg_disable_suspend,
761};
762
763static const struct regulator_ops max8997_safeout_ops = {
764 .list_voltage = regulator_list_voltage_table,
765 .is_enabled = max8997_reg_is_enabled,
766 .enable = max8997_reg_enable,
767 .disable = max8997_reg_disable,
768 .get_voltage_sel = max8997_get_voltage_sel,
769 .set_voltage_sel = max8997_set_voltage_safeout_sel,
770 .set_suspend_disable = max8997_reg_disable_suspend,
771};
772
773static const struct regulator_ops max8997_fixedstate_ops = {
774 .list_voltage = max8997_list_voltage_charger_cv,
775 .get_voltage_sel = max8997_get_voltage_sel,
776 .set_voltage = max8997_set_voltage_charger_cv,
777};
778
779static int max8997_set_current_limit(struct regulator_dev *rdev,
780 int min_uA, int max_uA)
781{
782 unsigned dummy;
783 int rid = rdev_get_id(rdev);
784
785 if (rid != MAX8997_CHARGER && rid != MAX8997_CHARGER_TOPOFF)
786 return -EINVAL;
787
788 /* Reuse max8997_set_voltage_ldobuck to set current_limit. */
789 return max8997_set_voltage_ldobuck(rdev, min_uV: min_uA, max_uV: max_uA, selector: &dummy);
790}
791
792static int max8997_get_current_limit(struct regulator_dev *rdev)
793{
794 int sel, rid = rdev_get_id(rdev);
795
796 if (rid != MAX8997_CHARGER && rid != MAX8997_CHARGER_TOPOFF)
797 return -EINVAL;
798
799 sel = max8997_get_voltage_sel(rdev);
800 if (sel < 0)
801 return sel;
802
803 /* Reuse max8997_list_voltage to get current_limit. */
804 return max8997_list_voltage(rdev, selector: sel);
805}
806
807static const struct regulator_ops max8997_charger_ops = {
808 .is_enabled = max8997_reg_is_enabled,
809 .enable = max8997_reg_enable,
810 .disable = max8997_reg_disable,
811 .get_current_limit = max8997_get_current_limit,
812 .set_current_limit = max8997_set_current_limit,
813};
814
815static const struct regulator_ops max8997_charger_fixedstate_ops = {
816 .get_current_limit = max8997_get_current_limit,
817 .set_current_limit = max8997_set_current_limit,
818};
819
820#define MAX8997_VOLTAGE_REGULATOR(_name, _ops) {\
821 .name = #_name, \
822 .id = MAX8997_##_name, \
823 .ops = &_ops, \
824 .type = REGULATOR_VOLTAGE, \
825 .owner = THIS_MODULE, \
826}
827
828#define MAX8997_CURRENT_REGULATOR(_name, _ops) {\
829 .name = #_name, \
830 .id = MAX8997_##_name, \
831 .ops = &_ops, \
832 .type = REGULATOR_CURRENT, \
833 .owner = THIS_MODULE, \
834}
835
836static struct regulator_desc regulators[] = {
837 MAX8997_VOLTAGE_REGULATOR(LDO1, max8997_ldo_ops),
838 MAX8997_VOLTAGE_REGULATOR(LDO2, max8997_ldo_ops),
839 MAX8997_VOLTAGE_REGULATOR(LDO3, max8997_ldo_ops),
840 MAX8997_VOLTAGE_REGULATOR(LDO4, max8997_ldo_ops),
841 MAX8997_VOLTAGE_REGULATOR(LDO5, max8997_ldo_ops),
842 MAX8997_VOLTAGE_REGULATOR(LDO6, max8997_ldo_ops),
843 MAX8997_VOLTAGE_REGULATOR(LDO7, max8997_ldo_ops),
844 MAX8997_VOLTAGE_REGULATOR(LDO8, max8997_ldo_ops),
845 MAX8997_VOLTAGE_REGULATOR(LDO9, max8997_ldo_ops),
846 MAX8997_VOLTAGE_REGULATOR(LDO10, max8997_ldo_ops),
847 MAX8997_VOLTAGE_REGULATOR(LDO11, max8997_ldo_ops),
848 MAX8997_VOLTAGE_REGULATOR(LDO12, max8997_ldo_ops),
849 MAX8997_VOLTAGE_REGULATOR(LDO13, max8997_ldo_ops),
850 MAX8997_VOLTAGE_REGULATOR(LDO14, max8997_ldo_ops),
851 MAX8997_VOLTAGE_REGULATOR(LDO15, max8997_ldo_ops),
852 MAX8997_VOLTAGE_REGULATOR(LDO16, max8997_ldo_ops),
853 MAX8997_VOLTAGE_REGULATOR(LDO17, max8997_ldo_ops),
854 MAX8997_VOLTAGE_REGULATOR(LDO18, max8997_ldo_ops),
855 MAX8997_VOLTAGE_REGULATOR(LDO21, max8997_ldo_ops),
856 MAX8997_VOLTAGE_REGULATOR(BUCK1, max8997_buck_ops),
857 MAX8997_VOLTAGE_REGULATOR(BUCK2, max8997_buck_ops),
858 MAX8997_VOLTAGE_REGULATOR(BUCK3, max8997_buck_ops),
859 MAX8997_VOLTAGE_REGULATOR(BUCK4, max8997_buck_ops),
860 MAX8997_VOLTAGE_REGULATOR(BUCK5, max8997_buck_ops),
861 MAX8997_VOLTAGE_REGULATOR(BUCK6, max8997_fixedvolt_ops),
862 MAX8997_VOLTAGE_REGULATOR(BUCK7, max8997_buck_ops),
863 MAX8997_VOLTAGE_REGULATOR(EN32KHZ_AP, max8997_fixedvolt_ops),
864 MAX8997_VOLTAGE_REGULATOR(EN32KHZ_CP, max8997_fixedvolt_ops),
865 MAX8997_VOLTAGE_REGULATOR(ENVICHG, max8997_fixedvolt_ops),
866 MAX8997_VOLTAGE_REGULATOR(ESAFEOUT1, max8997_safeout_ops),
867 MAX8997_VOLTAGE_REGULATOR(ESAFEOUT2, max8997_safeout_ops),
868 MAX8997_VOLTAGE_REGULATOR(CHARGER_CV, max8997_fixedstate_ops),
869 MAX8997_CURRENT_REGULATOR(CHARGER, max8997_charger_ops),
870 MAX8997_CURRENT_REGULATOR(CHARGER_TOPOFF,
871 max8997_charger_fixedstate_ops),
872};
873
874#ifdef CONFIG_OF
875static int max8997_pmic_dt_parse_pdata(struct platform_device *pdev,
876 struct max8997_platform_data *pdata)
877{
878 struct max8997_dev *iodev = dev_get_drvdata(dev: pdev->dev.parent);
879 struct device_node *pmic_np, *regulators_np, *reg_np;
880 struct max8997_regulator_data *rdata;
881 unsigned int i, dvs_voltage_nr = 1;
882
883 pmic_np = iodev->dev->of_node;
884 if (!pmic_np) {
885 dev_err(&pdev->dev, "could not find pmic sub-node\n");
886 return -ENODEV;
887 }
888
889 regulators_np = of_get_child_by_name(node: pmic_np, name: "regulators");
890 if (!regulators_np) {
891 dev_err(&pdev->dev, "could not find regulators sub-node\n");
892 return -EINVAL;
893 }
894
895 /* count the number of regulators to be supported in pmic */
896 pdata->num_regulators = of_get_child_count(np: regulators_np);
897
898 rdata = devm_kcalloc(dev: &pdev->dev,
899 n: pdata->num_regulators, size: sizeof(*rdata),
900 GFP_KERNEL);
901 if (!rdata) {
902 of_node_put(node: regulators_np);
903 return -ENOMEM;
904 }
905
906 pdata->regulators = rdata;
907 for_each_child_of_node(regulators_np, reg_np) {
908 for (i = 0; i < ARRAY_SIZE(regulators); i++)
909 if (of_node_name_eq(np: reg_np, name: regulators[i].name))
910 break;
911
912 if (i == ARRAY_SIZE(regulators)) {
913 dev_warn(&pdev->dev, "don't know how to configure regulator %pOFn\n",
914 reg_np);
915 continue;
916 }
917
918 rdata->id = i;
919 rdata->initdata = of_get_regulator_init_data(dev: &pdev->dev,
920 node: reg_np,
921 desc: &regulators[i]);
922 rdata->reg_node = reg_np;
923 rdata++;
924 }
925 of_node_put(node: regulators_np);
926
927 pdata->buck1_gpiodvs = of_property_read_bool(np: pmic_np, propname: "max8997,pmic-buck1-uses-gpio-dvs");
928 pdata->buck2_gpiodvs = of_property_read_bool(np: pmic_np, propname: "max8997,pmic-buck2-uses-gpio-dvs");
929 pdata->buck5_gpiodvs = of_property_read_bool(np: pmic_np, propname: "max8997,pmic-buck5-uses-gpio-dvs");
930
931 if (pdata->buck1_gpiodvs || pdata->buck2_gpiodvs ||
932 pdata->buck5_gpiodvs) {
933 if (of_property_read_u32(np: pmic_np,
934 propname: "max8997,pmic-buck125-default-dvs-idx",
935 out_value: &pdata->buck125_default_idx)) {
936 pdata->buck125_default_idx = 0;
937 } else {
938 if (pdata->buck125_default_idx >= 8) {
939 pdata->buck125_default_idx = 0;
940 dev_info(&pdev->dev, "invalid value for default dvs index, using 0 instead\n");
941 }
942 }
943
944 if (of_get_property(node: pmic_np,
945 name: "max8997,pmic-ignore-gpiodvs-side-effect", NULL))
946 pdata->ignore_gpiodvs_side_effect = true;
947
948 dvs_voltage_nr = 8;
949 }
950
951 if (of_property_read_u32_array(np: pmic_np,
952 propname: "max8997,pmic-buck1-dvs-voltage",
953 out_values: pdata->buck1_voltage, sz: dvs_voltage_nr)) {
954 dev_err(&pdev->dev, "buck1 voltages not specified\n");
955 return -EINVAL;
956 }
957
958 if (of_property_read_u32_array(np: pmic_np,
959 propname: "max8997,pmic-buck2-dvs-voltage",
960 out_values: pdata->buck2_voltage, sz: dvs_voltage_nr)) {
961 dev_err(&pdev->dev, "buck2 voltages not specified\n");
962 return -EINVAL;
963 }
964
965 if (of_property_read_u32_array(np: pmic_np,
966 propname: "max8997,pmic-buck5-dvs-voltage",
967 out_values: pdata->buck5_voltage, sz: dvs_voltage_nr)) {
968 dev_err(&pdev->dev, "buck5 voltages not specified\n");
969 return -EINVAL;
970 }
971
972 return 0;
973}
974#else
975static int max8997_pmic_dt_parse_pdata(struct platform_device *pdev,
976 struct max8997_platform_data *pdata)
977{
978 return 0;
979}
980#endif /* CONFIG_OF */
981
982static int max8997_pmic_probe(struct platform_device *pdev)
983{
984 struct max8997_dev *iodev = dev_get_drvdata(dev: pdev->dev.parent);
985 struct max8997_platform_data *pdata = iodev->pdata;
986 struct regulator_config config = { };
987 struct regulator_dev *rdev;
988 struct max8997_data *max8997;
989 struct i2c_client *i2c;
990 int i, ret, nr_dvs;
991 u8 max_buck1 = 0, max_buck2 = 0, max_buck5 = 0;
992
993 if (!pdata) {
994 dev_err(&pdev->dev, "No platform init data supplied.\n");
995 return -ENODEV;
996 }
997
998 if (iodev->dev->of_node) {
999 ret = max8997_pmic_dt_parse_pdata(pdev, pdata);
1000 if (ret)
1001 return ret;
1002 }
1003
1004 max8997 = devm_kzalloc(dev: &pdev->dev, size: sizeof(struct max8997_data),
1005 GFP_KERNEL);
1006 if (!max8997)
1007 return -ENOMEM;
1008
1009 max8997->dev = &pdev->dev;
1010 max8997->iodev = iodev;
1011 max8997->num_regulators = pdata->num_regulators;
1012 platform_set_drvdata(pdev, data: max8997);
1013 i2c = max8997->iodev->i2c;
1014
1015 max8997->buck125_gpioindex = pdata->buck125_default_idx;
1016 max8997->buck1_gpiodvs = pdata->buck1_gpiodvs;
1017 max8997->buck2_gpiodvs = pdata->buck2_gpiodvs;
1018 max8997->buck5_gpiodvs = pdata->buck5_gpiodvs;
1019 max8997->ignore_gpiodvs_side_effect = pdata->ignore_gpiodvs_side_effect;
1020
1021 nr_dvs = (pdata->buck1_gpiodvs || pdata->buck2_gpiodvs ||
1022 pdata->buck5_gpiodvs) ? 8 : 1;
1023
1024 for (i = 0; i < nr_dvs; i++) {
1025 max8997->buck1_vol[i] = ret =
1026 max8997_get_voltage_proper_val(
1027 desc: &buck1245_voltage_map_desc,
1028 min_vol: pdata->buck1_voltage[i],
1029 max_vol: pdata->buck1_voltage[i] +
1030 buck1245_voltage_map_desc.step);
1031 if (ret < 0)
1032 return ret;
1033
1034 max8997->buck2_vol[i] = ret =
1035 max8997_get_voltage_proper_val(
1036 desc: &buck1245_voltage_map_desc,
1037 min_vol: pdata->buck2_voltage[i],
1038 max_vol: pdata->buck2_voltage[i] +
1039 buck1245_voltage_map_desc.step);
1040 if (ret < 0)
1041 return ret;
1042
1043 max8997->buck5_vol[i] = ret =
1044 max8997_get_voltage_proper_val(
1045 desc: &buck1245_voltage_map_desc,
1046 min_vol: pdata->buck5_voltage[i],
1047 max_vol: pdata->buck5_voltage[i] +
1048 buck1245_voltage_map_desc.step);
1049 if (ret < 0)
1050 return ret;
1051
1052 if (max_buck1 < max8997->buck1_vol[i])
1053 max_buck1 = max8997->buck1_vol[i];
1054 if (max_buck2 < max8997->buck2_vol[i])
1055 max_buck2 = max8997->buck2_vol[i];
1056 if (max_buck5 < max8997->buck5_vol[i])
1057 max_buck5 = max8997->buck5_vol[i];
1058 }
1059
1060 /* For the safety, set max voltage before setting up */
1061 for (i = 0; i < 8; i++) {
1062 max8997_update_reg(i2c, reg: MAX8997_REG_BUCK1DVS1 + i,
1063 val: max_buck1, mask: 0x3f);
1064 max8997_update_reg(i2c, reg: MAX8997_REG_BUCK2DVS1 + i,
1065 val: max_buck2, mask: 0x3f);
1066 max8997_update_reg(i2c, reg: MAX8997_REG_BUCK5DVS1 + i,
1067 val: max_buck5, mask: 0x3f);
1068 }
1069
1070 /* Initialize all the DVS related BUCK registers */
1071 for (i = 0; i < nr_dvs; i++) {
1072 max8997_update_reg(i2c, reg: MAX8997_REG_BUCK1DVS1 + i,
1073 val: max8997->buck1_vol[i],
1074 mask: 0x3f);
1075 max8997_update_reg(i2c, reg: MAX8997_REG_BUCK2DVS1 + i,
1076 val: max8997->buck2_vol[i],
1077 mask: 0x3f);
1078 max8997_update_reg(i2c, reg: MAX8997_REG_BUCK5DVS1 + i,
1079 val: max8997->buck5_vol[i],
1080 mask: 0x3f);
1081 }
1082
1083 /*
1084 * If buck 1, 2, and 5 do not care DVS GPIO settings, ignore them.
1085 * If at least one of them cares, set gpios.
1086 */
1087 if (pdata->buck1_gpiodvs || pdata->buck2_gpiodvs ||
1088 pdata->buck5_gpiodvs) {
1089 const char *gpio_names[3] = {"MAX8997 SET1", "MAX8997 SET2", "MAX8997 SET3"};
1090
1091 for (i = 0; i < 3; i++) {
1092 enum gpiod_flags flags;
1093
1094 if (max8997->buck125_gpioindex & BIT(2 - i))
1095 flags = GPIOD_OUT_HIGH;
1096 else
1097 flags = GPIOD_OUT_LOW;
1098
1099 max8997->buck125_gpiods[i] = devm_gpiod_get_index(dev: iodev->dev,
1100 con_id: "max8997,pmic-buck125-dvs",
1101 idx: i,
1102 flags);
1103 if (IS_ERR(ptr: max8997->buck125_gpiods[i])) {
1104 ret = PTR_ERR(ptr: max8997->buck125_gpiods[i]);
1105 return dev_err_probe(dev: iodev->dev, err: ret, fmt: "cant get GPIO %d (%d)\n",
1106 i, ret);
1107 }
1108 gpiod_set_consumer_name(desc: max8997->buck125_gpiods[i], name: gpio_names[i]);
1109 }
1110 }
1111
1112 /* DVS-GPIO disabled */
1113 max8997_update_reg(i2c, reg: MAX8997_REG_BUCK1CTRL, val: (pdata->buck1_gpiodvs) ?
1114 (1 << 1) : (0 << 1), mask: 1 << 1);
1115 max8997_update_reg(i2c, reg: MAX8997_REG_BUCK2CTRL, val: (pdata->buck2_gpiodvs) ?
1116 (1 << 1) : (0 << 1), mask: 1 << 1);
1117 max8997_update_reg(i2c, reg: MAX8997_REG_BUCK5CTRL, val: (pdata->buck5_gpiodvs) ?
1118 (1 << 1) : (0 << 1), mask: 1 << 1);
1119
1120 /* Misc Settings */
1121 max8997->ramp_delay = 10; /* set 10mV/us, which is the default */
1122 max8997_write_reg(i2c, reg: MAX8997_REG_BUCKRAMP, value: (0xf << 4) | 0x9);
1123
1124 for (i = 0; i < pdata->num_regulators; i++) {
1125 const struct voltage_map_desc *desc;
1126 int id = pdata->regulators[i].id;
1127
1128 desc = reg_voltage_map[id];
1129 if (desc) {
1130 regulators[id].n_voltages =
1131 (desc->max - desc->min) / desc->step + 1;
1132 } else if (id == MAX8997_ESAFEOUT1 || id == MAX8997_ESAFEOUT2) {
1133 regulators[id].volt_table = safeoutvolt;
1134 regulators[id].n_voltages = ARRAY_SIZE(safeoutvolt);
1135 } else if (id == MAX8997_CHARGER_CV) {
1136 regulators[id].n_voltages = 16;
1137 }
1138
1139 config.dev = max8997->dev;
1140 config.init_data = pdata->regulators[i].initdata;
1141 config.driver_data = max8997;
1142 config.of_node = pdata->regulators[i].reg_node;
1143
1144 rdev = devm_regulator_register(dev: &pdev->dev, regulator_desc: &regulators[id],
1145 config: &config);
1146 if (IS_ERR(ptr: rdev)) {
1147 dev_err(max8997->dev, "regulator init failed for %d\n",
1148 id);
1149 return PTR_ERR(ptr: rdev);
1150 }
1151 }
1152
1153 return 0;
1154}
1155
1156static const struct platform_device_id max8997_pmic_id[] = {
1157 { "max8997-pmic", 0},
1158 { },
1159};
1160MODULE_DEVICE_TABLE(platform, max8997_pmic_id);
1161
1162static struct platform_driver max8997_pmic_driver = {
1163 .driver = {
1164 .name = "max8997-pmic",
1165 .probe_type = PROBE_PREFER_ASYNCHRONOUS,
1166 },
1167 .probe = max8997_pmic_probe,
1168 .id_table = max8997_pmic_id,
1169};
1170
1171static int __init max8997_pmic_init(void)
1172{
1173 return platform_driver_register(&max8997_pmic_driver);
1174}
1175subsys_initcall(max8997_pmic_init);
1176
1177static void __exit max8997_pmic_cleanup(void)
1178{
1179 platform_driver_unregister(&max8997_pmic_driver);
1180}
1181module_exit(max8997_pmic_cleanup);
1182
1183MODULE_DESCRIPTION("MAXIM 8997/8966 Regulator Driver");
1184MODULE_AUTHOR("MyungJoo Ham <myungjoo.ham@samsung.com>");
1185MODULE_LICENSE("GPL");
1186

source code of linux/drivers/regulator/max8997-regulator.c