Blame view

drivers/regulator/rk808-regulator.c 24.1 KB
2cd64ae3d   Chris Zhong   regulator: RK808:...
1
  /*
113752935   Wadim Egorov   regulator: rk808:...
2
   * Regulator driver for Rockchip RK808/RK818
2cd64ae3d   Chris Zhong   regulator: RK808:...
3
4
5
6
7
8
   *
   * Copyright (c) 2014, Fuzhou Rockchip Electronics Co., Ltd
   *
   * Author: Chris Zhong <zyw@rock-chips.com>
   * Author: Zhang Qing <zhangqing@rock-chips.com>
   *
113752935   Wadim Egorov   regulator: rk808:...
9
10
11
12
   * Copyright (C) 2016 PHYTEC Messtechnik GmbH
   *
   * Author: Wadim Egorov <w.egorov@phytec.de>
   *
2cd64ae3d   Chris Zhong   regulator: RK808:...
13
14
15
16
17
18
19
20
   * This program is free software; you can redistribute it and/or modify it
   * under the terms and conditions of the GNU General Public License,
   * version 2, as published by the Free Software Foundation.
   *
   * This program is distributed in the hope it will be useful, but WITHOUT
   * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
   * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for
   * more details.
2cd64ae3d   Chris Zhong   regulator: RK808:...
21
   */
bad47ad2e   Chris Zhong   regulator: rk808:...
22
23
  #include <linux/delay.h>
  #include <linux/gpio.h>
2cd64ae3d   Chris Zhong   regulator: RK808:...
24
  #include <linux/i2c.h>
bad47ad2e   Chris Zhong   regulator: rk808:...
25
  #include <linux/module.h>
2cd64ae3d   Chris Zhong   regulator: RK808:...
26
  #include <linux/of_device.h>
bad47ad2e   Chris Zhong   regulator: rk808:...
27
28
  #include <linux/of_gpio.h>
  #include <linux/mfd/rk808.h>
2cd64ae3d   Chris Zhong   regulator: RK808:...
29
30
  #include <linux/regulator/driver.h>
  #include <linux/regulator/of_regulator.h>
604d49942   Uwe Kleine-König   regulator: rk808:...
31
  #include <linux/gpio/consumer.h>
571a40108   Chris Zhong   regulator: rk808:...
32
33
  
  /* Field Definitions */
2cd64ae3d   Chris Zhong   regulator: RK808:...
34
35
36
  #define RK808_BUCK_VSEL_MASK	0x3f
  #define RK808_BUCK4_VSEL_MASK	0xf
  #define RK808_LDO_VSEL_MASK	0x1f
113752935   Wadim Egorov   regulator: rk808:...
37
38
39
40
41
  #define RK818_BUCK_VSEL_MASK		0x3f
  #define RK818_BUCK4_VSEL_MASK		0x1f
  #define RK818_LDO_VSEL_MASK		0x1f
  #define RK818_LDO3_ON_VSEL_MASK		0xf
  #define RK818_BOOST_ON_VSEL_MASK	0xe0
8af252272   Doug Anderson   regulator: rk808:...
42
43
44
45
46
47
48
  /* Ramp rate definitions for buck1 / buck2 only */
  #define RK808_RAMP_RATE_OFFSET		3
  #define RK808_RAMP_RATE_MASK		(3 << RK808_RAMP_RATE_OFFSET)
  #define RK808_RAMP_RATE_2MV_PER_US	(0 << RK808_RAMP_RATE_OFFSET)
  #define RK808_RAMP_RATE_4MV_PER_US	(1 << RK808_RAMP_RATE_OFFSET)
  #define RK808_RAMP_RATE_6MV_PER_US	(2 << RK808_RAMP_RATE_OFFSET)
  #define RK808_RAMP_RATE_10MV_PER_US	(3 << RK808_RAMP_RATE_OFFSET)
bad47ad2e   Chris Zhong   regulator: rk808:...
49
50
  #define RK808_DVS2_POL		BIT(2)
  #define RK808_DVS1_POL		BIT(1)
251ce318d   Chris Zhong   regulator: rk808:...
51
52
  /* Offset from XXX_ON_VSEL to XXX_SLP_VSEL */
  #define RK808_SLP_REG_OFFSET 1
bad47ad2e   Chris Zhong   regulator: rk808:...
53
54
  /* Offset from XXX_ON_VSEL to XXX_DVS_VSEL */
  #define RK808_DVS_REG_OFFSET 2
251ce318d   Chris Zhong   regulator: rk808:...
55
56
  /* Offset from XXX_EN_REG to SLEEP_SET_OFF_XXX */
  #define RK808_SLP_SET_OFF_REG_OFFSET 2
bad47ad2e   Chris Zhong   regulator: rk808:...
57
58
  /* max steps for increase voltage of Buck1/2, equal 100mv*/
  #define MAX_STEPS_ONE_TIME 8
c4e0d344c   Elaine Zhang   regulator: rk808:...
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
  #define RK805_DESC(_id, _match, _supply, _min, _max, _step, _vreg,      \
  	_vmask, _ereg, _emask, _etime)                                  \
  	[_id] = {                                                       \
  		.name           = (_match),                             \
  		.supply_name    = (_supply),                            \
  		.of_match       = of_match_ptr(_match),                 \
  		.regulators_node = of_match_ptr("regulators"),          \
  		.type           = REGULATOR_VOLTAGE,                    \
  		.id             = (_id),                                \
  		.n_voltages     = (((_max) - (_min)) / (_step) + 1),    \
  		.owner          = THIS_MODULE,                          \
  		.min_uV         = (_min) * 1000,                        \
  		.uV_step        = (_step) * 1000,                       \
  		.vsel_reg       = (_vreg),                              \
  		.vsel_mask      = (_vmask),                             \
  		.enable_reg     = (_ereg),                              \
  		.enable_mask    = (_emask),                             \
  		.enable_time    = (_etime),                             \
  		.ops            = &rk805_reg_ops,                       \
  	}
