drivers/regulator/pf530x-regulator.c

// SPDX-License-Identifier: GPL-2.0+

// documentation of this device is available at
// https://www.nxp.com/docs/en/data-sheet/PF5300.pdf

#include <linux/delay.h>
#include <linux/err.h>
#include <linux/gpio/consumer.h>
#include <linux/i2c.h>
#include <linux/module.h>
#include <linux/regmap.h>
#include <linux/regulator/driver.h>
#include <linux/regulator/consumer.h>
#include <linux/regulator/machine.h>
#include <linux/regulator/of_regulator.h>

/* registers */
#define PF530X_DEVICEID			0x00
#define PF530X_REV				0x01
#define PF530X_EMREV			0x02
#define PF530X_PROGID			0x03
#define PF530X_CONFIG1			0x04
#define PF530X_INT_STATUS1		0x05
#define PF530X_INT_SENSE1		0x06
#define PF530X_INT_STATUS2		0x07
#define PF530X_INT_SENSE2		0x08
#define PF530X_BIST_STAT1		0x09
#define PF530X_BIST_CTRL		0x0a
#define PF530X_STATE			0x0b
#define PF530X_STATE_CTRL		0x0c
#define PF530X_SW1_VOLT			0x0d
#define PF530X_SW1_STBY_VOLT	0x0e
#define PF530X_SW1_CTRL1		0x0f
#define PF530X_SW1_CTRL2		0x10
#define PF530X_CLK_CTRL			0x11
#define PF530X_SEQ_CTRL1		0x12
#define PF530X_SEQ_CTRL2		0x13
#define PF530X_RANDOM_CHK		0x14
#define PF530X_RANDOM_GEN		0x15
#define PF530X_WD_CTRL1			0x16
#define PF530X_WD_SEED			0x17
#define PF530X_WD_ANSWER		0x18
#define PF530X_FLT_CNT1			0x19
#define PF530X_FLT_CNT2			0x1a
#define PF530X_OTP_MODE			0x2f

enum pf530x_states {
	PF530X_STATE_POF,
	PF530X_STATE_FUSE_LOAD,
	PF530X_STATE_LP_OFF,
	PF530X_STATE_SELF_TEST,
	PF530X_STATE_POWER_UP,
	PF530X_STATE_INIT,
	PF530X_STATE_IO_RELEASE,
	PF530X_STATE_RUN,
	PF530X_STATE_STANDBY,
	PF530X_STATE_FAULT,
	PF530X_STATE_FAILSAFE,
	PF530X_STATE_POWER_DOWN,
	PF530X_STATE_2MS_SELFTEST_RETRY,
	PF530X_STATE_OFF_DLY,
};

#define PF530_FAM			0x50
enum pf530x_devid {
	PF5300			= 0x3,
	PF5301			= 0x4,
	PF5302			= 0x5,
};

#define PF530x_FAM			0x50
#define PF530x_DEVICE_FAM_MASK		GENMASK(7, 4)
#define PF530x_DEVICE_ID_MASK		GENMASK(3, 0)

#define PF530x_STATE_MASK		GENMASK(3, 0)
#define PF530x_STATE_RUN		0x07
#define PF530x_STATE_STANDBY	0x08
#define PF530x_STATE_LP_OFF		0x02

#define PF530X_OTP_STBY_MODE	GENMASK(3, 2)
#define PF530X_OTP_RUN_MODE		GENMASK(1, 0)

#define PF530X_INT_STATUS_OV	BIT(1)
#define PF530X_INT_STATUS_UV	BIT(2)
#define PF530X_INT_STATUS_ILIM	BIT(3)

#define SW1_ILIM_S	BIT(0)
#define VMON_UV_S	BIT(1)
#define VMON_OV_S	BIT(2)
#define VIN_OVLO_S	BIT(3)
#define BG_ERR_S	BIT(6)

#define THERM_155_S	BIT(3)
#define THERM_140_S	BIT(2)
#define THERM_125_S	BIT(1)
#define THERM_110_S	BIT(0)

struct pf530x_chip {
	struct regmap *regmap;
	struct device *dev;
};

static const struct regmap_config pf530x_regmap_config = {
	.reg_bits = 8,
	.val_bits = 8,
	.max_register = PF530X_OTP_MODE,
	.cache_type = REGCACHE_MAPLE,
};

