Release 4.12 drivers/regulator/max1586.c
  
  
  
/*
 * max1586.c  --  Voltage and current regulation for the Maxim 1586
 *
 * Copyright (C) 2008 Robert Jarzmik
 *
 * This program is free software; you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation; either version 2 of the License, or
 * (at your option) any later version.
 *
 * This program is distributed in the hope that 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.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program; if not, write to the Free Software
 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
 */
#include <linux/module.h>
#include <linux/err.h>
#include <linux/i2c.h>
#include <linux/platform_device.h>
#include <linux/regulator/driver.h>
#include <linux/slab.h>
#include <linux/regulator/max1586.h>
#include <linux/of_device.h>
#include <linux/regulator/of_regulator.h>
#define MAX1586_V3_MAX_VSEL 31
#define MAX1586_V6_MAX_VSEL 3
#define MAX1586_V3_MIN_UV   700000
#define MAX1586_V3_MAX_UV  1475000
#define MAX1586_V6_MIN_UV        0
#define MAX1586_V6_MAX_UV  3000000
#define I2C_V3_SELECT (0 << 5)
#define I2C_V6_SELECT (1 << 5)
struct max1586_data {
	
struct i2c_client *client;
	/* min/max V3 voltage */
	
unsigned int min_uV;
	
unsigned int max_uV;
	
unsigned int v3_curr_sel;
	
unsigned int v6_curr_sel;
};
/*
 * V6 voltage
 * On I2C bus, sending a "x" byte to the max1586 means :
 *   set V6 to either 0V, 1.8V, 2.5V, 3V depending on (x & 0x3)
 * As regulator framework doesn't accept voltages to be 0V, we use 1uV.
 */
static const unsigned int v6_voltages_uv[] = { 1, 1800000, 2500000, 3000000 };
/*
 * V3 voltage
 * On I2C bus, sending a "x" byte to the max1586 means :
 *   set V3 to 0.700V + (x & 0x1f) * 0.025V
 * This voltage can be increased by external resistors
 * R24 and R25=100kOhm as described in the data sheet.
 * The gain is approximately: 1 + R24/R25 + R24/185.5kOhm
 */
static int max1586_v3_get_voltage_sel(struct regulator_dev *rdev)
{
	struct max1586_data *max1586 = rdev_get_drvdata(rdev);
	return max1586->v3_curr_sel;
}
Contributors
| Person | Tokens | Prop | Commits | CommitProp | 
| Axel Lin | 26 | 100.00% | 1 | 100.00% | 
| Total | 26 | 100.00% | 1 | 100.00% | 
static int max1586_v3_set_voltage_sel(struct regulator_dev *rdev,
				      unsigned selector)
{
	struct max1586_data *max1586 = rdev_get_drvdata(rdev);
	struct i2c_client *client = max1586->client;
	int ret;
	u8 v3_prog;
	dev_dbg(&client->dev, "changing voltage v3 to %dmv\n",
		regulator_list_voltage_linear(rdev, selector) / 1000);
	v3_prog = I2C_V3_SELECT | (u8) selector;
	ret = i2c_smbus_write_byte(client, v3_prog);
	if (ret)
		return ret;
	max1586->v3_curr_sel = selector;
	return 0;
}
Contributors
| Person | Tokens | Prop | Commits | CommitProp | 
| Robert Jarzmik | 52 | 56.52% | 1 | 16.67% | 
| Axel Lin | 26 | 28.26% | 3 | 50.00% | 
| Philipp Zabel | 12 | 13.04% | 1 | 16.67% | 
| Mark Brown | 2 | 2.17% | 1 | 16.67% | 
| Total | 92 | 100.00% | 6 | 100.00% | 
static int max1586_v6_get_voltage_sel(struct regulator_dev *rdev)
{
	struct max1586_data *max1586 = rdev_get_drvdata(rdev);
	return max1586->v6_curr_sel;
}
Contributors
| Person | Tokens | Prop | Commits | CommitProp | 
| Axel Lin | 24 | 92.31% | 1 | 50.00% | 
| Robert Jarzmik | 2 | 7.69% | 1 | 50.00% | 
| Total | 26 | 100.00% | 2 | 100.00% | 
static int max1586_v6_set_voltage_sel(struct regulator_dev *rdev,
				      unsigned int selector)
{
	struct max1586_data *max1586 = rdev_get_drvdata(rdev);
	struct i2c_client *client = max1586->client;
	u8 v6_prog;
	int ret;
	dev_dbg(&client->dev, "changing voltage v6 to %dmv\n",
		rdev->desc->volt_table[selector] / 1000);
	v6_prog = I2C_V6_SELECT | (u8) selector;
	ret = i2c_smbus_write_byte(client, v6_prog);
	if (ret)
		return ret;
	max1586->v6_curr_sel = selector;
	return 0;
}
Contributors
| Person | Tokens | Prop | Commits | CommitProp | 
| Robert Jarzmik | 52 | 54.74% | 1 | 20.00% | 
| Axel Lin | 40 | 42.11% | 3 | 60.00% | 
| Mark Brown | 3 | 3.16% | 1 | 20.00% | 
| Total | 95 | 100.00% | 5 | 100.00% | 
/*
 * The Maxim 1586 controls V3 and V6 voltages, but offers no way of reading back
 * the set up value.
 */