9e9daa0a6   Wadim Egorov   regulator: rk808:...
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
  #define RK8XX_DESC(_id, _match, _supply, _min, _max, _step, _vreg,	\
  	_vmask, _ereg, _emask, _etime)					\
  	[_id] = {							\
  		.name		= (_match),				\
  		.supply_name	= (_supply),				\
  		.of_match	= of_match_ptr(_match),			\
  		.regulators_node = of_match_ptr("regulators"),		\
  		.type		= REGULATOR_VOLTAGE,			\
  		.id		= (_id),				\
  		.n_voltages	= (((_max) - (_min)) / (_step) + 1),	\
  		.owner		= THIS_MODULE,				\
  		.min_uV		= (_min) * 1000,			\
  		.uV_step	= (_step) * 1000,			\
  		.vsel_reg	= (_vreg),				\
  		.vsel_mask	= (_vmask),				\
  		.enable_reg	= (_ereg),				\
  		.enable_mask	= (_emask),				\
  		.enable_time	= (_etime),				\
  		.ops		= &rk808_reg_ops,			\
  	}
  
  #define RK8XX_DESC_SWITCH(_id, _match, _supply, _ereg, _emask)		\
  	[_id] = {							\
  		.name		= (_match),				\
  		.supply_name	= (_supply),				\
  		.of_match	= of_match_ptr(_match),			\
  		.regulators_node = of_match_ptr("regulators"),		\
  		.type		= REGULATOR_VOLTAGE,			\
  		.id		= (_id),				\
  		.enable_reg	= (_ereg),				\
  		.enable_mask	= (_emask),				\
  		.owner		= THIS_MODULE,				\
  		.ops		= &rk808_switch_ops			\
  	}
bad47ad2e   Chris Zhong   regulator: rk808:...
113
114
115
  struct rk808_regulator_data {
  	struct gpio_desc *dvs_gpio[2];
  };
8af252272   Doug Anderson   regulator: rk808:...
116
117
118
119
120
121
  static const int rk808_buck_config_regs[] = {
  	RK808_BUCK1_CONFIG_REG,
  	RK808_BUCK2_CONFIG_REG,
  	RK808_BUCK3_CONFIG_REG,
  	RK808_BUCK4_CONFIG_REG,
  };
2cd64ae3d   Chris Zhong   regulator: RK808:...
122
123
124
125
  static const struct regulator_linear_range rk808_ldo3_voltage_ranges[] = {
  	REGULATOR_LINEAR_RANGE(800000, 0, 13, 100000),
  	REGULATOR_LINEAR_RANGE(2500000, 15, 15, 0),
  };
bad47ad2e   Chris Zhong   regulator: rk808:...
126
127
128
  static int rk808_buck1_2_get_voltage_sel_regmap(struct regulator_dev *rdev)
  {
  	struct rk808_regulator_data *pdata = rdev_get_drvdata(rdev);
bf8e27621   Axel Lin   regulator: rk808:...
129
  	int id = rdev_get_id(rdev);
bad47ad2e   Chris Zhong   regulator: rk808:...
130
131
132
  	struct gpio_desc *gpio = pdata->dvs_gpio[id];
  	unsigned int val;
  	int ret;
a13eaf02e   Uwe Kleine-König   regulator: rk808:...
133
  	if (!gpio || gpiod_get_value(gpio) == 0)
bad47ad2e   Chris Zhong   regulator: rk808:...
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
  		return regulator_get_voltage_sel_regmap(rdev);
  
  	ret = regmap_read(rdev->regmap,
  			  rdev->desc->vsel_reg + RK808_DVS_REG_OFFSET,
  			  &val);
  	if (ret != 0)
  		return ret;
  
  	val &= rdev->desc->vsel_mask;
  	val >>= ffs(rdev->desc->vsel_mask) - 1;
  
  	return val;
  }
  
  static int rk808_buck1_2_i2c_set_voltage_sel(struct regulator_dev *rdev,
  					     unsigned sel)
  {
  	int ret, delta_sel;
  	unsigned int old_sel, tmp, val, mask = rdev->desc->vsel_mask;
  
  	ret = regmap_read(rdev->regmap, rdev->desc->vsel_reg, &val);
  	if (ret != 0)
  		return ret;
  
  	tmp = val & ~mask;
  	old_sel = val & mask;
  	old_sel >>= ffs(mask) - 1;
  	delta_sel = sel - old_sel;
  
  	/*
  	 * If directly modify the register to change the voltage, we will face
  	 * the risk of overshoot. Put it into a multi-step, can effectively
  	 * avoid this problem, a step is 100mv here.
  	 */
  	while (delta_sel > MAX_STEPS_ONE_TIME) {
  		old_sel += MAX_STEPS_ONE_TIME;
  		val = old_sel << (ffs(mask) - 1);
  		val |= tmp;
  
  		/*
  		 * i2c is 400kHz (2.5us per bit) and we must transmit _at least_
  		 * 3 bytes (24 bits) plus start and stop so 26 bits.  So we've
  		 * got more than 65 us between each voltage change and thus
  		 * won't ramp faster than ~1500 uV / us.
  		 */
  		ret = regmap_write(rdev->regmap, rdev->desc->vsel_reg, val);
  		delta_sel = sel - old_sel;
  	}
  
  	sel <<= ffs(mask) - 1;
  	val = tmp | sel;
  	ret = regmap_write(rdev->regmap, rdev->desc->vsel_reg, val);
  
  	/*
  	 * When we change the voltage register directly, the ramp rate is about
  	 * 100000uv/us, wait 1us to make sure the target voltage to be stable,
  	 * so we needn't wait extra time after that.
  	 */
  	udelay(1);
  
  	return ret;
  }
  
  static int rk808_buck1_2_set_voltage_sel(struct regulator_dev *rdev,
  					 unsigned sel)
  {
  	struct rk808_regulator_data *pdata = rdev_get_drvdata(rdev);
bf8e27621   Axel Lin   regulator: rk808:...
201
  	int id = rdev_get_id(rdev);
bad47ad2e   Chris Zhong   regulator: rk808:...
202
203
204
205
  	struct gpio_desc *gpio = pdata->dvs_gpio[id];
  	unsigned int reg = rdev->desc->vsel_reg;
  	unsigned old_sel;
  	int ret, gpio_level;
a13eaf02e   Uwe Kleine-König   regulator: rk808:...
206
  	if (!gpio)
bad47ad2e   Chris Zhong   regulator: rk808:...
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
  		return rk808_buck1_2_i2c_set_voltage_sel(rdev, sel);
  
  	gpio_level = gpiod_get_value(gpio);
  	if (gpio_level == 0) {
  		reg += RK808_DVS_REG_OFFSET;
  		ret = regmap_read(rdev->regmap, rdev->desc->vsel_reg, &old_sel);
  	} else {
  		ret = regmap_read(rdev->regmap,
  				  reg + RK808_DVS_REG_OFFSET,
  				  &old_sel);
  	}
  
  	if (ret != 0)
  		return ret;
  
  	sel <<= ffs(rdev->desc->vsel_mask) - 1;
  	sel |= old_sel & ~rdev->desc->vsel_mask;
  
  	ret = regmap_write(rdev->regmap, reg, sel);
  	if (ret)
  		return ret;
  
  	gpiod_set_value(gpio, !gpio_level);
  
  	return ret;
  }
  
  static int rk808_buck1_2_set_voltage_time_sel(struct regulator_dev *rdev,
  				       unsigned int old_selector,
  				       unsigned int new_selector)
  {
  	struct rk808_regulator_data *pdata = rdev_get_drvdata(rdev);
bf8e27621   Axel Lin   regulator: rk808:...
239
  	int id = rdev_get_id(rdev);
bad47ad2e   Chris Zhong   regulator: rk808:...
240
241
242
  	struct gpio_desc *gpio = pdata->dvs_gpio[id];
  
  	/* if there is no dvs1/2 pin, we don't need wait extra time here. */
a13eaf02e   Uwe Kleine-König   regulator: rk808:...
243
  	if (!gpio)
bad47ad2e   Chris Zhong   regulator: rk808:...
244
245
246
247
  		return 0;
  
  	return regulator_set_voltage_time_sel(rdev, old_selector, new_selector);
  }
