Linux Audio

Check our new training course

Loading...
v5.9
  1// SPDX-License-Identifier: GPL-2.0-or-later
  2/*
  3 * fixed.c
  4 *
  5 * Copyright 2008 Wolfson Microelectronics PLC.
  6 *
  7 * Author: Mark Brown <broonie@opensource.wolfsonmicro.com>
  8 *
  9 * Copyright (c) 2009 Nokia Corporation
 10 * Roger Quadros <ext-roger.quadros@nokia.com>
 11 *
 
 
 
 
 
 12 * This is useful for systems with mixed controllable and
 13 * non-controllable regulators, as well as for allowing testing on
 14 * systems with no controllable regulators.
 15 */
 16
 17#include <linux/err.h>
 18#include <linux/mutex.h>
 19#include <linux/module.h>
 20#include <linux/platform_device.h>
 21#include <linux/regulator/driver.h>
 22#include <linux/regulator/fixed.h>
 23#include <linux/gpio/consumer.h>
 
 24#include <linux/slab.h>
 25#include <linux/of.h>
 26#include <linux/of_device.h>
 27#include <linux/regulator/of_regulator.h>
 28#include <linux/regulator/machine.h>
 29#include <linux/clk.h>
 30
 31
 32struct fixed_voltage_data {
 33	struct regulator_desc desc;
 34	struct regulator_dev *dev;
 35
 36	struct clk *enable_clock;
 37	unsigned int clk_enable_counter;
 
 
 38};
 39
 40struct fixed_dev_type {
 41	bool has_enable_clock;
 42};
 43
 44static const struct fixed_dev_type fixed_voltage_data = {
 45	.has_enable_clock = false,
 46};
 47
 48static const struct fixed_dev_type fixed_clkenable_data = {
 49	.has_enable_clock = true,
 50};
 51
 52static int reg_clock_enable(struct regulator_dev *rdev)
 53{
 54	struct fixed_voltage_data *priv = rdev_get_drvdata(rdev);
 55	int ret = 0;
 56
 57	ret = clk_prepare_enable(priv->enable_clock);
 58	if (ret)
 59		return ret;
 60
 61	priv->clk_enable_counter++;
 62
 63	return ret;
 64}
 65
 66static int reg_clock_disable(struct regulator_dev *rdev)
 67{
 68	struct fixed_voltage_data *priv = rdev_get_drvdata(rdev);
 69
 70	clk_disable_unprepare(priv->enable_clock);
 71	priv->clk_enable_counter--;
 
 
 72
 73	return 0;
 74}
 75
 76static int reg_clock_is_enabled(struct regulator_dev *rdev)
 77{
 78	struct fixed_voltage_data *priv = rdev_get_drvdata(rdev);
 79
 80	return priv->clk_enable_counter > 0;
 81}
 82
 83
 84/**
 85 * of_get_fixed_voltage_config - extract fixed_voltage_config structure info
 86 * @dev: device requesting for fixed_voltage_config
 87 * @desc: regulator description
 88 *
 89 * Populates fixed_voltage_config structure by extracting data from device
 90 * tree node, returns a pointer to the populated structure of NULL if memory
 91 * alloc fails.
 92 */
 93static struct fixed_voltage_config *
 94of_get_fixed_voltage_config(struct device *dev,
 95			    const struct regulator_desc *desc)
 96{
 97	struct fixed_voltage_config *config;
 98	struct device_node *np = dev->of_node;
 99	struct regulator_init_data *init_data;
100
101	config = devm_kzalloc(dev, sizeof(struct fixed_voltage_config),
102								 GFP_KERNEL);
103	if (!config)
104		return ERR_PTR(-ENOMEM);
105
106	config->init_data = of_get_regulator_init_data(dev, dev->of_node, desc);
107	if (!config->init_data)
108		return ERR_PTR(-EINVAL);
109
110	init_data = config->init_data;
111	init_data->constraints.apply_uV = 0;
112
113	config->supply_name = init_data->constraints.name;
114	if (init_data->constraints.min_uV == init_data->constraints.max_uV) {
115		config->microvolts = init_data->constraints.min_uV;
116	} else {
117		dev_err(dev,
118			 "Fixed regulator specified with variable voltages\n");
119		return ERR_PTR(-EINVAL);
120	}
121
122	if (init_data->constraints.boot_on)
123		config->enabled_at_boot = true;
124
125	of_property_read_u32(np, "startup-delay-us", &config->startup_delay);
126	of_property_read_u32(np, "off-on-delay-us", &config->off_on_delay);
 
 
127
128	if (of_find_property(np, "vin-supply", NULL))
129		config->input_supply = "vin";
130
131	return config;
132}
133
134static struct regulator_ops fixed_voltage_ops = {
 
 
 
 
 
 
135};
136
137static struct regulator_ops fixed_voltage_clkenabled_ops = {
138	.enable = reg_clock_enable,
139	.disable = reg_clock_disable,
140	.is_enabled = reg_clock_is_enabled,
141};
142
143static int reg_fixed_voltage_probe(struct platform_device *pdev)
144{
145	struct device *dev = &pdev->dev;
146	struct fixed_voltage_config *config;
147	struct fixed_voltage_data *drvdata;
148	const struct fixed_dev_type *drvtype = of_device_get_match_data(dev);
149	struct regulator_config cfg = { };
150	enum gpiod_flags gflags;
151	int ret;
152
153	drvdata = devm_kzalloc(&pdev->dev, sizeof(struct fixed_voltage_data),
154			       GFP_KERNEL);
155	if (!drvdata)
156		return -ENOMEM;
157
158	if (pdev->dev.of_node) {
159		config = of_get_fixed_voltage_config(&pdev->dev,
160						     &drvdata->desc);
161		if (IS_ERR(config))
162			return PTR_ERR(config);
163	} else {
164		config = dev_get_platdata(&pdev->dev);
165	}
166
167	if (!config)
168		return -ENOMEM;
169
170	drvdata->desc.name = devm_kstrdup(&pdev->dev,
171					  config->supply_name,
172					  GFP_KERNEL);
173	if (drvdata->desc.name == NULL) {
174		dev_err(&pdev->dev, "Failed to allocate supply name\n");
175		return -ENOMEM;
 
176	}
177	drvdata->desc.type = REGULATOR_VOLTAGE;
178	drvdata->desc.owner = THIS_MODULE;
 
 
179
180	if (drvtype && drvtype->has_enable_clock) {
181		drvdata->desc.ops = &fixed_voltage_clkenabled_ops;
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
182
183		drvdata->enable_clock = devm_clk_get(dev, NULL);
184		if (IS_ERR(drvdata->enable_clock)) {
185			dev_err(dev, "Can't get enable-clock from devicetree\n");
186			return -ENOENT;
 
 
187		}
188	} else {
189		drvdata->desc.ops = &fixed_voltage_ops;
190	}
191
192	drvdata->desc.enable_time = config->startup_delay;
193	drvdata->desc.off_on_delay = config->off_on_delay;
 
 
 
 
194
195	if (config->input_supply) {
196		drvdata->desc.supply_name = devm_kstrdup(&pdev->dev,
197					    config->input_supply,
198					    GFP_KERNEL);
199		if (!drvdata->desc.supply_name) {
200			dev_err(&pdev->dev,
201				"Failed to allocate input supply\n");
202			return -ENOMEM;
 
203		}
204	}
205
206	if (config->microvolts)
207		drvdata->desc.n_voltages = 1;
208
209	drvdata->desc.fixed_uV = config->microvolts;
210
211	/*
212	 * The signal will be inverted by the GPIO core if flagged so in the
213	 * descriptor.
214	 */
215	if (config->enabled_at_boot)
216		gflags = GPIOD_OUT_HIGH;
217	else
218		gflags = GPIOD_OUT_LOW;
219
220	/*
221	 * Some fixed regulators share the enable line between two
222	 * regulators which makes it necessary to get a handle on the
223	 * same descriptor for two different consumers. This will get
224	 * the GPIO descriptor, but only the first call will initialize
225	 * it so any flags such as inversion or open drain will only
226	 * be set up by the first caller and assumed identical on the
227	 * next caller.
228	 *
229	 * FIXME: find a better way to deal with this.
230	 */
231	gflags |= GPIOD_FLAGS_BIT_NONEXCLUSIVE;
232
233	/*
234	 * Do not use devm* here: the regulator core takes over the
235	 * lifecycle management of the GPIO descriptor.
236	 */
237	cfg.ena_gpiod = gpiod_get_optional(&pdev->dev, NULL, gflags);
238	if (IS_ERR(cfg.ena_gpiod))
239		return PTR_ERR(cfg.ena_gpiod);
240
241	cfg.dev = &pdev->dev;
242	cfg.init_data = config->init_data;
243	cfg.driver_data = drvdata;
244	cfg.of_node = pdev->dev.of_node;
245
246	drvdata->dev = devm_regulator_register(&pdev->dev, &drvdata->desc,
247					       &cfg);
248	if (IS_ERR(drvdata->dev)) {
249		ret = PTR_ERR(drvdata->dev);
250		dev_err(&pdev->dev, "Failed to register regulator: %d\n", ret);
251		return ret;
252	}
253
254	platform_set_drvdata(pdev, drvdata);
255
256	dev_dbg(&pdev->dev, "%s supplying %duV\n", drvdata->desc.name,
257		drvdata->desc.fixed_uV);
258
259	return 0;
 
 
 
 
 
 
 
 
 
260}
261
262#if defined(CONFIG_OF)
263static const struct of_device_id fixed_of_match[] = {
264	{
265		.compatible = "regulator-fixed",
266		.data = &fixed_voltage_data,
267	},
268	{
269		.compatible = "regulator-fixed-clock",
270		.data = &fixed_clkenable_data,
271	},
272	{
273	},
274};
275MODULE_DEVICE_TABLE(of, fixed_of_match);
276#endif
277
278static struct platform_driver regulator_fixed_voltage_driver = {
279	.probe		= reg_fixed_voltage_probe,
 
280	.driver		= {
281		.name		= "reg-fixed-voltage",
282		.of_match_table = of_match_ptr(fixed_of_match),
283	},
284};
285
286static int __init regulator_fixed_voltage_init(void)
287{
288	return platform_driver_register(&regulator_fixed_voltage_driver);
289}
290subsys_initcall(regulator_fixed_voltage_init);
291
292static void __exit regulator_fixed_voltage_exit(void)
293{
294	platform_driver_unregister(&regulator_fixed_voltage_driver);
295}
296module_exit(regulator_fixed_voltage_exit);
297
298MODULE_AUTHOR("Mark Brown <broonie@opensource.wolfsonmicro.com>");
299MODULE_DESCRIPTION("Fixed voltage regulator");
300MODULE_LICENSE("GPL");
301MODULE_ALIAS("platform:reg-fixed-voltage");
v3.1
 
  1/*
  2 * fixed.c
  3 *
  4 * Copyright 2008 Wolfson Microelectronics PLC.
  5 *
  6 * Author: Mark Brown <broonie@opensource.wolfsonmicro.com>
  7 *
  8 * Copyright (c) 2009 Nokia Corporation
  9 * Roger Quadros <ext-roger.quadros@nokia.com>
 10 *
 11 * This program is free software; you can redistribute it and/or
 12 * modify it under the terms of the GNU General Public License as
 13 * published by the Free Software Foundation; either version 2 of the
 14 * License, or (at your option) any later version.
 15 *
 16 * This is useful for systems with mixed controllable and
 17 * non-controllable regulators, as well as for allowing testing on
 18 * systems with no controllable regulators.
 19 */
 20
 21#include <linux/err.h>
 22#include <linux/mutex.h>
 
 23#include <linux/platform_device.h>
 24#include <linux/regulator/driver.h>
 25#include <linux/regulator/fixed.h>
 26#include <linux/gpio.h>
 27#include <linux/delay.h>
 28#include <linux/slab.h>
 
 
 
 
 
 
 29
 30struct fixed_voltage_data {
 31	struct regulator_desc desc;
 32	struct regulator_dev *dev;
 33	int microvolts;
 34	int gpio;
 35	unsigned startup_delay;
 36	bool enable_high;
 37	bool is_enabled;
 38};
 39
 40static int fixed_voltage_is_enabled(struct regulator_dev *dev)
 41{
 42	struct fixed_voltage_data *data = rdev_get_drvdata(dev);
 
 
 
 
 43
 44	return data->is_enabled;
 45}
 
 46
 47static int fixed_voltage_enable(struct regulator_dev *dev)
 48{
 49	struct fixed_voltage_data *data = rdev_get_drvdata(dev);
 
 50
 51	if (gpio_is_valid(data->gpio)) {
 52		gpio_set_value_cansleep(data->gpio, data->enable_high);
 53		data->is_enabled = true;
 54	}
 
 55
 56	return 0;
 57}
 58
 59static int fixed_voltage_disable(struct regulator_dev *dev)
 60{
 61	struct fixed_voltage_data *data = rdev_get_drvdata(dev);
 62
 63	if (gpio_is_valid(data->gpio)) {
 64		gpio_set_value_cansleep(data->gpio, !data->enable_high);
 65		data->is_enabled = false;
 66	}
 67
 68	return 0;
 69}
 70
 71static int fixed_voltage_enable_time(struct regulator_dev *dev)
 72{
 73	struct fixed_voltage_data *data = rdev_get_drvdata(dev);
 74
 75	return data->startup_delay;
 76}
 77
 78static int fixed_voltage_get_voltage(struct regulator_dev *dev)
 
 
 
 
 
 
 
 
 
 
 
 
 79{
 80	struct fixed_voltage_data *data = rdev_get_drvdata(dev);
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 81
 82	return data->microvolts;
 83}
 84
 85static int fixed_voltage_list_voltage(struct regulator_dev *dev,
 86				      unsigned selector)
 87{
 88	struct fixed_voltage_data *data = rdev_get_drvdata(dev);
 89
 90	if (selector != 0)
 91		return -EINVAL;
 92
 93	return data->microvolts;
 94}
 95
 96static struct regulator_ops fixed_voltage_ops = {
 97	.is_enabled = fixed_voltage_is_enabled,
 98	.enable = fixed_voltage_enable,
 99	.disable = fixed_voltage_disable,
100	.enable_time = fixed_voltage_enable_time,
101	.get_voltage = fixed_voltage_get_voltage,
102	.list_voltage = fixed_voltage_list_voltage,
103};
104
105static int __devinit reg_fixed_voltage_probe(struct platform_device *pdev)
 
 
 
 
 
 
106{
107	struct fixed_voltage_config *config = pdev->dev.platform_data;
 
108	struct fixed_voltage_data *drvdata;
 
 
 
109	int ret;
110
111	drvdata = kzalloc(sizeof(struct fixed_voltage_data), GFP_KERNEL);
112	if (drvdata == NULL) {
113		dev_err(&pdev->dev, "Failed to allocate device data\n");
114		ret = -ENOMEM;
115		goto err;
 
 
 
 
 
 
 
116	}
117
118	drvdata->desc.name = kstrdup(config->supply_name, GFP_KERNEL);
 
 
 
 
 
119	if (drvdata->desc.name == NULL) {
120		dev_err(&pdev->dev, "Failed to allocate supply name\n");
121		ret = -ENOMEM;
122		goto err;
123	}
124	drvdata->desc.type = REGULATOR_VOLTAGE;
125	drvdata->desc.owner = THIS_MODULE;
126	drvdata->desc.ops = &fixed_voltage_ops;
127	drvdata->desc.n_voltages = 1;
128
129	drvdata->microvolts = config->microvolts;
130	drvdata->gpio = config->gpio;
131	drvdata->startup_delay = config->startup_delay;
132
133	if (gpio_is_valid(config->gpio)) {
134		drvdata->enable_high = config->enable_high;
135
136		/* FIXME: Remove below print warning
137		 *
138		 * config->gpio must be set to -EINVAL by platform code if
139		 * GPIO control is not required. However, early adopters
140		 * not requiring GPIO control may forget to initialize
141		 * config->gpio to -EINVAL. This will cause GPIO 0 to be used
142		 * for GPIO control.
143		 *
144		 * This warning will be removed once there are a couple of users
145		 * for this driver.
146		 */
147		if (!config->gpio)
148			dev_warn(&pdev->dev,
149				"using GPIO 0 for regulator enable control\n");
150
151		ret = gpio_request(config->gpio, config->supply_name);
152		if (ret) {
153			dev_err(&pdev->dev,
154			   "Could not obtain regulator enable GPIO %d: %d\n",
155							config->gpio, ret);
156			goto err_name;
157		}
 
 
 
158
159		/* set output direction without changing state
160		 * to prevent glitch
161		 */
162		drvdata->is_enabled = config->enabled_at_boot;
163		ret = drvdata->is_enabled ?
164				config->enable_high : !config->enable_high;
165
166		ret = gpio_direction_output(config->gpio, ret);
167		if (ret) {
 
 
 
168			dev_err(&pdev->dev,
169			   "Could not configure regulator enable GPIO %d direction: %d\n",
170							config->gpio, ret);
171			goto err_gpio;
172		}
 
 
 
 
 
 
173
174	} else {
175		/* Regulator without GPIO control is considered
176		 * always enabled
177		 */
178		drvdata->is_enabled = true;
179	}
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
180
181	drvdata->dev = regulator_register(&drvdata->desc, &pdev->dev,
182					  config->init_data, drvdata);
183	if (IS_ERR(drvdata->dev)) {
184		ret = PTR_ERR(drvdata->dev);
185		dev_err(&pdev->dev, "Failed to register regulator: %d\n", ret);
186		goto err_gpio;
187	}
188
189	platform_set_drvdata(pdev, drvdata);
190
191	dev_dbg(&pdev->dev, "%s supplying %duV\n", drvdata->desc.name,
192		drvdata->microvolts);
193
194	return 0;
195
196err_gpio:
197	if (gpio_is_valid(config->gpio))
198		gpio_free(config->gpio);
199err_name:
200	kfree(drvdata->desc.name);
201err:
202	kfree(drvdata);
203	return ret;
204}
205
206static int __devexit reg_fixed_voltage_remove(struct platform_device *pdev)
207{
208	struct fixed_voltage_data *drvdata = platform_get_drvdata(pdev);
209
210	regulator_unregister(drvdata->dev);
211	if (gpio_is_valid(drvdata->gpio))
212		gpio_free(drvdata->gpio);
213	kfree(drvdata->desc.name);
214	kfree(drvdata);
215
216	return 0;
217}
 
 
 
218
219static struct platform_driver regulator_fixed_voltage_driver = {
220	.probe		= reg_fixed_voltage_probe,
221	.remove		= __devexit_p(reg_fixed_voltage_remove),
222	.driver		= {
223		.name		= "reg-fixed-voltage",
224		.owner		= THIS_MODULE,
225	},
226};
227
228static int __init regulator_fixed_voltage_init(void)
229{
230	return platform_driver_register(&regulator_fixed_voltage_driver);
231}
232subsys_initcall(regulator_fixed_voltage_init);
233
234static void __exit regulator_fixed_voltage_exit(void)
235{
236	platform_driver_unregister(&regulator_fixed_voltage_driver);
237}
238module_exit(regulator_fixed_voltage_exit);
239
240MODULE_AUTHOR("Mark Brown <broonie@opensource.wolfsonmicro.com>");
241MODULE_DESCRIPTION("Fixed voltage regulator");
242MODULE_LICENSE("GPL");
243MODULE_ALIAS("platform:reg-fixed-voltage");