Quelle  max77686-regulator.c   Sprache: C

// SPDX-License-Identifier: GPL-2.0+
//
// max77686.c - Regulator driver for the Maxim 77686
//
// Copyright (C) 2012 Samsung Electronics
// Chiwoong Byun <woong.byun@samsung.com>
// Jonghwa Lee <jonghwa3.lee@samsung.com>
//
// This driver is based on max8997.c

#include <linux/kernel.h>
#include <linux/bug.h>
#include <linux/err.h>
#include <linux/gpio/consumer.h>
#include <linux/slab.h>
#include <linux/platform_device.h>
#include <linux/regulator/driver.h>
#include <linux/regulator/machine.h>
#include <linux/regulator/of_regulator.h>
#include <linux/mfd/max77686.h>
#include <linux/mfd/max77686-private.h>

#define MAX77686_LDO_MINUV 800000
#define MAX77686_LDO_UVSTEP 50000
#define MAX77686_LDO_LOW_MINUV 800000
#define MAX77686_LDO_LOW_UVSTEP 25000
#define MAX77686_BUCK_MINUV 750000
#define MAX77686_BUCK_UVSTEP 50000
#define MAX77686_BUCK_ENABLE_TIME 40  /* us */
#define MAX77686_DVS_ENABLE_TIME 22  /* us */
#define MAX77686_RAMP_DELAY 100000   /* uV/us */
#define MAX77686_DVS_RAMP_DELAY 27500   /* uV/us */
#define MAX77686_DVS_MINUV 600000
#define MAX77686_DVS_UVSTEP 12500

/*
 * Value for configuring buck[89] and LDO{20,21,22} as GPIO control.
 * It is the same as 'off' for other regulators.
 */
#define MAX77686_GPIO_CONTROL  0x0
/*
 * Values used for configuring LDOs and bucks.
 * Forcing low power mode: LDO1, 3-5, 9, 13, 17-26
 */
#define MAX77686_LDO_LOWPOWER  0x1
/*
 * On/off controlled by PWRREQ:
 *  - LDO2, 6-8, 10-12, 14-16
 *  - buck[1234]
 */
#define MAX77686_OFF_PWRREQ  0x1
/* Low power mode controlled by PWRREQ: All LDOs */
#define MAX77686_LDO_LOWPOWER_PWRREQ 0x2
/* Forcing low power mode: buck[234] */
#define MAX77686_BUCK_LOWPOWER  0x2
#define MAX77686_NORMAL   0x3

#define MAX77686_OPMODE_SHIFT 6
#define MAX77686_OPMODE_BUCK234_SHIFT 4
#define MAX77686_OPMODE_MASK 0x3

#define MAX77686_VSEL_MASK 0x3F
#define MAX77686_DVS_VSEL_MASK 0xFF

#define MAX77686_RAMP_RATE_MASK 0xC0

#define MAX77686_REGULATORS MAX77686_REG_MAX
#define MAX77686_LDOS  26

struct max77686_data {
 struct device *dev;
 DECLARE_BITMAP(gpio_enabled, MAX77686_REGULATORS);

 /* Array indexed by regulator id */
 unsigned int opmode[MAX77686_REGULATORS];
};

static unsigned int max77686_get_opmode_shift(int id)
{
 switch (id) {
 case MAX77686_BUCK1:
 case MAX77686_BUCK5 ... MAX77686_BUCK9:
  return 0;
 case MAX77686_BUCK2 ... MAX77686_BUCK4:
  return MAX77686_OPMODE_BUCK234_SHIFT;
 default:
  /* all LDOs */
  return MAX77686_OPMODE_SHIFT;
 }
}

/*
 * When regulator is configured for GPIO control then it
 * replaces "normal" mode. Any change from low power mode to normal
 * should actually change to GPIO control.
 * Map normal mode to proper value for such regulators.
 */