8af252272   Doug Anderson   regulator: rk808:...
248
249
250
  static int rk808_set_ramp_delay(struct regulator_dev *rdev, int ramp_delay)
  {
  	unsigned int ramp_value = RK808_RAMP_RATE_10MV_PER_US;
bf8e27621   Axel Lin   regulator: rk808:...
251
  	unsigned int reg = rk808_buck_config_regs[rdev_get_id(rdev)];
8af252272   Doug Anderson   regulator: rk808:...
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
  
  	switch (ramp_delay) {
  	case 1 ... 2000:
  		ramp_value = RK808_RAMP_RATE_2MV_PER_US;
  		break;
  	case 2001 ... 4000:
  		ramp_value = RK808_RAMP_RATE_4MV_PER_US;
  		break;
  	case 4001 ... 6000:
  		ramp_value = RK808_RAMP_RATE_6MV_PER_US;
  		break;
  	case 6001 ... 10000:
  		break;
  	default:
  		pr_warn("%s ramp_delay: %d not supported, setting 10000
  ",
  			rdev->desc->name, ramp_delay);
  	}
  
  	return regmap_update_bits(rdev->regmap, reg,
  				  RK808_RAMP_RATE_MASK, ramp_value);
  }
5cb2f03c6   Wei Yongjun   regulator: rk808:...
274
  static int rk808_set_suspend_voltage(struct regulator_dev *rdev, int uv)
251ce318d   Chris Zhong   regulator: rk808:...
275
276
  {
  	unsigned int reg;
afcd666d9   Wadim Egorov   regulator: rk808:...
277
278
279
280
281
282
283
284
285
286
287
  	int sel = regulator_map_voltage_linear(rdev, uv, uv);
  
  	if (sel < 0)
  		return -EINVAL;
  
  	reg = rdev->desc->vsel_reg + RK808_SLP_REG_OFFSET;
  
  	return regmap_update_bits(rdev->regmap, reg,
  				  rdev->desc->vsel_mask,
  				  sel);
  }
129d7cf98   Wadim Egorov   regulator: rk808:...
288
289
290
291
292
293
294
295
296
297
298
299
300
301
  static int rk808_set_suspend_voltage_range(struct regulator_dev *rdev, int uv)
  {
  	unsigned int reg;
  	int sel = regulator_map_voltage_linear_range(rdev, uv, uv);
  
  	if (sel < 0)
  		return -EINVAL;
  
  	reg = rdev->desc->vsel_reg + RK808_SLP_REG_OFFSET;
  
  	return regmap_update_bits(rdev->regmap, reg,
  				  rdev->desc->vsel_mask,
  				  sel);
  }
c4e0d344c   Elaine Zhang   regulator: rk808:...
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
  static int rk805_set_suspend_enable(struct regulator_dev *rdev)
  {
  	unsigned int reg;
  
  	reg = rdev->desc->enable_reg + RK808_SLP_SET_OFF_REG_OFFSET;
  
  	return regmap_update_bits(rdev->regmap, reg,
  				  rdev->desc->enable_mask,
  				  rdev->desc->enable_mask);
  }
  
  static int rk805_set_suspend_disable(struct regulator_dev *rdev)
  {
  	unsigned int reg;
  
  	reg = rdev->desc->enable_reg + RK808_SLP_SET_OFF_REG_OFFSET;
  
  	return regmap_update_bits(rdev->regmap, reg,
  				  rdev->desc->enable_mask,
  				  0);
  }
5cb2f03c6   Wei Yongjun   regulator: rk808:...
323
  static int rk808_set_suspend_enable(struct regulator_dev *rdev)
251ce318d   Chris Zhong   regulator: rk808:...
324
325
326
327
328
329
330
331
332
  {
  	unsigned int reg;
  
  	reg = rdev->desc->enable_reg + RK808_SLP_SET_OFF_REG_OFFSET;
  
  	return regmap_update_bits(rdev->regmap, reg,
  				  rdev->desc->enable_mask,
  				  0);
  }
5cb2f03c6   Wei Yongjun   regulator: rk808:...
333
  static int rk808_set_suspend_disable(struct regulator_dev *rdev)
