1 // SPDX-License-Identifier: GPL-2.0-or-later
3  * devres.c  --  Voltage/Current Regulator framework devres implementation.
17 static void devm_regulator_release(struct device *dev, void *res)  in devm_regulator_release()
22 static struct regulator *_devm_regulator_get(struct device *dev, const char *id,  in _devm_regulator_get()  argument
29 		return ERR_PTR(-ENOMEM);  in _devm_regulator_get()
31 	regulator = _regulator_get(dev, id, get_type);  in _devm_regulator_get()
43  * devm_regulator_get - Resource managed regulator_get()
44  * @dev: device to supply
45  * @id:  supply name or regulator ID.
51 struct regulator *devm_regulator_get(struct device *dev, const char *id)  in devm_regulator_get()  argument
53 	return _devm_regulator_get(dev, id, NORMAL_GET);  in devm_regulator_get()
58  * devm_regulator_get_exclusive - Resource managed regulator_get_exclusive()
59  * @dev: device to supply
60  * @id:  supply name or regulator ID.
66 struct regulator *devm_regulator_get_exclusive(struct device *dev,  in devm_regulator_get_exclusive()
67 					       const char *id)  in devm_regulator_get_exclusive()  argument
69 	return _devm_regulator_get(dev, id, EXCLUSIVE_GET);  in devm_regulator_get_exclusive()
80 static int _devm_regulator_get_enable(struct device *dev, const char *id,  in _devm_regulator_get_enable()  argument
86 	r = _devm_regulator_get(dev, id, get_type);  in _devm_regulator_get_enable()
101  * devm_regulator_get_enable_optional - Resource managed regulator get and enable
102  * @dev: device to supply
103  * @id:  supply name or regulator ID.
105  * Get and enable regulator for duration of the device life-time.
110 int devm_regulator_get_enable_optional(struct device *dev, const char *id)  in devm_regulator_get_enable_optional()  argument
112 	return _devm_regulator_get_enable(dev, id, OPTIONAL_GET);  in devm_regulator_get_enable_optional()
117  * devm_regulator_get_enable - Resource managed regulator get and enable
118  * @dev: device to supply
119  * @id:  supply name or regulator ID.
121  * Get and enable regulator for duration of the device life-time.
126 int devm_regulator_get_enable(struct device *dev, const char *id)  in devm_regulator_get_enable()  argument
128 	return _devm_regulator_get_enable(dev, id, NORMAL_GET);  in devm_regulator_get_enable()
133  * devm_regulator_get_optional - Resource managed regulator_get_optional()
134  * @dev: device to supply
135  * @id:  supply name or regulator ID.
141 struct regulator *devm_regulator_get_optional(struct device *dev,  in devm_regulator_get_optional()
142 					      const char *id)  in devm_regulator_get_optional()  argument
144 	return _devm_regulator_get(dev, id, OPTIONAL_GET);  in devm_regulator_get_optional()
148 static int devm_regulator_match(struct device *dev, void *res, void *data)  in devm_regulator_match()
159  * devm_regulator_put - Resource managed regulator_put()
170 	rc = devres_release(regulator->dev, devm_regulator_release,  in devm_regulator_put()
182 static void devm_regulator_bulk_release(struct device *dev, void *res)  in devm_regulator_bulk_release()
186 	regulator_bulk_free(devres->num_consumers, devres->consumers);  in devm_regulator_bulk_release()
189 static int _devm_regulator_bulk_get(struct device *dev, int num_consumers,  in _devm_regulator_bulk_get()
199 		return -ENOMEM;  in _devm_regulator_bulk_get()
203 		devres->consumers = consumers;  in _devm_regulator_bulk_get()
204 		devres->num_consumers = num_consumers;  in _devm_regulator_bulk_get()
214  * devm_regulator_bulk_get - managed get multiple regulator consumers
216  * @dev:           device to supply
224  * automatically be freed when the device is unbound.  If any of the
228 int devm_regulator_bulk_get(struct device *dev, int num_consumers,  in devm_regulator_bulk_get()
236  * devm_regulator_bulk_get_exclusive - managed exclusive get of multiple
239  * @dev:           device to supply
247  * will automatically be freed when the device is unbound.  If any of
251 int devm_regulator_bulk_get_exclusive(struct device *dev, int num_consumers,  in devm_regulator_bulk_get_exclusive()
259  * devm_regulator_bulk_get_const - devm_regulator_bulk_get() w/ const data
261  * @dev:           device to supply
272 int devm_regulator_bulk_get_const(struct device *dev, int num_consumers,  in devm_regulator_bulk_get_const()
280 		return -ENOMEM;  in devm_regulator_bulk_get_const()
286 static int devm_regulator_bulk_match(struct device *dev, void *res,  in devm_regulator_bulk_match()
298 	return match->consumers == target;  in devm_regulator_bulk_match()
302  * devm_regulator_bulk_put - Resource managed regulator_bulk_put()
314 	rc = devres_release(regulator->dev, devm_regulator_bulk_release,  in devm_regulator_bulk_put()
326 	for (i = 0; i < devres->num_consumers; i++)  in devm_regulator_bulk_disable()
327 		regulator_disable(devres->consumers[i].consumer);  in devm_regulator_bulk_disable()
331  * devm_regulator_bulk_get_enable - managed get'n enable multiple regulators
333  * @dev:           device to supply
335  * @id:            list of supply names or regulator IDs
341  * automatically be freed when the device is unbound.  If any of the
345 int devm_regulator_bulk_get_enable(struct device *dev, int num_consumers,  in devm_regulator_bulk_get_enable()
346 				   const char * const *id)  in devm_regulator_bulk_get_enable()  argument
354 		return -ENOMEM;  in devm_regulator_bulk_get_enable()
356 	devres->consumers = devm_kcalloc(dev, num_consumers, sizeof(*consumers),  in devm_regulator_bulk_get_enable()
358 	consumers = devres->consumers;  in devm_regulator_bulk_get_enable()
360 		return -ENOMEM;  in devm_regulator_bulk_get_enable()
362 	devres->num_consumers = num_consumers;  in devm_regulator_bulk_get_enable()
365 		consumers[i].supply = id[i];  in devm_regulator_bulk_get_enable()
382 	while (--i >= 0)  in devm_regulator_bulk_get_enable()
391 static void devm_rdev_release(struct device *dev, void *res)  in devm_rdev_release()
397  * devm_regulator_register - Resource managed regulator_register()
398  * @dev:            device to supply
404  * error.  The regulator will automatically be released when the device
407 struct regulator_dev *devm_regulator_register(struct device *dev,  in devm_regulator_register()
416 		return ERR_PTR(-ENOMEM);  in devm_regulator_register()
431 	struct device *dev;
432 	const char *id;  member
435 static int devm_regulator_match_supply_alias(struct device *dev, void *res,  in devm_regulator_match_supply_alias()
441 	return match->dev == target->dev && strcmp(match->id, target->id) == 0;  in devm_regulator_match_supply_alias()
444 static void devm_regulator_destroy_supply_alias(struct device *dev, void *res)  in devm_regulator_destroy_supply_alias()
448 	regulator_unregister_supply_alias(match->dev, match->id);  in devm_regulator_destroy_supply_alias()
452  * devm_regulator_register_supply_alias - Resource managed
455  * @dev:       device to supply
456  * @id:        supply name or regulator ID
457  * @alias_dev: device that should be used to lookup the supply
458  * @alias_id:  supply name or regulator ID that should be used to lookup the
462  * device is unbound.
464 int devm_regulator_register_supply_alias(struct device *dev, const char *id,  in devm_regulator_register_supply_alias()  argument
465 					 struct device *alias_dev,  in devm_regulator_register_supply_alias()
475 		return -ENOMEM;  in devm_regulator_register_supply_alias()
477 	match->dev = dev;  in devm_regulator_register_supply_alias()
478 	match->id = id;  in devm_regulator_register_supply_alias()
480 	ret = regulator_register_supply_alias(dev, id, alias_dev, alias_id);  in devm_regulator_register_supply_alias()
492 static void devm_regulator_unregister_supply_alias(struct device *dev,  in devm_regulator_unregister_supply_alias()
493 						   const char *id)  in devm_regulator_unregister_supply_alias()  argument
499 	match.id = id;  in devm_regulator_unregister_supply_alias()
508  * devm_regulator_bulk_register_supply_alias - Managed register
511  * @dev:       device to supply
512  * @id:        list of supply names or regulator IDs
513  * @alias_dev: device that should be used to lookup the supply
522  * unregisters when the source device is unbound.  If any of the
526 int devm_regulator_bulk_register_supply_alias(struct device *dev,  in devm_regulator_bulk_register_supply_alias()
527 					      const char *const *id,  in devm_regulator_bulk_register_supply_alias()  argument
528 					      struct device *alias_dev,  in devm_regulator_bulk_register_supply_alias()
536 		ret = devm_regulator_register_supply_alias(dev, id[i],  in devm_regulator_bulk_register_supply_alias()
547 		"Failed to create supply alias %s,%s -> %s,%s\n",  in devm_regulator_bulk_register_supply_alias()
548 		id[i], dev_name(dev), alias_id[i], dev_name(alias_dev));  in devm_regulator_bulk_register_supply_alias()
550 	while (--i >= 0)  in devm_regulator_bulk_register_supply_alias()
551 		devm_regulator_unregister_supply_alias(dev, id[i]);  in devm_regulator_bulk_register_supply_alias()
562 static int devm_regulator_match_notifier(struct device *dev, void *res,  in devm_regulator_match_notifier()
568 	return match->regulator == target->regulator && match->nb == target->nb;  in devm_regulator_match_notifier()
571 static void devm_regulator_destroy_notifier(struct device *dev, void *res)  in devm_regulator_destroy_notifier()
575 	regulator_unregister_notifier(match->regulator, match->nb);  in devm_regulator_destroy_notifier()
579  * devm_regulator_register_notifier - Resource managed
585  * The notifier will be registers under the consumer device and be
586  * automatically be unregistered when the source device is unbound.
598 		return -ENOMEM;  in devm_regulator_register_notifier()
600 	match->regulator = regulator;  in devm_regulator_register_notifier()
601 	match->nb = nb;  in devm_regulator_register_notifier()
609 	devres_add(regulator->dev, match);  in devm_regulator_register_notifier()
616  * devm_regulator_unregister_notifier - Resource managed
635 	rc = devres_release(regulator->dev, devm_regulator_destroy_notifier,  in devm_regulator_unregister_notifier()
648  * devm_regulator_irq_helper - resource managed registration of IRQ based
651  * @dev:		device to which lifetime the helper's lifetime is
658  *			When IRQ is re-enabled these errors will be cleared
672 void *devm_regulator_irq_helper(struct device *dev,  in devm_regulator_irq_helper()