Quelle  adp5055-regulator.c   Sprache: C

// SPDX-License-Identifier: GPL-2.0
//
// Regulator driver for Analog Devices ADP5055
//
// Copyright (C) 2025 Analog Devices, Inc.

#include <linux/bitfield.h>
#include <linux/device.h>
#include <linux/gpio/consumer.h>
#include <linux/i2c.h>
#include <linux/module.h>
#include <linux/mod_devicetable.h>
#include <linux/regmap.h>
#include <linux/regulator/driver.h>
#include <linux/regulator/machine.h>
#include <linux/regulator/of_regulator.h>

// ADP5055 Register Map.

#define ADP5055_CTRL123         0xD1
#define ADP5055_CTRL_MODE1      0xD3
#define ADP5055_CTRL_MODE2      0xD4
#define ADP5055_DLY0            0xD5
#define ADP5055_DLY1            0xD6
#define ADP5055_DLY2            0xD7
#define ADP5055_VID0            0xD8
#define ADP5055_VID1            0xD9
#define ADP5055_VID2            0xDA
#define ADP5055_DVS_LIM0        0xDC
#define ADP5055_DVS_LIM1        0xDD
#define ADP5055_DVS_LIM2        0xDE
#define ADP5055_FT_CFG          0xDF
#define ADP5055_PG_CFG          0xE0

// ADP5055 Field Masks.

#define ADP5055_MASK_EN_MODE  BIT(0)
#define ADP5055_MASK_OCP_BLANKING BIT(7)
#define ADP5055_MASK_PSM  BIT(4)
#define ADP5055_MASK_DIS2  BIT(2)
#define ADP5055_MASK_DIS1  BIT(1)
#define ADP5055_MASK_DIS0  BIT(0)
#define ADP5055_MASK_DIS_DLY  GENMASK(6, 4)
#define ADP5055_MASK_EN_DLY  GENMASK(2, 0)
#define ADP5055_MASK_DVS_LIM_UPPER GENMASK(7, 4)
#define ADP5055_MASK_DVS_LIM_LOWER GENMASK(3, 0)
#define ADP5055_MASK_FAST_TRANSIENT2 GENMASK(5, 4)
#define ADP5055_MASK_FAST_TRANSIENT1 GENMASK(3, 2)
#define ADP5055_MASK_FAST_TRANSIENT0 GENMASK(1, 0)
#define ADP5055_MASK_DLY_PWRGD  BIT(4)
#define ADP5055_MASK_PWRGD2  BIT(2)
#define ADP5055_MASK_PWRGD1  BIT(1)
#define ADP5055_MASK_PWRGD0  BIT(0)

#define ADP5055_MIN_VOUT  408000
#define ADP5055_NUM_CH   3

struct adp5055 {
 struct device *dev;
 struct regmap *regmap;
 u32 tset;
 struct gpio_desc *en_gpiod[ADP5055_NUM_CH];
 bool en_mode_software;
 int dvs_limit_upper[ADP5055_NUM_CH];
 int dvs_limit_lower[ADP5055_NUM_CH];
 u32 fast_transient[ADP5055_NUM_CH];
 bool mask_power_good[ADP5055_NUM_CH];
};

static const unsigned int adp5055_tset_vals[] = {
 2600,
 20800,
};

static const unsigned int adp5055_enable_delay_vals_2_6[] = {
 0,
 2600,
 5200,
 7800,
 10400,
 13000,
 15600,
 18200,
};

static const unsigned int adp5055_enable_delay_vals_20_8[] = {
 0,
 20800,
 41600,
 62400,
 83200,
 104000,
 124800,
 145600,
};

static const char * const adp5055_fast_transient_vals[] = {
 "none",
 "3G_1.5%",
 "5G_1.5%",
 "5G_2.5%",
};

static int adp5055_get_prop_index(const u32 *table, size_t table_size,
      u32 value)
{
 int i;

 for (i = 0; i < table_size; i++)
  if (table[i] == value)
   return i;

 return -EINVAL;
}

static const struct regmap_range adp5055_reg_ranges[] = {
 regmap_reg_range(0xD1, 0xE0),
};

