1 // SPDX-License-Identifier: GPL-2.0
3 * Device driver for regulators in Hisi IC
5 * Copyright (c) 2013 Linaro Ltd.
6 * Copyright (c) 2011 Hisilicon.
8 * Guodong Xu <guodong.xu@linaro.org>
10 * This program is free software; you can redistribute it and/or modify
11 * it under the terms of the GNU General Public License version 2 as
12 * published by the Free Software Foundation.
14 * This program is distributed in the hope that it will be useful,
15 * but WITHOUT ANY WARRANTY; without even the implied warranty of
16 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
17 * GNU General Public License for more details.
20 #include <linux/delay.h>
21 #include <linux/device.h>
22 #include <linux/err.h>
24 #include <linux/mfd/hi6421-spmi-pmic.h>
25 #include <linux/module.h>
26 #include <linux/of_address.h>
27 #include <linux/of_device.h>
29 #include <linux/platform_device.h>
30 #include <linux/regmap.h>
31 #include <linux/regulator/driver.h>
32 #include <linux/regulator/machine.h>
33 #include <linux/regulator/of_regulator.h>
34 #include <linux/seq_file.h>
35 #include <linux/slab.h>
36 #include <linux/spmi.h>
37 #include <linux/time.h>
38 #include <linux/uaccess.h>
40 #define rdev_dbg(rdev, fmt, arg...) \
41 pr_debug("%s: %s: " fmt, (rdev)->desc->name, __func__, ##arg)
43 struct hi6421v600_regulator {
44 struct regulator_desc rdesc;
45 struct hi6421_spmi_pmic *pmic;
46 u32 eco_mode_mask, eco_uA;
49 static DEFINE_MUTEX(enable_mutex);
52 * helper function to ensure when it returns it is at least 'delay_us'
53 * microseconds after 'since'.
56 static int hi6421_spmi_regulator_is_enabled(struct regulator_dev *rdev)
58 struct hi6421v600_regulator *sreg = rdev_get_drvdata(rdev);
59 struct hi6421_spmi_pmic *pmic = sreg->pmic;
62 reg_val = hi6421_spmi_pmic_read(pmic, rdev->desc->enable_reg);
65 "enable_reg=0x%x, val= 0x%x, enable_state=%d\n",
66 rdev->desc->enable_reg,
67 reg_val, (reg_val & rdev->desc->enable_mask));
69 return ((reg_val & rdev->desc->enable_mask) != 0);
72 static int hi6421_spmi_regulator_enable(struct regulator_dev *rdev)
74 struct hi6421v600_regulator *sreg = rdev_get_drvdata(rdev);
75 struct hi6421_spmi_pmic *pmic = sreg->pmic;
77 /* cannot enable more than one regulator at one time */
78 mutex_lock(&enable_mutex);
79 usleep_range(HISI_REGS_ENA_PROTECT_TIME,
80 HISI_REGS_ENA_PROTECT_TIME + 1000);
82 /* set enable register */
84 "off_on_delay=%d us, enable_reg=0x%x, enable_mask=0x%x\n",
85 rdev->desc->off_on_delay, rdev->desc->enable_reg,
86 rdev->desc->enable_mask);
88 hi6421_spmi_pmic_rmw(pmic, rdev->desc->enable_reg,
89 rdev->desc->enable_mask,
90 rdev->desc->enable_mask);
92 mutex_unlock(&enable_mutex);
97 static int hi6421_spmi_regulator_disable(struct regulator_dev *rdev)
99 struct hi6421v600_regulator *sreg = rdev_get_drvdata(rdev);
100 struct hi6421_spmi_pmic *pmic = sreg->pmic;
102 /* set enable register to 0 */
103 rdev_dbg(rdev, "enable_reg=0x%x, enable_mask=0x%x\n",
104 rdev->desc->enable_reg, rdev->desc->enable_mask);
106 hi6421_spmi_pmic_rmw(pmic, rdev->desc->enable_reg,
107 rdev->desc->enable_mask, 0);
112 static int hi6421_spmi_regulator_get_voltage_sel(struct regulator_dev *rdev)
114 struct hi6421v600_regulator *sreg = rdev_get_drvdata(rdev);
115 struct hi6421_spmi_pmic *pmic = sreg->pmic;
116 u32 reg_val, selector;
118 /* get voltage selector */
119 reg_val = hi6421_spmi_pmic_read(pmic, rdev->desc->vsel_reg);
121 selector = (reg_val & rdev->desc->vsel_mask) >> (ffs(rdev->desc->vsel_mask) - 1);
124 "vsel_reg=0x%x, value=0x%x, entry=0x%x, voltage=%d mV\n",
125 rdev->desc->vsel_reg, reg_val, selector,
126 rdev->desc->ops->list_voltage(rdev, selector) / 1000);
131 static int hi6421_spmi_regulator_set_voltage_sel(struct regulator_dev *rdev,
132 unsigned int selector)
134 struct hi6421v600_regulator *sreg = rdev_get_drvdata(rdev);
135 struct hi6421_spmi_pmic *pmic = sreg->pmic;
138 if (unlikely(selector >= rdev->desc->n_voltages))
141 reg_val = selector << (ffs(rdev->desc->vsel_mask) - 1);
143 /* set voltage selector */
145 "vsel_reg=0x%x, mask=0x%x, value=0x%x, voltage=%d mV\n",
146 rdev->desc->vsel_reg, rdev->desc->vsel_mask, reg_val,
147 rdev->desc->ops->list_voltage(rdev, selector) / 1000);
149 hi6421_spmi_pmic_rmw(pmic, rdev->desc->vsel_reg,
150 rdev->desc->vsel_mask, reg_val);
155 static unsigned int hi6421_spmi_regulator_get_mode(struct regulator_dev *rdev)
157 struct hi6421v600_regulator *sreg = rdev_get_drvdata(rdev);
158 struct hi6421_spmi_pmic *pmic = sreg->pmic;
162 reg_val = hi6421_spmi_pmic_read(pmic, rdev->desc->enable_reg);
164 if (reg_val & sreg->eco_mode_mask)
165 mode = REGULATOR_MODE_IDLE;
167 mode = REGULATOR_MODE_NORMAL;
170 "enable_reg=0x%x, eco_mode_mask=0x%x, reg_val=0x%x, %s mode\n",
171 rdev->desc->enable_reg, sreg->eco_mode_mask, reg_val,
172 mode == REGULATOR_MODE_IDLE ? "idle" : "normal");
177 static int hi6421_spmi_regulator_set_mode(struct regulator_dev *rdev,
180 struct hi6421v600_regulator *sreg = rdev_get_drvdata(rdev);
181 struct hi6421_spmi_pmic *pmic = sreg->pmic;
185 case REGULATOR_MODE_NORMAL:
188 case REGULATOR_MODE_IDLE:
189 val = sreg->eco_mode_mask << (ffs(sreg->eco_mode_mask) - 1);
196 rdev_dbg(rdev, "enable_reg=0x%x, eco_mode_mask=0x%x, value=0x%x\n",
197 rdev->desc->enable_reg, sreg->eco_mode_mask, val);
199 hi6421_spmi_pmic_rmw(pmic, rdev->desc->enable_reg,
200 sreg->eco_mode_mask, val);
206 hi6421_spmi_regulator_get_optimum_mode(struct regulator_dev *rdev,
207 int input_uV, int output_uV,
210 struct hi6421v600_regulator *sreg = rdev_get_drvdata(rdev);
212 if (load_uA || ((unsigned int)load_uA > sreg->eco_uA))
213 return REGULATOR_MODE_NORMAL;
215 return REGULATOR_MODE_IDLE;
218 static int hi6421_spmi_dt_parse(struct platform_device *pdev,
219 struct hi6421v600_regulator *sreg,
220 struct regulator_desc *rdesc)
222 struct device *dev = &pdev->dev;
223 struct device_node *np = dev->of_node;
224 unsigned int *v_table;
227 ret = of_property_read_u32(np, "reg", &rdesc->enable_reg);
229 dev_err(dev, "missing reg property\n");
233 ret = of_property_read_u32(np, "vsel-reg", &rdesc->vsel_reg);
235 dev_err(dev, "missing vsel-reg property\n");
239 ret = of_property_read_u32(np, "enable-mask", &rdesc->enable_mask);
241 dev_err(dev, "missing enable-mask property\n");
246 * Not all regulators work on idle mode
248 ret = of_property_read_u32(np, "idle-mode-mask", &sreg->eco_mode_mask);
250 dev_dbg(dev, "LDO doesn't support economy mode.\n");
251 sreg->eco_mode_mask = 0;
254 ret = of_property_read_u32(np, "eco-microamp", &sreg->eco_uA);
256 dev_err(dev, "missing eco-microamp property\n");
261 /* parse .off-on-delay */
262 ret = of_property_read_u32(np, "off-on-delay-us",
263 &rdesc->off_on_delay);
265 dev_err(dev, "missing off-on-delay-us property\n");
269 /* parse .enable_time */
270 ret = of_property_read_u32(np, "startup-delay-us",
271 &rdesc->enable_time);
273 dev_err(dev, "missing startup-delay-us property\n");
277 /* FIXME: are there a better value for this? */
278 rdesc->ramp_delay = rdesc->enable_time;
280 /* parse volt_table */
282 rdesc->n_voltages = of_property_count_u32_elems(np, "voltage-table");
284 v_table = devm_kzalloc(dev, sizeof(unsigned int) * rdesc->n_voltages,
286 if (unlikely(!v_table))
288 rdesc->volt_table = v_table;
290 ret = of_property_read_u32_array(np, "voltage-table",
291 v_table, rdesc->n_voltages);
293 dev_err(dev, "missing voltage-table property\n");
298 * Instead of explicitly requiring a mask for the voltage selector,
299 * as they all start from bit zero (at least on the known LDOs),
300 * just use the number of voltages at the voltage table, getting the
301 * minimal mask that would pick everything.
303 rdesc->vsel_mask = (1 << (fls(rdesc->n_voltages) - 1)) - 1;
305 dev_dbg(dev, "voltage selector settings: reg: 0x%x, mask: 0x%x\n",
306 rdesc->vsel_reg, rdesc->vsel_mask);
311 static const struct regulator_ops hi6421_spmi_ldo_rops = {
312 .is_enabled = hi6421_spmi_regulator_is_enabled,
313 .enable = hi6421_spmi_regulator_enable,
314 .disable = hi6421_spmi_regulator_disable,
315 .list_voltage = regulator_list_voltage_table,
316 .map_voltage = regulator_map_voltage_iterate,
317 .get_voltage_sel = hi6421_spmi_regulator_get_voltage_sel,
318 .set_voltage_sel = hi6421_spmi_regulator_set_voltage_sel,
319 .get_mode = hi6421_spmi_regulator_get_mode,
320 .set_mode = hi6421_spmi_regulator_set_mode,
321 .get_optimum_mode = hi6421_spmi_regulator_get_optimum_mode,
324 static int hi6421_spmi_regulator_probe_ldo(struct platform_device *pdev,
325 struct device_node *np,
326 struct hi6421_spmi_pmic *pmic)
328 struct regulation_constraints *constraint;
329 struct regulator_init_data *initdata;
330 struct regulator_config config = { };
331 struct hi6421v600_regulator *sreg;
332 struct device *dev = &pdev->dev;
333 struct regulator_desc *rdesc;
334 struct regulator_dev *rdev;
335 const char *supplyname;
338 initdata = of_get_regulator_init_data(dev, np, NULL);
340 dev_err(dev, "failed to get regulator data\n");
344 sreg = devm_kzalloc(dev, sizeof(*sreg), GFP_KERNEL);
349 rdesc = &sreg->rdesc;
351 rdesc->name = initdata->constraints.name;
352 rdesc->ops = &hi6421_spmi_ldo_rops;
353 rdesc->type = REGULATOR_VOLTAGE;
354 rdesc->min_uV = initdata->constraints.min_uV;
356 supplyname = of_get_property(np, "supply_name", NULL);
358 initdata->supply_regulator = supplyname;
360 /* parse device tree data for regulator specific */
361 ret = hi6421_spmi_dt_parse(pdev, sreg, rdesc);
365 /* hisi regulator supports two modes */
366 constraint = &initdata->constraints;
368 constraint->valid_modes_mask = REGULATOR_MODE_NORMAL;
369 if (sreg->eco_mode_mask) {
370 constraint->valid_modes_mask |= REGULATOR_MODE_IDLE;
371 constraint->valid_ops_mask |= REGULATOR_CHANGE_MODE;
374 config.dev = &pdev->dev;
375 config.init_data = initdata;
376 config.driver_data = sreg;
377 config.of_node = pdev->dev.of_node;
379 /* register regulator */
380 rdev = regulator_register(rdesc, &config);
382 dev_err(dev, "failed to register %s\n",
384 return PTR_ERR(rdev);
387 rdev_dbg(rdev, "valid_modes_mask: 0x%x, valid_ops_mask: 0x%x\n",
388 constraint->valid_modes_mask, constraint->valid_ops_mask);
390 dev_set_drvdata(dev, rdev);
395 static int hi6421_spmi_regulator_probe(struct platform_device *pdev)
397 struct device *pmic_dev = pdev->dev.parent;
398 struct device_node *np = pmic_dev->of_node;
399 struct device_node *regulators, *child;
400 struct platform_device *new_pdev;
401 struct hi6421_spmi_pmic *pmic;
405 * This driver is meant to be called by hi6421-spmi-core,
406 * which should first set drvdata. If this doesn't happen, hit
407 * a warn on and return.
409 pmic = dev_get_drvdata(pmic_dev);
413 regulators = of_get_child_by_name(np, "regulators");
415 dev_err(&pdev->dev, "regulator node not found\n");
420 * Parse all LDO regulator nodes
422 for_each_child_of_node(regulators, child) {
423 dev_dbg(&pdev->dev, "adding child %pOF\n", child);
425 new_pdev = platform_device_alloc(child->name, -1);
426 new_pdev->dev.parent = pmic_dev;
427 new_pdev->dev.of_node = of_node_get(child);
429 ret = platform_device_add(new_pdev);
431 platform_device_put(new_pdev);
435 ret = hi6421_spmi_regulator_probe_ldo(new_pdev, child, pmic);
437 platform_device_put(new_pdev);
440 of_node_put(regulators);
445 static int hi6421_spmi_regulator_remove(struct platform_device *pdev)
447 struct regulator_dev *rdev = dev_get_drvdata(&pdev->dev);
448 struct hi6421v600_regulator *sreg = rdev_get_drvdata(rdev);
450 regulator_unregister(rdev);
452 if (rdev->desc->volt_table)
453 devm_kfree(&pdev->dev, (unsigned int *)rdev->desc->volt_table);
460 static const struct platform_device_id hi6421v600_regulator_table[] = {
461 { .name = "hi6421v600-regulator" },
464 MODULE_DEVICE_TABLE(platform, hi6421v600_regulator_table);
466 static struct platform_driver hi6421v600_regulator_driver = {
467 .id_table = hi6421v600_regulator_table,
469 .name = "hi6421v600-regulator",
471 .probe = hi6421_spmi_regulator_probe,
472 .remove = hi6421_spmi_regulator_remove,
474 module_platform_driver(hi6421v600_regulator_driver);
476 MODULE_DESCRIPTION("Hi6421v600 regulator driver");
477 MODULE_LICENSE("GPL v2");