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