static const struct regmap_access_table adp5055_access_ranges_table = {
 .yes_ranges = adp5055_reg_ranges,
 .n_yes_ranges = ARRAY_SIZE(adp5055_reg_ranges),
};

static const struct regmap_config adp5055_regmap_config = {
 .reg_bits = 8,
 .val_bits = 8,
 .max_register = 0xE0,
 .wr_table = &adp5055_access_ranges_table,
 .rd_table = &adp5055_access_ranges_table,
};

static const struct linear_range adp5055_voltage_ranges[] = {
 REGULATOR_LINEAR_RANGE(ADP5055_MIN_VOUT, 0, 255, 1500),
};

static int adp5055_parse_fw(struct device *dev, struct  adp5055 *adp5055)
{
 int i, ret;
 struct regmap *regmap = adp5055->regmap;
 int val;
 bool ocp_blanking;
 bool delay_power_good;

 ret = device_property_read_u32(dev, "adi,tset-us", &adp5055->tset);
 if (!ret) {
  ret = adp5055_get_prop_index(adp5055_tset_vals,
     ARRAY_SIZE(adp5055_tset_vals), adp5055->tset);
  if (ret < 0)
   return dev_err_probe(dev, ret,
    "Failed to initialize tset.");
  adp5055->tset = adp5055_tset_vals[ret];
 }

 ocp_blanking = device_property_read_bool(dev, "adi,ocp-blanking");

 delay_power_good = device_property_read_bool(dev,
        "adi,delay-power-good");

 for (i = 0; i < ADP5055_NUM_CH; i++) {
  val = FIELD_PREP(ADP5055_MASK_DVS_LIM_UPPER,
    DIV_ROUND_CLOSEST_ULL(192000 - adp5055->dvs_limit_upper[i], 12000));
  val |= FIELD_PREP(ADP5055_MASK_DVS_LIM_LOWER,
    DIV_ROUND_CLOSEST_ULL(adp5055->dvs_limit_lower[i] + 190500, 12000));
  ret = regmap_write(regmap, ADP5055_DVS_LIM0 + i, val);
  if (ret)
   return ret;
 }

 val = FIELD_PREP(ADP5055_MASK_EN_MODE, adp5055->en_mode_software);
 ret = regmap_write(regmap, ADP5055_CTRL_MODE1, val);
 if (ret)
  return ret;

 val = FIELD_PREP(ADP5055_MASK_OCP_BLANKING, ocp_blanking);
 ret = regmap_update_bits(regmap, ADP5055_CTRL_MODE2,
    ADP5055_MASK_OCP_BLANKING, val);
 if (ret)
  return ret;

 val = FIELD_PREP(ADP5055_MASK_FAST_TRANSIENT2, adp5055->fast_transient[2]);
 val |= FIELD_PREP(ADP5055_MASK_FAST_TRANSIENT1, adp5055->fast_transient[1]);
 val |= FIELD_PREP(ADP5055_MASK_FAST_TRANSIENT0, adp5055->fast_transient[0]);
 ret = regmap_write(regmap, ADP5055_FT_CFG, val);
 if (ret)
  return ret;

 val = FIELD_PREP(ADP5055_MASK_DLY_PWRGD, delay_power_good);
 val |= FIELD_PREP(ADP5055_MASK_PWRGD2, adp5055->mask_power_good[2]);
 val |= FIELD_PREP(ADP5055_MASK_PWRGD1, adp5055->mask_power_good[1]);
 val |= FIELD_PREP(ADP5055_MASK_PWRGD0, adp5055->mask_power_good[0]);
 ret = regmap_write(regmap, ADP5055_PG_CFG, val);
 if (ret)
  return ret;

 return 0;
}

static int adp5055_of_parse_cb(struct device_node *np,
         const struct regulator_desc *desc,
         struct regulator_config *config)
{
 struct adp5055 *adp5055 = config->driver_data;
 int id, ret, pval, i;

 id = desc->id;