static unsigned int max77686_map_normal_mode(struct max77686_data *max77686,
          int id)
{
 switch (id) {
 case MAX77686_BUCK8:
 case MAX77686_BUCK9:
 case MAX77686_LDO20 ... MAX77686_LDO22:
  if (test_bit(id, max77686->gpio_enabled))
   return MAX77686_GPIO_CONTROL;
 }

 return MAX77686_NORMAL;
}

/* Some BUCKs and LDOs supports Normal[ON/OFF] mode during suspend */
static int max77686_set_suspend_disable(struct regulator_dev *rdev)
{
 unsigned int val, shift;
 struct max77686_data *max77686 = rdev_get_drvdata(rdev);
 int ret, id = rdev_get_id(rdev);

 shift = max77686_get_opmode_shift(id);
 val = MAX77686_OFF_PWRREQ;

 ret = regmap_update_bits(rdev->regmap, rdev->desc->enable_reg,
     rdev->desc->enable_mask, val << shift);
 if (ret)
  return ret;

 max77686->opmode[id] = val;
 return 0;
}

/* Some LDOs supports [LPM/Normal]ON mode during suspend state */
static int max77686_set_suspend_mode(struct regulator_dev *rdev,
         unsigned int mode)
{
 struct max77686_data *max77686 = rdev_get_drvdata(rdev);
 unsigned int val;
 int ret, id = rdev_get_id(rdev);

 /* BUCK[5-9] doesn't support this feature */
 if (id >= MAX77686_BUCK5)
  return 0;

 switch (mode) {
 case REGULATOR_MODE_IDLE:   /* ON in LP Mode */
  val = MAX77686_LDO_LOWPOWER_PWRREQ;
  break;
 case REGULATOR_MODE_NORMAL:   /* ON in Normal Mode */
  val = max77686_map_normal_mode(max77686, id);
  break;
 default:
  pr_warn("%s: regulator_suspend_mode : 0x%x not supported\n",
   rdev->desc->name, mode);
  return -EINVAL;
 }

 ret = regmap_update_bits(rdev->regmap, rdev->desc->enable_reg,
      rdev->desc->enable_mask,
      val << MAX77686_OPMODE_SHIFT);
 if (ret)
  return ret;

 max77686->opmode[id] = val;
 return 0;
}

/* Some LDOs supports LPM-ON/OFF/Normal-ON mode during suspend state */
static int max77686_ldo_set_suspend_mode(struct regulator_dev *rdev,
         unsigned int mode)
{
 unsigned int val;
 struct max77686_data *max77686 = rdev_get_drvdata(rdev);
 int ret, id = rdev_get_id(rdev);

 switch (mode) {
 case REGULATOR_MODE_STANDBY:   /* switch off */
  val = MAX77686_OFF_PWRREQ;
  break;
 case REGULATOR_MODE_IDLE:   /* ON in LP Mode */
  val = MAX77686_LDO_LOWPOWER_PWRREQ;
  break;
 case REGULATOR_MODE_NORMAL:   /* ON in Normal Mode */
  val = max77686_map_normal_mode(max77686, id);
  break;
 default:
  pr_warn("%s: regulator_suspend_mode : 0x%x not supported\n",
   rdev->desc->name, mode);
  return -EINVAL;
 }

 ret = regmap_update_bits(rdev->regmap, rdev->desc->enable_reg,
     rdev->desc->enable_mask,
     val << MAX77686_OPMODE_SHIFT);
 if (ret)
  return ret;

 max77686->opmode[id] = val;
 return 0;
}

static int max77686_enable(struct regulator_dev *rdev)
{
 struct max77686_data *max77686 = rdev_get_drvdata(rdev);
 unsigned int shift;
 int id = rdev_get_id(rdev);

 shift = max77686_get_opmode_shift(id);

 if (max77686->opmode[id] == MAX77686_OFF_PWRREQ)
  max77686->opmode[id] = max77686_map_normal_mode(max77686, id);

 return regmap_update_bits(rdev->regmap, rdev->desc->enable_reg,
      rdev->desc->enable_mask,
      max77686->opmode[id] << shift);
}

