Linux Audio

Check our new training course

Loading...
v6.8
  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), &reg);
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");
v4.6
 
  1/*
  2 * PWM device driver for ST SoCs.
  3 * Author: Ajit Pal Singh <ajitpal.singh@st.com>
  4 *
  5 * Copyright (C) 2013-2014 STMicroelectronics (R&D) Limited
  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 of the License, or
 10 * (at your option) any later version.
 11 */
 12
 13#include <linux/clk.h>
 
 14#include <linux/math64.h>
 15#include <linux/mfd/syscon.h>
 16#include <linux/module.h>
 17#include <linux/of.h>
 18#include <linux/platform_device.h>
 19#include <linux/pwm.h>
 20#include <linux/regmap.h>
 
 21#include <linux/slab.h>
 22#include <linux/time.h>
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 23
 24#define STI_DS_REG(ch)	(4 * (ch))	/* Channel's Duty Cycle register */
 25#define STI_PWMCR	0x50		/* Control/Config register */
 26#define STI_INTEN	0x54		/* Interrupt Enable/Disable register */
 27#define PWM_PRESCALE_LOW_MASK		0x0f
 28#define PWM_PRESCALE_HIGH_MASK		0xf0
 29
 30/* Regfield IDs */
 31enum {
 
 32	PWMCLK_PRESCALE_LOW,
 33	PWMCLK_PRESCALE_HIGH,
 34	PWM_EN,
 35	PWM_INT_EN,
 
 
 
 
 
 36
 37	/* Keep last */
 38	MAX_REGFIELDS
 39};
 40
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 41struct sti_pwm_compat_data {
 42	const struct reg_field *reg_fields;
 43	unsigned int num_chan;
 
 44	unsigned int max_pwm_cnt;
 45	unsigned int max_prescale;
 
 46};
 47
 48struct sti_pwm_chip {
 49	struct device *dev;
 50	struct clk *clk;
 51	unsigned long clk_rate;
 52	struct regmap *regmap;
 53	struct sti_pwm_compat_data *cdata;
 54	struct regmap_field *prescale_low;
 55	struct regmap_field *prescale_high;
 56	struct regmap_field *pwm_en;
 57	struct regmap_field *pwm_int_en;
 
 
 58	struct pwm_chip chip;
 59	struct pwm_device *cur;
 60	unsigned long configured;
 61	unsigned int en_count;
 62	struct mutex sti_pwm_lock; /* To sync between enable/disable calls */
 63	void __iomem *mmio;
 64};
 65
 66static const struct reg_field sti_pwm_regfields[MAX_REGFIELDS] = {
 67	[PWMCLK_PRESCALE_LOW]	= REG_FIELD(STI_PWMCR, 0, 3),
 68	[PWMCLK_PRESCALE_HIGH]	= REG_FIELD(STI_PWMCR, 11, 14),
 69	[PWM_EN]		= REG_FIELD(STI_PWMCR, 9, 9),
 70	[PWM_INT_EN]		= REG_FIELD(STI_INTEN, 0, 0),
 
 
 
 71};
 72
 73static inline struct sti_pwm_chip *to_sti_pwmchip(struct pwm_chip *chip)
 74{
 75	return container_of(chip, struct sti_pwm_chip, chip);
 76}
 77
 78/*
 79 * Calculate the prescaler value corresponding to the period.
 80 */
 81static int sti_pwm_get_prescale(struct sti_pwm_chip *pc, unsigned long period,
 82				unsigned int *prescale)
 83{
 84	struct sti_pwm_compat_data *cdata = pc->cdata;
 85	unsigned long val;
 
 86	unsigned int ps;
 87
 
 
 
 
 
 
 88	/*
 89	 * prescale = ((period_ns * clk_rate) / (10^9 * (max_pwm_count + 1)) - 1
 90	 */
 91	val = NSEC_PER_SEC / pc->clk_rate;
 92	val *= cdata->max_pwm_cnt + 1;
 
 
 
 93
 94	if (period % val) {
 
 95		return -EINVAL;
 96	} else {
 97		ps  = period / val - 1;
 98		if (ps > cdata->max_prescale)
 99			return -EINVAL;
100	}
101	*prescale = ps;
102
103	return 0;
104}
105
106/*
107 * For STiH4xx PWM IP, the PWM period is fixed to 256 local clock cycles.
108 * The only way to change the period (apart from changing the PWM input clock)
109 * is to change the PWM clock prescaler.
110 * The prescaler is of 8 bits, so 256 prescaler values and hence
111 * 256 possible period values are supported (for a particular clock rate).
112 * The requested period will be applied only if it matches one of these
113 * 256 values.
114 */
115static int sti_pwm_config(struct pwm_chip *chip, struct pwm_device *pwm,
116			 int duty_ns, int period_ns)
117{
118	struct sti_pwm_chip *pc = to_sti_pwmchip(chip);
119	struct sti_pwm_compat_data *cdata = pc->cdata;
 
120	struct pwm_device *cur = pc->cur;
121	struct device *dev = pc->dev;
122	unsigned int prescale = 0, pwmvalx;
123	int ret;
124	unsigned int ncfg;
125	bool period_same = false;
126
127	ncfg = hweight_long(pc->configured);
128	if (ncfg)
129		period_same = (period_ns == pwm_get_period(cur));
130
131	/* Allow configuration changes if one of the
132	 * following conditions satisfy.
133	 * 1. No channels have been configured.
134	 * 2. Only one channel has been configured and the new request
135	 *    is for the same channel.
136	 * 3. Only one channel has been configured and the new request is
137	 *    for a new channel and period of the new channel is same as
138	 *    the current configured period.
139	 * 4. More than one channels are configured and period of the new
 
140	 *    requestis the same as the current period.
141	 */
142	if (!ncfg ||
143	    ((ncfg == 1) && (pwm->hwpwm == cur->hwpwm)) ||
144	    ((ncfg == 1) && (pwm->hwpwm != cur->hwpwm) && period_same) ||
145	    ((ncfg > 1) && period_same)) {
146		/* Enable clock before writing to PWM registers. */
147		ret = clk_enable(pc->clk);
 
 
 
 
148		if (ret)
149			return ret;
150
151		if (!period_same) {
152			ret = sti_pwm_get_prescale(pc, period_ns, &prescale);
153			if (ret)
154				goto clk_dis;
155
156			ret =
157			regmap_field_write(pc->prescale_low,
158					   prescale & PWM_PRESCALE_LOW_MASK);
159			if (ret)
160				goto clk_dis;
161
162			ret =
163			regmap_field_write(pc->prescale_high,
164				(prescale & PWM_PRESCALE_HIGH_MASK) >> 4);
165			if (ret)
166				goto clk_dis;
167		}
168
169		/*
170		 * When PWMVal == 0, PWM pulse = 1 local clock cycle.
171		 * When PWMVal == max_pwm_count,
172		 * PWM pulse = (max_pwm_count + 1) local cycles,
173		 * that is continuous pulse: signal never goes low.
174		 */
175		pwmvalx = cdata->max_pwm_cnt * duty_ns / period_ns;
176
177		ret = regmap_write(pc->regmap, STI_DS_REG(pwm->hwpwm), pwmvalx);
178		if (ret)
179			goto clk_dis;
180
181		ret = regmap_field_write(pc->pwm_int_en, 0);
182
183		set_bit(pwm->hwpwm, &pc->configured);
184		pc->cur = pwm;
185
186		dev_dbg(dev, "prescale:%u, period:%i, duty:%i, pwmvalx:%u\n",
187			prescale, period_ns, duty_ns, pwmvalx);
188	} else {
189		return -EINVAL;
190	}
191
192clk_dis:
193	clk_disable(pc->clk);
 
194	return ret;
195}
196
197static int sti_pwm_enable(struct pwm_chip *chip, struct pwm_device *pwm)
198{
199	struct sti_pwm_chip *pc = to_sti_pwmchip(chip);
200	struct device *dev = pc->dev;
201	int ret = 0;
202
203	/*
204	 * Since we have a common enable for all PWM channels,
205	 * do not enable if already enabled.
206	 */
207	mutex_lock(&pc->sti_pwm_lock);
 
208	if (!pc->en_count) {
209		ret = clk_enable(pc->clk);
 
 
 
 
210		if (ret)
211			goto out;
212
213		ret = regmap_field_write(pc->pwm_en, 1);
214		if (ret) {
215			dev_err(dev, "failed to enable PWM device:%d\n",
216				pwm->hwpwm);
217			goto out;
218		}
219	}
 
220	pc->en_count++;
 
221out:
222	mutex_unlock(&pc->sti_pwm_lock);
223	return ret;
224}
225
226static void sti_pwm_disable(struct pwm_chip *chip, struct pwm_device *pwm)
227{
228	struct sti_pwm_chip *pc = to_sti_pwmchip(chip);
229
230	mutex_lock(&pc->sti_pwm_lock);
 
231	if (--pc->en_count) {
232		mutex_unlock(&pc->sti_pwm_lock);
233		return;
234	}
235	regmap_field_write(pc->pwm_en, 0);
236
237	clk_disable(pc->clk);
 
 
 
 
238	mutex_unlock(&pc->sti_pwm_lock);
239}
240
241static void sti_pwm_free(struct pwm_chip *chip, struct pwm_device *pwm)
242{
243	struct sti_pwm_chip *pc = to_sti_pwmchip(chip);
244
245	clear_bit(pwm->hwpwm, &pc->configured);
246}
247
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
248static const struct pwm_ops sti_pwm_ops = {
249	.config = sti_pwm_config,
250	.enable = sti_pwm_enable,
251	.disable = sti_pwm_disable,
252	.free = sti_pwm_free,
253	.owner = THIS_MODULE,
254};
255
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
256static int sti_pwm_probe_dt(struct sti_pwm_chip *pc)
257{
258	struct device *dev = pc->dev;
259	const struct reg_field *reg_fields;
260	struct device_node *np = dev->of_node;
261	struct sti_pwm_compat_data *cdata = pc->cdata;
262	u32 num_chan;
 
263
264	of_property_read_u32(np, "st,pwm-num-chan", &num_chan);
265	if (num_chan)
266		cdata->num_chan = num_chan;
 
 
 
 
 
 
 
 
 
267
268	reg_fields = cdata->reg_fields;
269
270	pc->prescale_low = devm_regmap_field_alloc(dev, pc->regmap,
271					reg_fields[PWMCLK_PRESCALE_LOW]);
272	if (IS_ERR(pc->prescale_low))
273		return PTR_ERR(pc->prescale_low);
274
275	pc->prescale_high = devm_regmap_field_alloc(dev, pc->regmap,
276					reg_fields[PWMCLK_PRESCALE_HIGH]);
277	if (IS_ERR(pc->prescale_high))
278		return PTR_ERR(pc->prescale_high);
279
280	pc->pwm_en = devm_regmap_field_alloc(dev, pc->regmap,
281					     reg_fields[PWM_EN]);
282	if (IS_ERR(pc->pwm_en))
283		return PTR_ERR(pc->pwm_en);
284
285	pc->pwm_int_en = devm_regmap_field_alloc(dev, pc->regmap,
286						 reg_fields[PWM_INT_EN]);
287	if (IS_ERR(pc->pwm_int_en))
288		return PTR_ERR(pc->pwm_int_en);
 
 
 
 
 
 
 
 
 
 
289
290	return 0;
291}
292
293static const struct regmap_config sti_pwm_regmap_config = {
294	.reg_bits = 32,
295	.val_bits = 32,
296	.reg_stride = 4,
297};
298
299static int sti_pwm_probe(struct platform_device *pdev)
300{
301	struct device *dev = &pdev->dev;
302	struct sti_pwm_compat_data *cdata;
303	struct sti_pwm_chip *pc;
304	struct resource *res;
305	int ret;
306
307	pc = devm_kzalloc(dev, sizeof(*pc), GFP_KERNEL);
308	if (!pc)
309		return -ENOMEM;
310
311	cdata = devm_kzalloc(dev, sizeof(*cdata), GFP_KERNEL);
312	if (!cdata)
313		return -ENOMEM;
314
315	res = platform_get_resource(pdev, IORESOURCE_MEM, 0);
316
317	pc->mmio = devm_ioremap_resource(dev, res);
318	if (IS_ERR(pc->mmio))
319		return PTR_ERR(pc->mmio);
320
321	pc->regmap = devm_regmap_init_mmio(dev, pc->mmio,
322					   &sti_pwm_regmap_config);
323	if (IS_ERR(pc->regmap))
324		return PTR_ERR(pc->regmap);
325
 
 
 
 
 
 
 
 
 
 
 
326	/*
327	 * Setup PWM data with default values: some values could be replaced
328	 * with specific ones provided from Device Tree.
329	 */
330	cdata->reg_fields   = &sti_pwm_regfields[0];
331	cdata->max_prescale = 0xff;
332	cdata->max_pwm_cnt  = 255;
333	cdata->num_chan     = 1;
 
334
335	pc->cdata = cdata;
336	pc->dev = dev;
337	pc->en_count = 0;
338	mutex_init(&pc->sti_pwm_lock);
339
340	ret = sti_pwm_probe_dt(pc);
341	if (ret)
342		return ret;
343
344	pc->clk = of_clk_get_by_name(dev->of_node, "pwm");
345	if (IS_ERR(pc->clk)) {
346		dev_err(dev, "failed to get PWM clock\n");
347		return PTR_ERR(pc->clk);
 
 
 
 
 
 
 
 
348	}
349
350	pc->clk_rate = clk_get_rate(pc->clk);
351	if (!pc->clk_rate) {
352		dev_err(dev, "failed to get clock rate\n");
353		return -EINVAL;
354	}
 
 
 
 
 
 
 
355
356	ret = clk_prepare(pc->clk);
357	if (ret) {
358		dev_err(dev, "failed to prepare clock\n");
359		return ret;
360	}
361
362	pc->chip.dev = dev;
363	pc->chip.ops = &sti_pwm_ops;
364	pc->chip.base = -1;
365	pc->chip.npwm = pc->cdata->num_chan;
366	pc->chip.can_sleep = true;
 
 
 
 
 
367
368	ret = pwmchip_add(&pc->chip);
369	if (ret < 0) {
370		clk_unprepare(pc->clk);
 
371		return ret;
372	}
373
374	platform_set_drvdata(pdev, pc);
375
376	return 0;
377}
378
379static int sti_pwm_remove(struct platform_device *pdev)
380{
381	struct sti_pwm_chip *pc = platform_get_drvdata(pdev);
382	unsigned int i;
383
384	for (i = 0; i < pc->cdata->num_chan; i++)
385		pwm_disable(&pc->chip.pwms[i]);
386
387	clk_unprepare(pc->clk);
388
389	return pwmchip_remove(&pc->chip);
 
390}
391
392static const struct of_device_id sti_pwm_of_match[] = {
393	{ .compatible = "st,sti-pwm", },
394	{ /* sentinel */ }
395};
396MODULE_DEVICE_TABLE(of, sti_pwm_of_match);
397
398static struct platform_driver sti_pwm_driver = {
399	.driver = {
400		.name = "sti-pwm",
401		.of_match_table = sti_pwm_of_match,
402	},
403	.probe = sti_pwm_probe,
404	.remove = sti_pwm_remove,
405};
406module_platform_driver(sti_pwm_driver);
407
408MODULE_AUTHOR("Ajit Pal Singh <ajitpal.singh@st.com>");
409MODULE_DESCRIPTION("STMicroelectronics ST PWM driver");
410MODULE_LICENSE("GPL");