 if (of_property_read_bool(np, "enable-gpios")) {
  adp5055->en_gpiod[id] = devm_fwnode_gpiod_get(config->dev,
      of_fwnode_handle(np), "enable",
      GPIOD_OUT_LOW, "enable");
  if (IS_ERR(adp5055->en_gpiod[id]))
   return dev_err_probe(config->dev, PTR_ERR(adp5055->en_gpiod[id]),
     "Failed to get enable GPIO\n");

  config->ena_gpiod = adp5055->en_gpiod[id];
 } else {
  adp5055->en_mode_software = true;
 }

 ret = of_property_read_u32(np, "adi,dvs-limit-upper-microvolt", &pval);
 if (ret)
  adp5055->dvs_limit_upper[id] = 192000;
 else
  adp5055->dvs_limit_upper[id] = pval;

 if (adp5055->dvs_limit_upper[id] > 192000 || adp5055->dvs_limit_upper[id] < 12000)
  return dev_err_probe(config->dev, adp5055->dvs_limit_upper[id],
   "Out of range - dvs-limit-upper-microvolt value.");

 ret = of_property_read_u32(np, "adi,dvs-limit-lower-microvolt", &pval);
 if (ret)
  adp5055->dvs_limit_lower[id] = -190500;
 else
  adp5055->dvs_limit_lower[id] = pval;

 if (adp5055->dvs_limit_lower[id] > -10500 || adp5055->dvs_limit_lower[id] < -190500)
  return dev_err_probe(config->dev, adp5055->dvs_limit_lower[id],
   "Out of range - dvs-limit-lower-microvolt value.");

 for (i = 0; i < 4; i++) {
  ret = of_property_match_string(np, "adi,fast-transient",
     adp5055_fast_transient_vals[i]);
  if (!ret)
   break;
 }

 if (ret < 0)
  adp5055->fast_transient[id] = 3;
 else
  adp5055->fast_transient[id] = i;

 adp5055->mask_power_good[id] = of_property_read_bool(np, "adi,mask-power-good");

 return 0;
}

static int adp5055_set_mode(struct regulator_dev *rdev, u32 mode)
{
 struct adp5055 *adp5055 = rdev_get_drvdata(rdev);
 int id, ret;

 id = rdev_get_id(rdev);

 switch (mode) {
 case REGULATOR_MODE_NORMAL:
  ret = regmap_update_bits(adp5055->regmap, ADP5055_CTRL_MODE2,
     ADP5055_MASK_PSM << id, 0);
  break;
 case REGULATOR_MODE_IDLE:
  ret = regmap_update_bits(adp5055->regmap, ADP5055_CTRL_MODE2,
     ADP5055_MASK_PSM << id, ADP5055_MASK_PSM << id);
  break;
 default:
  return dev_err_probe(&rdev->dev, -EINVAL,
    "Unsupported mode: %d\n", mode);
 }

 return ret;
}

static unsigned int adp5055_get_mode(struct regulator_dev *rdev)
{
 struct adp5055 *adp5055 = rdev_get_drvdata(rdev);
 int id, ret, regval;

 id = rdev_get_id(rdev);

 ret = regmap_read(adp5055->regmap, ADP5055_CTRL_MODE2, ®val);
 if (ret)
  return ret;

 if (regval & (ADP5055_MASK_PSM << id))
  return REGULATOR_MODE_IDLE;
 else
  return REGULATOR_MODE_NORMAL;
}

static const struct regulator_ops adp5055_ops = {
 .list_voltage = regulator_list_voltage_linear_range,
 .map_voltage = regulator_map_voltage_linear_range,
 .set_voltage_sel = regulator_set_voltage_sel_regmap,
 .get_voltage_sel = regulator_get_voltage_sel_regmap,
 .set_active_discharge = regulator_set_active_discharge_regmap,
 .enable = regulator_enable_regmap,
 .disable = regulator_disable_regmap,
 .is_enabled = regulator_is_enabled_regmap,
 .set_mode = adp5055_set_mode,
 .get_mode = adp5055_get_mode,
 .set_ramp_delay = regulator_set_ramp_delay_regmap,
};