static int max77686_of_parse_cb(struct device_node *np,
  const struct regulator_desc *desc,
  struct regulator_config *config)
{
 struct max77686_data *max77686 = config->driver_data;
 int ret;

 switch (desc->id) {
 case MAX77686_BUCK8:
 case MAX77686_BUCK9:
 case MAX77686_LDO20 ... MAX77686_LDO22:
  config->ena_gpiod = fwnode_gpiod_get_index(
    of_fwnode_handle(np),
    "maxim,ena",
    0,
    GPIOD_OUT_HIGH | GPIOD_FLAGS_BIT_NONEXCLUSIVE,
    "max77686-regulator");
  if (IS_ERR(config->ena_gpiod))
   config->ena_gpiod = NULL;
  break;
 default:
  return 0;
 }

 if (config->ena_gpiod) {
  set_bit(desc->id, max77686->gpio_enabled);

  ret = regmap_update_bits(config->regmap, desc->enable_reg,
      desc->enable_mask,
      MAX77686_GPIO_CONTROL);
  if (ret) {
   gpiod_put(config->ena_gpiod);
   config->ena_gpiod = NULL;
  }
 }

 return 0;
}

static const unsigned int max77686_buck_dvs_ramp_table[] = {
 13750, 27500, 55000, 100000
};

static const struct regulator_ops max77686_ops = {
 .list_voltage  = regulator_list_voltage_linear,
 .map_voltage  = regulator_map_voltage_linear,
 .is_enabled  = regulator_is_enabled_regmap,
 .enable   = max77686_enable,
 .disable  = regulator_disable_regmap,
 .get_voltage_sel = regulator_get_voltage_sel_regmap,
 .set_voltage_sel = regulator_set_voltage_sel_regmap,
 .set_voltage_time_sel = regulator_set_voltage_time_sel,
 .set_suspend_mode = max77686_set_suspend_mode,
};

static const struct regulator_ops max77686_ldo_ops = {
 .list_voltage  = regulator_list_voltage_linear,
 .map_voltage  = regulator_map_voltage_linear,
 .is_enabled  = regulator_is_enabled_regmap,
 .enable   = max77686_enable,
 .disable  = regulator_disable_regmap,
 .get_voltage_sel = regulator_get_voltage_sel_regmap,
 .set_voltage_sel = regulator_set_voltage_sel_regmap,
 .set_voltage_time_sel = regulator_set_voltage_time_sel,
 .set_suspend_mode = max77686_ldo_set_suspend_mode,
 .set_suspend_disable = max77686_set_suspend_disable,
};

static const struct regulator_ops max77686_buck1_ops = {
 .list_voltage  = regulator_list_voltage_linear,
 .map_voltage  = regulator_map_voltage_linear,
 .is_enabled  = regulator_is_enabled_regmap,
 .enable   = max77686_enable,
 .disable  = regulator_disable_regmap,
 .get_voltage_sel = regulator_get_voltage_sel_regmap,
 .set_voltage_sel = regulator_set_voltage_sel_regmap,
 .set_voltage_time_sel = regulator_set_voltage_time_sel,
 .set_suspend_disable = max77686_set_suspend_disable,
};

static const struct regulator_ops max77686_buck_dvs_ops = {
 .list_voltage  = regulator_list_voltage_linear,
 .map_voltage  = regulator_map_voltage_linear,
 .is_enabled  = regulator_is_enabled_regmap,
 .enable   = max77686_enable,
 .disable  = regulator_disable_regmap,
 .get_voltage_sel = regulator_get_voltage_sel_regmap,
 .set_voltage_sel = regulator_set_voltage_sel_regmap,
 .set_voltage_time_sel = regulator_set_voltage_time_sel,
 .set_ramp_delay  = regulator_set_ramp_delay_regmap,
 .set_suspend_disable = max77686_set_suspend_disable,
};

