Loading...
1// SPDX-License-Identifier: GPL-2.0-or-later
2/*
3 * PWM device driver for ST SoCs
4 *
5 * Copyright (C) 2013-2016 STMicroelectronics (R&D) Limited
6 *
7 * Author: Ajit Pal Singh <ajitpal.singh@st.com>
8 * Lee Jones <lee.jones@linaro.org>
9 */
10
11#include <linux/clk.h>
12#include <linux/interrupt.h>
13#include <linux/math64.h>
14#include <linux/mfd/syscon.h>
15#include <linux/module.h>
16#include <linux/of.h>
17#include <linux/platform_device.h>
18#include <linux/pwm.h>
19#include <linux/regmap.h>
20#include <linux/sched.h>
21#include <linux/slab.h>
22#include <linux/time.h>
23#include <linux/wait.h>
24
25#define PWM_OUT_VAL(x) (0x00 + (4 * (x))) /* Device's Duty Cycle register */
26#define PWM_CPT_VAL(x) (0x10 + (4 * (x))) /* Capture value */
27#define PWM_CPT_EDGE(x) (0x30 + (4 * (x))) /* Edge to capture on */
28
29#define STI_PWM_CTRL 0x50 /* Control/Config register */
30#define STI_INT_EN 0x54 /* Interrupt Enable/Disable register */
31#define STI_INT_STA 0x58 /* Interrupt Status register */
32#define PWM_INT_ACK 0x5c
33#define PWM_PRESCALE_LOW_MASK 0x0f
34#define PWM_PRESCALE_HIGH_MASK 0xf0
35#define PWM_CPT_EDGE_MASK 0x03
36#define PWM_INT_ACK_MASK 0x1ff
37
38#define STI_MAX_CPT_DEVS 4
39#define CPT_DC_MAX 0xff
40
41/* Regfield IDs */
42enum {
43 /* Bits in PWM_CTRL*/
44 PWMCLK_PRESCALE_LOW,
45 PWMCLK_PRESCALE_HIGH,
46 CPTCLK_PRESCALE,
47
48 PWM_OUT_EN,
49 PWM_CPT_EN,
50
51 PWM_CPT_INT_EN,
52 PWM_CPT_INT_STAT,
53
54 /* Keep last */
55 MAX_REGFIELDS
56};
57
58/*
59 * Each capture input can be programmed to detect rising-edge, falling-edge,
60 * either edge or neither egde.
61 */
62enum sti_cpt_edge {
63 CPT_EDGE_DISABLED,
64 CPT_EDGE_RISING,
65 CPT_EDGE_FALLING,
66 CPT_EDGE_BOTH,
67};
68
69struct sti_cpt_ddata {
70 u32 snapshot[3];
71 unsigned int index;
72 struct mutex lock;
73 wait_queue_head_t wait;
74};
75
76struct sti_pwm_compat_data {
77 const struct reg_field *reg_fields;
78 unsigned int pwm_num_devs;
79 unsigned int cpt_num_devs;
80 unsigned int max_pwm_cnt;
81 unsigned int max_prescale;
82 struct sti_cpt_ddata *ddata;
83};
84
85struct sti_pwm_chip {
86 struct device *dev;
87 struct clk *pwm_clk;
88 struct clk *cpt_clk;
89 struct regmap *regmap;
90 struct sti_pwm_compat_data *cdata;
91 struct regmap_field *prescale_low;
92 struct regmap_field *prescale_high;
93 struct regmap_field *pwm_out_en;
94 struct regmap_field *pwm_cpt_en;
95 struct regmap_field *pwm_cpt_int_en;
96 struct regmap_field *pwm_cpt_int_stat;
97 struct pwm_chip chip;
98 struct pwm_device *cur;
99 unsigned long configured;
100 unsigned int en_count;
101 struct mutex sti_pwm_lock; /* To sync between enable/disable calls */
102 void __iomem *mmio;
103};
104
105static const struct reg_field sti_pwm_regfields[MAX_REGFIELDS] = {
106 [PWMCLK_PRESCALE_LOW] = REG_FIELD(STI_PWM_CTRL, 0, 3),
107 [PWMCLK_PRESCALE_HIGH] = REG_FIELD(STI_PWM_CTRL, 11, 14),
108 [CPTCLK_PRESCALE] = REG_FIELD(STI_PWM_CTRL, 4, 8),
109 [PWM_OUT_EN] = REG_FIELD(STI_PWM_CTRL, 9, 9),
110 [PWM_CPT_EN] = REG_FIELD(STI_PWM_CTRL, 10, 10),
111 [PWM_CPT_INT_EN] = REG_FIELD(STI_INT_EN, 1, 4),
112 [PWM_CPT_INT_STAT] = REG_FIELD(STI_INT_STA, 1, 4),
113};
114
115static inline struct sti_pwm_chip *to_sti_pwmchip(struct pwm_chip *chip)
116{
117 return container_of(chip, struct sti_pwm_chip, chip);
118}
119
120/*
121 * Calculate the prescaler value corresponding to the period.
122 */
123static int sti_pwm_get_prescale(struct sti_pwm_chip *pc, unsigned long period,
124 unsigned int *prescale)
125{
126 struct sti_pwm_compat_data *cdata = pc->cdata;
127 unsigned long clk_rate;
128 unsigned long value;
129 unsigned int ps;
130
131 clk_rate = clk_get_rate(pc->pwm_clk);
132 if (!clk_rate) {
133 dev_err(pc->dev, "failed to get clock rate\n");
134 return -EINVAL;
135 }
136
137 /*
138 * prescale = ((period_ns * clk_rate) / (10^9 * (max_pwm_cnt + 1)) - 1
139 */
140 value = NSEC_PER_SEC / clk_rate;
141 value *= cdata->max_pwm_cnt + 1;
142
143 if (period % value)
144 return -EINVAL;
145
146 ps = period / value - 1;
147 if (ps > cdata->max_prescale)
148 return -EINVAL;
149
150 *prescale = ps;
151
152 return 0;
153}
154
155/*
156 * For STiH4xx PWM IP, the PWM period is fixed to 256 local clock cycles. The
157 * only way to change the period (apart from changing the PWM input clock) is
158 * to change the PWM clock prescaler.
159 *
160 * The prescaler is of 8 bits, so 256 prescaler values and hence 256 possible
161 * period values are supported (for a particular clock rate). The requested
162 * period will be applied only if it matches one of these 256 values.
163 */
164static int sti_pwm_config(struct pwm_chip *chip, struct pwm_device *pwm,
165 int duty_ns, int period_ns)
166{
167 struct sti_pwm_chip *pc = to_sti_pwmchip(chip);
168 struct sti_pwm_compat_data *cdata = pc->cdata;
169 unsigned int ncfg, value, prescale = 0;
170 struct pwm_device *cur = pc->cur;
171 struct device *dev = pc->dev;
172 bool period_same = false;
173 int ret;
174
175 ncfg = hweight_long(pc->configured);
176 if (ncfg)
177 period_same = (period_ns == pwm_get_period(cur));
178
179 /*
180 * Allow configuration changes if one of the following conditions
181 * satisfy.
182 * 1. No devices have been configured.
183 * 2. Only one device has been configured and the new request is for
184 * the same device.
185 * 3. Only one device has been configured and the new request is for
186 * a new device and period of the new device is same as the current
187 * configured period.
188 * 4. More than one devices are configured and period of the new
189 * requestis the same as the current period.
190 */
191 if (!ncfg ||
192 ((ncfg == 1) && (pwm->hwpwm == cur->hwpwm)) ||
193 ((ncfg == 1) && (pwm->hwpwm != cur->hwpwm) && period_same) ||
194 ((ncfg > 1) && period_same)) {
195 /* Enable clock before writing to PWM registers. */
196 ret = clk_enable(pc->pwm_clk);
197 if (ret)
198 return ret;
199
200 ret = clk_enable(pc->cpt_clk);
201 if (ret)
202 return ret;
203
204 if (!period_same) {
205 ret = sti_pwm_get_prescale(pc, period_ns, &prescale);
206 if (ret)
207 goto clk_dis;
208
209 value = prescale & PWM_PRESCALE_LOW_MASK;
210
211 ret = regmap_field_write(pc->prescale_low, value);
212 if (ret)
213 goto clk_dis;
214
215 value = (prescale & PWM_PRESCALE_HIGH_MASK) >> 4;
216
217 ret = regmap_field_write(pc->prescale_high, value);
218 if (ret)
219 goto clk_dis;
220 }
221
222 /*
223 * When PWMVal == 0, PWM pulse = 1 local clock cycle.
224 * When PWMVal == max_pwm_count,
225 * PWM pulse = (max_pwm_count + 1) local cycles,
226 * that is continuous pulse: signal never goes low.
227 */
228 value = cdata->max_pwm_cnt * duty_ns / period_ns;
229
230 ret = regmap_write(pc->regmap, PWM_OUT_VAL(pwm->hwpwm), value);
231 if (ret)
232 goto clk_dis;
233
234 ret = regmap_field_write(pc->pwm_cpt_int_en, 0);
235
236 set_bit(pwm->hwpwm, &pc->configured);
237 pc->cur = pwm;
238
239 dev_dbg(dev, "prescale:%u, period:%i, duty:%i, value:%u\n",
240 prescale, period_ns, duty_ns, value);
241 } else {
242 return -EINVAL;
243 }
244
245clk_dis:
246 clk_disable(pc->pwm_clk);
247 clk_disable(pc->cpt_clk);
248 return ret;
249}
250
251static int sti_pwm_enable(struct pwm_chip *chip, struct pwm_device *pwm)
252{
253 struct sti_pwm_chip *pc = to_sti_pwmchip(chip);
254 struct device *dev = pc->dev;
255 int ret = 0;
256
257 /*
258 * Since we have a common enable for all PWM devices, do not enable if
259 * already enabled.
260 */
261 mutex_lock(&pc->sti_pwm_lock);
262
263 if (!pc->en_count) {
264 ret = clk_enable(pc->pwm_clk);
265 if (ret)
266 goto out;
267
268 ret = clk_enable(pc->cpt_clk);
269 if (ret)
270 goto out;
271
272 ret = regmap_field_write(pc->pwm_out_en, 1);
273 if (ret) {
274 dev_err(dev, "failed to enable PWM device %u: %d\n",
275 pwm->hwpwm, ret);
276 goto out;
277 }
278 }
279
280 pc->en_count++;
281
282out:
283 mutex_unlock(&pc->sti_pwm_lock);
284 return ret;
285}
286
287static void sti_pwm_disable(struct pwm_chip *chip, struct pwm_device *pwm)
288{
289 struct sti_pwm_chip *pc = to_sti_pwmchip(chip);
290
291 mutex_lock(&pc->sti_pwm_lock);
292
293 if (--pc->en_count) {
294 mutex_unlock(&pc->sti_pwm_lock);
295 return;
296 }
297
298 regmap_field_write(pc->pwm_out_en, 0);
299
300 clk_disable(pc->pwm_clk);
301 clk_disable(pc->cpt_clk);
302
303 mutex_unlock(&pc->sti_pwm_lock);
304}
305
306static void sti_pwm_free(struct pwm_chip *chip, struct pwm_device *pwm)
307{
308 struct sti_pwm_chip *pc = to_sti_pwmchip(chip);
309
310 clear_bit(pwm->hwpwm, &pc->configured);
311}
312
313static int sti_pwm_capture(struct pwm_chip *chip, struct pwm_device *pwm,
314 struct pwm_capture *result, unsigned long timeout)
315{
316 struct sti_pwm_chip *pc = to_sti_pwmchip(chip);
317 struct sti_pwm_compat_data *cdata = pc->cdata;
318 struct sti_cpt_ddata *ddata = &cdata->ddata[pwm->hwpwm];
319 struct device *dev = pc->dev;
320 unsigned int effective_ticks;
321 unsigned long long high, low;
322 int ret;
323
324 if (pwm->hwpwm >= cdata->cpt_num_devs) {
325 dev_err(dev, "device %u is not valid\n", pwm->hwpwm);
326 return -EINVAL;
327 }
328
329 mutex_lock(&ddata->lock);
330 ddata->index = 0;
331
332 /* Prepare capture measurement */
333 regmap_write(pc->regmap, PWM_CPT_EDGE(pwm->hwpwm), CPT_EDGE_RISING);
334 regmap_field_write(pc->pwm_cpt_int_en, BIT(pwm->hwpwm));
335
336 /* Enable capture */
337 ret = regmap_field_write(pc->pwm_cpt_en, 1);
338 if (ret) {
339 dev_err(dev, "failed to enable PWM capture %u: %d\n",
340 pwm->hwpwm, ret);
341 goto out;
342 }
343
344 ret = wait_event_interruptible_timeout(ddata->wait, ddata->index > 1,
345 msecs_to_jiffies(timeout));
346
347 regmap_write(pc->regmap, PWM_CPT_EDGE(pwm->hwpwm), CPT_EDGE_DISABLED);
348
349 if (ret == -ERESTARTSYS)
350 goto out;
351
352 switch (ddata->index) {
353 case 0:
354 case 1:
355 /*
356 * Getting here could mean:
357 * - input signal is constant of less than 1 Hz
358 * - there is no input signal at all
359 *
360 * In such case the frequency is rounded down to 0
361 */
362 result->period = 0;
363 result->duty_cycle = 0;
364
365 break;
366
367 case 2:
368 /* We have everying we need */
369 high = ddata->snapshot[1] - ddata->snapshot[0];
370 low = ddata->snapshot[2] - ddata->snapshot[1];
371
372 effective_ticks = clk_get_rate(pc->cpt_clk);
373
374 result->period = (high + low) * NSEC_PER_SEC;
375 result->period /= effective_ticks;
376
377 result->duty_cycle = high * NSEC_PER_SEC;
378 result->duty_cycle /= effective_ticks;
379
380 break;
381
382 default:
383 dev_err(dev, "internal error\n");
384 break;
385 }
386
387out:
388 /* Disable capture */
389 regmap_field_write(pc->pwm_cpt_en, 0);
390
391 mutex_unlock(&ddata->lock);
392 return ret;
393}
394
395static int sti_pwm_apply(struct pwm_chip *chip, struct pwm_device *pwm,
396 const struct pwm_state *state)
397{
398 int err;
399
400 if (state->polarity != PWM_POLARITY_NORMAL)
401 return -EINVAL;
402
403 if (!state->enabled) {
404 if (pwm->state.enabled)
405 sti_pwm_disable(chip, pwm);
406
407 return 0;
408 }
409
410 err = sti_pwm_config(chip, pwm, state->duty_cycle, state->period);
411 if (err)
412 return err;
413
414 if (!pwm->state.enabled)
415 err = sti_pwm_enable(chip, pwm);
416
417 return err;
418}
419
420static const struct pwm_ops sti_pwm_ops = {
421 .capture = sti_pwm_capture,
422 .apply = sti_pwm_apply,
423 .free = sti_pwm_free,
424};
425
426static irqreturn_t sti_pwm_interrupt(int irq, void *data)
427{
428 struct sti_pwm_chip *pc = data;
429 struct device *dev = pc->dev;
430 struct sti_cpt_ddata *ddata;
431 int devicenum;
432 unsigned int cpt_int_stat;
433 unsigned int reg;
434 int ret = IRQ_NONE;
435
436 ret = regmap_field_read(pc->pwm_cpt_int_stat, &cpt_int_stat);
437 if (ret)
438 return ret;
439
440 while (cpt_int_stat) {
441 devicenum = ffs(cpt_int_stat) - 1;
442
443 ddata = &pc->cdata->ddata[devicenum];
444
445 /*
446 * Capture input:
447 * _______ _______
448 * | | | |
449 * __| |_________________| |________
450 * ^0 ^1 ^2
451 *
452 * Capture start by the first available rising edge. When a
453 * capture event occurs, capture value (CPT_VALx) is stored,
454 * index incremented, capture edge changed.
455 *
456 * After the capture, if the index > 1, we have collected the
457 * necessary data so we signal the thread waiting for it and
458 * disable the capture by setting capture edge to none
459 */
460
461 regmap_read(pc->regmap,
462 PWM_CPT_VAL(devicenum),
463 &ddata->snapshot[ddata->index]);
464
465 switch (ddata->index) {
466 case 0:
467 case 1:
468 regmap_read(pc->regmap, PWM_CPT_EDGE(devicenum), ®);
469 reg ^= PWM_CPT_EDGE_MASK;
470 regmap_write(pc->regmap, PWM_CPT_EDGE(devicenum), reg);
471
472 ddata->index++;
473 break;
474
475 case 2:
476 regmap_write(pc->regmap,
477 PWM_CPT_EDGE(devicenum),
478 CPT_EDGE_DISABLED);
479 wake_up(&ddata->wait);
480 break;
481
482 default:
483 dev_err(dev, "Internal error\n");
484 }
485
486 cpt_int_stat &= ~BIT_MASK(devicenum);
487
488 ret = IRQ_HANDLED;
489 }
490
491 /* Just ACK everything */
492 regmap_write(pc->regmap, PWM_INT_ACK, PWM_INT_ACK_MASK);
493
494 return ret;
495}
496
497static int sti_pwm_probe_dt(struct sti_pwm_chip *pc)
498{
499 struct device *dev = pc->dev;
500 const struct reg_field *reg_fields;
501 struct device_node *np = dev->of_node;
502 struct sti_pwm_compat_data *cdata = pc->cdata;
503 u32 num_devs;
504 int ret;
505
506 ret = of_property_read_u32(np, "st,pwm-num-chan", &num_devs);
507 if (!ret)
508 cdata->pwm_num_devs = num_devs;
509
510 ret = of_property_read_u32(np, "st,capture-num-chan", &num_devs);
511 if (!ret)
512 cdata->cpt_num_devs = num_devs;
513
514 if (!cdata->pwm_num_devs && !cdata->cpt_num_devs) {
515 dev_err(dev, "No channels configured\n");
516 return -EINVAL;
517 }
518
519 reg_fields = cdata->reg_fields;
520
521 pc->prescale_low = devm_regmap_field_alloc(dev, pc->regmap,
522 reg_fields[PWMCLK_PRESCALE_LOW]);
523 if (IS_ERR(pc->prescale_low))
524 return PTR_ERR(pc->prescale_low);
525
526 pc->prescale_high = devm_regmap_field_alloc(dev, pc->regmap,
527 reg_fields[PWMCLK_PRESCALE_HIGH]);
528 if (IS_ERR(pc->prescale_high))
529 return PTR_ERR(pc->prescale_high);
530
531 pc->pwm_out_en = devm_regmap_field_alloc(dev, pc->regmap,
532 reg_fields[PWM_OUT_EN]);
533 if (IS_ERR(pc->pwm_out_en))
534 return PTR_ERR(pc->pwm_out_en);
535
536 pc->pwm_cpt_en = devm_regmap_field_alloc(dev, pc->regmap,
537 reg_fields[PWM_CPT_EN]);
538 if (IS_ERR(pc->pwm_cpt_en))
539 return PTR_ERR(pc->pwm_cpt_en);
540
541 pc->pwm_cpt_int_en = devm_regmap_field_alloc(dev, pc->regmap,
542 reg_fields[PWM_CPT_INT_EN]);
543 if (IS_ERR(pc->pwm_cpt_int_en))
544 return PTR_ERR(pc->pwm_cpt_int_en);
545
546 pc->pwm_cpt_int_stat = devm_regmap_field_alloc(dev, pc->regmap,
547 reg_fields[PWM_CPT_INT_STAT]);
548 if (PTR_ERR_OR_ZERO(pc->pwm_cpt_int_stat))
549 return PTR_ERR(pc->pwm_cpt_int_stat);
550
551 return 0;
552}
553
554static const struct regmap_config sti_pwm_regmap_config = {
555 .reg_bits = 32,
556 .val_bits = 32,
557 .reg_stride = 4,
558};
559
560static int sti_pwm_probe(struct platform_device *pdev)
561{
562 struct device *dev = &pdev->dev;
563 struct sti_pwm_compat_data *cdata;
564 struct sti_pwm_chip *pc;
565 unsigned int i;
566 int irq, ret;
567
568 pc = devm_kzalloc(dev, sizeof(*pc), GFP_KERNEL);
569 if (!pc)
570 return -ENOMEM;
571
572 cdata = devm_kzalloc(dev, sizeof(*cdata), GFP_KERNEL);
573 if (!cdata)
574 return -ENOMEM;
575
576 pc->mmio = devm_platform_ioremap_resource(pdev, 0);
577 if (IS_ERR(pc->mmio))
578 return PTR_ERR(pc->mmio);
579
580 pc->regmap = devm_regmap_init_mmio(dev, pc->mmio,
581 &sti_pwm_regmap_config);
582 if (IS_ERR(pc->regmap))
583 return PTR_ERR(pc->regmap);
584
585 irq = platform_get_irq(pdev, 0);
586 if (irq < 0)
587 return irq;
588
589 ret = devm_request_irq(&pdev->dev, irq, sti_pwm_interrupt, 0,
590 pdev->name, pc);
591 if (ret < 0) {
592 dev_err(&pdev->dev, "Failed to request IRQ\n");
593 return ret;
594 }
595
596 /*
597 * Setup PWM data with default values: some values could be replaced
598 * with specific ones provided from Device Tree.
599 */
600 cdata->reg_fields = sti_pwm_regfields;
601 cdata->max_prescale = 0xff;
602 cdata->max_pwm_cnt = 255;
603 cdata->pwm_num_devs = 0;
604 cdata->cpt_num_devs = 0;
605
606 pc->cdata = cdata;
607 pc->dev = dev;
608 pc->en_count = 0;
609 mutex_init(&pc->sti_pwm_lock);
610
611 ret = sti_pwm_probe_dt(pc);
612 if (ret)
613 return ret;
614
615 if (cdata->pwm_num_devs) {
616 pc->pwm_clk = of_clk_get_by_name(dev->of_node, "pwm");
617 if (IS_ERR(pc->pwm_clk)) {
618 dev_err(dev, "failed to get PWM clock\n");
619 return PTR_ERR(pc->pwm_clk);
620 }
621
622 ret = clk_prepare(pc->pwm_clk);
623 if (ret) {
624 dev_err(dev, "failed to prepare clock\n");
625 return ret;
626 }
627 }
628
629 if (cdata->cpt_num_devs) {
630 pc->cpt_clk = of_clk_get_by_name(dev->of_node, "capture");
631 if (IS_ERR(pc->cpt_clk)) {
632 dev_err(dev, "failed to get PWM capture clock\n");
633 return PTR_ERR(pc->cpt_clk);
634 }
635
636 ret = clk_prepare(pc->cpt_clk);
637 if (ret) {
638 dev_err(dev, "failed to prepare clock\n");
639 return ret;
640 }
641
642 cdata->ddata = devm_kzalloc(dev, cdata->cpt_num_devs * sizeof(*cdata->ddata), GFP_KERNEL);
643 if (!cdata->ddata)
644 return -ENOMEM;
645 }
646
647 pc->chip.dev = dev;
648 pc->chip.ops = &sti_pwm_ops;
649 pc->chip.npwm = pc->cdata->pwm_num_devs;
650
651 for (i = 0; i < cdata->cpt_num_devs; i++) {
652 struct sti_cpt_ddata *ddata = &cdata->ddata[i];
653
654 init_waitqueue_head(&ddata->wait);
655 mutex_init(&ddata->lock);
656 }
657
658 ret = pwmchip_add(&pc->chip);
659 if (ret < 0) {
660 clk_unprepare(pc->pwm_clk);
661 clk_unprepare(pc->cpt_clk);
662 return ret;
663 }
664
665 platform_set_drvdata(pdev, pc);
666
667 return 0;
668}
669
670static void sti_pwm_remove(struct platform_device *pdev)
671{
672 struct sti_pwm_chip *pc = platform_get_drvdata(pdev);
673
674 pwmchip_remove(&pc->chip);
675
676 clk_unprepare(pc->pwm_clk);
677 clk_unprepare(pc->cpt_clk);
678}
679
680static const struct of_device_id sti_pwm_of_match[] = {
681 { .compatible = "st,sti-pwm", },
682 { /* sentinel */ }
683};
684MODULE_DEVICE_TABLE(of, sti_pwm_of_match);
685
686static struct platform_driver sti_pwm_driver = {
687 .driver = {
688 .name = "sti-pwm",
689 .of_match_table = sti_pwm_of_match,
690 },
691 .probe = sti_pwm_probe,
692 .remove_new = sti_pwm_remove,
693};
694module_platform_driver(sti_pwm_driver);
695
696MODULE_AUTHOR("Ajit Pal Singh <ajitpal.singh@st.com>");
697MODULE_DESCRIPTION("STMicroelectronics ST PWM driver");
698MODULE_LICENSE("GPL");
1/*
2 * PWM device driver for ST SoCs
3 *
4 * Copyright (C) 2013-2016 STMicroelectronics (R&D) Limited
5 *
6 * Author: Ajit Pal Singh <ajitpal.singh@st.com>
7 * Lee Jones <lee.jones@linaro.org>
8 *
9 * This program is free software; you can redistribute it and/or modify
10 * it under the terms of the GNU General Public License as published by
11 * the Free Software Foundation; either version 2 of the License, or
12 * (at your option) any later version.
13 */
14
15#include <linux/clk.h>
16#include <linux/interrupt.h>
17#include <linux/math64.h>
18#include <linux/mfd/syscon.h>
19#include <linux/module.h>
20#include <linux/of.h>
21#include <linux/platform_device.h>
22#include <linux/pwm.h>
23#include <linux/regmap.h>
24#include <linux/sched.h>
25#include <linux/slab.h>
26#include <linux/time.h>
27#include <linux/wait.h>
28
29#define PWM_OUT_VAL(x) (0x00 + (4 * (x))) /* Device's Duty Cycle register */
30#define PWM_CPT_VAL(x) (0x10 + (4 * (x))) /* Capture value */
31#define PWM_CPT_EDGE(x) (0x30 + (4 * (x))) /* Edge to capture on */
32
33#define STI_PWM_CTRL 0x50 /* Control/Config register */
34#define STI_INT_EN 0x54 /* Interrupt Enable/Disable register */
35#define STI_INT_STA 0x58 /* Interrupt Status register */
36#define PWM_INT_ACK 0x5c
37#define PWM_PRESCALE_LOW_MASK 0x0f
38#define PWM_PRESCALE_HIGH_MASK 0xf0
39#define PWM_CPT_EDGE_MASK 0x03
40#define PWM_INT_ACK_MASK 0x1ff
41
42#define STI_MAX_CPT_DEVS 4
43#define CPT_DC_MAX 0xff
44
45/* Regfield IDs */
46enum {
47 /* Bits in PWM_CTRL*/
48 PWMCLK_PRESCALE_LOW,
49 PWMCLK_PRESCALE_HIGH,
50 CPTCLK_PRESCALE,
51
52 PWM_OUT_EN,
53 PWM_CPT_EN,
54
55 PWM_CPT_INT_EN,
56 PWM_CPT_INT_STAT,
57
58 /* Keep last */
59 MAX_REGFIELDS
60};
61
62/*
63 * Each capture input can be programmed to detect rising-edge, falling-edge,
64 * either edge or neither egde.
65 */
66enum sti_cpt_edge {
67 CPT_EDGE_DISABLED,
68 CPT_EDGE_RISING,
69 CPT_EDGE_FALLING,
70 CPT_EDGE_BOTH,
71};
72
73struct sti_cpt_ddata {
74 u32 snapshot[3];
75 unsigned int index;
76 struct mutex lock;
77 wait_queue_head_t wait;
78};
79
80struct sti_pwm_compat_data {
81 const struct reg_field *reg_fields;
82 unsigned int pwm_num_devs;
83 unsigned int cpt_num_devs;
84 unsigned int max_pwm_cnt;
85 unsigned int max_prescale;
86};
87
88struct sti_pwm_chip {
89 struct device *dev;
90 struct clk *pwm_clk;
91 struct clk *cpt_clk;
92 struct regmap *regmap;
93 struct sti_pwm_compat_data *cdata;
94 struct regmap_field *prescale_low;
95 struct regmap_field *prescale_high;
96 struct regmap_field *pwm_out_en;
97 struct regmap_field *pwm_cpt_en;
98 struct regmap_field *pwm_cpt_int_en;
99 struct regmap_field *pwm_cpt_int_stat;
100 struct pwm_chip chip;
101 struct pwm_device *cur;
102 unsigned long configured;
103 unsigned int en_count;
104 struct mutex sti_pwm_lock; /* To sync between enable/disable calls */
105 void __iomem *mmio;
106};
107
108static const struct reg_field sti_pwm_regfields[MAX_REGFIELDS] = {
109 [PWMCLK_PRESCALE_LOW] = REG_FIELD(STI_PWM_CTRL, 0, 3),
110 [PWMCLK_PRESCALE_HIGH] = REG_FIELD(STI_PWM_CTRL, 11, 14),
111 [CPTCLK_PRESCALE] = REG_FIELD(STI_PWM_CTRL, 4, 8),
112 [PWM_OUT_EN] = REG_FIELD(STI_PWM_CTRL, 9, 9),
113 [PWM_CPT_EN] = REG_FIELD(STI_PWM_CTRL, 10, 10),
114 [PWM_CPT_INT_EN] = REG_FIELD(STI_INT_EN, 1, 4),
115 [PWM_CPT_INT_STAT] = REG_FIELD(STI_INT_STA, 1, 4),
116};
117
118static inline struct sti_pwm_chip *to_sti_pwmchip(struct pwm_chip *chip)
119{
120 return container_of(chip, struct sti_pwm_chip, chip);
121}
122
123/*
124 * Calculate the prescaler value corresponding to the period.
125 */
126static int sti_pwm_get_prescale(struct sti_pwm_chip *pc, unsigned long period,
127 unsigned int *prescale)
128{
129 struct sti_pwm_compat_data *cdata = pc->cdata;
130 unsigned long clk_rate;
131 unsigned long value;
132 unsigned int ps;
133
134 clk_rate = clk_get_rate(pc->pwm_clk);
135 if (!clk_rate) {
136 dev_err(pc->dev, "failed to get clock rate\n");
137 return -EINVAL;
138 }
139
140 /*
141 * prescale = ((period_ns * clk_rate) / (10^9 * (max_pwm_cnt + 1)) - 1
142 */
143 value = NSEC_PER_SEC / clk_rate;
144 value *= cdata->max_pwm_cnt + 1;
145
146 if (period % value)
147 return -EINVAL;
148
149 ps = period / value - 1;
150 if (ps > cdata->max_prescale)
151 return -EINVAL;
152
153 *prescale = ps;
154
155 return 0;
156}
157
158/*
159 * For STiH4xx PWM IP, the PWM period is fixed to 256 local clock cycles. The
160 * only way to change the period (apart from changing the PWM input clock) is
161 * to change the PWM clock prescaler.
162 *
163 * The prescaler is of 8 bits, so 256 prescaler values and hence 256 possible
164 * period values are supported (for a particular clock rate). The requested
165 * period will be applied only if it matches one of these 256 values.
166 */
167static int sti_pwm_config(struct pwm_chip *chip, struct pwm_device *pwm,
168 int duty_ns, int period_ns)
169{
170 struct sti_pwm_chip *pc = to_sti_pwmchip(chip);
171 struct sti_pwm_compat_data *cdata = pc->cdata;
172 unsigned int ncfg, value, prescale = 0;
173 struct pwm_device *cur = pc->cur;
174 struct device *dev = pc->dev;
175 bool period_same = false;
176 int ret;
177
178 ncfg = hweight_long(pc->configured);
179 if (ncfg)
180 period_same = (period_ns == pwm_get_period(cur));
181
182 /*
183 * Allow configuration changes if one of the following conditions
184 * satisfy.
185 * 1. No devices have been configured.
186 * 2. Only one device has been configured and the new request is for
187 * the same device.
188 * 3. Only one device has been configured and the new request is for
189 * a new device and period of the new device is same as the current
190 * configured period.
191 * 4. More than one devices are configured and period of the new
192 * requestis the same as the current period.
193 */
194 if (!ncfg ||
195 ((ncfg == 1) && (pwm->hwpwm == cur->hwpwm)) ||
196 ((ncfg == 1) && (pwm->hwpwm != cur->hwpwm) && period_same) ||
197 ((ncfg > 1) && period_same)) {
198 /* Enable clock before writing to PWM registers. */
199 ret = clk_enable(pc->pwm_clk);
200 if (ret)
201 return ret;
202
203 ret = clk_enable(pc->cpt_clk);
204 if (ret)
205 return ret;
206
207 if (!period_same) {
208 ret = sti_pwm_get_prescale(pc, period_ns, &prescale);
209 if (ret)
210 goto clk_dis;
211
212 value = prescale & PWM_PRESCALE_LOW_MASK;
213
214 ret = regmap_field_write(pc->prescale_low, value);
215 if (ret)
216 goto clk_dis;
217
218 value = (prescale & PWM_PRESCALE_HIGH_MASK) >> 4;
219
220 ret = regmap_field_write(pc->prescale_high, value);
221 if (ret)
222 goto clk_dis;
223 }
224
225 /*
226 * When PWMVal == 0, PWM pulse = 1 local clock cycle.
227 * When PWMVal == max_pwm_count,
228 * PWM pulse = (max_pwm_count + 1) local cycles,
229 * that is continuous pulse: signal never goes low.
230 */
231 value = cdata->max_pwm_cnt * duty_ns / period_ns;
232
233 ret = regmap_write(pc->regmap, PWM_OUT_VAL(pwm->hwpwm), value);
234 if (ret)
235 goto clk_dis;
236
237 ret = regmap_field_write(pc->pwm_cpt_int_en, 0);
238
239 set_bit(pwm->hwpwm, &pc->configured);
240 pc->cur = pwm;
241
242 dev_dbg(dev, "prescale:%u, period:%i, duty:%i, value:%u\n",
243 prescale, period_ns, duty_ns, value);
244 } else {
245 return -EINVAL;
246 }
247
248clk_dis:
249 clk_disable(pc->pwm_clk);
250 clk_disable(pc->cpt_clk);
251 return ret;
252}
253
254static int sti_pwm_enable(struct pwm_chip *chip, struct pwm_device *pwm)
255{
256 struct sti_pwm_chip *pc = to_sti_pwmchip(chip);
257 struct device *dev = pc->dev;
258 int ret = 0;
259
260 /*
261 * Since we have a common enable for all PWM devices, do not enable if
262 * already enabled.
263 */
264 mutex_lock(&pc->sti_pwm_lock);
265
266 if (!pc->en_count) {
267 ret = clk_enable(pc->pwm_clk);
268 if (ret)
269 goto out;
270
271 ret = clk_enable(pc->cpt_clk);
272 if (ret)
273 goto out;
274
275 ret = regmap_field_write(pc->pwm_out_en, 1);
276 if (ret) {
277 dev_err(dev, "failed to enable PWM device %u: %d\n",
278 pwm->hwpwm, ret);
279 goto out;
280 }
281 }
282
283 pc->en_count++;
284
285out:
286 mutex_unlock(&pc->sti_pwm_lock);
287 return ret;
288}
289
290static void sti_pwm_disable(struct pwm_chip *chip, struct pwm_device *pwm)
291{
292 struct sti_pwm_chip *pc = to_sti_pwmchip(chip);
293
294 mutex_lock(&pc->sti_pwm_lock);
295
296 if (--pc->en_count) {
297 mutex_unlock(&pc->sti_pwm_lock);
298 return;
299 }
300
301 regmap_field_write(pc->pwm_out_en, 0);
302
303 clk_disable(pc->pwm_clk);
304 clk_disable(pc->cpt_clk);
305
306 mutex_unlock(&pc->sti_pwm_lock);
307}
308
309static void sti_pwm_free(struct pwm_chip *chip, struct pwm_device *pwm)
310{
311 struct sti_pwm_chip *pc = to_sti_pwmchip(chip);
312
313 clear_bit(pwm->hwpwm, &pc->configured);
314}
315
316static int sti_pwm_capture(struct pwm_chip *chip, struct pwm_device *pwm,
317 struct pwm_capture *result, unsigned long timeout)
318{
319 struct sti_pwm_chip *pc = to_sti_pwmchip(chip);
320 struct sti_pwm_compat_data *cdata = pc->cdata;
321 struct sti_cpt_ddata *ddata = pwm_get_chip_data(pwm);
322 struct device *dev = pc->dev;
323 unsigned int effective_ticks;
324 unsigned long long high, low;
325 int ret;
326
327 if (pwm->hwpwm >= cdata->cpt_num_devs) {
328 dev_err(dev, "device %u is not valid\n", pwm->hwpwm);
329 return -EINVAL;
330 }
331
332 mutex_lock(&ddata->lock);
333 ddata->index = 0;
334
335 /* Prepare capture measurement */
336 regmap_write(pc->regmap, PWM_CPT_EDGE(pwm->hwpwm), CPT_EDGE_RISING);
337 regmap_field_write(pc->pwm_cpt_int_en, BIT(pwm->hwpwm));
338
339 /* Enable capture */
340 ret = regmap_field_write(pc->pwm_cpt_en, 1);
341 if (ret) {
342 dev_err(dev, "failed to enable PWM capture %u: %d\n",
343 pwm->hwpwm, ret);
344 goto out;
345 }
346
347 ret = wait_event_interruptible_timeout(ddata->wait, ddata->index > 1,
348 msecs_to_jiffies(timeout));
349
350 regmap_write(pc->regmap, PWM_CPT_EDGE(pwm->hwpwm), CPT_EDGE_DISABLED);
351
352 if (ret == -ERESTARTSYS)
353 goto out;
354
355 switch (ddata->index) {
356 case 0:
357 case 1:
358 /*
359 * Getting here could mean:
360 * - input signal is constant of less than 1 Hz
361 * - there is no input signal at all
362 *
363 * In such case the frequency is rounded down to 0
364 */
365 result->period = 0;
366 result->duty_cycle = 0;
367
368 break;
369
370 case 2:
371 /* We have everying we need */
372 high = ddata->snapshot[1] - ddata->snapshot[0];
373 low = ddata->snapshot[2] - ddata->snapshot[1];
374
375 effective_ticks = clk_get_rate(pc->cpt_clk);
376
377 result->period = (high + low) * NSEC_PER_SEC;
378 result->period /= effective_ticks;
379
380 result->duty_cycle = high * NSEC_PER_SEC;
381 result->duty_cycle /= effective_ticks;
382
383 break;
384
385 default:
386 dev_err(dev, "internal error\n");
387 break;
388 }
389
390out:
391 /* Disable capture */
392 regmap_field_write(pc->pwm_cpt_en, 0);
393
394 mutex_unlock(&ddata->lock);
395 return ret;
396}
397
398static const struct pwm_ops sti_pwm_ops = {
399 .capture = sti_pwm_capture,
400 .config = sti_pwm_config,
401 .enable = sti_pwm_enable,
402 .disable = sti_pwm_disable,
403 .free = sti_pwm_free,
404 .owner = THIS_MODULE,
405};
406
407static irqreturn_t sti_pwm_interrupt(int irq, void *data)
408{
409 struct sti_pwm_chip *pc = data;
410 struct device *dev = pc->dev;
411 struct sti_cpt_ddata *ddata;
412 int devicenum;
413 unsigned int cpt_int_stat;
414 unsigned int reg;
415 int ret = IRQ_NONE;
416
417 ret = regmap_field_read(pc->pwm_cpt_int_stat, &cpt_int_stat);
418 if (ret)
419 return ret;
420
421 while (cpt_int_stat) {
422 devicenum = ffs(cpt_int_stat) - 1;
423
424 ddata = pwm_get_chip_data(&pc->chip.pwms[devicenum]);
425
426 /*
427 * Capture input:
428 * _______ _______
429 * | | | |
430 * __| |_________________| |________
431 * ^0 ^1 ^2
432 *
433 * Capture start by the first available rising edge. When a
434 * capture event occurs, capture value (CPT_VALx) is stored,
435 * index incremented, capture edge changed.
436 *
437 * After the capture, if the index > 1, we have collected the
438 * necessary data so we signal the thread waiting for it and
439 * disable the capture by setting capture edge to none
440 */
441
442 regmap_read(pc->regmap,
443 PWM_CPT_VAL(devicenum),
444 &ddata->snapshot[ddata->index]);
445
446 switch (ddata->index) {
447 case 0:
448 case 1:
449 regmap_read(pc->regmap, PWM_CPT_EDGE(devicenum), ®);
450 reg ^= PWM_CPT_EDGE_MASK;
451 regmap_write(pc->regmap, PWM_CPT_EDGE(devicenum), reg);
452
453 ddata->index++;
454 break;
455
456 case 2:
457 regmap_write(pc->regmap,
458 PWM_CPT_EDGE(devicenum),
459 CPT_EDGE_DISABLED);
460 wake_up(&ddata->wait);
461 break;
462
463 default:
464 dev_err(dev, "Internal error\n");
465 }
466
467 cpt_int_stat &= ~BIT_MASK(devicenum);
468
469 ret = IRQ_HANDLED;
470 }
471
472 /* Just ACK everything */
473 regmap_write(pc->regmap, PWM_INT_ACK, PWM_INT_ACK_MASK);
474
475 return ret;
476}
477
478static int sti_pwm_probe_dt(struct sti_pwm_chip *pc)
479{
480 struct device *dev = pc->dev;
481 const struct reg_field *reg_fields;
482 struct device_node *np = dev->of_node;
483 struct sti_pwm_compat_data *cdata = pc->cdata;
484 u32 num_devs;
485 int ret;
486
487 ret = of_property_read_u32(np, "st,pwm-num-chan", &num_devs);
488 if (!ret)
489 cdata->pwm_num_devs = num_devs;
490
491 ret = of_property_read_u32(np, "st,capture-num-chan", &num_devs);
492 if (!ret)
493 cdata->cpt_num_devs = num_devs;
494
495 if (!cdata->pwm_num_devs && !cdata->cpt_num_devs) {
496 dev_err(dev, "No channels configured\n");
497 return -EINVAL;
498 }
499
500 reg_fields = cdata->reg_fields;
501
502 pc->prescale_low = devm_regmap_field_alloc(dev, pc->regmap,
503 reg_fields[PWMCLK_PRESCALE_LOW]);
504 if (IS_ERR(pc->prescale_low))
505 return PTR_ERR(pc->prescale_low);
506
507 pc->prescale_high = devm_regmap_field_alloc(dev, pc->regmap,
508 reg_fields[PWMCLK_PRESCALE_HIGH]);
509 if (IS_ERR(pc->prescale_high))
510 return PTR_ERR(pc->prescale_high);
511
512
513 pc->pwm_out_en = devm_regmap_field_alloc(dev, pc->regmap,
514 reg_fields[PWM_OUT_EN]);
515 if (IS_ERR(pc->pwm_out_en))
516 return PTR_ERR(pc->pwm_out_en);
517
518 pc->pwm_cpt_en = devm_regmap_field_alloc(dev, pc->regmap,
519 reg_fields[PWM_CPT_EN]);
520 if (IS_ERR(pc->pwm_cpt_en))
521 return PTR_ERR(pc->pwm_cpt_en);
522
523 pc->pwm_cpt_int_en = devm_regmap_field_alloc(dev, pc->regmap,
524 reg_fields[PWM_CPT_INT_EN]);
525 if (IS_ERR(pc->pwm_cpt_int_en))
526 return PTR_ERR(pc->pwm_cpt_int_en);
527
528 pc->pwm_cpt_int_stat = devm_regmap_field_alloc(dev, pc->regmap,
529 reg_fields[PWM_CPT_INT_STAT]);
530 if (PTR_ERR_OR_ZERO(pc->pwm_cpt_int_stat))
531 return PTR_ERR(pc->pwm_cpt_int_stat);
532
533 return 0;
534}
535
536static const struct regmap_config sti_pwm_regmap_config = {
537 .reg_bits = 32,
538 .val_bits = 32,
539 .reg_stride = 4,
540};
541
542static int sti_pwm_probe(struct platform_device *pdev)
543{
544 struct device *dev = &pdev->dev;
545 struct sti_pwm_compat_data *cdata;
546 struct sti_pwm_chip *pc;
547 struct resource *res;
548 unsigned int i;
549 int irq, ret;
550
551 pc = devm_kzalloc(dev, sizeof(*pc), GFP_KERNEL);
552 if (!pc)
553 return -ENOMEM;
554
555 cdata = devm_kzalloc(dev, sizeof(*cdata), GFP_KERNEL);
556 if (!cdata)
557 return -ENOMEM;
558
559 res = platform_get_resource(pdev, IORESOURCE_MEM, 0);
560
561 pc->mmio = devm_ioremap_resource(dev, res);
562 if (IS_ERR(pc->mmio))
563 return PTR_ERR(pc->mmio);
564
565 pc->regmap = devm_regmap_init_mmio(dev, pc->mmio,
566 &sti_pwm_regmap_config);
567 if (IS_ERR(pc->regmap))
568 return PTR_ERR(pc->regmap);
569
570 irq = platform_get_irq(pdev, 0);
571 if (irq < 0) {
572 dev_err(&pdev->dev, "Failed to obtain IRQ\n");
573 return irq;
574 }
575
576 ret = devm_request_irq(&pdev->dev, irq, sti_pwm_interrupt, 0,
577 pdev->name, pc);
578 if (ret < 0) {
579 dev_err(&pdev->dev, "Failed to request IRQ\n");
580 return ret;
581 }
582
583 /*
584 * Setup PWM data with default values: some values could be replaced
585 * with specific ones provided from Device Tree.
586 */
587 cdata->reg_fields = sti_pwm_regfields;
588 cdata->max_prescale = 0xff;
589 cdata->max_pwm_cnt = 255;
590 cdata->pwm_num_devs = 0;
591 cdata->cpt_num_devs = 0;
592
593 pc->cdata = cdata;
594 pc->dev = dev;
595 pc->en_count = 0;
596 mutex_init(&pc->sti_pwm_lock);
597
598 ret = sti_pwm_probe_dt(pc);
599 if (ret)
600 return ret;
601
602 if (!cdata->pwm_num_devs)
603 goto skip_pwm;
604
605 pc->pwm_clk = of_clk_get_by_name(dev->of_node, "pwm");
606 if (IS_ERR(pc->pwm_clk)) {
607 dev_err(dev, "failed to get PWM clock\n");
608 return PTR_ERR(pc->pwm_clk);
609 }
610
611 ret = clk_prepare(pc->pwm_clk);
612 if (ret) {
613 dev_err(dev, "failed to prepare clock\n");
614 return ret;
615 }
616
617skip_pwm:
618 if (!cdata->cpt_num_devs)
619 goto skip_cpt;
620
621 pc->cpt_clk = of_clk_get_by_name(dev->of_node, "capture");
622 if (IS_ERR(pc->cpt_clk)) {
623 dev_err(dev, "failed to get PWM capture clock\n");
624 return PTR_ERR(pc->cpt_clk);
625 }
626
627 ret = clk_prepare(pc->cpt_clk);
628 if (ret) {
629 dev_err(dev, "failed to prepare clock\n");
630 return ret;
631 }
632
633skip_cpt:
634 pc->chip.dev = dev;
635 pc->chip.ops = &sti_pwm_ops;
636 pc->chip.base = -1;
637 pc->chip.npwm = pc->cdata->pwm_num_devs;
638
639 ret = pwmchip_add(&pc->chip);
640 if (ret < 0) {
641 clk_unprepare(pc->pwm_clk);
642 clk_unprepare(pc->cpt_clk);
643 return ret;
644 }
645
646 for (i = 0; i < cdata->cpt_num_devs; i++) {
647 struct sti_cpt_ddata *ddata;
648
649 ddata = devm_kzalloc(dev, sizeof(*ddata), GFP_KERNEL);
650 if (!ddata)
651 return -ENOMEM;
652
653 init_waitqueue_head(&ddata->wait);
654 mutex_init(&ddata->lock);
655
656 pwm_set_chip_data(&pc->chip.pwms[i], ddata);
657 }
658
659 platform_set_drvdata(pdev, pc);
660
661 return 0;
662}
663
664static int sti_pwm_remove(struct platform_device *pdev)
665{
666 struct sti_pwm_chip *pc = platform_get_drvdata(pdev);
667 unsigned int i;
668
669 for (i = 0; i < pc->cdata->pwm_num_devs; i++)
670 pwm_disable(&pc->chip.pwms[i]);
671
672 clk_unprepare(pc->pwm_clk);
673 clk_unprepare(pc->cpt_clk);
674
675 return pwmchip_remove(&pc->chip);
676}
677
678static const struct of_device_id sti_pwm_of_match[] = {
679 { .compatible = "st,sti-pwm", },
680 { /* sentinel */ }
681};
682MODULE_DEVICE_TABLE(of, sti_pwm_of_match);
683
684static struct platform_driver sti_pwm_driver = {
685 .driver = {
686 .name = "sti-pwm",
687 .of_match_table = sti_pwm_of_match,
688 },
689 .probe = sti_pwm_probe,
690 .remove = sti_pwm_remove,
691};
692module_platform_driver(sti_pwm_driver);
693
694MODULE_AUTHOR("Ajit Pal Singh <ajitpal.singh@st.com>");
695MODULE_DESCRIPTION("STMicroelectronics ST PWM driver");
696MODULE_LICENSE("GPL");