Loading...
1/*
2 * devres.c -- Voltage/Current Regulator framework devres implementation.
3 *
4 * Copyright 2013 Linaro Ltd
5 *
6 * This program is free software; you can redistribute it and/or modify it
7 * under the terms of the GNU General Public License as published by the
8 * Free Software Foundation; either version 2 of the License, or (at your
9 * option) any later version.
10 *
11 */
12
13#include <linux/kernel.h>
14#include <linux/err.h>
15#include <linux/regmap.h>
16#include <linux/regulator/consumer.h>
17#include <linux/regulator/driver.h>
18#include <linux/module.h>
19
20#include "internal.h"
21
22enum {
23 NORMAL_GET,
24 EXCLUSIVE_GET,
25 OPTIONAL_GET,
26};
27
28static void devm_regulator_release(struct device *dev, void *res)
29{
30 regulator_put(*(struct regulator **)res);
31}
32
33static struct regulator *_devm_regulator_get(struct device *dev, const char *id,
34 int get_type)
35{
36 struct regulator **ptr, *regulator;
37
38 ptr = devres_alloc(devm_regulator_release, sizeof(*ptr), GFP_KERNEL);
39 if (!ptr)
40 return ERR_PTR(-ENOMEM);
41
42 switch (get_type) {
43 case NORMAL_GET:
44 regulator = regulator_get(dev, id);
45 break;
46 case EXCLUSIVE_GET:
47 regulator = regulator_get_exclusive(dev, id);
48 break;
49 case OPTIONAL_GET:
50 regulator = regulator_get_optional(dev, id);
51 break;
52 default:
53 regulator = ERR_PTR(-EINVAL);
54 }
55
56 if (!IS_ERR(regulator)) {
57 *ptr = regulator;
58 devres_add(dev, ptr);
59 } else {
60 devres_free(ptr);
61 }
62
63 return regulator;
64}
65
66/**
67 * devm_regulator_get - Resource managed regulator_get()
68 * @dev: device for regulator "consumer"
69 * @id: Supply name or regulator ID.
70 *
71 * Managed regulator_get(). Regulators returned from this function are
72 * automatically regulator_put() on driver detach. See regulator_get() for more
73 * information.
74 */
75struct regulator *devm_regulator_get(struct device *dev, const char *id)
76{
77 return _devm_regulator_get(dev, id, NORMAL_GET);
78}
79EXPORT_SYMBOL_GPL(devm_regulator_get);
80
81/**
82 * devm_regulator_get_exclusive - Resource managed regulator_get_exclusive()
83 * @dev: device for regulator "consumer"
84 * @id: Supply name or regulator ID.
85 *
86 * Managed regulator_get_exclusive(). Regulators returned from this function
87 * are automatically regulator_put() on driver detach. See regulator_get() for
88 * more information.
89 */
90struct regulator *devm_regulator_get_exclusive(struct device *dev,
91 const char *id)
92{
93 return _devm_regulator_get(dev, id, EXCLUSIVE_GET);
94}
95EXPORT_SYMBOL_GPL(devm_regulator_get_exclusive);
96
97/**
98 * devm_regulator_get_optional - Resource managed regulator_get_optional()
99 * @dev: device for regulator "consumer"
100 * @id: Supply name or regulator ID.
101 *
102 * Managed regulator_get_optional(). Regulators returned from this
103 * function are automatically regulator_put() on driver detach. See
104 * regulator_get_optional() for more information.
105 */
106struct regulator *devm_regulator_get_optional(struct device *dev,
107 const char *id)
108{
109 return _devm_regulator_get(dev, id, OPTIONAL_GET);
110}
111EXPORT_SYMBOL_GPL(devm_regulator_get_optional);
112
113static int devm_regulator_match(struct device *dev, void *res, void *data)
114{
115 struct regulator **r = res;
116 if (!r || !*r) {
117 WARN_ON(!r || !*r);
118 return 0;
119 }
120 return *r == data;
121}
122
123/**
124 * devm_regulator_put - Resource managed regulator_put()
125 * @regulator: regulator to free
126 *
127 * Deallocate a regulator allocated with devm_regulator_get(). Normally
128 * this function will not need to be called and the resource management
129 * code will ensure that the resource is freed.
130 */
131void devm_regulator_put(struct regulator *regulator)
132{
133 int rc;
134
135 rc = devres_release(regulator->dev, devm_regulator_release,
136 devm_regulator_match, regulator);
137 if (rc != 0)
138 WARN_ON(rc);
139}
140EXPORT_SYMBOL_GPL(devm_regulator_put);
141
142/**
143 * devm_regulator_bulk_get - managed get multiple regulator consumers
144 *
145 * @dev: Device to supply
146 * @num_consumers: Number of consumers to register
147 * @consumers: Configuration of consumers; clients are stored here.
148 *
149 * @return 0 on success, an errno on failure.
150 *
151 * This helper function allows drivers to get several regulator
152 * consumers in one operation with management, the regulators will
153 * automatically be freed when the device is unbound. If any of the
154 * regulators cannot be acquired then any regulators that were
155 * allocated will be freed before returning to the caller.
156 */
157int devm_regulator_bulk_get(struct device *dev, int num_consumers,
158 struct regulator_bulk_data *consumers)
159{
160 int i;
161 int ret;
162
163 for (i = 0; i < num_consumers; i++)
164 consumers[i].consumer = NULL;
165
166 for (i = 0; i < num_consumers; i++) {
167 consumers[i].consumer = _devm_regulator_get(dev,
168 consumers[i].supply,
169 consumers[i].optional ?
170 OPTIONAL_GET :
171 NORMAL_GET);
172 if (IS_ERR(consumers[i].consumer)) {
173 ret = PTR_ERR(consumers[i].consumer);
174 dev_err(dev, "Failed to get supply '%s': %d\n",
175 consumers[i].supply, ret);
176 consumers[i].consumer = NULL;
177 goto err;
178 }
179 }
180
181 return 0;
182
183err:
184 for (i = 0; i < num_consumers && consumers[i].consumer; i++)
185 devm_regulator_put(consumers[i].consumer);
186
187 return ret;
188}
189EXPORT_SYMBOL_GPL(devm_regulator_bulk_get);
190
191static void devm_rdev_release(struct device *dev, void *res)
192{
193 regulator_unregister(*(struct regulator_dev **)res);
194}
195
196/**
197 * devm_regulator_register - Resource managed regulator_register()
198 * @regulator_desc: regulator to register
199 * @config: runtime configuration for regulator
200 *
201 * Called by regulator drivers to register a regulator. Returns a
202 * valid pointer to struct regulator_dev on success or an ERR_PTR() on
203 * error. The regulator will automatically be released when the device
204 * is unbound.
205 */
206struct regulator_dev *devm_regulator_register(struct device *dev,
207 const struct regulator_desc *regulator_desc,
208 const struct regulator_config *config)
209{
210 struct regulator_dev **ptr, *rdev;
211
212 ptr = devres_alloc(devm_rdev_release, sizeof(*ptr),
213 GFP_KERNEL);
214 if (!ptr)
215 return ERR_PTR(-ENOMEM);
216
217 rdev = regulator_register(regulator_desc, config);
218 if (!IS_ERR(rdev)) {
219 *ptr = rdev;
220 devres_add(dev, ptr);
221 } else {
222 devres_free(ptr);
223 }
224
225 return rdev;
226}
227EXPORT_SYMBOL_GPL(devm_regulator_register);
228
229static int devm_rdev_match(struct device *dev, void *res, void *data)
230{
231 struct regulator_dev **r = res;
232 if (!r || !*r) {
233 WARN_ON(!r || !*r);
234 return 0;
235 }
236 return *r == data;
237}
238
239/**
240 * devm_regulator_unregister - Resource managed regulator_unregister()
241 * @regulator: regulator to free
242 *
243 * Unregister a regulator registered with devm_regulator_register().
244 * Normally this function will not need to be called and the resource
245 * management code will ensure that the resource is freed.
246 */
247void devm_regulator_unregister(struct device *dev, struct regulator_dev *rdev)
248{
249 int rc;
250
251 rc = devres_release(dev, devm_rdev_release, devm_rdev_match, rdev);
252 if (rc != 0)
253 WARN_ON(rc);
254}
255EXPORT_SYMBOL_GPL(devm_regulator_unregister);
256
257struct regulator_supply_alias_match {
258 struct device *dev;
259 const char *id;
260};
261
262static int devm_regulator_match_supply_alias(struct device *dev, void *res,
263 void *data)
264{
265 struct regulator_supply_alias_match *match = res;
266 struct regulator_supply_alias_match *target = data;
267
268 return match->dev == target->dev && strcmp(match->id, target->id) == 0;
269}
270
271static void devm_regulator_destroy_supply_alias(struct device *dev, void *res)
272{
273 struct regulator_supply_alias_match *match = res;
274
275 regulator_unregister_supply_alias(match->dev, match->id);
276}
277
278/**
279 * devm_regulator_register_supply_alias - Resource managed
280 * regulator_register_supply_alias()
281 *
282 * @dev: device that will be given as the regulator "consumer"
283 * @id: Supply name or regulator ID
284 * @alias_dev: device that should be used to lookup the supply
285 * @alias_id: Supply name or regulator ID that should be used to lookup the
286 * supply
287 *
288 * The supply alias will automatically be unregistered when the source
289 * device is unbound.
290 */
291int devm_regulator_register_supply_alias(struct device *dev, const char *id,
292 struct device *alias_dev,
293 const char *alias_id)
294{
295 struct regulator_supply_alias_match *match;
296 int ret;
297
298 match = devres_alloc(devm_regulator_destroy_supply_alias,
299 sizeof(struct regulator_supply_alias_match),
300 GFP_KERNEL);
301 if (!match)
302 return -ENOMEM;
303
304 match->dev = dev;
305 match->id = id;
306
307 ret = regulator_register_supply_alias(dev, id, alias_dev, alias_id);
308 if (ret < 0) {
309 devres_free(match);
310 return ret;
311 }
312
313 devres_add(dev, match);
314
315 return 0;
316}
317EXPORT_SYMBOL_GPL(devm_regulator_register_supply_alias);
318
319/**
320 * devm_regulator_unregister_supply_alias - Resource managed
321 * regulator_unregister_supply_alias()
322 *
323 * @dev: device that will be given as the regulator "consumer"
324 * @id: Supply name or regulator ID
325 *
326 * Unregister an alias registered with
327 * devm_regulator_register_supply_alias(). Normally this function
328 * will not need to be called and the resource management code
329 * will ensure that the resource is freed.
330 */
331void devm_regulator_unregister_supply_alias(struct device *dev, const char *id)
332{
333 struct regulator_supply_alias_match match;
334 int rc;
335
336 match.dev = dev;
337 match.id = id;
338
339 rc = devres_release(dev, devm_regulator_destroy_supply_alias,
340 devm_regulator_match_supply_alias, &match);
341 if (rc != 0)
342 WARN_ON(rc);
343}
344EXPORT_SYMBOL_GPL(devm_regulator_unregister_supply_alias);
345
346/**
347 * devm_regulator_bulk_register_supply_alias - Managed register
348 * multiple aliases
349 *
350 * @dev: device that will be given as the regulator "consumer"
351 * @id: List of supply names or regulator IDs
352 * @alias_dev: device that should be used to lookup the supply
353 * @alias_id: List of supply names or regulator IDs that should be used to
354 * lookup the supply
355 * @num_id: Number of aliases to register
356 *
357 * @return 0 on success, an errno on failure.
358 *
359 * This helper function allows drivers to register several supply
360 * aliases in one operation, the aliases will be automatically
361 * unregisters when the source device is unbound. If any of the
362 * aliases cannot be registered any aliases that were registered
363 * will be removed before returning to the caller.
364 */
365int devm_regulator_bulk_register_supply_alias(struct device *dev,
366 const char *const *id,
367 struct device *alias_dev,
368 const char *const *alias_id,
369 int num_id)
370{
371 int i;
372 int ret;
373
374 for (i = 0; i < num_id; ++i) {
375 ret = devm_regulator_register_supply_alias(dev, id[i],
376 alias_dev,
377 alias_id[i]);
378 if (ret < 0)
379 goto err;
380 }
381
382 return 0;
383
384err:
385 dev_err(dev,
386 "Failed to create supply alias %s,%s -> %s,%s\n",
387 id[i], dev_name(dev), alias_id[i], dev_name(alias_dev));
388
389 while (--i >= 0)
390 devm_regulator_unregister_supply_alias(dev, id[i]);
391
392 return ret;
393}
394EXPORT_SYMBOL_GPL(devm_regulator_bulk_register_supply_alias);
395
396/**
397 * devm_regulator_bulk_unregister_supply_alias - Managed unregister
398 * multiple aliases
399 *
400 * @dev: device that will be given as the regulator "consumer"
401 * @id: List of supply names or regulator IDs
402 * @num_id: Number of aliases to unregister
403 *
404 * Unregister aliases registered with
405 * devm_regulator_bulk_register_supply_alias(). Normally this function
406 * will not need to be called and the resource management code
407 * will ensure that the resource is freed.
408 */
409void devm_regulator_bulk_unregister_supply_alias(struct device *dev,
410 const char *const *id,
411 int num_id)
412{
413 int i;
414
415 for (i = 0; i < num_id; ++i)
416 devm_regulator_unregister_supply_alias(dev, id[i]);
417}
418EXPORT_SYMBOL_GPL(devm_regulator_bulk_unregister_supply_alias);
419
420struct regulator_notifier_match {
421 struct regulator *regulator;
422 struct notifier_block *nb;
423};
424
425static int devm_regulator_match_notifier(struct device *dev, void *res,
426 void *data)
427{
428 struct regulator_notifier_match *match = res;
429 struct regulator_notifier_match *target = data;
430
431 return match->regulator == target->regulator && match->nb == target->nb;
432}
433
434static void devm_regulator_destroy_notifier(struct device *dev, void *res)
435{
436 struct regulator_notifier_match *match = res;
437
438 regulator_unregister_notifier(match->regulator, match->nb);
439}
440
441/**
442 * devm_regulator_register_notifier - Resource managed
443 * regulator_register_notifier
444 *
445 * @regulator: regulator source
446 * @nb: notifier block
447 *
448 * The notifier will be registers under the consumer device and be
449 * automatically be unregistered when the source device is unbound.
450 */
451int devm_regulator_register_notifier(struct regulator *regulator,
452 struct notifier_block *nb)
453{
454 struct regulator_notifier_match *match;
455 int ret;
456
457 match = devres_alloc(devm_regulator_destroy_notifier,
458 sizeof(struct regulator_notifier_match),
459 GFP_KERNEL);
460 if (!match)
461 return -ENOMEM;
462
463 match->regulator = regulator;
464 match->nb = nb;
465
466 ret = regulator_register_notifier(regulator, nb);
467 if (ret < 0) {
468 devres_free(match);
469 return ret;
470 }
471
472 devres_add(regulator->dev, match);
473
474 return 0;
475}
476EXPORT_SYMBOL_GPL(devm_regulator_register_notifier);
477
478/**
479 * devm_regulator_unregister_notifier - Resource managed
480 * regulator_unregister_notifier()
481 *
482 * @regulator: regulator source
483 * @nb: notifier block
484 *
485 * Unregister a notifier registered with devm_regulator_register_notifier().
486 * Normally this function will not need to be called and the resource
487 * management code will ensure that the resource is freed.
488 */
489void devm_regulator_unregister_notifier(struct regulator *regulator,
490 struct notifier_block *nb)
491{
492 struct regulator_notifier_match match;
493 int rc;
494
495 match.regulator = regulator;
496 match.nb = nb;
497
498 rc = devres_release(regulator->dev, devm_regulator_destroy_notifier,
499 devm_regulator_match_notifier, &match);
500 if (rc != 0)
501 WARN_ON(rc);
502}
503EXPORT_SYMBOL_GPL(devm_regulator_unregister_notifier);
1/*
2 * devres.c -- Voltage/Current Regulator framework devres implementation.
3 *
4 * Copyright 2013 Linaro Ltd
5 *
6 * This program is free software; you can redistribute it and/or modify it
7 * under the terms of the GNU General Public License as published by the
8 * Free Software Foundation; either version 2 of the License, or (at your
9 * option) any later version.
10 *
11 */
12
13#include <linux/kernel.h>
14#include <linux/err.h>
15#include <linux/regmap.h>
16#include <linux/regulator/consumer.h>
17#include <linux/regulator/driver.h>
18#include <linux/module.h>
19
20#include "internal.h"
21
22static void devm_regulator_release(struct device *dev, void *res)
23{
24 regulator_put(*(struct regulator **)res);
25}
26
27static struct regulator *_devm_regulator_get(struct device *dev, const char *id,
28 int get_type)
29{
30 struct regulator **ptr, *regulator;
31
32 ptr = devres_alloc(devm_regulator_release, sizeof(*ptr), GFP_KERNEL);
33 if (!ptr)
34 return ERR_PTR(-ENOMEM);
35
36 regulator = _regulator_get(dev, id, get_type);
37 if (!IS_ERR(regulator)) {
38 *ptr = regulator;
39 devres_add(dev, ptr);
40 } else {
41 devres_free(ptr);
42 }
43
44 return regulator;
45}
46
47/**
48 * devm_regulator_get - Resource managed regulator_get()
49 * @dev: device for regulator "consumer"
50 * @id: Supply name or regulator ID.
51 *
52 * Managed regulator_get(). Regulators returned from this function are
53 * automatically regulator_put() on driver detach. See regulator_get() for more
54 * information.
55 */
56struct regulator *devm_regulator_get(struct device *dev, const char *id)
57{
58 return _devm_regulator_get(dev, id, NORMAL_GET);
59}
60EXPORT_SYMBOL_GPL(devm_regulator_get);
61
62/**
63 * devm_regulator_get_exclusive - Resource managed regulator_get_exclusive()
64 * @dev: device for regulator "consumer"
65 * @id: Supply name or regulator ID.
66 *
67 * Managed regulator_get_exclusive(). Regulators returned from this function
68 * are automatically regulator_put() on driver detach. See regulator_get() for
69 * more information.
70 */
71struct regulator *devm_regulator_get_exclusive(struct device *dev,
72 const char *id)
73{
74 return _devm_regulator_get(dev, id, EXCLUSIVE_GET);
75}
76EXPORT_SYMBOL_GPL(devm_regulator_get_exclusive);
77
78/**
79 * devm_regulator_get_optional - Resource managed regulator_get_optional()
80 * @dev: device for regulator "consumer"
81 * @id: Supply name or regulator ID.
82 *
83 * Managed regulator_get_optional(). Regulators returned from this
84 * function are automatically regulator_put() on driver detach. See
85 * regulator_get_optional() for more information.
86 */
87struct regulator *devm_regulator_get_optional(struct device *dev,
88 const char *id)
89{
90 return _devm_regulator_get(dev, id, OPTIONAL_GET);
91}
92EXPORT_SYMBOL_GPL(devm_regulator_get_optional);
93
94static int devm_regulator_match(struct device *dev, void *res, void *data)
95{
96 struct regulator **r = res;
97 if (!r || !*r) {
98 WARN_ON(!r || !*r);
99 return 0;
100 }
101 return *r == data;
102}
103
104/**
105 * devm_regulator_put - Resource managed regulator_put()
106 * @regulator: regulator to free
107 *
108 * Deallocate a regulator allocated with devm_regulator_get(). Normally
109 * this function will not need to be called and the resource management
110 * code will ensure that the resource is freed.
111 */
112void devm_regulator_put(struct regulator *regulator)
113{
114 int rc;
115
116 rc = devres_release(regulator->dev, devm_regulator_release,
117 devm_regulator_match, regulator);
118 if (rc != 0)
119 WARN_ON(rc);
120}
121EXPORT_SYMBOL_GPL(devm_regulator_put);
122
123struct regulator_bulk_devres {
124 struct regulator_bulk_data *consumers;
125 int num_consumers;
126};
127
128static void devm_regulator_bulk_release(struct device *dev, void *res)
129{
130 struct regulator_bulk_devres *devres = res;
131
132 regulator_bulk_free(devres->num_consumers, devres->consumers);
133}
134
135/**
136 * devm_regulator_bulk_get - managed get multiple regulator consumers
137 *
138 * @dev: Device to supply
139 * @num_consumers: Number of consumers to register
140 * @consumers: Configuration of consumers; clients are stored here.
141 *
142 * @return 0 on success, an errno on failure.
143 *
144 * This helper function allows drivers to get several regulator
145 * consumers in one operation with management, the regulators will
146 * automatically be freed when the device is unbound. If any of the
147 * regulators cannot be acquired then any regulators that were
148 * allocated will be freed before returning to the caller.
149 */
150int devm_regulator_bulk_get(struct device *dev, int num_consumers,
151 struct regulator_bulk_data *consumers)
152{
153 struct regulator_bulk_devres *devres;
154 int ret;
155
156 devres = devres_alloc(devm_regulator_bulk_release,
157 sizeof(*devres), GFP_KERNEL);
158 if (!devres)
159 return -ENOMEM;
160
161 ret = regulator_bulk_get(dev, num_consumers, consumers);
162 if (!ret) {
163 devres->consumers = consumers;
164 devres->num_consumers = num_consumers;
165 devres_add(dev, devres);
166 } else {
167 devres_free(devres);
168 }
169
170 return ret;
171}
172EXPORT_SYMBOL_GPL(devm_regulator_bulk_get);
173
174static void devm_rdev_release(struct device *dev, void *res)
175{
176 regulator_unregister(*(struct regulator_dev **)res);
177}
178
179/**
180 * devm_regulator_register - Resource managed regulator_register()
181 * @regulator_desc: regulator to register
182 * @config: runtime configuration for regulator
183 *
184 * Called by regulator drivers to register a regulator. Returns a
185 * valid pointer to struct regulator_dev on success or an ERR_PTR() on
186 * error. The regulator will automatically be released when the device
187 * is unbound.
188 */
189struct regulator_dev *devm_regulator_register(struct device *dev,
190 const struct regulator_desc *regulator_desc,
191 const struct regulator_config *config)
192{
193 struct regulator_dev **ptr, *rdev;
194
195 ptr = devres_alloc(devm_rdev_release, sizeof(*ptr),
196 GFP_KERNEL);
197 if (!ptr)
198 return ERR_PTR(-ENOMEM);
199
200 rdev = regulator_register(regulator_desc, config);
201 if (!IS_ERR(rdev)) {
202 *ptr = rdev;
203 devres_add(dev, ptr);
204 } else {
205 devres_free(ptr);
206 }
207
208 return rdev;
209}
210EXPORT_SYMBOL_GPL(devm_regulator_register);
211
212static int devm_rdev_match(struct device *dev, void *res, void *data)
213{
214 struct regulator_dev **r = res;
215 if (!r || !*r) {
216 WARN_ON(!r || !*r);
217 return 0;
218 }
219 return *r == data;
220}
221
222/**
223 * devm_regulator_unregister - Resource managed regulator_unregister()
224 * @regulator: regulator to free
225 *
226 * Unregister a regulator registered with devm_regulator_register().
227 * Normally this function will not need to be called and the resource
228 * management code will ensure that the resource is freed.
229 */
230void devm_regulator_unregister(struct device *dev, struct regulator_dev *rdev)
231{
232 int rc;
233
234 rc = devres_release(dev, devm_rdev_release, devm_rdev_match, rdev);
235 if (rc != 0)
236 WARN_ON(rc);
237}
238EXPORT_SYMBOL_GPL(devm_regulator_unregister);
239
240struct regulator_supply_alias_match {
241 struct device *dev;
242 const char *id;
243};
244
245static int devm_regulator_match_supply_alias(struct device *dev, void *res,
246 void *data)
247{
248 struct regulator_supply_alias_match *match = res;
249 struct regulator_supply_alias_match *target = data;
250
251 return match->dev == target->dev && strcmp(match->id, target->id) == 0;
252}
253
254static void devm_regulator_destroy_supply_alias(struct device *dev, void *res)
255{
256 struct regulator_supply_alias_match *match = res;
257
258 regulator_unregister_supply_alias(match->dev, match->id);
259}
260
261/**
262 * devm_regulator_register_supply_alias - Resource managed
263 * regulator_register_supply_alias()
264 *
265 * @dev: device that will be given as the regulator "consumer"
266 * @id: Supply name or regulator ID
267 * @alias_dev: device that should be used to lookup the supply
268 * @alias_id: Supply name or regulator ID that should be used to lookup the
269 * supply
270 *
271 * The supply alias will automatically be unregistered when the source
272 * device is unbound.
273 */
274int devm_regulator_register_supply_alias(struct device *dev, const char *id,
275 struct device *alias_dev,
276 const char *alias_id)
277{
278 struct regulator_supply_alias_match *match;
279 int ret;
280
281 match = devres_alloc(devm_regulator_destroy_supply_alias,
282 sizeof(struct regulator_supply_alias_match),
283 GFP_KERNEL);
284 if (!match)
285 return -ENOMEM;
286
287 match->dev = dev;
288 match->id = id;
289
290 ret = regulator_register_supply_alias(dev, id, alias_dev, alias_id);
291 if (ret < 0) {
292 devres_free(match);
293 return ret;
294 }
295
296 devres_add(dev, match);
297
298 return 0;
299}
300EXPORT_SYMBOL_GPL(devm_regulator_register_supply_alias);
301
302/**
303 * devm_regulator_unregister_supply_alias - Resource managed
304 * regulator_unregister_supply_alias()
305 *
306 * @dev: device that will be given as the regulator "consumer"
307 * @id: Supply name or regulator ID
308 *
309 * Unregister an alias registered with
310 * devm_regulator_register_supply_alias(). Normally this function
311 * will not need to be called and the resource management code
312 * will ensure that the resource is freed.
313 */
314void devm_regulator_unregister_supply_alias(struct device *dev, const char *id)
315{
316 struct regulator_supply_alias_match match;
317 int rc;
318
319 match.dev = dev;
320 match.id = id;
321
322 rc = devres_release(dev, devm_regulator_destroy_supply_alias,
323 devm_regulator_match_supply_alias, &match);
324 if (rc != 0)
325 WARN_ON(rc);
326}
327EXPORT_SYMBOL_GPL(devm_regulator_unregister_supply_alias);
328
329/**
330 * devm_regulator_bulk_register_supply_alias - Managed register
331 * multiple aliases
332 *
333 * @dev: device that will be given as the regulator "consumer"
334 * @id: List of supply names or regulator IDs
335 * @alias_dev: device that should be used to lookup the supply
336 * @alias_id: List of supply names or regulator IDs that should be used to
337 * lookup the supply
338 * @num_id: Number of aliases to register
339 *
340 * @return 0 on success, an errno on failure.
341 *
342 * This helper function allows drivers to register several supply
343 * aliases in one operation, the aliases will be automatically
344 * unregisters when the source device is unbound. If any of the
345 * aliases cannot be registered any aliases that were registered
346 * will be removed before returning to the caller.
347 */
348int devm_regulator_bulk_register_supply_alias(struct device *dev,
349 const char *const *id,
350 struct device *alias_dev,
351 const char *const *alias_id,
352 int num_id)
353{
354 int i;
355 int ret;
356
357 for (i = 0; i < num_id; ++i) {
358 ret = devm_regulator_register_supply_alias(dev, id[i],
359 alias_dev,
360 alias_id[i]);
361 if (ret < 0)
362 goto err;
363 }
364
365 return 0;
366
367err:
368 dev_err(dev,
369 "Failed to create supply alias %s,%s -> %s,%s\n",
370 id[i], dev_name(dev), alias_id[i], dev_name(alias_dev));
371
372 while (--i >= 0)
373 devm_regulator_unregister_supply_alias(dev, id[i]);
374
375 return ret;
376}
377EXPORT_SYMBOL_GPL(devm_regulator_bulk_register_supply_alias);
378
379/**
380 * devm_regulator_bulk_unregister_supply_alias - Managed unregister
381 * multiple aliases
382 *
383 * @dev: device that will be given as the regulator "consumer"
384 * @id: List of supply names or regulator IDs
385 * @num_id: Number of aliases to unregister
386 *
387 * Unregister aliases registered with
388 * devm_regulator_bulk_register_supply_alias(). Normally this function
389 * will not need to be called and the resource management code
390 * will ensure that the resource is freed.
391 */
392void devm_regulator_bulk_unregister_supply_alias(struct device *dev,
393 const char *const *id,
394 int num_id)
395{
396 int i;
397
398 for (i = 0; i < num_id; ++i)
399 devm_regulator_unregister_supply_alias(dev, id[i]);
400}
401EXPORT_SYMBOL_GPL(devm_regulator_bulk_unregister_supply_alias);
402
403struct regulator_notifier_match {
404 struct regulator *regulator;
405 struct notifier_block *nb;
406};
407
408static int devm_regulator_match_notifier(struct device *dev, void *res,
409 void *data)
410{
411 struct regulator_notifier_match *match = res;
412 struct regulator_notifier_match *target = data;
413
414 return match->regulator == target->regulator && match->nb == target->nb;
415}
416
417static void devm_regulator_destroy_notifier(struct device *dev, void *res)
418{
419 struct regulator_notifier_match *match = res;
420
421 regulator_unregister_notifier(match->regulator, match->nb);
422}
423
424/**
425 * devm_regulator_register_notifier - Resource managed
426 * regulator_register_notifier
427 *
428 * @regulator: regulator source
429 * @nb: notifier block
430 *
431 * The notifier will be registers under the consumer device and be
432 * automatically be unregistered when the source device is unbound.
433 */
434int devm_regulator_register_notifier(struct regulator *regulator,
435 struct notifier_block *nb)
436{
437 struct regulator_notifier_match *match;
438 int ret;
439
440 match = devres_alloc(devm_regulator_destroy_notifier,
441 sizeof(struct regulator_notifier_match),
442 GFP_KERNEL);
443 if (!match)
444 return -ENOMEM;
445
446 match->regulator = regulator;
447 match->nb = nb;
448
449 ret = regulator_register_notifier(regulator, nb);
450 if (ret < 0) {
451 devres_free(match);
452 return ret;
453 }
454
455 devres_add(regulator->dev, match);
456
457 return 0;
458}
459EXPORT_SYMBOL_GPL(devm_regulator_register_notifier);
460
461/**
462 * devm_regulator_unregister_notifier - Resource managed
463 * regulator_unregister_notifier()
464 *
465 * @regulator: regulator source
466 * @nb: notifier block
467 *
468 * Unregister a notifier registered with devm_regulator_register_notifier().
469 * Normally this function will not need to be called and the resource
470 * management code will ensure that the resource is freed.
471 */
472void devm_regulator_unregister_notifier(struct regulator *regulator,
473 struct notifier_block *nb)
474{
475 struct regulator_notifier_match match;
476 int rc;
477
478 match.regulator = regulator;
479 match.nb = nb;
480
481 rc = devres_release(regulator->dev, devm_regulator_destroy_notifier,
482 devm_regulator_match_notifier, &match);
483 if (rc != 0)
484 WARN_ON(rc);
485}
486EXPORT_SYMBOL_GPL(devm_regulator_unregister_notifier);