#define regulator_desc_ldo(num)  {    \
 .name  = "LDO"#num,     \
 .of_match = of_match_ptr("LDO"#num),   \
 .regulators_node = of_match_ptr("voltage-regulators"), \
 .of_parse_cb = max77686_of_parse_cb,    \
 .id  = MAX77686_LDO##num,    \
 .ops  = &max77686_ops,    \
 .type  = REGULATOR_VOLTAGE,    \
 .owner  = THIS_MODULE,     \
 .min_uV  = MAX77686_LDO_MINUV,    \
 .uV_step = MAX77686_LDO_UVSTEP,    \
 .ramp_delay = MAX77686_RAMP_DELAY,    \
 .n_voltages = MAX77686_VSEL_MASK + 1,   \
 .vsel_reg = MAX77686_REG_LDO1CTRL1 + num - 1,  \
 .vsel_mask = MAX77686_VSEL_MASK,    \
 .enable_reg = MAX77686_REG_LDO1CTRL1 + num - 1,  \
 .enable_mask = MAX77686_OPMODE_MASK    \
   << MAX77686_OPMODE_SHIFT,   \
}
#define regulator_desc_lpm_ldo(num) {    \
 .name  = "LDO"#num,     \
 .of_match = of_match_ptr("LDO"#num),   \
 .regulators_node = of_match_ptr("voltage-regulators"), \
 .id  = MAX77686_LDO##num,    \
 .ops  = &max77686_ldo_ops,    \
 .type  = REGULATOR_VOLTAGE,    \
 .owner  = THIS_MODULE,     \
 .min_uV  = MAX77686_LDO_MINUV,    \
 .uV_step = MAX77686_LDO_UVSTEP,    \
 .ramp_delay = MAX77686_RAMP_DELAY,    \
 .n_voltages = MAX77686_VSEL_MASK + 1,   \
 .vsel_reg = MAX77686_REG_LDO1CTRL1 + num - 1,  \
 .vsel_mask = MAX77686_VSEL_MASK,    \
 .enable_reg = MAX77686_REG_LDO1CTRL1 + num - 1,  \
 .enable_mask = MAX77686_OPMODE_MASK    \
   << MAX77686_OPMODE_SHIFT,   \
}
#define regulator_desc_ldo_low(num)  {   \
 .name  = "LDO"#num,     \
 .of_match = of_match_ptr("LDO"#num),   \
 .regulators_node = of_match_ptr("voltage-regulators"), \
 .id  = MAX77686_LDO##num,    \
 .ops  = &max77686_ldo_ops,    \
 .type  = REGULATOR_VOLTAGE,    \
 .owner  = THIS_MODULE,     \
 .min_uV  = MAX77686_LDO_LOW_MINUV,   \
 .uV_step = MAX77686_LDO_LOW_UVSTEP,   \
 .ramp_delay = MAX77686_RAMP_DELAY,    \
 .n_voltages = MAX77686_VSEL_MASK + 1,   \
 .vsel_reg = MAX77686_REG_LDO1CTRL1 + num - 1,  \
 .vsel_mask = MAX77686_VSEL_MASK,    \
 .enable_reg = MAX77686_REG_LDO1CTRL1 + num - 1,  \
 .enable_mask = MAX77686_OPMODE_MASK    \
   << MAX77686_OPMODE_SHIFT,   \
}
#define regulator_desc_ldo1_low(num)  {   \
 .name  = "LDO"#num,     \
 .of_match = of_match_ptr("LDO"#num),   \
 .regulators_node = of_match_ptr("voltage-regulators"), \
 .id  = MAX77686_LDO##num,    \
 .ops  = &max77686_ops,    \
 .type  = REGULATOR_VOLTAGE,    \
 .owner  = THIS_MODULE,     \
 .min_uV  = MAX77686_LDO_LOW_MINUV,   \
 .uV_step = MAX77686_LDO_LOW_UVSTEP,   \
 .ramp_delay = MAX77686_RAMP_DELAY,    \
 .n_voltages = MAX77686_VSEL_MASK + 1,   \
 .vsel_reg = MAX77686_REG_LDO1CTRL1 + num - 1,  \
 .vsel_mask = MAX77686_VSEL_MASK,    \
 .enable_reg = MAX77686_REG_LDO1CTRL1 + num - 1,  \
 .enable_mask = MAX77686_OPMODE_MASK    \
   << MAX77686_OPMODE_SHIFT,   \
}
#define regulator_desc_buck(num)  {   \
 .name  = "BUCK"#num,     \
 .of_match = of_match_ptr("BUCK"#num),   \
 .regulators_node = of_match_ptr("voltage-regulators"), \
 .of_parse_cb = max77686_of_parse_cb,    \
 .id  = MAX77686_BUCK##num,    \
 .ops  = &max77686_ops,    \
 .type  = REGULATOR_VOLTAGE,    \
 .owner  = THIS_MODULE,     \
 .min_uV  = MAX77686_BUCK_MINUV,    \
 .uV_step = MAX77686_BUCK_UVSTEP,    \
 .ramp_delay = MAX77686_RAMP_DELAY,    \
 .enable_time = MAX77686_BUCK_ENABLE_TIME,   \
 .n_voltages = MAX77686_VSEL_MASK + 1,   \
 .vsel_reg = MAX77686_REG_BUCK5OUT + (num - 5) * 2, \
 .vsel_mask = MAX77686_VSEL_MASK,    \
 .enable_reg = MAX77686_REG_BUCK5CTRL + (num - 5) * 2, \
 .enable_mask = MAX77686_OPMODE_MASK,    \
}
#define regulator_desc_buck1(num)  {   \
 .name  = "BUCK"#num,     \
 .of_match = of_match_ptr("BUCK"#num),   \
 .regulators_node = of_match_ptr("voltage-regulators"), \
 .id  = MAX77686_BUCK##num,    \
 .ops  = &max77686_buck1_ops,    \
 .type  = REGULATOR_VOLTAGE,    \
 .owner  = THIS_MODULE,     \
 .min_uV  = MAX77686_BUCK_MINUV,    \
 .uV_step = MAX77686_BUCK_UVSTEP,    \
 .ramp_delay = MAX77686_RAMP_DELAY,    \
 .enable_time = MAX77686_BUCK_ENABLE_TIME,   \
 .n_voltages = MAX77686_VSEL_MASK + 1,   \
 .vsel_reg = MAX77686_REG_BUCK1OUT,   \
 .vsel_mask = MAX77686_VSEL_MASK,    \
 .enable_reg = MAX77686_REG_BUCK1CTRL,   \
 .enable_mask = MAX77686_OPMODE_MASK,    \
}
#define regulator_desc_buck_dvs(num)  {   \
 .name  = "BUCK"#num,     \
 .of_match = of_match_ptr("BUCK"#num),   \
 .regulators_node = of_match_ptr("voltage-regulators"), \
 .id  = MAX77686_BUCK##num,    \
 .ops  = &max77686_buck_dvs_ops,   \
 .type  = REGULATOR_VOLTAGE,    \
 .owner  = THIS_MODULE,     \
 .min_uV  = MAX77686_DVS_MINUV,    \
 .uV_step = MAX77686_DVS_UVSTEP,    \
 .ramp_delay = MAX77686_DVS_RAMP_DELAY,   \
 .enable_time = MAX77686_DVS_ENABLE_TIME,   \
 .n_voltages = MAX77686_DVS_VSEL_MASK + 1,   \
 .vsel_reg = MAX77686_REG_BUCK2DVS1 + (num - 2) * 10, \
 .vsel_mask = MAX77686_DVS_VSEL_MASK,   \
 .enable_reg = MAX77686_REG_BUCK2CTRL1 + (num - 2) * 10, \
 .enable_mask = MAX77686_OPMODE_MASK    \
   << MAX77686_OPMODE_BUCK234_SHIFT,  \
 .ramp_reg = MAX77686_REG_BUCK2CTRL1 + (num - 2) * 10, \
 .ramp_mask = MAX77686_RAMP_RATE_MASK,   \
 .ramp_delay_table = max77686_buck_dvs_ramp_table,  \
 .n_ramp_values = ARRAY_SIZE(max77686_buck_dvs_ramp_table), \
}

