2 * Copyright (C) 2014 Broadcom Corporation
4 * This program is free software; you can redistribute it and/or
5 * modify it under the terms of the GNU General Public License as
6 * published by the Free Software Foundation version 2.
8 * This program is distributed "as is" WITHOUT ANY WARRANTY of any
9 * kind, whether express or implied; without even the implied warranty
10 * of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
11 * GNU General Public License for more details.
14 #include <linux/clk.h>
15 #include <linux/delay.h>
16 #include <linux/err.h>
18 #include <linux/ioport.h>
19 #include <linux/math64.h>
20 #include <linux/module.h>
22 #include <linux/platform_device.h>
23 #include <linux/pwm.h>
24 #include <linux/slab.h>
25 #include <linux/types.h>
28 * The Kona PWM has some unusual characteristics. Here are the main points.
30 * 1) There is no disable bit and the hardware docs advise programming a zero
31 * duty to achieve output equivalent to that of a normal disable operation.
33 * 2) Changes to prescale, duty, period, and polarity do not take effect until
34 * a subsequent rising edge of the trigger bit.
36 * 3) If the smooth bit and trigger bit are both low, the output is a constant
37 * high signal. Otherwise, the earlier waveform continues to be output.
39 * 4) If the smooth bit is set on the rising edge of the trigger bit, output
40 * will transition to the new settings on a period boundary (which could be
41 * seconds away). If the smooth bit is clear, new settings will be applied
42 * as soon as possible (the hardware always has a 400ns delay).
44 * 5) When the external clock that feeds the PWM is disabled, output is pegged
45 * high or low depending on its state at that exact instant.
48 #define PWM_CONTROL_OFFSET (0x00000000)
49 #define PWM_CONTROL_SMOOTH_SHIFT(chan) (24 + (chan))
50 #define PWM_CONTROL_TYPE_SHIFT(chan) (16 + (chan))
51 #define PWM_CONTROL_POLARITY_SHIFT(chan) (8 + (chan))
52 #define PWM_CONTROL_TRIGGER_SHIFT(chan) (chan)
54 #define PRESCALE_OFFSET (0x00000004)
55 #define PRESCALE_SHIFT(chan) ((chan) << 2)
56 #define PRESCALE_MASK(chan) (0x7 << PRESCALE_SHIFT(chan))
57 #define PRESCALE_MIN (0x00000000)
58 #define PRESCALE_MAX (0x00000007)
60 #define PERIOD_COUNT_OFFSET(chan) (0x00000008 + ((chan) << 3))
61 #define PERIOD_COUNT_MIN (0x00000002)
62 #define PERIOD_COUNT_MAX (0x00ffffff)
64 #define DUTY_CYCLE_HIGH_OFFSET(chan) (0x0000000c + ((chan) << 3))
65 #define DUTY_CYCLE_HIGH_MIN (0x00000000)
66 #define DUTY_CYCLE_HIGH_MAX (0x00ffffff)
74 static inline struct kona_pwmc
*to_kona_pwmc(struct pwm_chip
*_chip
)
76 return container_of(_chip
, struct kona_pwmc
, chip
);
80 * Clear trigger bit but set smooth bit to maintain old output.
82 static void kona_pwmc_prepare_for_settings(struct kona_pwmc
*kp
,
85 unsigned int value
= readl(kp
->base
+ PWM_CONTROL_OFFSET
);
87 value
|= 1 << PWM_CONTROL_SMOOTH_SHIFT(chan
);
88 value
&= ~(1 << PWM_CONTROL_TRIGGER_SHIFT(chan
));
89 writel(value
, kp
->base
+ PWM_CONTROL_OFFSET
);
92 * There must be a min 400ns delay between clearing trigger and setting
93 * it. Failing to do this may result in no PWM signal.
98 static void kona_pwmc_apply_settings(struct kona_pwmc
*kp
, unsigned int chan
)
100 unsigned int value
= readl(kp
->base
+ PWM_CONTROL_OFFSET
);
102 /* Set trigger bit and clear smooth bit to apply new settings */
103 value
&= ~(1 << PWM_CONTROL_SMOOTH_SHIFT(chan
));
104 value
|= 1 << PWM_CONTROL_TRIGGER_SHIFT(chan
);
105 writel(value
, kp
->base
+ PWM_CONTROL_OFFSET
);
107 /* Trigger bit must be held high for at least 400 ns. */
111 static int kona_pwmc_config(struct pwm_chip
*chip
, struct pwm_device
*pwm
,
112 int duty_ns
, int period_ns
)
114 struct kona_pwmc
*kp
= to_kona_pwmc(chip
);
116 unsigned long prescale
= PRESCALE_MIN
, pc
, dc
;
117 unsigned int value
, chan
= pwm
->hwpwm
;
120 * Find period count, duty count and prescale to suit duty_ns and
121 * period_ns. This is done according to formulas described below:
123 * period_ns = 10^9 * (PRESCALE + 1) * PC / PWM_CLK_RATE
124 * duty_ns = 10^9 * (PRESCALE + 1) * DC / PWM_CLK_RATE
126 * PC = (PWM_CLK_RATE * period_ns) / (10^9 * (PRESCALE + 1))
127 * DC = (PWM_CLK_RATE * duty_ns) / (10^9 * (PRESCALE + 1))
130 rate
= clk_get_rate(kp
->clk
);
135 val
= rate
* period_ns
;
136 pc
= div64_u64(val
, div
);
137 val
= rate
* duty_ns
;
138 dc
= div64_u64(val
, div
);
140 /* If duty_ns or period_ns are not achievable then return */
141 if (pc
< PERIOD_COUNT_MIN
|| dc
< DUTY_CYCLE_HIGH_MIN
)
144 /* If pc and dc are in bounds, the calculation is done */
145 if (pc
<= PERIOD_COUNT_MAX
&& dc
<= DUTY_CYCLE_HIGH_MAX
)
148 /* Otherwise, increase prescale and recalculate pc and dc */
149 if (++prescale
> PRESCALE_MAX
)
154 * Don't apply settings if disabled. The period and duty cycle are
155 * always calculated above to ensure the new values are
156 * validated immediately instead of on enable.
158 if (pwm_is_enabled(pwm
)) {
159 kona_pwmc_prepare_for_settings(kp
, chan
);
161 value
= readl(kp
->base
+ PRESCALE_OFFSET
);
162 value
&= ~PRESCALE_MASK(chan
);
163 value
|= prescale
<< PRESCALE_SHIFT(chan
);
164 writel(value
, kp
->base
+ PRESCALE_OFFSET
);
166 writel(pc
, kp
->base
+ PERIOD_COUNT_OFFSET(chan
));
168 writel(dc
, kp
->base
+ DUTY_CYCLE_HIGH_OFFSET(chan
));
170 kona_pwmc_apply_settings(kp
, chan
);
176 static int kona_pwmc_set_polarity(struct pwm_chip
*chip
, struct pwm_device
*pwm
,
177 enum pwm_polarity polarity
)
179 struct kona_pwmc
*kp
= to_kona_pwmc(chip
);
180 unsigned int chan
= pwm
->hwpwm
;
184 ret
= clk_prepare_enable(kp
->clk
);
186 dev_err(chip
->dev
, "failed to enable clock: %d\n", ret
);
190 kona_pwmc_prepare_for_settings(kp
, chan
);
192 value
= readl(kp
->base
+ PWM_CONTROL_OFFSET
);
194 if (polarity
== PWM_POLARITY_NORMAL
)
195 value
|= 1 << PWM_CONTROL_POLARITY_SHIFT(chan
);
197 value
&= ~(1 << PWM_CONTROL_POLARITY_SHIFT(chan
));
199 writel(value
, kp
->base
+ PWM_CONTROL_OFFSET
);
201 kona_pwmc_apply_settings(kp
, chan
);
203 clk_disable_unprepare(kp
->clk
);
208 static int kona_pwmc_enable(struct pwm_chip
*chip
, struct pwm_device
*pwm
)
210 struct kona_pwmc
*kp
= to_kona_pwmc(chip
);
213 ret
= clk_prepare_enable(kp
->clk
);
215 dev_err(chip
->dev
, "failed to enable clock: %d\n", ret
);
219 ret
= kona_pwmc_config(chip
, pwm
, pwm_get_duty_cycle(pwm
),
220 pwm_get_period(pwm
));
222 clk_disable_unprepare(kp
->clk
);
229 static void kona_pwmc_disable(struct pwm_chip
*chip
, struct pwm_device
*pwm
)
231 struct kona_pwmc
*kp
= to_kona_pwmc(chip
);
232 unsigned int chan
= pwm
->hwpwm
;
235 kona_pwmc_prepare_for_settings(kp
, chan
);
237 /* Simulate a disable by configuring for zero duty */
238 writel(0, kp
->base
+ DUTY_CYCLE_HIGH_OFFSET(chan
));
239 writel(0, kp
->base
+ PERIOD_COUNT_OFFSET(chan
));
241 /* Set prescale to 0 for this channel */
242 value
= readl(kp
->base
+ PRESCALE_OFFSET
);
243 value
&= ~PRESCALE_MASK(chan
);
244 writel(value
, kp
->base
+ PRESCALE_OFFSET
);
246 kona_pwmc_apply_settings(kp
, chan
);
248 clk_disable_unprepare(kp
->clk
);
251 static const struct pwm_ops kona_pwm_ops
= {
252 .config
= kona_pwmc_config
,
253 .set_polarity
= kona_pwmc_set_polarity
,
254 .enable
= kona_pwmc_enable
,
255 .disable
= kona_pwmc_disable
,
256 .owner
= THIS_MODULE
,
259 static int kona_pwmc_probe(struct platform_device
*pdev
)
261 struct kona_pwmc
*kp
;
262 struct resource
*res
;
264 unsigned int value
= 0;
267 kp
= devm_kzalloc(&pdev
->dev
, sizeof(*kp
), GFP_KERNEL
);
271 platform_set_drvdata(pdev
, kp
);
273 kp
->chip
.dev
= &pdev
->dev
;
274 kp
->chip
.ops
= &kona_pwm_ops
;
277 kp
->chip
.of_xlate
= of_pwm_xlate_with_flags
;
278 kp
->chip
.of_pwm_n_cells
= 3;
280 res
= platform_get_resource(pdev
, IORESOURCE_MEM
, 0);
281 kp
->base
= devm_ioremap_resource(&pdev
->dev
, res
);
282 if (IS_ERR(kp
->base
))
283 return PTR_ERR(kp
->base
);
285 kp
->clk
= devm_clk_get(&pdev
->dev
, NULL
);
286 if (IS_ERR(kp
->clk
)) {
287 dev_err(&pdev
->dev
, "failed to get clock: %ld\n",
289 return PTR_ERR(kp
->clk
);
292 ret
= clk_prepare_enable(kp
->clk
);
294 dev_err(&pdev
->dev
, "failed to enable clock: %d\n", ret
);
298 /* Set push/pull for all channels */
299 for (chan
= 0; chan
< kp
->chip
.npwm
; chan
++)
300 value
|= (1 << PWM_CONTROL_TYPE_SHIFT(chan
));
302 writel(value
, kp
->base
+ PWM_CONTROL_OFFSET
);
304 clk_disable_unprepare(kp
->clk
);
306 ret
= pwmchip_add_with_polarity(&kp
->chip
, PWM_POLARITY_INVERSED
);
308 dev_err(&pdev
->dev
, "failed to add PWM chip: %d\n", ret
);
313 static int kona_pwmc_remove(struct platform_device
*pdev
)
315 struct kona_pwmc
*kp
= platform_get_drvdata(pdev
);
318 for (chan
= 0; chan
< kp
->chip
.npwm
; chan
++)
319 if (pwm_is_enabled(&kp
->chip
.pwms
[chan
]))
320 clk_disable_unprepare(kp
->clk
);
322 return pwmchip_remove(&kp
->chip
);
325 static const struct of_device_id bcm_kona_pwmc_dt
[] = {
326 { .compatible
= "brcm,kona-pwm" },
329 MODULE_DEVICE_TABLE(of
, bcm_kona_pwmc_dt
);
331 static struct platform_driver kona_pwmc_driver
= {
333 .name
= "bcm-kona-pwm",
334 .of_match_table
= bcm_kona_pwmc_dt
,
336 .probe
= kona_pwmc_probe
,
337 .remove
= kona_pwmc_remove
,
339 module_platform_driver(kona_pwmc_driver
);
341 MODULE_AUTHOR("Broadcom Corporation <bcm-kernel-feedback-list@broadcom.com>");
342 MODULE_AUTHOR("Tim Kryger <tkryger@broadcom.com>");
343 MODULE_DESCRIPTION("Broadcom Kona PWM driver");
344 MODULE_LICENSE("GPL v2");