251ce318d   Chris Zhong   regulator: rk808:...
334
335
336
337
338
339
340
341
342
  {
  	unsigned int reg;
  
  	reg = rdev->desc->enable_reg + RK808_SLP_SET_OFF_REG_OFFSET;
  
  	return regmap_update_bits(rdev->regmap, reg,
  				  rdev->desc->enable_mask,
  				  rdev->desc->enable_mask);
  }
c4e0d344c   Elaine Zhang   regulator: rk808:...
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
  static struct regulator_ops rk805_reg_ops = {
  		.list_voltage           = regulator_list_voltage_linear,
  		.map_voltage            = regulator_map_voltage_linear,
  		.get_voltage_sel        = regulator_get_voltage_sel_regmap,
  		.set_voltage_sel        = regulator_set_voltage_sel_regmap,
  		.enable                 = regulator_enable_regmap,
  		.disable                = regulator_disable_regmap,
  		.is_enabled             = regulator_is_enabled_regmap,
  		.set_suspend_voltage    = rk808_set_suspend_voltage,
  		.set_suspend_enable     = rk805_set_suspend_enable,
  		.set_suspend_disable    = rk805_set_suspend_disable,
  };
  
  static struct regulator_ops rk805_switch_ops = {
  		.enable                 = regulator_enable_regmap,
  		.disable                = regulator_disable_regmap,
  		.is_enabled             = regulator_is_enabled_regmap,
  		.set_suspend_enable     = rk805_set_suspend_enable,
  		.set_suspend_disable    = rk805_set_suspend_disable,
  };
8af252272   Doug Anderson   regulator: rk808:...
363
  static struct regulator_ops rk808_buck1_2_ops = {
afcd666d9   Wadim Egorov   regulator: rk808:...
364
365
  	.list_voltage		= regulator_list_voltage_linear,
  	.map_voltage		= regulator_map_voltage_linear,
bad47ad2e   Chris Zhong   regulator: rk808:...
366
367
368
  	.get_voltage_sel	= rk808_buck1_2_get_voltage_sel_regmap,
  	.set_voltage_sel	= rk808_buck1_2_set_voltage_sel,
  	.set_voltage_time_sel	= rk808_buck1_2_set_voltage_time_sel,
8af252272   Doug Anderson   regulator: rk808:...
369
370
371
372
  	.enable			= regulator_enable_regmap,
  	.disable		= regulator_disable_regmap,
  	.is_enabled		= regulator_is_enabled_regmap,
  	.set_ramp_delay		= rk808_set_ramp_delay,
251ce318d   Chris Zhong   regulator: rk808:...
373
374
375
  	.set_suspend_voltage	= rk808_set_suspend_voltage,
  	.set_suspend_enable	= rk808_set_suspend_enable,
  	.set_suspend_disable	= rk808_set_suspend_disable,
8af252272   Doug Anderson   regulator: rk808:...
376
  };
2cd64ae3d   Chris Zhong   regulator: RK808:...
377
  static struct regulator_ops rk808_reg_ops = {
afcd666d9   Wadim Egorov   regulator: rk808:...
378
379
380
381
382
383
384
385
386
387
388
  	.list_voltage		= regulator_list_voltage_linear,
  	.map_voltage		= regulator_map_voltage_linear,
  	.get_voltage_sel	= regulator_get_voltage_sel_regmap,
  	.set_voltage_sel	= regulator_set_voltage_sel_regmap,
  	.enable			= regulator_enable_regmap,
  	.disable		= regulator_disable_regmap,
  	.is_enabled		= regulator_is_enabled_regmap,
  	.set_suspend_voltage	= rk808_set_suspend_voltage,
  	.set_suspend_enable	= rk808_set_suspend_enable,
  	.set_suspend_disable	= rk808_set_suspend_disable,
  };
129d7cf98   Wadim Egorov   regulator: rk808:...
389
390
391
392
393
394
395
396
397
398
399
400
  static struct regulator_ops rk808_reg_ops_ranges = {
  	.list_voltage		= regulator_list_voltage_linear_range,
  	.map_voltage		= regulator_map_voltage_linear_range,
  	.get_voltage_sel	= regulator_get_voltage_sel_regmap,
  	.set_voltage_sel	= regulator_set_voltage_sel_regmap,
  	.enable			= regulator_enable_regmap,
  	.disable		= regulator_disable_regmap,
  	.is_enabled		= regulator_is_enabled_regmap,
  	.set_suspend_voltage	= rk808_set_suspend_voltage_range,
  	.set_suspend_enable	= rk808_set_suspend_enable,
  	.set_suspend_disable	= rk808_set_suspend_disable,
  };
2cd64ae3d   Chris Zhong   regulator: RK808:...
401
  static struct regulator_ops rk808_switch_ops = {
251ce318d   Chris Zhong   regulator: rk808:...
402
403
404
405
406
  	.enable			= regulator_enable_regmap,
  	.disable		= regulator_disable_regmap,
  	.is_enabled		= regulator_is_enabled_regmap,
  	.set_suspend_enable	= rk808_set_suspend_enable,
  	.set_suspend_disable	= rk808_set_suspend_disable,
2cd64ae3d   Chris Zhong   regulator: RK808:...
407
  };