static const struct regulator_desc regulators[] = {
 regulator_desc_ldo1_low(1),
 regulator_desc_ldo_low(2),
 regulator_desc_ldo(3),
 regulator_desc_ldo(4),
 regulator_desc_ldo(5),
 regulator_desc_ldo_low(6),
 regulator_desc_ldo_low(7),
 regulator_desc_ldo_low(8),
 regulator_desc_ldo(9),
 regulator_desc_lpm_ldo(10),
 regulator_desc_lpm_ldo(11),
 regulator_desc_lpm_ldo(12),
 regulator_desc_ldo(13),
 regulator_desc_lpm_ldo(14),
 regulator_desc_ldo_low(15),
 regulator_desc_lpm_ldo(16),
 regulator_desc_ldo(17),
 regulator_desc_ldo(18),
 regulator_desc_ldo(19),
 regulator_desc_ldo(20),
 regulator_desc_ldo(21),
 regulator_desc_ldo(22),
 regulator_desc_ldo(23),
 regulator_desc_ldo(24),
 regulator_desc_ldo(25),
 regulator_desc_ldo(26),
 regulator_desc_buck1(1),
 regulator_desc_buck_dvs(2),
 regulator_desc_buck_dvs(3),
 regulator_desc_buck_dvs(4),
 regulator_desc_buck(5),
 regulator_desc_buck(6),
 regulator_desc_buck(7),
 regulator_desc_buck(8),
 regulator_desc_buck(9),
};

