1 // SPDX-License-Identifier: GPL-2.0
3 * simple driver for PWM (Pulse Width Modulator) controller
5 * Derived from pxa PWM driver by eric miao <eric.miao@marvell.com>
8 * - When disabled the output is driven to 0 independent of the configured
12 #include <linux/bitfield.h>
13 #include <linux/bitops.h>
14 #include <linux/clk.h>
15 #include <linux/delay.h>
16 #include <linux/err.h>
18 #include <linux/kernel.h>
19 #include <linux/module.h>
21 #include <linux/of_device.h>
22 #include <linux/platform_device.h>
23 #include <linux/pwm.h>
24 #include <linux/slab.h>
26 #define MX3_PWMCR 0x00 /* PWM Control Register */
27 #define MX3_PWMSR 0x04 /* PWM Status Register */
28 #define MX3_PWMSAR 0x0C /* PWM Sample Register */
29 #define MX3_PWMPR 0x10 /* PWM Period Register */
31 #define MX3_PWMCR_FWM GENMASK(27, 26)
32 #define MX3_PWMCR_STOPEN BIT(25)
33 #define MX3_PWMCR_DOZEN BIT(24)
34 #define MX3_PWMCR_WAITEN BIT(23)
35 #define MX3_PWMCR_DBGEN BIT(22)
36 #define MX3_PWMCR_BCTR BIT(21)
37 #define MX3_PWMCR_HCTR BIT(20)
39 #define MX3_PWMCR_POUTC GENMASK(19, 18)
40 #define MX3_PWMCR_POUTC_NORMAL 0
41 #define MX3_PWMCR_POUTC_INVERTED 1
42 #define MX3_PWMCR_POUTC_OFF 2
44 #define MX3_PWMCR_CLKSRC GENMASK(17, 16)
45 #define MX3_PWMCR_CLKSRC_OFF 0
46 #define MX3_PWMCR_CLKSRC_IPG 1
47 #define MX3_PWMCR_CLKSRC_IPG_HIGH 2
48 #define MX3_PWMCR_CLKSRC_IPG_32K 3
50 #define MX3_PWMCR_PRESCALER GENMASK(15, 4)
52 #define MX3_PWMCR_SWR BIT(3)
54 #define MX3_PWMCR_REPEAT GENMASK(2, 1)
55 #define MX3_PWMCR_REPEAT_1X 0
56 #define MX3_PWMCR_REPEAT_2X 1
57 #define MX3_PWMCR_REPEAT_4X 2
58 #define MX3_PWMCR_REPEAT_8X 3
60 #define MX3_PWMCR_EN BIT(0)
62 #define MX3_PWMSR_FWE BIT(6)
63 #define MX3_PWMSR_CMP BIT(5)
64 #define MX3_PWMSR_ROV BIT(4)
65 #define MX3_PWMSR_FE BIT(3)
67 #define MX3_PWMSR_FIFOAV GENMASK(2, 0)
68 #define MX3_PWMSR_FIFOAV_EMPTY 0
69 #define MX3_PWMSR_FIFOAV_1WORD 1
70 #define MX3_PWMSR_FIFOAV_2WORDS 2
71 #define MX3_PWMSR_FIFOAV_3WORDS 3
72 #define MX3_PWMSR_FIFOAV_4WORDS 4
74 #define MX3_PWMCR_PRESCALER_SET(x) FIELD_PREP(MX3_PWMCR_PRESCALER, (x) - 1)
75 #define MX3_PWMCR_PRESCALER_GET(x) (FIELD_GET(MX3_PWMCR_PRESCALER, \
78 #define MX3_PWM_SWR_LOOP 5
80 /* PWMPR register value of 0xffff has the same effect as 0xfffe */
81 #define MX3_PWMPR_MAX 0xfffe
83 struct pwm_imx27_chip {
86 void __iomem *mmio_base;
90 * The driver cannot read the current duty cycle from the hardware if
91 * the hardware is disabled. Cache the last programmed duty cycle
92 * value to return in that case.
94 unsigned int duty_cycle;
97 #define to_pwm_imx27_chip(chip) container_of(chip, struct pwm_imx27_chip, chip)
99 static int pwm_imx27_clk_prepare_enable(struct pwm_imx27_chip *imx)
103 ret = clk_prepare_enable(imx->clk_ipg);
107 ret = clk_prepare_enable(imx->clk_per);
109 clk_disable_unprepare(imx->clk_ipg);
116 static void pwm_imx27_clk_disable_unprepare(struct pwm_imx27_chip *imx)
118 clk_disable_unprepare(imx->clk_per);
119 clk_disable_unprepare(imx->clk_ipg);
122 static void pwm_imx27_get_state(struct pwm_chip *chip,
123 struct pwm_device *pwm, struct pwm_state *state)
125 struct pwm_imx27_chip *imx = to_pwm_imx27_chip(chip);
126 u32 period, prescaler, pwm_clk, val;
130 ret = pwm_imx27_clk_prepare_enable(imx);
134 val = readl(imx->mmio_base + MX3_PWMCR);
136 if (val & MX3_PWMCR_EN)
137 state->enabled = true;
139 state->enabled = false;
141 switch (FIELD_GET(MX3_PWMCR_POUTC, val)) {
142 case MX3_PWMCR_POUTC_NORMAL:
143 state->polarity = PWM_POLARITY_NORMAL;
145 case MX3_PWMCR_POUTC_INVERTED:
146 state->polarity = PWM_POLARITY_INVERSED;
149 dev_warn(chip->dev, "can't set polarity, output disconnected");
152 prescaler = MX3_PWMCR_PRESCALER_GET(val);
153 pwm_clk = clk_get_rate(imx->clk_per);
154 pwm_clk = DIV_ROUND_CLOSEST_ULL(pwm_clk, prescaler);
155 val = readl(imx->mmio_base + MX3_PWMPR);
156 period = val >= MX3_PWMPR_MAX ? MX3_PWMPR_MAX : val;
158 /* PWMOUT (Hz) = PWMCLK / (PWMPR + 2) */
159 tmp = NSEC_PER_SEC * (u64)(period + 2);
160 state->period = DIV_ROUND_CLOSEST_ULL(tmp, pwm_clk);
163 * PWMSAR can be read only if PWM is enabled. If the PWM is disabled,
164 * use the cached value.
167 val = readl(imx->mmio_base + MX3_PWMSAR);
169 val = imx->duty_cycle;
171 tmp = NSEC_PER_SEC * (u64)(val);
172 state->duty_cycle = DIV_ROUND_CLOSEST_ULL(tmp, pwm_clk);
174 pwm_imx27_clk_disable_unprepare(imx);
177 static void pwm_imx27_sw_reset(struct pwm_chip *chip)
179 struct pwm_imx27_chip *imx = to_pwm_imx27_chip(chip);
180 struct device *dev = chip->dev;
184 writel(MX3_PWMCR_SWR, imx->mmio_base + MX3_PWMCR);
186 usleep_range(200, 1000);
187 cr = readl(imx->mmio_base + MX3_PWMCR);
188 } while ((cr & MX3_PWMCR_SWR) &&
189 (wait_count++ < MX3_PWM_SWR_LOOP));
191 if (cr & MX3_PWMCR_SWR)
192 dev_warn(dev, "software reset timeout\n");
195 static void pwm_imx27_wait_fifo_slot(struct pwm_chip *chip,
196 struct pwm_device *pwm)
198 struct pwm_imx27_chip *imx = to_pwm_imx27_chip(chip);
199 struct device *dev = chip->dev;
200 unsigned int period_ms;
204 sr = readl(imx->mmio_base + MX3_PWMSR);
205 fifoav = FIELD_GET(MX3_PWMSR_FIFOAV, sr);
206 if (fifoav == MX3_PWMSR_FIFOAV_4WORDS) {
207 period_ms = DIV_ROUND_UP(pwm_get_period(pwm),
211 sr = readl(imx->mmio_base + MX3_PWMSR);
212 if (fifoav == FIELD_GET(MX3_PWMSR_FIFOAV, sr))
213 dev_warn(dev, "there is no free FIFO slot\n");
217 static int pwm_imx27_apply(struct pwm_chip *chip, struct pwm_device *pwm,
218 const struct pwm_state *state)
220 unsigned long period_cycles, duty_cycles, prescale;
221 struct pwm_imx27_chip *imx = to_pwm_imx27_chip(chip);
222 struct pwm_state cstate;
223 unsigned long long c;
227 pwm_get_state(pwm, &cstate);
229 c = clk_get_rate(imx->clk_per);
232 do_div(c, 1000000000);
235 prescale = period_cycles / 0x10000 + 1;
237 period_cycles /= prescale;
238 c = (unsigned long long)period_cycles * state->duty_cycle;
239 do_div(c, state->period);
243 * according to imx pwm RM, the real period value should be PERIOD
244 * value in PWMPR plus 2.
246 if (period_cycles > 2)
252 * Wait for a free FIFO slot if the PWM is already enabled, and flush
253 * the FIFO if the PWM was disabled and is about to be enabled.
255 if (cstate.enabled) {
256 pwm_imx27_wait_fifo_slot(chip, pwm);
258 ret = pwm_imx27_clk_prepare_enable(imx);
262 pwm_imx27_sw_reset(chip);
265 writel(duty_cycles, imx->mmio_base + MX3_PWMSAR);
266 writel(period_cycles, imx->mmio_base + MX3_PWMPR);
269 * Store the duty cycle for future reference in cases where the
270 * MX3_PWMSAR register can't be read (i.e. when the PWM is disabled).
272 imx->duty_cycle = duty_cycles;
274 cr = MX3_PWMCR_PRESCALER_SET(prescale) |
275 MX3_PWMCR_STOPEN | MX3_PWMCR_DOZEN | MX3_PWMCR_WAITEN |
276 FIELD_PREP(MX3_PWMCR_CLKSRC, MX3_PWMCR_CLKSRC_IPG_HIGH) |
279 if (state->polarity == PWM_POLARITY_INVERSED)
280 cr |= FIELD_PREP(MX3_PWMCR_POUTC,
281 MX3_PWMCR_POUTC_INVERTED);
286 writel(cr, imx->mmio_base + MX3_PWMCR);
289 pwm_imx27_clk_disable_unprepare(imx);
294 static const struct pwm_ops pwm_imx27_ops = {
295 .apply = pwm_imx27_apply,
296 .get_state = pwm_imx27_get_state,
297 .owner = THIS_MODULE,
300 static const struct of_device_id pwm_imx27_dt_ids[] = {
301 { .compatible = "fsl,imx27-pwm", },
304 MODULE_DEVICE_TABLE(of, pwm_imx27_dt_ids);
306 static int pwm_imx27_probe(struct platform_device *pdev)
308 struct pwm_imx27_chip *imx;
312 imx = devm_kzalloc(&pdev->dev, sizeof(*imx), GFP_KERNEL);
316 platform_set_drvdata(pdev, imx);
318 imx->clk_ipg = devm_clk_get(&pdev->dev, "ipg");
319 if (IS_ERR(imx->clk_ipg)) {
320 int ret = PTR_ERR(imx->clk_ipg);
322 if (ret != -EPROBE_DEFER)
324 "getting ipg clock failed with %d\n",
329 imx->clk_per = devm_clk_get(&pdev->dev, "per");
330 if (IS_ERR(imx->clk_per)) {
331 int ret = PTR_ERR(imx->clk_per);
333 if (ret != -EPROBE_DEFER)
335 "failed to get peripheral clock: %d\n",
341 imx->chip.ops = &pwm_imx27_ops;
342 imx->chip.dev = &pdev->dev;
346 imx->chip.of_xlate = of_pwm_xlate_with_flags;
347 imx->chip.of_pwm_n_cells = 3;
349 imx->mmio_base = devm_platform_ioremap_resource(pdev, 0);
350 if (IS_ERR(imx->mmio_base))
351 return PTR_ERR(imx->mmio_base);
353 ret = pwm_imx27_clk_prepare_enable(imx);
357 /* keep clks on if pwm is running */
358 pwmcr = readl(imx->mmio_base + MX3_PWMCR);
359 if (!(pwmcr & MX3_PWMCR_EN))
360 pwm_imx27_clk_disable_unprepare(imx);
362 return pwmchip_add(&imx->chip);
365 static int pwm_imx27_remove(struct platform_device *pdev)
367 struct pwm_imx27_chip *imx;
369 imx = platform_get_drvdata(pdev);
371 return pwmchip_remove(&imx->chip);
374 static struct platform_driver imx_pwm_driver = {
377 .of_match_table = pwm_imx27_dt_ids,
379 .probe = pwm_imx27_probe,
380 .remove = pwm_imx27_remove,
382 module_platform_driver(imx_pwm_driver);
384 MODULE_LICENSE("GPL v2");
385 MODULE_AUTHOR("Sascha Hauer <s.hauer@pengutronix.de>");