c4e0d344c   Elaine Zhang   regulator: rk808:...
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
  static const struct regulator_desc rk805_reg[] = {
  	{
  		.name = "DCDC_REG1",
  		.supply_name = "vcc1",
  		.of_match = of_match_ptr("DCDC_REG1"),
  		.regulators_node = of_match_ptr("regulators"),
  		.id = RK805_ID_DCDC1,
  		.ops = &rk805_reg_ops,
  		.type = REGULATOR_VOLTAGE,
  		.min_uV = 712500,
  		.uV_step = 12500,
  		.n_voltages = 64,
  		.vsel_reg = RK805_BUCK1_ON_VSEL_REG,
  		.vsel_mask = RK818_BUCK_VSEL_MASK,
  		.enable_reg = RK805_DCDC_EN_REG,
  		.enable_mask = BIT(0),
  		.owner = THIS_MODULE,
  	}, {
  		.name = "DCDC_REG2",
  		.supply_name = "vcc2",
  		.of_match = of_match_ptr("DCDC_REG2"),
  		.regulators_node = of_match_ptr("regulators"),
  		.id = RK805_ID_DCDC2,
  		.ops = &rk805_reg_ops,
  		.type = REGULATOR_VOLTAGE,
  		.min_uV = 712500,
  		.uV_step = 12500,
  		.n_voltages = 64,
  		.vsel_reg = RK805_BUCK2_ON_VSEL_REG,
  		.vsel_mask = RK818_BUCK_VSEL_MASK,
  		.enable_reg = RK805_DCDC_EN_REG,
  		.enable_mask = BIT(1),
  		.owner = THIS_MODULE,
  	}, {
  		.name = "DCDC_REG3",
  		.supply_name = "vcc3",
  		.of_match = of_match_ptr("DCDC_REG3"),
  		.regulators_node = of_match_ptr("regulators"),
  		.id = RK805_ID_DCDC3,
  		.ops = &rk805_switch_ops,
  		.type = REGULATOR_VOLTAGE,
  		.n_voltages = 1,
  		.enable_reg = RK805_DCDC_EN_REG,
  		.enable_mask = BIT(2),
  		.owner = THIS_MODULE,
  	},
  
  	RK805_DESC(RK805_ID_DCDC4, "DCDC_REG4", "vcc4", 800, 3400, 100,
  		RK805_BUCK4_ON_VSEL_REG, RK818_BUCK4_VSEL_MASK,
  		RK805_DCDC_EN_REG, BIT(3), 0),
  
  	RK805_DESC(RK805_ID_LDO1, "LDO_REG1", "vcc5", 800, 3400, 100,
  		RK805_LDO1_ON_VSEL_REG, RK818_LDO_VSEL_MASK, RK805_LDO_EN_REG,
  		BIT(0), 400),
  	RK805_DESC(RK805_ID_LDO2, "LDO_REG2", "vcc5", 800, 3400, 100,
  		RK805_LDO2_ON_VSEL_REG, RK818_LDO_VSEL_MASK, RK805_LDO_EN_REG,
  		BIT(1), 400),
  	RK805_DESC(RK805_ID_LDO3, "LDO_REG3", "vcc6", 800, 3400, 100,
  		RK805_LDO3_ON_VSEL_REG, RK818_LDO_VSEL_MASK, RK805_LDO_EN_REG,
  		BIT(2), 400),
  };