static int max77686_pmic_probe(struct platform_device *pdev)
{
 struct max77686_dev *iodev = dev_get_drvdata(pdev->dev.parent);
 struct max77686_data *max77686;
 int i;
 struct regulator_config config = { };

 dev_dbg(&pdev->dev, "%s\n", __func__);

 max77686 = devm_kzalloc(&pdev->dev, sizeof(struct max77686_data),
    GFP_KERNEL);
 if (!max77686)
  return -ENOMEM;

 max77686->dev = &pdev->dev;
 config.dev = iodev->dev;
 config.regmap = iodev->regmap;
 config.driver_data = max77686;
 platform_set_drvdata(pdev, max77686);

 for (i = 0; i < MAX77686_REGULATORS; i++) {
  struct regulator_dev *rdev;
  int id = regulators[i].id;

  max77686->opmode[id] = MAX77686_NORMAL;
  rdev = devm_regulator_register(&pdev->dev,
      ®ulators[i], &config);
  if (IS_ERR(rdev)) {
   int ret = PTR_ERR(rdev);
   dev_err(&pdev->dev,
    "regulator init failed for %d: %d\n", i, ret);
   return ret;
  }
 }

 return 0;
}

static const struct platform_device_id max77686_pmic_id[] = {
 {"max77686-pmic", 0},
 { },
};
MODULE_DEVICE_TABLE(platform, max77686_pmic_id);

static struct platform_driver max77686_pmic_driver = {
 .driver = {
  .name = "max77686-pmic",
  .probe_type = PROBE_PREFER_ASYNCHRONOUS,
 },
 .probe = max77686_pmic_probe,
 .id_table = max77686_pmic_id,
};

module_platform_driver(max77686_pmic_driver);

MODULE_DESCRIPTION("MAXIM 77686 Regulator Driver");
MODULE_AUTHOR("Chiwoong Byun ");
MODULE_LICENSE("GPL");