static int pf530x_get_status(struct regulator_dev *rdev)
{
	unsigned int state;
	int ret;

	ret = regmap_read(rdev->regmap, PF530X_INT_SENSE1, &state);
	if (ret != 0)
		return ret;

	if ((state & (BG_ERR_S | SW1_ILIM_S | VMON_UV_S | VMON_OV_S | VIN_OVLO_S))
			!= 0)
		return REGULATOR_STATUS_ERROR;

	// no errors, check if what non-error state we're in
	ret = regmap_read(rdev->regmap, PF530X_STATE, &state);
	if (ret != 0)
		return ret;

	state &= PF530x_STATE_MASK;

	switch (state) {
	case PF530x_STATE_RUN:
		ret = REGULATOR_STATUS_NORMAL;
		break;
	case PF530x_STATE_STANDBY:
		ret = REGULATOR_STATUS_STANDBY;
		break;
	case PF530x_STATE_LP_OFF:
		ret = REGULATOR_STATUS_OFF;
		break;
	default:
		ret = REGULATOR_STATUS_ERROR;
		break;
	}
	return ret;
}

static int pf530x_get_error_flags(struct regulator_dev *rdev, unsigned int *flags)
{
	unsigned int status;
	int ret;

	ret = regmap_read(rdev->regmap, PF530X_INT_STATUS1, &status);

	if (ret != 0)
		return ret;

	*flags = 0;

	if (status & PF530X_INT_STATUS_OV)
		*flags |= REGULATOR_ERROR_OVER_VOLTAGE_WARN;

	if (status & PF530X_INT_STATUS_UV)
		*flags |= REGULATOR_ERROR_UNDER_VOLTAGE;

	if (status & PF530X_INT_STATUS_ILIM)
		*flags |= REGULATOR_ERROR_OVER_CURRENT;

	ret = regmap_read(rdev->regmap, PF530X_INT_SENSE2, &status);

	if (ret != 0)
		return ret;

	if ((status & (THERM_155_S |
		       THERM_140_S |
		       THERM_125_S |
		       THERM_110_S)) != 0)
		*flags |= REGULATOR_ERROR_OVER_TEMP_WARN;

	return 0;
}

static const struct regulator_ops pf530x_regulator_ops = {
	.enable = regulator_enable_regmap,
	.disable = regulator_disable_regmap,
	.is_enabled = regulator_is_enabled_regmap,
	.map_voltage = regulator_map_voltage_linear_range,
	.list_voltage = regulator_list_voltage_linear_range,
	.set_voltage_sel = regulator_set_voltage_sel_regmap,
	.get_voltage_sel = regulator_get_voltage_sel_regmap,
	.get_status = pf530x_get_status,
	.get_error_flags = pf530x_get_error_flags,
	.set_bypass = regulator_set_bypass_regmap,
	.get_bypass = regulator_get_bypass_regmap,
};

static const struct linear_range vrange = REGULATOR_LINEAR_RANGE(500000, 0, 140, 5000);

static const struct regulator_desc pf530x_reg_desc = {
	.name = "SW1",
	.ops = &pf530x_regulator_ops,
	.linear_ranges = &vrange,
	.n_linear_ranges = 1,
	.type = REGULATOR_VOLTAGE,
	.id = 0,
	.owner = THIS_MODULE,
	.vsel_reg = PF530X_SW1_VOLT,
	.vsel_mask = 0xFF,
	.bypass_reg = PF530X_SW1_CTRL2,
	.bypass_mask = 0x07,
	.bypass_val_on = 0x07,
	.bypass_val_off = 0x00,
	.enable_reg = PF530X_SW1_CTRL1,
	.enable_mask = GENMASK(5, 2),
	.enable_val = GENMASK(5, 2),
	.disable_val = 0,
};