2cd64ae3d   Chris Zhong   regulator: RK808:...
469
470
471
  static const struct regulator_desc rk808_reg[] = {
  	{
  		.name = "DCDC_REG1",
b8074eba2   Doug Anderson   regulator: RK808:...
472
  		.supply_name = "vcc1",
9e9daa0a6   Wadim Egorov   regulator: rk808:...
473
474
  		.of_match = of_match_ptr("DCDC_REG1"),
  		.regulators_node = of_match_ptr("regulators"),
2cd64ae3d   Chris Zhong   regulator: RK808:...
475
  		.id = RK808_ID_DCDC1,
8af252272   Doug Anderson   regulator: rk808:...
476
  		.ops = &rk808_buck1_2_ops,
2cd64ae3d   Chris Zhong   regulator: RK808:...
477
  		.type = REGULATOR_VOLTAGE,
afcd666d9   Wadim Egorov   regulator: rk808:...
478
479
  		.min_uV = 712500,
  		.uV_step = 12500,
2cd64ae3d   Chris Zhong   regulator: RK808:...
480
  		.n_voltages = 64,
2cd64ae3d   Chris Zhong   regulator: RK808:...
481
482
483
484
485
486
487
  		.vsel_reg = RK808_BUCK1_ON_VSEL_REG,
  		.vsel_mask = RK808_BUCK_VSEL_MASK,
  		.enable_reg = RK808_DCDC_EN_REG,
  		.enable_mask = BIT(0),
  		.owner = THIS_MODULE,
  	}, {
  		.name = "DCDC_REG2",
b8074eba2   Doug Anderson   regulator: RK808:...
488
  		.supply_name = "vcc2",
9e9daa0a6   Wadim Egorov   regulator: rk808:...
489
490
  		.of_match = of_match_ptr("DCDC_REG2"),
  		.regulators_node = of_match_ptr("regulators"),
2cd64ae3d   Chris Zhong   regulator: RK808:...
491
  		.id = RK808_ID_DCDC2,
8af252272   Doug Anderson   regulator: rk808:...
492
  		.ops = &rk808_buck1_2_ops,
2cd64ae3d   Chris Zhong   regulator: RK808:...
493
  		.type = REGULATOR_VOLTAGE,
afcd666d9   Wadim Egorov   regulator: rk808:...
494
495
  		.min_uV = 712500,
  		.uV_step = 12500,
2cd64ae3d   Chris Zhong   regulator: RK808:...
496
  		.n_voltages = 64,
2cd64ae3d   Chris Zhong   regulator: RK808:...
497
498
499
500
501
502
503
  		.vsel_reg = RK808_BUCK2_ON_VSEL_REG,
  		.vsel_mask = RK808_BUCK_VSEL_MASK,
  		.enable_reg = RK808_DCDC_EN_REG,
  		.enable_mask = BIT(1),
  		.owner = THIS_MODULE,
  	}, {
  		.name = "DCDC_REG3",
b8074eba2   Doug Anderson   regulator: RK808:...
504
  		.supply_name = "vcc3",
9e9daa0a6   Wadim Egorov   regulator: rk808:...
505
506
  		.of_match = of_match_ptr("DCDC_REG3"),
  		.regulators_node = of_match_ptr("regulators"),
2cd64ae3d   Chris Zhong   regulator: RK808:...
507
508
509
510
511
512
513
  		.id = RK808_ID_DCDC3,
  		.ops = &rk808_switch_ops,
  		.type = REGULATOR_VOLTAGE,
  		.n_voltages = 1,
  		.enable_reg = RK808_DCDC_EN_REG,
  		.enable_mask = BIT(2),
  		.owner = THIS_MODULE,
9e9daa0a6   Wadim Egorov   regulator: rk808:...
514
515
516
517
518
519
520
521
522
523
524
  	},
  	RK8XX_DESC(RK808_ID_DCDC4, "DCDC_REG4", "vcc4", 1800, 3300, 100,
  		RK808_BUCK4_ON_VSEL_REG, RK808_BUCK4_VSEL_MASK,
  		RK808_DCDC_EN_REG, BIT(3), 0),
  	RK8XX_DESC(RK808_ID_LDO1, "LDO_REG1", "vcc6", 1800, 3400, 100,
  		RK808_LDO1_ON_VSEL_REG, RK808_LDO_VSEL_MASK, RK808_LDO_EN_REG,
  		BIT(0), 400),
  	RK8XX_DESC(RK808_ID_LDO2, "LDO_REG2", "vcc6", 1800, 3400, 100,
  		RK808_LDO2_ON_VSEL_REG, RK808_LDO_VSEL_MASK, RK808_LDO_EN_REG,
  		BIT(1), 400),
  	{
2cd64ae3d   Chris Zhong   regulator: RK808:...
525
  		.name = "LDO_REG3",
b8074eba2   Doug Anderson   regulator: RK808:...
526
  		.supply_name = "vcc7",
9e9daa0a6   Wadim Egorov   regulator: rk808:...
527
528
  		.of_match = of_match_ptr("LDO_REG3"),
  		.regulators_node = of_match_ptr("regulators"),
2cd64ae3d   Chris Zhong   regulator: RK808:...
529
  		.id = RK808_ID_LDO3,
129d7cf98   Wadim Egorov   regulator: rk808:...
530
  		.ops = &rk808_reg_ops_ranges,
2cd64ae3d   Chris Zhong   regulator: RK808:...
531
532
533
534
535
536
537
538
  		.type = REGULATOR_VOLTAGE,
  		.n_voltages = 16,
  		.linear_ranges = rk808_ldo3_voltage_ranges,
  		.n_linear_ranges = ARRAY_SIZE(rk808_ldo3_voltage_ranges),
  		.vsel_reg = RK808_LDO3_ON_VSEL_REG,
  		.vsel_mask = RK808_BUCK4_VSEL_MASK,
  		.enable_reg = RK808_LDO_EN_REG,
  		.enable_mask = BIT(2),
28249b0c2   Doug Anderson   regulator: rk808:...
539
  		.enable_time = 400,
2cd64ae3d   Chris Zhong   regulator: RK808:...
540
  		.owner = THIS_MODULE,
2cd64ae3d   Chris Zhong   regulator: RK808:...
541
  	},
9e9daa0a6   Wadim Egorov   regulator: rk808:...
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
  	RK8XX_DESC(RK808_ID_LDO4, "LDO_REG4", "vcc9", 1800, 3400, 100,
  		RK808_LDO4_ON_VSEL_REG, RK808_LDO_VSEL_MASK, RK808_LDO_EN_REG,
  		BIT(3), 400),
  	RK8XX_DESC(RK808_ID_LDO5, "LDO_REG5", "vcc9", 1800, 3400, 100,
  		RK808_LDO5_ON_VSEL_REG, RK808_LDO_VSEL_MASK, RK808_LDO_EN_REG,
  		BIT(4), 400),
  	RK8XX_DESC(RK808_ID_LDO6, "LDO_REG6", "vcc10", 800, 2500, 100,
  		RK808_LDO6_ON_VSEL_REG, RK808_LDO_VSEL_MASK, RK808_LDO_EN_REG,
  		BIT(5), 400),
  	RK8XX_DESC(RK808_ID_LDO7, "LDO_REG7", "vcc7", 800, 2500, 100,
  		RK808_LDO7_ON_VSEL_REG, RK808_LDO_VSEL_MASK, RK808_LDO_EN_REG,
  		BIT(6), 400),
  	RK8XX_DESC(RK808_ID_LDO8, "LDO_REG8", "vcc11", 1800, 3400, 100,
  		RK808_LDO8_ON_VSEL_REG, RK808_LDO_VSEL_MASK, RK808_LDO_EN_REG,
  		BIT(7), 400),
  	RK8XX_DESC_SWITCH(RK808_ID_SWITCH1, "SWITCH_REG1", "vcc8",
  		RK808_DCDC_EN_REG, BIT(5)),
  	RK8XX_DESC_SWITCH(RK808_ID_SWITCH2, "SWITCH_REG2", "vcc12",
  		RK808_DCDC_EN_REG, BIT(6)),
2cd64ae3d   Chris Zhong   regulator: RK808:...
561
  };