#define ADP5055_REG_(_name, _id, _ch, _ops) \
 [_id] = { \
  .name = _name, \
  .of_match = of_match_ptr(_name), \
  .of_parse_cb = adp5055_of_parse_cb, \
  .id = _id, \
  .ops = _ops, \
  .linear_ranges = adp5055_voltage_ranges, \
  .n_linear_ranges = ARRAY_SIZE(adp5055_voltage_ranges), \
  .vsel_reg = ADP5055_VID##_ch, \
  .vsel_mask = GENMASK(7, 0), \
  .enable_reg = ADP5055_CTRL123, \
  .enable_mask = BIT(_ch), \
  .active_discharge_on = ADP5055_MASK_DIS##_id, \
  .active_discharge_off = 0, \
  .active_discharge_mask = ADP5055_MASK_DIS##_id, \
  .active_discharge_reg = ADP5055_CTRL_MODE2, \
  .ramp_reg = ADP5055_DLY##_ch, \
  .ramp_mask = ADP5055_MASK_EN_DLY, \
  .n_ramp_values = ARRAY_SIZE(adp5055_enable_delay_vals_2_6), \
  .type = REGULATOR_VOLTAGE, \
  .owner = THIS_MODULE, \
 }

#define ADP5055_REG(_name, _id, _ch) \
 ADP5055_REG_(_name, _id, _ch, &adp5055_ops)

static struct regulator_desc adp5055_regulators[] = {
 ADP5055_REG("buck0", 0, 0),
 ADP5055_REG("buck1", 1, 1),
 ADP5055_REG("buck2", 2, 2),
};

static int adp5055_probe(struct i2c_client *client)
{
 struct regulator_init_data *init_data;
 struct device *dev = &client->dev;
 struct adp5055 *adp5055;
 int i, ret;

 init_data = of_get_regulator_init_data(dev, client->dev.of_node,
            &adp5055_regulators[0]);
 if (!init_data)
  return -EINVAL;

 adp5055 = devm_kzalloc(dev, sizeof(struct adp5055), GFP_KERNEL);
 if (!adp5055)
  return -ENOMEM;

 adp5055->tset = 2600;
 adp5055->en_mode_software = false;

 adp5055->regmap = devm_regmap_init_i2c(client, &adp5055_regmap_config);
 if (IS_ERR(adp5055->regmap))
  return dev_err_probe(dev, PTR_ERR(adp5055->regmap), "Failed to allocate reg map");

 for (i = 0; i < ADP5055_NUM_CH; i++) {
  const struct regulator_desc *desc;
  struct regulator_config config = { };
  struct regulator_dev *rdev;

  if (adp5055->tset == 2600)
   adp5055_regulators[i].ramp_delay_table = adp5055_enable_delay_vals_2_6;
  else
   adp5055_regulators[i].ramp_delay_table = adp5055_enable_delay_vals_20_8;

  desc = &adp5055_regulators[i];

  config.dev = dev;
  config.driver_data = adp5055;
  config.regmap = adp5055->regmap;
  config.init_data = init_data;

  rdev = devm_regulator_register(dev, desc, &config);
  if (IS_ERR(rdev)) {
   return dev_err_probe(dev, PTR_ERR(rdev),
     "Failed to register %s\n", desc->name);
  }
 }

 ret = adp5055_parse_fw(dev, adp5055);
 if (ret < 0)
  return ret;

 return 0;
}

static const struct of_device_id adp5055_of_match[] = {
 { .compatible = "adi,adp5055", },
 { }
};
MODULE_DEVICE_TABLE(of, adp5055_of_match);

static const struct i2c_device_id adp5055_ids[] = {
 { .name = "adp5055"},
 { },
};
MODULE_DEVICE_TABLE(i2c, adp5055_ids);

static struct i2c_driver adp5055_driver = {
 .driver = {
  .name = "adp5055",
  .of_match_table = adp5055_of_match,
 },
 .probe  = adp5055_probe,
 .id_table = adp5055_ids,
};
module_i2c_driver(adp5055_driver);

MODULE_DESCRIPTION("ADP5055 Voltage Regulator Driver");
MODULE_AUTHOR("Alexis Czezar Torreno ");
MODULE_LICENSE("GPL");