static const struct regulator_ops max1586_v3_ops = {
	.get_voltage_sel = max1586_v3_get_voltage_sel,
	.set_voltage_sel = max1586_v3_set_voltage_sel,
	.list_voltage = regulator_list_voltage_linear,
	.map_voltage = regulator_map_voltage_linear,
};
static const struct regulator_ops max1586_v6_ops = {
	.get_voltage_sel = max1586_v6_get_voltage_sel,
	.set_voltage_sel = max1586_v6_set_voltage_sel,
	.list_voltage = regulator_list_voltage_table,
};
static struct regulator_desc max1586_reg[] = {
	{
		.name = "Output_V3",
		.id = MAX1586_V3,
		.ops = &max1586_v3_ops,
		.type = REGULATOR_VOLTAGE,
		.n_voltages = MAX1586_V3_MAX_VSEL + 1,
		.owner = THIS_MODULE,
        },
	{
		.name = "Output_V6",
		.id = MAX1586_V6,
		.ops = &max1586_v6_ops,
		.type = REGULATOR_VOLTAGE,
		.n_voltages = MAX1586_V6_MAX_VSEL + 1,
		.volt_table = v6_voltages_uv,
		.owner = THIS_MODULE,
        },
};
static int of_get_max1586_platform_data(struct device *dev,
				 struct max1586_platform_data *pdata)
{
	struct max1586_subdev_data *sub;
	struct of_regulator_match rmatch[ARRAY_SIZE(max1586_reg)] = { };
	struct device_node *np = dev->of_node;
	int i, matched;
	if (of_property_read_u32(np, "v3-gain",
				 &pdata->v3_gain) < 0) {
		dev_err(dev, "%s has no 'v3-gain' property\n", np->full_name);
		return -EINVAL;
	}
	np = of_get_child_by_name(np, "regulators");
	if (!np) {
		dev_err(dev, "missing 'regulators' subnode in DT\n");
		return -EINVAL;
	}
	for (i = 0; i < ARRAY_SIZE(rmatch); i++)
		rmatch[i].name = max1586_reg[i].name;
	matched = of_regulator_match(dev, np, rmatch, ARRAY_SIZE(rmatch));
	of_node_put(np);
	/*
         * If matched is 0, ie. neither Output_V3 nor Output_V6 have been found,
         * return 0, which signals the normal situation where no subregulator is
         * available. This is normal because the max1586 doesn't provide any
         * readback support, so the subregulators can't report any status
         * anyway.  If matched < 0, return the error.
         */
	if (matched <= 0)
		return matched;
	pdata->subdevs = devm_kzalloc(dev, sizeof(struct max1586_subdev_data) *
						matched, GFP_KERNEL);
	if (!pdata->subdevs)
		return -ENOMEM;
	pdata->num_subdevs = matched;
	sub = pdata->subdevs;
	for (i = 0; i < matched; i++) {
		sub->id = i;
		sub->name = rmatch[i].of_node->name;
		sub->platform_data = rmatch[i].init_data;
		sub++;
	}
	return 0;
}
Contributors
| Person | Tokens | Prop | Commits | CommitProp | 
| Robert Jarzmik | 258 | 98.85% | 1 | 33.33% | 
| Javier Martinez Canillas | 2 | 0.77% | 1 | 33.33% | 
| Fengguang Wu | 1 | 0.38% | 1 | 33.33% | 
| Total | 261 | 100.00% | 3 | 100.00% | 
static const struct of_device_id max1586_of_match[] = {
	{ .compatible = "maxim,max1586", },
	{},
};
MODULE_DEVICE_TABLE(of, max1586_of_match);
static int max1586_pmic_probe(struct i2c_client *client,
					const struct i2c_device_id *i2c_id)
{
	struct max1586_platform_data *pdata, pdata_of;
	struct regulator_config config = { };
	struct max1586_data *max1586;
	int i, id, ret;
	const struct of_device_id *match;
	pdata = dev_get_platdata(&client->dev);
	if (client->dev.of_node && !pdata) {
		match = of_match_device(of_match_ptr(max1586_of_match),
					&client->dev);
		if (!match) {
			dev_err(&client->dev, "Error: No device match found\n");
			return -ENODEV;
		}
		ret = of_get_max1586_platform_data(&client->dev, &pdata_of);
		if (ret < 0)
			return ret;
		pdata = &pdata_of;
	}
	max1586 = devm_kzalloc(&client->dev, sizeof(struct max1586_data),
			GFP_KERNEL);
	if (!max1586)
		return -ENOMEM;
	max1586->client = client;
	if (!pdata->v3_gain)
		return -EINVAL;
	max1586->min_uV = MAX1586_V3_MIN_UV / 1000 * pdata->v3_gain / 1000;
	max1586->max_uV = MAX1586_V3_MAX_UV / 1000 * pdata->v3_gain / 1000;
	/* Set curr_sel to default voltage on power-up */
	max1586->v3_curr_sel = 24; /* 1.3V */
	max1586->v6_curr_sel = 0;
	for (i = 0; i < pdata->num_subdevs && i <= MAX1586_V6; i++) {
		struct regulator_dev *rdev;
		id = pdata->subdevs[i].id;
		if (!pdata->subdevs[i].platform_data)
			continue;
		if (id < MAX1586_V3 || id > MAX1586_V6) {
			dev_err(&client->dev, "invalid regulator id %d\n", id);
			return -EINVAL;
		}
		if (id == MAX1586_V3) {
			max1586_reg[id].min_uV = max1586->min_uV;
			max1586_reg[id].uV_step =
					(max1586->max_uV - max1586->min_uV) /
					MAX1586_V3_MAX_VSEL;
		}
		config.dev = &client->dev;
		config.init_data = pdata->subdevs[i].platform_data;
		config.driver_data = max1586;
		rdev = devm_regulator_register(&client->dev,
						  &max1586_reg[id], &config);
		if (IS_ERR(rdev)) {
			dev_err(&client->dev, "failed to register %s\n",
				max1586_reg[id].name);
			return PTR_ERR(rdev);
		}
	}
	i2c_set_clientdata(client, max1586);
	dev_info(&client->dev, "Maxim 1586 regulator driver loaded\n");
	return 0;
}
Contributors
| Person | Tokens | Prop | Commits | CommitProp | 
| Robert Jarzmik | 267 | 61.38% | 2 | 16.67% | 
| Axel Lin | 65 | 14.94% | 4 | 33.33% | 
| Philipp Zabel | 51 | 11.72% | 2 | 16.67% | 
| Mark Brown | 30 | 6.90% | 1 | 8.33% | 
| Sachin Kamat | 16 | 3.68% | 1 | 8.33% | 
| Krzysztof Kozlowski | 5 | 1.15% | 1 | 8.33% | 
| Rajendra Nayak | 1 | 0.23% | 1 | 8.33% | 
| Total | 435 | 100.00% | 12 | 100.00% | 
static const struct i2c_device_id max1586_id[] = {
	{ "max1586", 0 },
	{ }
};
MODULE_DEVICE_TABLE(i2c, max1586_id);
static struct i2c_driver max1586_pmic_driver = {
	.probe = max1586_pmic_probe,
	.driver		= {
		.name	= "max1586",
		.of_match_table = of_match_ptr(max1586_of_match),
        },
	.id_table	= max1586_id,
};
static int __init max1586_pmic_init(void)
{
	return i2c_add_driver(&max1586_pmic_driver);
}
Contributors
| Person | Tokens | Prop | Commits | CommitProp | 
| Robert Jarzmik | 16 | 100.00% | 1 | 100.00% | 
| Total | 16 | 100.00% | 1 | 100.00% | 
subsys_initcall(max1586_pmic_init);
static void __exit max1586_pmic_exit(void)
{
	i2c_del_driver(&max1586_pmic_driver);
}
Contributors
| Person | Tokens | Prop | Commits | CommitProp | 
| Robert Jarzmik | 15 | 100.00% | 1 | 100.00% | 
| Total | 15 | 100.00% | 1 | 100.00% | 
module_exit(max1586_pmic_exit);
/* Module information */
MODULE_DESCRIPTION("MAXIM 1586 voltage regulator driver");
MODULE_AUTHOR("Robert Jarzmik");
MODULE_LICENSE("GPL");
Overall Contributors
| Person | Tokens | Prop | Commits | CommitProp | 
| Robert Jarzmik | 934 | 70.92% | 2 | 9.09% | 
| Axel Lin | 233 | 17.69% | 8 | 36.36% | 
| Philipp Zabel | 83 | 6.30% | 2 | 9.09% | 
| Mark Brown | 35 | 2.66% | 2 | 9.09% | 
| Sachin Kamat | 16 | 1.21% | 1 | 4.55% | 
| Krzysztof Kozlowski | 7 | 0.53% | 2 | 9.09% | 
| Tejun Heo | 3 | 0.23% | 1 | 4.55% | 
| Dmitry Torokhov | 2 | 0.15% | 1 | 4.55% | 
| Javier Martinez Canillas | 2 | 0.15% | 1 | 4.55% | 
| Rajendra Nayak | 1 | 0.08% | 1 | 4.55% | 
| Fengguang Wu | 1 | 0.08% | 1 | 4.55% | 
| Total | 1317 | 100.00% | 22 | 100.00% | 
Information contained on this website is for historical information purposes only and does not indicate or represent copyright ownership.