113752935   Wadim Egorov   regulator: rk808:...
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
  static const struct regulator_desc rk818_reg[] = {
  	{
  		.name = "DCDC_REG1",
  		.supply_name = "vcc1",
  		.of_match = of_match_ptr("DCDC_REG1"),
  		.regulators_node = of_match_ptr("regulators"),
  		.id = RK818_ID_DCDC1,
  		.ops = &rk808_reg_ops,
  		.type = REGULATOR_VOLTAGE,
  		.min_uV = 712500,
  		.uV_step = 12500,
  		.n_voltages = 64,
  		.vsel_reg = RK818_BUCK1_ON_VSEL_REG,
  		.vsel_mask = RK818_BUCK_VSEL_MASK,
  		.enable_reg = RK818_DCDC_EN_REG,
  		.enable_mask = BIT(0),
  		.owner = THIS_MODULE,
  	}, {
  		.name = "DCDC_REG2",
  		.supply_name = "vcc2",
  		.of_match = of_match_ptr("DCDC_REG2"),
  		.regulators_node = of_match_ptr("regulators"),
  		.id = RK818_ID_DCDC2,
  		.ops = &rk808_reg_ops,
  		.type = REGULATOR_VOLTAGE,
  		.min_uV = 712500,
  		.uV_step = 12500,
  		.n_voltages = 64,
  		.vsel_reg = RK818_BUCK2_ON_VSEL_REG,
  		.vsel_mask = RK818_BUCK_VSEL_MASK,
  		.enable_reg = RK818_DCDC_EN_REG,
  		.enable_mask = BIT(1),
  		.owner = THIS_MODULE,
  	}, {
  		.name = "DCDC_REG3",
  		.supply_name = "vcc3",
  		.of_match = of_match_ptr("DCDC_REG3"),
  		.regulators_node = of_match_ptr("regulators"),
  		.id = RK818_ID_DCDC3,
  		.ops = &rk808_switch_ops,
  		.type = REGULATOR_VOLTAGE,
  		.n_voltages = 1,
  		.enable_reg = RK818_DCDC_EN_REG,
  		.enable_mask = BIT(2),
  		.owner = THIS_MODULE,
  	},
  	RK8XX_DESC(RK818_ID_DCDC4, "DCDC_REG4", "vcc4", 1800, 3600, 100,
  		RK818_BUCK4_ON_VSEL_REG, RK818_BUCK4_VSEL_MASK,
  		RK818_DCDC_EN_REG, BIT(3), 0),
  	RK8XX_DESC(RK818_ID_BOOST, "DCDC_BOOST", "boost", 4700, 5400, 100,
  		RK818_BOOST_LDO9_ON_VSEL_REG, RK818_BOOST_ON_VSEL_MASK,
  		RK818_DCDC_EN_REG, BIT(4), 0),
  	RK8XX_DESC(RK818_ID_LDO1, "LDO_REG1", "vcc6", 1800, 3400, 100,
  		RK818_LDO1_ON_VSEL_REG, RK818_LDO_VSEL_MASK, RK818_LDO_EN_REG,
  		BIT(0), 400),
  	RK8XX_DESC(RK818_ID_LDO2, "LDO_REG2", "vcc6", 1800, 3400, 100,
75f881153   Wadim Egorov   regulator: rk808:...
618
  		RK818_LDO2_ON_VSEL_REG, RK818_LDO_VSEL_MASK, RK818_LDO_EN_REG,
113752935   Wadim Egorov   regulator: rk808:...
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
  		BIT(1), 400),
  	{
  		.name = "LDO_REG3",
  		.supply_name = "vcc7",
  		.of_match = of_match_ptr("LDO_REG3"),
  		.regulators_node = of_match_ptr("regulators"),
  		.id = RK818_ID_LDO3,
  		.ops = &rk808_reg_ops_ranges,
  		.type = REGULATOR_VOLTAGE,
  		.n_voltages = 16,
  		.linear_ranges = rk808_ldo3_voltage_ranges,
  		.n_linear_ranges = ARRAY_SIZE(rk808_ldo3_voltage_ranges),
  		.vsel_reg = RK818_LDO3_ON_VSEL_REG,
  		.vsel_mask = RK818_LDO3_ON_VSEL_MASK,
  		.enable_reg = RK818_LDO_EN_REG,
  		.enable_mask = BIT(2),
  		.enable_time = 400,
  		.owner = THIS_MODULE,
  	},
  	RK8XX_DESC(RK818_ID_LDO4, "LDO_REG4", "vcc8", 1800, 3400, 100,
  		RK818_LDO4_ON_VSEL_REG, RK818_LDO_VSEL_MASK, RK818_LDO_EN_REG,
  		BIT(3), 400),
  	RK8XX_DESC(RK818_ID_LDO5, "LDO_REG5", "vcc7", 1800, 3400, 100,
  		RK818_LDO5_ON_VSEL_REG, RK818_LDO_VSEL_MASK, RK818_LDO_EN_REG,
  		BIT(4), 400),
  	RK8XX_DESC(RK818_ID_LDO6, "LDO_REG6", "vcc8", 800, 2500, 100,
  		RK818_LDO6_ON_VSEL_REG, RK818_LDO_VSEL_MASK, RK818_LDO_EN_REG,
  		BIT(5), 400),
  	RK8XX_DESC(RK818_ID_LDO7, "LDO_REG7", "vcc7", 800, 2500, 100,
  		RK818_LDO7_ON_VSEL_REG, RK818_LDO_VSEL_MASK, RK818_LDO_EN_REG,
  		BIT(6), 400),
  	RK8XX_DESC(RK818_ID_LDO8, "LDO_REG8", "vcc8", 1800, 3400, 100,
  		RK818_LDO8_ON_VSEL_REG, RK818_LDO_VSEL_MASK, RK818_LDO_EN_REG,
  		BIT(7), 400),
  	RK8XX_DESC(RK818_ID_LDO9, "LDO_REG9", "vcc9", 1800, 3400, 100,
  		RK818_BOOST_LDO9_ON_VSEL_REG, RK818_LDO_VSEL_MASK,
  		RK818_DCDC_EN_REG, BIT(5), 400),
  	RK8XX_DESC_SWITCH(RK818_ID_SWITCH, "SWITCH_REG", "vcc9",
  		RK818_DCDC_EN_REG, BIT(6)),
  	RK8XX_DESC_SWITCH(RK818_ID_HDMI_SWITCH, "HDMI_SWITCH", "h_5v",
  		RK818_H5V_EN_REG, BIT(0)),
  	RK8XX_DESC_SWITCH(RK818_ID_OTG_SWITCH, "OTG_SWITCH", "usb",
  		RK818_DCDC_EN_REG, BIT(7)),
  };