static int pf530x_identify(struct pf530x_chip *chip)
{
	unsigned int value;
	u8 dev_fam, dev_id, full_layer_rev, metal_layer_rev, prog_idh, prog_idl, emrev;
	const char *name = NULL;
	int ret;

	ret = regmap_read(chip->regmap, PF530X_DEVICEID, &value);
	if (ret) {
		dev_err(chip->dev, "failed to read chip family\n");
		return ret;
	}

	dev_fam = value & PF530x_DEVICE_FAM_MASK;
	switch (dev_fam) {
	case PF530x_FAM:
		break;
	default:
		dev_err(chip->dev,
			"Chip 0x%x is not from PF530X family\n", dev_fam);
		return ret;
	}

	dev_id = value & PF530x_DEVICE_ID_MASK;
	switch (dev_id) {
	case PF5300:
		name = "PF5300";
		break;
	case PF5301:
		name = "PF5301";
		break;
	case PF5302:
		name = "PF5302";
		break;
	default:
		dev_err(chip->dev, "Unknown pf530x device id 0x%x\n", dev_id);
		return -ENODEV;
	}

	ret = regmap_read(chip->regmap, PF530X_REV, &value);
	if (ret) {
		dev_err(chip->dev, "failed to read chip rev\n");
		return ret;
	}

	full_layer_rev = ((value & 0xF0) == 0) ? '0' : ((((value & 0xF0) >> 4) - 1) + 'A');
	metal_layer_rev = value & 0xF;

	ret = regmap_read(chip->regmap, PF530X_EMREV, &value);
	if (ret) {
		dev_err(chip->dev, "failed to read chip emrev register\n");
		return ret;
	}

	prog_idh = (value >> 4) + 'A';
	// prog_idh skips 'O', per page 96 of the datasheet
	if (prog_idh >= 'O')
		prog_idh += 1;

	emrev = value & 0x7;

	ret = regmap_read(chip->regmap, PF530X_PROGID, &value);
	if (ret) {
		dev_err(chip->dev, "failed to read chip progid register\n");
		return ret;
	}

	if (value >= 0x22) {
		dev_err(chip->dev, "invalid value for progid register\n");
		return -ENODEV;
	} else if (value < 10) {
		prog_idl = value + '0';
	} else {
		prog_idl = (value - 10) + 'A';
		// prog_idh skips 'O', per page 97 of the datasheet
		if (prog_idl >= 'O')
			prog_idl += 1;
	}

	dev_info(chip->dev, "%s Regulator found (Rev %c%d ProgID %c%c EMREV %x).\n",
		 name, full_layer_rev, metal_layer_rev, prog_idh, prog_idl, emrev);

	return 0;
}

static int pf530x_i2c_probe(struct i2c_client *client)
{
	struct regulator_config config = { NULL, };
	struct pf530x_chip *chip;
	int ret;
	struct regulator_dev *rdev;
	struct regulator_init_data *init_data;

	chip = devm_kzalloc(&client->dev, sizeof(*chip), GFP_KERNEL);
	if (!chip)
		return -ENOMEM;

	i2c_set_clientdata(client, chip);
	chip->dev = &client->dev;

	chip->regmap = devm_regmap_init_i2c(client, &pf530x_regmap_config);
	if (IS_ERR(chip->regmap)) {
		ret = PTR_ERR(chip->regmap);
		dev_err(&client->dev,
			"regmap allocation failed with err %d\n", ret);
		return ret;
	}

	ret = pf530x_identify(chip);
	if (ret)
		return ret;

	init_data = of_get_regulator_init_data(chip->dev, chip->dev->of_node, &pf530x_reg_desc);
	if (!init_data)
		return -ENODATA;

	config.dev = chip->dev;
	config.of_node = chip->dev->of_node;
	config.regmap = chip->regmap;
	config.init_data = init_data;

	// the config parameter gets copied, it's ok to pass a pointer on the stack here
	rdev = devm_regulator_register(&client->dev, &pf530x_reg_desc, &config);
	if (IS_ERR(rdev)) {
		dev_err(&client->dev, "failed to register %s regulator\n", pf530x_reg_desc.name);
		return PTR_ERR(rdev);
	}

	return 0;
}

static const struct of_device_id pf530x_dt_ids[] = {
	{ .compatible = "nxp,pf5300",},
	{ }
};
MODULE_DEVICE_TABLE(of, pf530x_dt_ids);

static const struct i2c_device_id pf530x_i2c_id[] = {
	{ .name = "pf5300" },
	{ .name = "pf5301" },
	{ .name = "pf5302" },
	{ }
};
MODULE_DEVICE_TABLE(i2c, pf530x_i2c_id);

static struct i2c_driver pf530x_regulator_driver = {
	.id_table = pf530x_i2c_id,
	.driver = {
		.name = "pf530x",
		.of_match_table = pf530x_dt_ids,
	},
	.probe = pf530x_i2c_probe,
};
module_i2c_driver(pf530x_regulator_driver);

MODULE_AUTHOR("Woodrow Douglass <wdouglass@carnegierobotics.com>");
MODULE_DESCRIPTION("Regulator Driver for NXP's PF5300/PF5301/PF5302 PMIC");
MODULE_LICENSE("GPL");