Merge remote-tracking branch 'spi/fix/s3c64xx' into spi-linus
[deliverable/linux.git] / drivers / pwm / core.c
CommitLineData
0c2498f1
SH
1/*
2 * Generic pwmlib implementation
3 *
4 * Copyright (C) 2011 Sascha Hauer <s.hauer@pengutronix.de>
f051c466 5 * Copyright (C) 2011-2012 Avionic Design GmbH
0c2498f1
SH
6 *
7 * This program is free software; you can redistribute it and/or modify
8 * it under the terms of the GNU General Public License as published by
9 * the Free Software Foundation; either version 2, or (at your option)
10 * any later version.
11 *
12 * This program is distributed in the hope that it will be useful,
13 * but WITHOUT ANY WARRANTY; without even the implied warranty of
14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 * GNU General Public License for more details.
16 *
17 * You should have received a copy of the GNU General Public License
18 * along with this program; see the file COPYING. If not, write to
19 * the Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA.
20 */
21
22#include <linux/module.h>
23#include <linux/pwm.h>
f051c466 24#include <linux/radix-tree.h>
0c2498f1
SH
25#include <linux/list.h>
26#include <linux/mutex.h>
27#include <linux/err.h>
28#include <linux/slab.h>
29#include <linux/device.h>
62099abf
TR
30#include <linux/debugfs.h>
31#include <linux/seq_file.h>
0c2498f1 32
f051c466 33#define MAX_PWMS 1024
0c2498f1 34
83af2402
PA
35/* flags in the third cell of the DT PWM specifier */
36#define PWM_SPEC_POLARITY (1 << 0)
37
8138d2dd
TR
38static DEFINE_MUTEX(pwm_lookup_lock);
39static LIST_HEAD(pwm_lookup_list);
0c2498f1 40static DEFINE_MUTEX(pwm_lock);
f051c466
TR
41static LIST_HEAD(pwm_chips);
42static DECLARE_BITMAP(allocated_pwms, MAX_PWMS);
43static RADIX_TREE(pwm_tree, GFP_KERNEL);
0c2498f1 44
f051c466 45static struct pwm_device *pwm_to_device(unsigned int pwm)
0c2498f1 46{
f051c466
TR
47 return radix_tree_lookup(&pwm_tree, pwm);
48}
49
50static int alloc_pwms(int pwm, unsigned int count)
51{
52 unsigned int from = 0;
53 unsigned int start;
54
55 if (pwm >= MAX_PWMS)
56 return -EINVAL;
57
58 if (pwm >= 0)
59 from = pwm;
0c2498f1 60
f051c466
TR
61 start = bitmap_find_next_zero_area(allocated_pwms, MAX_PWMS, from,
62 count, 0);
63
64 if (pwm >= 0 && start != pwm)
65 return -EEXIST;
66
67 if (start + count > MAX_PWMS)
68 return -ENOSPC;
69
70 return start;
71}
72
73static void free_pwms(struct pwm_chip *chip)
74{
75 unsigned int i;
76
77 for (i = 0; i < chip->npwm; i++) {
78 struct pwm_device *pwm = &chip->pwms[i];
79 radix_tree_delete(&pwm_tree, pwm->pwm);
0c2498f1
SH
80 }
81
f051c466
TR
82 bitmap_clear(allocated_pwms, chip->base, chip->npwm);
83
84 kfree(chip->pwms);
85 chip->pwms = NULL;
86}
87
8138d2dd
TR
88static struct pwm_chip *pwmchip_find_by_name(const char *name)
89{
90 struct pwm_chip *chip;
91
92 if (!name)
93 return NULL;
94
95 mutex_lock(&pwm_lock);
96
97 list_for_each_entry(chip, &pwm_chips, list) {
98 const char *chip_name = dev_name(chip->dev);
99
100 if (chip_name && strcmp(chip_name, name) == 0) {
101 mutex_unlock(&pwm_lock);
102 return chip;
103 }
104 }
105
106 mutex_unlock(&pwm_lock);
107
108 return NULL;
109}
110
f051c466
TR
111static int pwm_device_request(struct pwm_device *pwm, const char *label)
112{
113 int err;
114
115 if (test_bit(PWMF_REQUESTED, &pwm->flags))
116 return -EBUSY;
117
118 if (!try_module_get(pwm->chip->ops->owner))
119 return -ENODEV;
120
121 if (pwm->chip->ops->request) {
122 err = pwm->chip->ops->request(pwm->chip, pwm);
123 if (err) {
124 module_put(pwm->chip->ops->owner);
125 return err;
126 }
127 }
128
129 set_bit(PWMF_REQUESTED, &pwm->flags);
130 pwm->label = label;
131
132 return 0;
133}
134
83af2402
PA
135struct pwm_device *
136of_pwm_xlate_with_flags(struct pwm_chip *pc, const struct of_phandle_args *args)
137{
138 struct pwm_device *pwm;
139
140 if (pc->of_pwm_n_cells < 3)
141 return ERR_PTR(-EINVAL);
142
143 if (args->args[0] >= pc->npwm)
144 return ERR_PTR(-EINVAL);
145
146 pwm = pwm_request_from_chip(pc, args->args[0], NULL);
147 if (IS_ERR(pwm))
148 return pwm;
149
150 pwm_set_period(pwm, args->args[1]);
151
152 if (args->args[2] & PWM_SPEC_POLARITY)
153 pwm_set_polarity(pwm, PWM_POLARITY_INVERSED);
154 else
155 pwm_set_polarity(pwm, PWM_POLARITY_NORMAL);
156
157 return pwm;
158}
417328c3 159EXPORT_SYMBOL_GPL(of_pwm_xlate_with_flags);
83af2402 160
e50d3523
SK
161static struct pwm_device *
162of_pwm_simple_xlate(struct pwm_chip *pc, const struct of_phandle_args *args)
7299ab70
TR
163{
164 struct pwm_device *pwm;
165
166 if (pc->of_pwm_n_cells < 2)
167 return ERR_PTR(-EINVAL);
168
169 if (args->args[0] >= pc->npwm)
170 return ERR_PTR(-EINVAL);
171
172 pwm = pwm_request_from_chip(pc, args->args[0], NULL);
173 if (IS_ERR(pwm))
174 return pwm;
175
176 pwm_set_period(pwm, args->args[1]);
177
178 return pwm;
179}
180
dfeb86ec 181static void of_pwmchip_add(struct pwm_chip *chip)
7299ab70
TR
182{
183 if (!chip->dev || !chip->dev->of_node)
184 return;
185
186 if (!chip->of_xlate) {
187 chip->of_xlate = of_pwm_simple_xlate;
188 chip->of_pwm_n_cells = 2;
189 }
190
191 of_node_get(chip->dev->of_node);
192}
193
dfeb86ec 194static void of_pwmchip_remove(struct pwm_chip *chip)
7299ab70
TR
195{
196 if (chip->dev && chip->dev->of_node)
197 of_node_put(chip->dev->of_node);
198}
199
f051c466
TR
200/**
201 * pwm_set_chip_data() - set private chip data for a PWM
202 * @pwm: PWM device
203 * @data: pointer to chip-specific data
204 */
205int pwm_set_chip_data(struct pwm_device *pwm, void *data)
206{
207 if (!pwm)
208 return -EINVAL;
209
210 pwm->chip_data = data;
211
212 return 0;
213}
928c4477 214EXPORT_SYMBOL_GPL(pwm_set_chip_data);
f051c466
TR
215
216/**
217 * pwm_get_chip_data() - get private chip data for a PWM
218 * @pwm: PWM device
219 */
220void *pwm_get_chip_data(struct pwm_device *pwm)
221{
222 return pwm ? pwm->chip_data : NULL;
0c2498f1 223}
928c4477 224EXPORT_SYMBOL_GPL(pwm_get_chip_data);
0c2498f1
SH
225
226/**
227 * pwmchip_add() - register a new PWM chip
228 * @chip: the PWM chip to add
f051c466
TR
229 *
230 * Register a new PWM chip. If chip->base < 0 then a dynamically assigned base
231 * will be used.
0c2498f1
SH
232 */
233int pwmchip_add(struct pwm_chip *chip)
234{
235 struct pwm_device *pwm;
f051c466
TR
236 unsigned int i;
237 int ret;
0c2498f1 238
f051c466
TR
239 if (!chip || !chip->dev || !chip->ops || !chip->ops->config ||
240 !chip->ops->enable || !chip->ops->disable)
241 return -EINVAL;
0c2498f1
SH
242
243 mutex_lock(&pwm_lock);
244
f051c466
TR
245 ret = alloc_pwms(chip->base, chip->npwm);
246 if (ret < 0)
247 goto out;
248
249 chip->pwms = kzalloc(chip->npwm * sizeof(*pwm), GFP_KERNEL);
250 if (!chip->pwms) {
251 ret = -ENOMEM;
0c2498f1
SH
252 goto out;
253 }
254
f051c466
TR
255 chip->base = ret;
256
257 for (i = 0; i < chip->npwm; i++) {
258 pwm = &chip->pwms[i];
259
260 pwm->chip = chip;
261 pwm->pwm = chip->base + i;
262 pwm->hwpwm = i;
0c2498f1 263
f051c466
TR
264 radix_tree_insert(&pwm_tree, pwm->pwm, pwm);
265 }
266
267 bitmap_set(allocated_pwms, chip->base, chip->npwm);
268
269 INIT_LIST_HEAD(&chip->list);
270 list_add(&chip->list, &pwm_chips);
0c2498f1 271
f051c466
TR
272 ret = 0;
273
7299ab70
TR
274 if (IS_ENABLED(CONFIG_OF))
275 of_pwmchip_add(chip);
276
76abbdde
HS
277 pwmchip_sysfs_export(chip);
278
f051c466
TR
279out:
280 mutex_unlock(&pwm_lock);
0c2498f1
SH
281 return ret;
282}
283EXPORT_SYMBOL_GPL(pwmchip_add);
284
285/**
286 * pwmchip_remove() - remove a PWM chip
287 * @chip: the PWM chip to remove
288 *
289 * Removes a PWM chip. This function may return busy if the PWM chip provides
290 * a PWM device that is still requested.
291 */
292int pwmchip_remove(struct pwm_chip *chip)
293{
f051c466 294 unsigned int i;
0c2498f1
SH
295 int ret = 0;
296
297 mutex_lock(&pwm_lock);
298
f051c466
TR
299 for (i = 0; i < chip->npwm; i++) {
300 struct pwm_device *pwm = &chip->pwms[i];
0c2498f1 301
f051c466
TR
302 if (test_bit(PWMF_REQUESTED, &pwm->flags)) {
303 ret = -EBUSY;
304 goto out;
305 }
0c2498f1
SH
306 }
307
f051c466 308 list_del_init(&chip->list);
7299ab70
TR
309
310 if (IS_ENABLED(CONFIG_OF))
311 of_pwmchip_remove(chip);
312
f051c466 313 free_pwms(chip);
0c2498f1 314
76abbdde
HS
315 pwmchip_sysfs_unexport(chip);
316
0c2498f1
SH
317out:
318 mutex_unlock(&pwm_lock);
0c2498f1
SH
319 return ret;
320}
321EXPORT_SYMBOL_GPL(pwmchip_remove);
322
323/**
324 * pwm_request() - request a PWM device
325 * @pwm_id: global PWM device index
326 * @label: PWM device label
8138d2dd
TR
327 *
328 * This function is deprecated, use pwm_get() instead.
0c2498f1 329 */
f051c466 330struct pwm_device *pwm_request(int pwm, const char *label)
0c2498f1 331{
f051c466
TR
332 struct pwm_device *dev;
333 int err;
334
335 if (pwm < 0 || pwm >= MAX_PWMS)
336 return ERR_PTR(-EINVAL);
0c2498f1
SH
337
338 mutex_lock(&pwm_lock);
339
f051c466
TR
340 dev = pwm_to_device(pwm);
341 if (!dev) {
342 dev = ERR_PTR(-EPROBE_DEFER);
0c2498f1
SH
343 goto out;
344 }
345
f051c466
TR
346 err = pwm_device_request(dev, label);
347 if (err < 0)
348 dev = ERR_PTR(err);
0c2498f1 349
f051c466
TR
350out:
351 mutex_unlock(&pwm_lock);
0c2498f1 352
f051c466
TR
353 return dev;
354}
355EXPORT_SYMBOL_GPL(pwm_request);
0c2498f1 356
f051c466
TR
357/**
358 * pwm_request_from_chip() - request a PWM device relative to a PWM chip
359 * @chip: PWM chip
360 * @index: per-chip index of the PWM to request
361 * @label: a literal description string of this PWM
362 *
363 * Returns the PWM at the given index of the given PWM chip. A negative error
364 * code is returned if the index is not valid for the specified PWM chip or
365 * if the PWM device cannot be requested.
366 */
367struct pwm_device *pwm_request_from_chip(struct pwm_chip *chip,
368 unsigned int index,
369 const char *label)
370{
371 struct pwm_device *pwm;
372 int err;
0c2498f1 373
f051c466
TR
374 if (!chip || index >= chip->npwm)
375 return ERR_PTR(-EINVAL);
0c2498f1 376
f051c466
TR
377 mutex_lock(&pwm_lock);
378 pwm = &chip->pwms[index];
0c2498f1 379
f051c466
TR
380 err = pwm_device_request(pwm, label);
381 if (err < 0)
382 pwm = ERR_PTR(err);
383
384 mutex_unlock(&pwm_lock);
0c2498f1
SH
385 return pwm;
386}
f051c466 387EXPORT_SYMBOL_GPL(pwm_request_from_chip);
0c2498f1
SH
388
389/**
390 * pwm_free() - free a PWM device
391 * @pwm: PWM device
8138d2dd
TR
392 *
393 * This function is deprecated, use pwm_put() instead.
0c2498f1
SH
394 */
395void pwm_free(struct pwm_device *pwm)
396{
8138d2dd 397 pwm_put(pwm);
0c2498f1
SH
398}
399EXPORT_SYMBOL_GPL(pwm_free);
400
401/**
402 * pwm_config() - change a PWM device configuration
403 * @pwm: PWM device
404 * @duty_ns: "on" time (in nanoseconds)
405 * @period_ns: duration (in nanoseconds) of one cycle
406 */
407int pwm_config(struct pwm_device *pwm, int duty_ns, int period_ns)
408{
76abbdde
HS
409 int err;
410
c2d476a9 411 if (!pwm || duty_ns < 0 || period_ns <= 0 || duty_ns > period_ns)
f051c466
TR
412 return -EINVAL;
413
76abbdde
HS
414 err = pwm->chip->ops->config(pwm->chip, pwm, duty_ns, period_ns);
415 if (err)
416 return err;
417
418 pwm->duty_cycle = duty_ns;
419 pwm->period = period_ns;
420
421 return 0;
0c2498f1
SH
422}
423EXPORT_SYMBOL_GPL(pwm_config);
424
0aa0869c
PA
425/**
426 * pwm_set_polarity() - configure the polarity of a PWM signal
427 * @pwm: PWM device
428 * @polarity: new polarity of the PWM signal
429 *
430 * Note that the polarity cannot be configured while the PWM device is enabled
431 */
432int pwm_set_polarity(struct pwm_device *pwm, enum pwm_polarity polarity)
433{
76abbdde
HS
434 int err;
435
0aa0869c
PA
436 if (!pwm || !pwm->chip->ops)
437 return -EINVAL;
438
439 if (!pwm->chip->ops->set_polarity)
440 return -ENOSYS;
441
442 if (test_bit(PWMF_ENABLED, &pwm->flags))
443 return -EBUSY;
444
76abbdde
HS
445 err = pwm->chip->ops->set_polarity(pwm->chip, pwm, polarity);
446 if (err)
447 return err;
448
449 pwm->polarity = polarity;
450
451 return 0;
0aa0869c
PA
452}
453EXPORT_SYMBOL_GPL(pwm_set_polarity);
454
0c2498f1
SH
455/**
456 * pwm_enable() - start a PWM output toggling
457 * @pwm: PWM device
458 */
459int pwm_enable(struct pwm_device *pwm)
460{
f051c466
TR
461 if (pwm && !test_and_set_bit(PWMF_ENABLED, &pwm->flags))
462 return pwm->chip->ops->enable(pwm->chip, pwm);
0c2498f1 463
f051c466 464 return pwm ? 0 : -EINVAL;
0c2498f1
SH
465}
466EXPORT_SYMBOL_GPL(pwm_enable);
467
468/**
469 * pwm_disable() - stop a PWM output toggling
470 * @pwm: PWM device
471 */
472void pwm_disable(struct pwm_device *pwm)
473{
f051c466
TR
474 if (pwm && test_and_clear_bit(PWMF_ENABLED, &pwm->flags))
475 pwm->chip->ops->disable(pwm->chip, pwm);
0c2498f1
SH
476}
477EXPORT_SYMBOL_GPL(pwm_disable);
62099abf 478
7299ab70
TR
479static struct pwm_chip *of_node_to_pwmchip(struct device_node *np)
480{
481 struct pwm_chip *chip;
482
483 mutex_lock(&pwm_lock);
484
485 list_for_each_entry(chip, &pwm_chips, list)
486 if (chip->dev && chip->dev->of_node == np) {
487 mutex_unlock(&pwm_lock);
488 return chip;
489 }
490
491 mutex_unlock(&pwm_lock);
492
493 return ERR_PTR(-EPROBE_DEFER);
494}
495
496/**
8eb96127 497 * of_pwm_get() - request a PWM via the PWM framework
7299ab70
TR
498 * @np: device node to get the PWM from
499 * @con_id: consumer name
500 *
501 * Returns the PWM device parsed from the phandle and index specified in the
502 * "pwms" property of a device tree node or a negative error-code on failure.
503 * Values parsed from the device tree are stored in the returned PWM device
504 * object.
505 *
506 * If con_id is NULL, the first PWM device listed in the "pwms" property will
507 * be requested. Otherwise the "pwm-names" property is used to do a reverse
508 * lookup of the PWM index. This also means that the "pwm-names" property
509 * becomes mandatory for devices that look up the PWM device via the con_id
510 * parameter.
511 */
8eb96127 512struct pwm_device *of_pwm_get(struct device_node *np, const char *con_id)
7299ab70
TR
513{
514 struct pwm_device *pwm = NULL;
515 struct of_phandle_args args;
516 struct pwm_chip *pc;
517 int index = 0;
518 int err;
519
520 if (con_id) {
521 index = of_property_match_string(np, "pwm-names", con_id);
522 if (index < 0)
523 return ERR_PTR(index);
524 }
525
526 err = of_parse_phandle_with_args(np, "pwms", "#pwm-cells", index,
527 &args);
528 if (err) {
529 pr_debug("%s(): can't parse \"pwms\" property\n", __func__);
530 return ERR_PTR(err);
531 }
532
533 pc = of_node_to_pwmchip(args.np);
534 if (IS_ERR(pc)) {
535 pr_debug("%s(): PWM chip not found\n", __func__);
536 pwm = ERR_CAST(pc);
537 goto put;
538 }
539
540 if (args.args_count != pc->of_pwm_n_cells) {
541 pr_debug("%s: wrong #pwm-cells for %s\n", np->full_name,
542 args.np->full_name);
543 pwm = ERR_PTR(-EINVAL);
544 goto put;
545 }
546
547 pwm = pc->of_xlate(pc, &args);
548 if (IS_ERR(pwm))
549 goto put;
550
551 /*
552 * If a consumer name was not given, try to look it up from the
553 * "pwm-names" property if it exists. Otherwise use the name of
554 * the user device node.
555 */
556 if (!con_id) {
557 err = of_property_read_string_index(np, "pwm-names", index,
558 &con_id);
559 if (err < 0)
560 con_id = np->name;
561 }
562
563 pwm->label = con_id;
564
565put:
566 of_node_put(args.np);
567
568 return pwm;
569}
8eb96127 570EXPORT_SYMBOL_GPL(of_pwm_get);
7299ab70 571
8138d2dd
TR
572/**
573 * pwm_add_table() - register PWM device consumers
574 * @table: array of consumers to register
575 * @num: number of consumers in table
576 */
577void __init pwm_add_table(struct pwm_lookup *table, size_t num)
578{
579 mutex_lock(&pwm_lookup_lock);
580
581 while (num--) {
582 list_add_tail(&table->list, &pwm_lookup_list);
583 table++;
584 }
585
586 mutex_unlock(&pwm_lookup_lock);
587}
588
589/**
590 * pwm_get() - look up and request a PWM device
591 * @dev: device for PWM consumer
592 * @con_id: consumer name
593 *
7299ab70
TR
594 * Lookup is first attempted using DT. If the device was not instantiated from
595 * a device tree, a PWM chip and a relative index is looked up via a table
596 * supplied by board setup code (see pwm_add_table()).
8138d2dd
TR
597 *
598 * Once a PWM chip has been found the specified PWM device will be requested
599 * and is ready to be used.
600 */
601struct pwm_device *pwm_get(struct device *dev, const char *con_id)
602{
603 struct pwm_device *pwm = ERR_PTR(-EPROBE_DEFER);
e50d3523 604 const char *dev_id = dev ? dev_name(dev) : NULL;
8138d2dd 605 struct pwm_chip *chip = NULL;
d295b129 606 unsigned int index = 0;
8138d2dd
TR
607 unsigned int best = 0;
608 struct pwm_lookup *p;
8138d2dd
TR
609 unsigned int match;
610
7299ab70
TR
611 /* look up via DT first */
612 if (IS_ENABLED(CONFIG_OF) && dev && dev->of_node)
8eb96127 613 return of_pwm_get(dev->of_node, con_id);
7299ab70 614
8138d2dd
TR
615 /*
616 * We look up the provider in the static table typically provided by
617 * board setup code. We first try to lookup the consumer device by
618 * name. If the consumer device was passed in as NULL or if no match
619 * was found, we try to find the consumer by directly looking it up
620 * by name.
621 *
622 * If a match is found, the provider PWM chip is looked up by name
623 * and a PWM device is requested using the PWM device per-chip index.
624 *
625 * The lookup algorithm was shamelessly taken from the clock
626 * framework:
627 *
628 * We do slightly fuzzy matching here:
629 * An entry with a NULL ID is assumed to be a wildcard.
630 * If an entry has a device ID, it must match
631 * If an entry has a connection ID, it must match
632 * Then we take the most specific entry - with the following order
633 * of precedence: dev+con > dev only > con only.
634 */
635 mutex_lock(&pwm_lookup_lock);
636
637 list_for_each_entry(p, &pwm_lookup_list, list) {
638 match = 0;
639
640 if (p->dev_id) {
641 if (!dev_id || strcmp(p->dev_id, dev_id))
642 continue;
643
644 match += 2;
645 }
646
647 if (p->con_id) {
648 if (!con_id || strcmp(p->con_id, con_id))
649 continue;
650
651 match += 1;
652 }
653
654 if (match > best) {
655 chip = pwmchip_find_by_name(p->provider);
656 index = p->index;
657
658 if (match != 3)
659 best = match;
660 else
661 break;
662 }
663 }
664
665 if (chip)
666 pwm = pwm_request_from_chip(chip, index, con_id ?: dev_id);
667
668 mutex_unlock(&pwm_lookup_lock);
669
670 return pwm;
671}
672EXPORT_SYMBOL_GPL(pwm_get);
673
674/**
675 * pwm_put() - release a PWM device
676 * @pwm: PWM device
677 */
678void pwm_put(struct pwm_device *pwm)
679{
680 if (!pwm)
681 return;
682
683 mutex_lock(&pwm_lock);
684
685 if (!test_and_clear_bit(PWMF_REQUESTED, &pwm->flags)) {
e50d3523 686 pr_warn("PWM device already freed\n");
8138d2dd
TR
687 goto out;
688 }
689
690 if (pwm->chip->ops->free)
691 pwm->chip->ops->free(pwm->chip, pwm);
692
693 pwm->label = NULL;
694
695 module_put(pwm->chip->ops->owner);
696out:
697 mutex_unlock(&pwm_lock);
698}
699EXPORT_SYMBOL_GPL(pwm_put);
700
6354316d
AC
701static void devm_pwm_release(struct device *dev, void *res)
702{
703 pwm_put(*(struct pwm_device **)res);
704}
705
706/**
707 * devm_pwm_get() - resource managed pwm_get()
708 * @dev: device for PWM consumer
709 * @con_id: consumer name
710 *
711 * This function performs like pwm_get() but the acquired PWM device will
712 * automatically be released on driver detach.
713 */
714struct pwm_device *devm_pwm_get(struct device *dev, const char *con_id)
715{
716 struct pwm_device **ptr, *pwm;
717
77f0b9d2 718 ptr = devres_alloc(devm_pwm_release, sizeof(*ptr), GFP_KERNEL);
6354316d
AC
719 if (!ptr)
720 return ERR_PTR(-ENOMEM);
721
722 pwm = pwm_get(dev, con_id);
723 if (!IS_ERR(pwm)) {
724 *ptr = pwm;
725 devres_add(dev, ptr);
726 } else {
727 devres_free(ptr);
728 }
729
730 return pwm;
731}
732EXPORT_SYMBOL_GPL(devm_pwm_get);
733
261a5edd
PU
734/**
735 * devm_of_pwm_get() - resource managed of_pwm_get()
736 * @dev: device for PWM consumer
737 * @np: device node to get the PWM from
738 * @con_id: consumer name
739 *
740 * This function performs like of_pwm_get() but the acquired PWM device will
741 * automatically be released on driver detach.
742 */
743struct pwm_device *devm_of_pwm_get(struct device *dev, struct device_node *np,
744 const char *con_id)
745{
746 struct pwm_device **ptr, *pwm;
747
77f0b9d2 748 ptr = devres_alloc(devm_pwm_release, sizeof(*ptr), GFP_KERNEL);
261a5edd
PU
749 if (!ptr)
750 return ERR_PTR(-ENOMEM);
751
752 pwm = of_pwm_get(np, con_id);
753 if (!IS_ERR(pwm)) {
754 *ptr = pwm;
755 devres_add(dev, ptr);
756 } else {
757 devres_free(ptr);
758 }
759
760 return pwm;
761}
762EXPORT_SYMBOL_GPL(devm_of_pwm_get);
763
6354316d
AC
764static int devm_pwm_match(struct device *dev, void *res, void *data)
765{
766 struct pwm_device **p = res;
767
768 if (WARN_ON(!p || !*p))
769 return 0;
770
771 return *p == data;
772}
773
774/**
775 * devm_pwm_put() - resource managed pwm_put()
776 * @dev: device for PWM consumer
777 * @pwm: PWM device
778 *
779 * Release a PWM previously allocated using devm_pwm_get(). Calling this
780 * function is usually not needed because devm-allocated resources are
781 * automatically released on driver detach.
782 */
783void devm_pwm_put(struct device *dev, struct pwm_device *pwm)
784{
785 WARN_ON(devres_release(dev, devm_pwm_release, devm_pwm_match, pwm));
786}
787EXPORT_SYMBOL_GPL(devm_pwm_put);
788
6e69ab13
FV
789/**
790 * pwm_can_sleep() - report whether PWM access will sleep
791 * @pwm: PWM device
792 *
793 * It returns true if accessing the PWM can sleep, false otherwise.
794 */
795bool pwm_can_sleep(struct pwm_device *pwm)
796{
797 return pwm->chip->can_sleep;
798}
799EXPORT_SYMBOL_GPL(pwm_can_sleep);
800
62099abf
TR
801#ifdef CONFIG_DEBUG_FS
802static void pwm_dbg_show(struct pwm_chip *chip, struct seq_file *s)
803{
804 unsigned int i;
805
806 for (i = 0; i < chip->npwm; i++) {
807 struct pwm_device *pwm = &chip->pwms[i];
808
809 seq_printf(s, " pwm-%-3d (%-20.20s):", i, pwm->label);
810
811 if (test_bit(PWMF_REQUESTED, &pwm->flags))
812 seq_printf(s, " requested");
813
814 if (test_bit(PWMF_ENABLED, &pwm->flags))
815 seq_printf(s, " enabled");
816
817 seq_printf(s, "\n");
818 }
819}
820
821static void *pwm_seq_start(struct seq_file *s, loff_t *pos)
822{
823 mutex_lock(&pwm_lock);
824 s->private = "";
825
826 return seq_list_start(&pwm_chips, *pos);
827}
828
829static void *pwm_seq_next(struct seq_file *s, void *v, loff_t *pos)
830{
831 s->private = "\n";
832
833 return seq_list_next(v, &pwm_chips, pos);
834}
835
836static void pwm_seq_stop(struct seq_file *s, void *v)
837{
838 mutex_unlock(&pwm_lock);
839}
840
841static int pwm_seq_show(struct seq_file *s, void *v)
842{
843 struct pwm_chip *chip = list_entry(v, struct pwm_chip, list);
844
845 seq_printf(s, "%s%s/%s, %d PWM device%s\n", (char *)s->private,
846 chip->dev->bus ? chip->dev->bus->name : "no-bus",
847 dev_name(chip->dev), chip->npwm,
848 (chip->npwm != 1) ? "s" : "");
849
850 if (chip->ops->dbg_show)
851 chip->ops->dbg_show(chip, s);
852 else
853 pwm_dbg_show(chip, s);
854
855 return 0;
856}
857
858static const struct seq_operations pwm_seq_ops = {
859 .start = pwm_seq_start,
860 .next = pwm_seq_next,
861 .stop = pwm_seq_stop,
862 .show = pwm_seq_show,
863};
864
865static int pwm_seq_open(struct inode *inode, struct file *file)
866{
867 return seq_open(file, &pwm_seq_ops);
868}
869
870static const struct file_operations pwm_debugfs_ops = {
871 .owner = THIS_MODULE,
872 .open = pwm_seq_open,
873 .read = seq_read,
874 .llseek = seq_lseek,
875 .release = seq_release,
876};
877
878static int __init pwm_debugfs_init(void)
879{
880 debugfs_create_file("pwm", S_IFREG | S_IRUGO, NULL, NULL,
881 &pwm_debugfs_ops);
882
883 return 0;
884}
885
886subsys_initcall(pwm_debugfs_init);
887#endif /* CONFIG_DEBUG_FS */
This page took 0.198102 seconds and 5 git commands to generate.