bad47ad2e   Chris Zhong   regulator: rk808:...
663
664
665
666
667
668
  static int rk808_regulator_dt_parse_pdata(struct device *dev,
  				   struct device *client_dev,
  				   struct regmap *map,
  				   struct rk808_regulator_data *pdata)
  {
  	struct device_node *np;
9e9daa0a6   Wadim Egorov   regulator: rk808:...
669
  	int tmp, ret = 0, i;
bad47ad2e   Chris Zhong   regulator: rk808:...
670
671
672
673
  
  	np = of_get_child_by_name(client_dev->of_node, "regulators");
  	if (!np)
  		return -ENXIO;
bad47ad2e   Chris Zhong   regulator: rk808:...
674
  	for (i = 0; i < ARRAY_SIZE(pdata->dvs_gpio); i++) {
a13eaf02e   Uwe Kleine-König   regulator: rk808:...
675
676
677
  		pdata->dvs_gpio[i] =
  			devm_gpiod_get_index_optional(client_dev, "dvs", i,
  						      GPIOD_OUT_LOW);
bad47ad2e   Chris Zhong   regulator: rk808:...
678
  		if (IS_ERR(pdata->dvs_gpio[i])) {
a13eaf02e   Uwe Kleine-König   regulator: rk808:...
679
680
681
682
683
684
685
  			ret = PTR_ERR(pdata->dvs_gpio[i]);
  			dev_err(dev, "failed to get dvs%d gpio (%d)
  ", i, ret);
  			goto dt_parse_end;
  		}
  
  		if (!pdata->dvs_gpio[i]) {
bad47ad2e   Chris Zhong   regulator: rk808:...
686
687
688
689
  			dev_warn(dev, "there is no dvs%d gpio
  ", i);
  			continue;
  		}
bad47ad2e   Chris Zhong   regulator: rk808:...
690
691
692
693
694
695
696
697
698
699
  		tmp = i ? RK808_DVS2_POL : RK808_DVS1_POL;
  		ret = regmap_update_bits(map, RK808_IO_POL_REG, tmp,
  				gpiod_is_active_low(pdata->dvs_gpio[i]) ?
  				0 : tmp);
  	}
  
  dt_parse_end:
  	of_node_put(np);
  	return ret;
  }
2cd64ae3d   Chris Zhong   regulator: RK808:...
700
701
702
  static int rk808_regulator_probe(struct platform_device *pdev)
  {
  	struct rk808 *rk808 = dev_get_drvdata(pdev->dev.parent);
d76c333e9   Chris Zhong   regulator: RK808:...
703
  	struct i2c_client *client = rk808->i2c;
462004f12   Doug Anderson   regulator: rk808:...
704
  	struct regulator_config config = {};
2cd64ae3d   Chris Zhong   regulator: RK808:...
705
  	struct regulator_dev *rk808_rdev;
bad47ad2e   Chris Zhong   regulator: rk808:...
706
  	struct rk808_regulator_data *pdata;
113752935   Wadim Egorov   regulator: rk808:...
707
708
  	const struct regulator_desc *regulators;
  	int ret, i, nregulators;
2cd64ae3d   Chris Zhong   regulator: RK808:...
709

bad47ad2e   Chris Zhong   regulator: rk808:...
710
711
712
  	pdata = devm_kzalloc(&pdev->dev, sizeof(*pdata), GFP_KERNEL);
  	if (!pdata)
  		return -ENOMEM;
2cd64ae3d   Chris Zhong   regulator: RK808:...
713

bad47ad2e   Chris Zhong   regulator: rk808:...
714
715
  	ret = rk808_regulator_dt_parse_pdata(&pdev->dev, &client->dev,
  					     rk808->regmap, pdata);
571a40108   Chris Zhong   regulator: rk808:...
716
  	if (ret < 0)
2cd64ae3d   Chris Zhong   regulator: RK808:...
717
  		return ret;
bad47ad2e   Chris Zhong   regulator: rk808:...
718
  	platform_set_drvdata(pdev, pdata);
113752935   Wadim Egorov   regulator: rk808:...
719
  	switch (rk808->variant) {
c4e0d344c   Elaine Zhang   regulator: rk808:...
720
721
722
723
  	case RK805_ID:
  		regulators = rk805_reg;
  		nregulators = RK805_NUM_REGULATORS;
  		break;
113752935   Wadim Egorov   regulator: rk808:...
724
725
726
727
728
729
730
731
732
733
734
735
736
737
  	case RK808_ID:
  		regulators = rk808_reg;
  		nregulators = RK808_NUM_REGULATORS;
  		break;
  	case RK818_ID:
  		regulators = rk818_reg;
  		nregulators = RK818_NUM_REGULATORS;
  		break;
  	default:
  		dev_err(&client->dev, "unsupported RK8XX ID %lu
  ",
  			rk808->variant);
  		return -EINVAL;
  	}
9e9daa0a6   Wadim Egorov   regulator: rk808:...
738
739
740
  	config.dev = &client->dev;
  	config.driver_data = pdata;
  	config.regmap = rk808->regmap;
2cd64ae3d   Chris Zhong   regulator: RK808:...
741
  	/* Instantiate the regulators */
113752935   Wadim Egorov   regulator: rk808:...
742
  	for (i = 0; i < nregulators; i++) {
2cd64ae3d   Chris Zhong   regulator: RK808:...
743
  		rk808_rdev = devm_regulator_register(&pdev->dev,
113752935   Wadim Egorov   regulator: rk808:...
744
  						     &regulators[i], &config);
2cd64ae3d   Chris Zhong   regulator: RK808:...
745
  		if (IS_ERR(rk808_rdev)) {
d76c333e9   Chris Zhong   regulator: RK808:...
746
  			dev_err(&client->dev,
2cd64ae3d   Chris Zhong   regulator: RK808:...
747
748
749
750
  				"failed to register %d regulator
  ", i);
  			return PTR_ERR(rk808_rdev);
  		}
2cd64ae3d   Chris Zhong   regulator: RK808:...
751
  	}
571a40108   Chris Zhong   regulator: rk808:...
752

2cd64ae3d   Chris Zhong   regulator: RK808:...
753
754
755
756
757
758
  	return 0;
  }
  
  static struct platform_driver rk808_regulator_driver = {
  	.probe = rk808_regulator_probe,
  	.driver = {
556ae220a   Markus Elfring   regulator: rk808:...
759
  		.name = "rk808-regulator"
2cd64ae3d   Chris Zhong   regulator: RK808:...
760
761
762
763
  	},
  };
  
  module_platform_driver(rk808_regulator_driver);
113752935   Wadim Egorov   regulator: rk808:...
764
765
766
767
  MODULE_DESCRIPTION("regulator driver for the RK808/RK818 series PMICs");
  MODULE_AUTHOR("Chris Zhong <zyw@rock-chips.com>");
  MODULE_AUTHOR("Zhang Qing <zhangqing@rock-chips.com>");
  MODULE_AUTHOR("Wadim Egorov <w.egorov@phytec.de>");
2cd64ae3d   Chris Zhong   regulator: RK808:...
768
769
  MODULE_LICENSE("GPL");
  MODULE_ALIAS("platform:rk808-regulator");