Loading...
1// SPDX-License-Identifier: GPL-2.0-or-later
2/*
3 * EHRPWM PWM driver
4 *
5 * Copyright (C) 2012 Texas Instruments, Inc. - https://www.ti.com/
6 */
7
8#include <linux/module.h>
9#include <linux/platform_device.h>
10#include <linux/pwm.h>
11#include <linux/io.h>
12#include <linux/err.h>
13#include <linux/clk.h>
14#include <linux/pm_runtime.h>
15#include <linux/of_device.h>
16
17/* EHRPWM registers and bits definitions */
18
19/* Time base module registers */
20#define TBCTL 0x00
21#define TBPRD 0x0A
22
23#define TBCTL_PRDLD_MASK BIT(3)
24#define TBCTL_PRDLD_SHDW 0
25#define TBCTL_PRDLD_IMDT BIT(3)
26#define TBCTL_CLKDIV_MASK (BIT(12) | BIT(11) | BIT(10) | BIT(9) | \
27 BIT(8) | BIT(7))
28#define TBCTL_CTRMODE_MASK (BIT(1) | BIT(0))
29#define TBCTL_CTRMODE_UP 0
30#define TBCTL_CTRMODE_DOWN BIT(0)
31#define TBCTL_CTRMODE_UPDOWN BIT(1)
32#define TBCTL_CTRMODE_FREEZE (BIT(1) | BIT(0))
33
34#define TBCTL_HSPCLKDIV_SHIFT 7
35#define TBCTL_CLKDIV_SHIFT 10
36
37#define CLKDIV_MAX 7
38#define HSPCLKDIV_MAX 7
39#define PERIOD_MAX 0xFFFF
40
41/* compare module registers */
42#define CMPA 0x12
43#define CMPB 0x14
44
45/* Action qualifier module registers */
46#define AQCTLA 0x16
47#define AQCTLB 0x18
48#define AQSFRC 0x1A
49#define AQCSFRC 0x1C
50
51#define AQCTL_CBU_MASK (BIT(9) | BIT(8))
52#define AQCTL_CBU_FRCLOW BIT(8)
53#define AQCTL_CBU_FRCHIGH BIT(9)
54#define AQCTL_CBU_FRCTOGGLE (BIT(9) | BIT(8))
55#define AQCTL_CAU_MASK (BIT(5) | BIT(4))
56#define AQCTL_CAU_FRCLOW BIT(4)
57#define AQCTL_CAU_FRCHIGH BIT(5)
58#define AQCTL_CAU_FRCTOGGLE (BIT(5) | BIT(4))
59#define AQCTL_PRD_MASK (BIT(3) | BIT(2))
60#define AQCTL_PRD_FRCLOW BIT(2)
61#define AQCTL_PRD_FRCHIGH BIT(3)
62#define AQCTL_PRD_FRCTOGGLE (BIT(3) | BIT(2))
63#define AQCTL_ZRO_MASK (BIT(1) | BIT(0))
64#define AQCTL_ZRO_FRCLOW BIT(0)
65#define AQCTL_ZRO_FRCHIGH BIT(1)
66#define AQCTL_ZRO_FRCTOGGLE (BIT(1) | BIT(0))
67
68#define AQCTL_CHANA_POLNORMAL (AQCTL_CAU_FRCLOW | AQCTL_PRD_FRCHIGH | \
69 AQCTL_ZRO_FRCHIGH)
70#define AQCTL_CHANA_POLINVERSED (AQCTL_CAU_FRCHIGH | AQCTL_PRD_FRCLOW | \
71 AQCTL_ZRO_FRCLOW)
72#define AQCTL_CHANB_POLNORMAL (AQCTL_CBU_FRCLOW | AQCTL_PRD_FRCHIGH | \
73 AQCTL_ZRO_FRCHIGH)
74#define AQCTL_CHANB_POLINVERSED (AQCTL_CBU_FRCHIGH | AQCTL_PRD_FRCLOW | \
75 AQCTL_ZRO_FRCLOW)
76
77#define AQSFRC_RLDCSF_MASK (BIT(7) | BIT(6))
78#define AQSFRC_RLDCSF_ZRO 0
79#define AQSFRC_RLDCSF_PRD BIT(6)
80#define AQSFRC_RLDCSF_ZROPRD BIT(7)
81#define AQSFRC_RLDCSF_IMDT (BIT(7) | BIT(6))
82
83#define AQCSFRC_CSFB_MASK (BIT(3) | BIT(2))
84#define AQCSFRC_CSFB_FRCDIS 0
85#define AQCSFRC_CSFB_FRCLOW BIT(2)
86#define AQCSFRC_CSFB_FRCHIGH BIT(3)
87#define AQCSFRC_CSFB_DISSWFRC (BIT(3) | BIT(2))
88#define AQCSFRC_CSFA_MASK (BIT(1) | BIT(0))
89#define AQCSFRC_CSFA_FRCDIS 0
90#define AQCSFRC_CSFA_FRCLOW BIT(0)
91#define AQCSFRC_CSFA_FRCHIGH BIT(1)
92#define AQCSFRC_CSFA_DISSWFRC (BIT(1) | BIT(0))
93
94#define NUM_PWM_CHANNEL 2 /* EHRPWM channels */
95
96struct ehrpwm_context {
97 u16 tbctl;
98 u16 tbprd;
99 u16 cmpa;
100 u16 cmpb;
101 u16 aqctla;
102 u16 aqctlb;
103 u16 aqsfrc;
104 u16 aqcsfrc;
105};
106
107struct ehrpwm_pwm_chip {
108 struct pwm_chip chip;
109 unsigned long clk_rate;
110 void __iomem *mmio_base;
111 unsigned long period_cycles[NUM_PWM_CHANNEL];
112 enum pwm_polarity polarity[NUM_PWM_CHANNEL];
113 struct clk *tbclk;
114 struct ehrpwm_context ctx;
115};
116
117static inline struct ehrpwm_pwm_chip *to_ehrpwm_pwm_chip(struct pwm_chip *chip)
118{
119 return container_of(chip, struct ehrpwm_pwm_chip, chip);
120}
121
122static inline u16 ehrpwm_read(void __iomem *base, unsigned int offset)
123{
124 return readw(base + offset);
125}
126
127static inline void ehrpwm_write(void __iomem *base, unsigned int offset,
128 u16 value)
129{
130 writew(value, base + offset);
131}
132
133static void ehrpwm_modify(void __iomem *base, unsigned int offset, u16 mask,
134 u16 value)
135{
136 unsigned short val;
137
138 val = readw(base + offset);
139 val &= ~mask;
140 val |= value & mask;
141 writew(val, base + offset);
142}
143
144/**
145 * set_prescale_div - Set up the prescaler divider function
146 * @rqst_prescaler: prescaler value min
147 * @prescale_div: prescaler value set
148 * @tb_clk_div: Time Base Control prescaler bits
149 */
150static int set_prescale_div(unsigned long rqst_prescaler, u16 *prescale_div,
151 u16 *tb_clk_div)
152{
153 unsigned int clkdiv, hspclkdiv;
154
155 for (clkdiv = 0; clkdiv <= CLKDIV_MAX; clkdiv++) {
156 for (hspclkdiv = 0; hspclkdiv <= HSPCLKDIV_MAX; hspclkdiv++) {
157 /*
158 * calculations for prescaler value :
159 * prescale_div = HSPCLKDIVIDER * CLKDIVIDER.
160 * HSPCLKDIVIDER = 2 ** hspclkdiv
161 * CLKDIVIDER = (1), if clkdiv == 0 *OR*
162 * (2 * clkdiv), if clkdiv != 0
163 *
164 * Configure prescale_div value such that period
165 * register value is less than 65535.
166 */
167
168 *prescale_div = (1 << clkdiv) *
169 (hspclkdiv ? (hspclkdiv * 2) : 1);
170 if (*prescale_div > rqst_prescaler) {
171 *tb_clk_div = (clkdiv << TBCTL_CLKDIV_SHIFT) |
172 (hspclkdiv << TBCTL_HSPCLKDIV_SHIFT);
173 return 0;
174 }
175 }
176 }
177
178 return 1;
179}
180
181static void configure_polarity(struct ehrpwm_pwm_chip *pc, int chan)
182{
183 u16 aqctl_val, aqctl_mask;
184 unsigned int aqctl_reg;
185
186 /*
187 * Configure PWM output to HIGH/LOW level on counter
188 * reaches compare register value and LOW/HIGH level
189 * on counter value reaches period register value and
190 * zero value on counter
191 */
192 if (chan == 1) {
193 aqctl_reg = AQCTLB;
194 aqctl_mask = AQCTL_CBU_MASK;
195
196 if (pc->polarity[chan] == PWM_POLARITY_INVERSED)
197 aqctl_val = AQCTL_CHANB_POLINVERSED;
198 else
199 aqctl_val = AQCTL_CHANB_POLNORMAL;
200 } else {
201 aqctl_reg = AQCTLA;
202 aqctl_mask = AQCTL_CAU_MASK;
203
204 if (pc->polarity[chan] == PWM_POLARITY_INVERSED)
205 aqctl_val = AQCTL_CHANA_POLINVERSED;
206 else
207 aqctl_val = AQCTL_CHANA_POLNORMAL;
208 }
209
210 aqctl_mask |= AQCTL_PRD_MASK | AQCTL_ZRO_MASK;
211 ehrpwm_modify(pc->mmio_base, aqctl_reg, aqctl_mask, aqctl_val);
212}
213
214/*
215 * period_ns = 10^9 * (ps_divval * period_cycles) / PWM_CLK_RATE
216 * duty_ns = 10^9 * (ps_divval * duty_cycles) / PWM_CLK_RATE
217 */
218static int ehrpwm_pwm_config(struct pwm_chip *chip, struct pwm_device *pwm,
219 int duty_ns, int period_ns)
220{
221 struct ehrpwm_pwm_chip *pc = to_ehrpwm_pwm_chip(chip);
222 u32 period_cycles, duty_cycles;
223 u16 ps_divval, tb_divval;
224 unsigned int i, cmp_reg;
225 unsigned long long c;
226
227 if (period_ns > NSEC_PER_SEC)
228 return -ERANGE;
229
230 c = pc->clk_rate;
231 c = c * period_ns;
232 do_div(c, NSEC_PER_SEC);
233 period_cycles = (unsigned long)c;
234
235 if (period_cycles < 1) {
236 period_cycles = 1;
237 duty_cycles = 1;
238 } else {
239 c = pc->clk_rate;
240 c = c * duty_ns;
241 do_div(c, NSEC_PER_SEC);
242 duty_cycles = (unsigned long)c;
243 }
244
245 /*
246 * Period values should be same for multiple PWM channels as IP uses
247 * same period register for multiple channels.
248 */
249 for (i = 0; i < NUM_PWM_CHANNEL; i++) {
250 if (pc->period_cycles[i] &&
251 (pc->period_cycles[i] != period_cycles)) {
252 /*
253 * Allow channel to reconfigure period if no other
254 * channels being configured.
255 */
256 if (i == pwm->hwpwm)
257 continue;
258
259 dev_err(chip->dev,
260 "period value conflicts with channel %u\n",
261 i);
262 return -EINVAL;
263 }
264 }
265
266 pc->period_cycles[pwm->hwpwm] = period_cycles;
267
268 /* Configure clock prescaler to support Low frequency PWM wave */
269 if (set_prescale_div(period_cycles/PERIOD_MAX, &ps_divval,
270 &tb_divval)) {
271 dev_err(chip->dev, "Unsupported values\n");
272 return -EINVAL;
273 }
274
275 pm_runtime_get_sync(chip->dev);
276
277 /* Update clock prescaler values */
278 ehrpwm_modify(pc->mmio_base, TBCTL, TBCTL_CLKDIV_MASK, tb_divval);
279
280 /* Update period & duty cycle with presacler division */
281 period_cycles = period_cycles / ps_divval;
282 duty_cycles = duty_cycles / ps_divval;
283
284 /* Configure shadow loading on Period register */
285 ehrpwm_modify(pc->mmio_base, TBCTL, TBCTL_PRDLD_MASK, TBCTL_PRDLD_SHDW);
286
287 ehrpwm_write(pc->mmio_base, TBPRD, period_cycles);
288
289 /* Configure ehrpwm counter for up-count mode */
290 ehrpwm_modify(pc->mmio_base, TBCTL, TBCTL_CTRMODE_MASK,
291 TBCTL_CTRMODE_UP);
292
293 if (pwm->hwpwm == 1)
294 /* Channel 1 configured with compare B register */
295 cmp_reg = CMPB;
296 else
297 /* Channel 0 configured with compare A register */
298 cmp_reg = CMPA;
299
300 ehrpwm_write(pc->mmio_base, cmp_reg, duty_cycles);
301
302 pm_runtime_put_sync(chip->dev);
303
304 return 0;
305}
306
307static int ehrpwm_pwm_set_polarity(struct pwm_chip *chip,
308 struct pwm_device *pwm,
309 enum pwm_polarity polarity)
310{
311 struct ehrpwm_pwm_chip *pc = to_ehrpwm_pwm_chip(chip);
312
313 /* Configuration of polarity in hardware delayed, do at enable */
314 pc->polarity[pwm->hwpwm] = polarity;
315
316 return 0;
317}
318
319static int ehrpwm_pwm_enable(struct pwm_chip *chip, struct pwm_device *pwm)
320{
321 struct ehrpwm_pwm_chip *pc = to_ehrpwm_pwm_chip(chip);
322 u16 aqcsfrc_val, aqcsfrc_mask;
323 int ret;
324
325 /* Leave clock enabled on enabling PWM */
326 pm_runtime_get_sync(chip->dev);
327
328 /* Disabling Action Qualifier on PWM output */
329 if (pwm->hwpwm) {
330 aqcsfrc_val = AQCSFRC_CSFB_FRCDIS;
331 aqcsfrc_mask = AQCSFRC_CSFB_MASK;
332 } else {
333 aqcsfrc_val = AQCSFRC_CSFA_FRCDIS;
334 aqcsfrc_mask = AQCSFRC_CSFA_MASK;
335 }
336
337 /* Changes to shadow mode */
338 ehrpwm_modify(pc->mmio_base, AQSFRC, AQSFRC_RLDCSF_MASK,
339 AQSFRC_RLDCSF_ZRO);
340
341 ehrpwm_modify(pc->mmio_base, AQCSFRC, aqcsfrc_mask, aqcsfrc_val);
342
343 /* Channels polarity can be configured from action qualifier module */
344 configure_polarity(pc, pwm->hwpwm);
345
346 /* Enable TBCLK */
347 ret = clk_enable(pc->tbclk);
348 if (ret) {
349 dev_err(chip->dev, "Failed to enable TBCLK for %s: %d\n",
350 dev_name(pc->chip.dev), ret);
351 return ret;
352 }
353
354 return 0;
355}
356
357static void ehrpwm_pwm_disable(struct pwm_chip *chip, struct pwm_device *pwm)
358{
359 struct ehrpwm_pwm_chip *pc = to_ehrpwm_pwm_chip(chip);
360 u16 aqcsfrc_val, aqcsfrc_mask;
361
362 /* Action Qualifier puts PWM output low forcefully */
363 if (pwm->hwpwm) {
364 aqcsfrc_val = AQCSFRC_CSFB_FRCLOW;
365 aqcsfrc_mask = AQCSFRC_CSFB_MASK;
366 } else {
367 aqcsfrc_val = AQCSFRC_CSFA_FRCLOW;
368 aqcsfrc_mask = AQCSFRC_CSFA_MASK;
369 }
370
371 /* Update shadow register first before modifying active register */
372 ehrpwm_modify(pc->mmio_base, AQSFRC, AQSFRC_RLDCSF_MASK,
373 AQSFRC_RLDCSF_ZRO);
374 ehrpwm_modify(pc->mmio_base, AQCSFRC, aqcsfrc_mask, aqcsfrc_val);
375 /*
376 * Changes to immediate action on Action Qualifier. This puts
377 * Action Qualifier control on PWM output from next TBCLK
378 */
379 ehrpwm_modify(pc->mmio_base, AQSFRC, AQSFRC_RLDCSF_MASK,
380 AQSFRC_RLDCSF_IMDT);
381
382 ehrpwm_modify(pc->mmio_base, AQCSFRC, aqcsfrc_mask, aqcsfrc_val);
383
384 /* Disabling TBCLK on PWM disable */
385 clk_disable(pc->tbclk);
386
387 /* Disable clock on PWM disable */
388 pm_runtime_put_sync(chip->dev);
389}
390
391static void ehrpwm_pwm_free(struct pwm_chip *chip, struct pwm_device *pwm)
392{
393 struct ehrpwm_pwm_chip *pc = to_ehrpwm_pwm_chip(chip);
394
395 if (pwm_is_enabled(pwm)) {
396 dev_warn(chip->dev, "Removing PWM device without disabling\n");
397 pm_runtime_put_sync(chip->dev);
398 }
399
400 /* set period value to zero on free */
401 pc->period_cycles[pwm->hwpwm] = 0;
402}
403
404static const struct pwm_ops ehrpwm_pwm_ops = {
405 .free = ehrpwm_pwm_free,
406 .config = ehrpwm_pwm_config,
407 .set_polarity = ehrpwm_pwm_set_polarity,
408 .enable = ehrpwm_pwm_enable,
409 .disable = ehrpwm_pwm_disable,
410 .owner = THIS_MODULE,
411};
412
413static const struct of_device_id ehrpwm_of_match[] = {
414 { .compatible = "ti,am3352-ehrpwm" },
415 { .compatible = "ti,am33xx-ehrpwm" },
416 {},
417};
418MODULE_DEVICE_TABLE(of, ehrpwm_of_match);
419
420static int ehrpwm_pwm_probe(struct platform_device *pdev)
421{
422 struct device_node *np = pdev->dev.of_node;
423 struct ehrpwm_pwm_chip *pc;
424 struct resource *r;
425 struct clk *clk;
426 int ret;
427
428 pc = devm_kzalloc(&pdev->dev, sizeof(*pc), GFP_KERNEL);
429 if (!pc)
430 return -ENOMEM;
431
432 clk = devm_clk_get(&pdev->dev, "fck");
433 if (IS_ERR(clk)) {
434 if (of_device_is_compatible(np, "ti,am33xx-ecap")) {
435 dev_warn(&pdev->dev, "Binding is obsolete.\n");
436 clk = devm_clk_get(pdev->dev.parent, "fck");
437 }
438 }
439
440 if (IS_ERR(clk)) {
441 dev_err(&pdev->dev, "failed to get clock\n");
442 return PTR_ERR(clk);
443 }
444
445 pc->clk_rate = clk_get_rate(clk);
446 if (!pc->clk_rate) {
447 dev_err(&pdev->dev, "failed to get clock rate\n");
448 return -EINVAL;
449 }
450
451 pc->chip.dev = &pdev->dev;
452 pc->chip.ops = &ehrpwm_pwm_ops;
453 pc->chip.of_xlate = of_pwm_xlate_with_flags;
454 pc->chip.of_pwm_n_cells = 3;
455 pc->chip.base = -1;
456 pc->chip.npwm = NUM_PWM_CHANNEL;
457
458 r = platform_get_resource(pdev, IORESOURCE_MEM, 0);
459 pc->mmio_base = devm_ioremap_resource(&pdev->dev, r);
460 if (IS_ERR(pc->mmio_base))
461 return PTR_ERR(pc->mmio_base);
462
463 /* Acquire tbclk for Time Base EHRPWM submodule */
464 pc->tbclk = devm_clk_get(&pdev->dev, "tbclk");
465 if (IS_ERR(pc->tbclk)) {
466 dev_err(&pdev->dev, "Failed to get tbclk\n");
467 return PTR_ERR(pc->tbclk);
468 }
469
470 ret = clk_prepare(pc->tbclk);
471 if (ret < 0) {
472 dev_err(&pdev->dev, "clk_prepare() failed: %d\n", ret);
473 return ret;
474 }
475
476 ret = pwmchip_add(&pc->chip);
477 if (ret < 0) {
478 dev_err(&pdev->dev, "pwmchip_add() failed: %d\n", ret);
479 goto err_clk_unprepare;
480 }
481
482 platform_set_drvdata(pdev, pc);
483 pm_runtime_enable(&pdev->dev);
484
485 return 0;
486
487err_clk_unprepare:
488 clk_unprepare(pc->tbclk);
489
490 return ret;
491}
492
493static int ehrpwm_pwm_remove(struct platform_device *pdev)
494{
495 struct ehrpwm_pwm_chip *pc = platform_get_drvdata(pdev);
496
497 clk_unprepare(pc->tbclk);
498
499 pm_runtime_disable(&pdev->dev);
500
501 return pwmchip_remove(&pc->chip);
502}
503
504#ifdef CONFIG_PM_SLEEP
505static void ehrpwm_pwm_save_context(struct ehrpwm_pwm_chip *pc)
506{
507 pm_runtime_get_sync(pc->chip.dev);
508
509 pc->ctx.tbctl = ehrpwm_read(pc->mmio_base, TBCTL);
510 pc->ctx.tbprd = ehrpwm_read(pc->mmio_base, TBPRD);
511 pc->ctx.cmpa = ehrpwm_read(pc->mmio_base, CMPA);
512 pc->ctx.cmpb = ehrpwm_read(pc->mmio_base, CMPB);
513 pc->ctx.aqctla = ehrpwm_read(pc->mmio_base, AQCTLA);
514 pc->ctx.aqctlb = ehrpwm_read(pc->mmio_base, AQCTLB);
515 pc->ctx.aqsfrc = ehrpwm_read(pc->mmio_base, AQSFRC);
516 pc->ctx.aqcsfrc = ehrpwm_read(pc->mmio_base, AQCSFRC);
517
518 pm_runtime_put_sync(pc->chip.dev);
519}
520
521static void ehrpwm_pwm_restore_context(struct ehrpwm_pwm_chip *pc)
522{
523 ehrpwm_write(pc->mmio_base, TBPRD, pc->ctx.tbprd);
524 ehrpwm_write(pc->mmio_base, CMPA, pc->ctx.cmpa);
525 ehrpwm_write(pc->mmio_base, CMPB, pc->ctx.cmpb);
526 ehrpwm_write(pc->mmio_base, AQCTLA, pc->ctx.aqctla);
527 ehrpwm_write(pc->mmio_base, AQCTLB, pc->ctx.aqctlb);
528 ehrpwm_write(pc->mmio_base, AQSFRC, pc->ctx.aqsfrc);
529 ehrpwm_write(pc->mmio_base, AQCSFRC, pc->ctx.aqcsfrc);
530 ehrpwm_write(pc->mmio_base, TBCTL, pc->ctx.tbctl);
531}
532
533static int ehrpwm_pwm_suspend(struct device *dev)
534{
535 struct ehrpwm_pwm_chip *pc = dev_get_drvdata(dev);
536 unsigned int i;
537
538 ehrpwm_pwm_save_context(pc);
539
540 for (i = 0; i < pc->chip.npwm; i++) {
541 struct pwm_device *pwm = &pc->chip.pwms[i];
542
543 if (!pwm_is_enabled(pwm))
544 continue;
545
546 /* Disable explicitly if PWM is running */
547 pm_runtime_put_sync(dev);
548 }
549
550 return 0;
551}
552
553static int ehrpwm_pwm_resume(struct device *dev)
554{
555 struct ehrpwm_pwm_chip *pc = dev_get_drvdata(dev);
556 unsigned int i;
557
558 for (i = 0; i < pc->chip.npwm; i++) {
559 struct pwm_device *pwm = &pc->chip.pwms[i];
560
561 if (!pwm_is_enabled(pwm))
562 continue;
563
564 /* Enable explicitly if PWM was running */
565 pm_runtime_get_sync(dev);
566 }
567
568 ehrpwm_pwm_restore_context(pc);
569
570 return 0;
571}
572#endif
573
574static SIMPLE_DEV_PM_OPS(ehrpwm_pwm_pm_ops, ehrpwm_pwm_suspend,
575 ehrpwm_pwm_resume);
576
577static struct platform_driver ehrpwm_pwm_driver = {
578 .driver = {
579 .name = "ehrpwm",
580 .of_match_table = ehrpwm_of_match,
581 .pm = &ehrpwm_pwm_pm_ops,
582 },
583 .probe = ehrpwm_pwm_probe,
584 .remove = ehrpwm_pwm_remove,
585};
586module_platform_driver(ehrpwm_pwm_driver);
587
588MODULE_DESCRIPTION("EHRPWM PWM driver");
589MODULE_AUTHOR("Texas Instruments");
590MODULE_LICENSE("GPL");
1/*
2 * EHRPWM PWM driver
3 *
4 * Copyright (C) 2012 Texas Instruments, Inc. - http://www.ti.com/
5 *
6 * This program is free software; you can redistribute it and/or modify
7 * it under the terms of the GNU General Public License as published by
8 * the Free Software Foundation; either version 2 of the License, or
9 * (at your option) any later version.
10 *
11 * This program is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 * GNU General Public License for more details.
15 *
16 * You should have received a copy of the GNU General Public License
17 * along with this program; if not, write to the Free Software
18 * Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
19 */
20
21#include <linux/module.h>
22#include <linux/platform_device.h>
23#include <linux/pwm.h>
24#include <linux/io.h>
25#include <linux/err.h>
26#include <linux/clk.h>
27#include <linux/pm_runtime.h>
28#include <linux/of_device.h>
29
30/* EHRPWM registers and bits definitions */
31
32/* Time base module registers */
33#define TBCTL 0x00
34#define TBPRD 0x0A
35
36#define TBCTL_RUN_MASK (BIT(15) | BIT(14))
37#define TBCTL_STOP_NEXT 0
38#define TBCTL_STOP_ON_CYCLE BIT(14)
39#define TBCTL_FREE_RUN (BIT(15) | BIT(14))
40#define TBCTL_PRDLD_MASK BIT(3)
41#define TBCTL_PRDLD_SHDW 0
42#define TBCTL_PRDLD_IMDT BIT(3)
43#define TBCTL_CLKDIV_MASK (BIT(12) | BIT(11) | BIT(10) | BIT(9) | \
44 BIT(8) | BIT(7))
45#define TBCTL_CTRMODE_MASK (BIT(1) | BIT(0))
46#define TBCTL_CTRMODE_UP 0
47#define TBCTL_CTRMODE_DOWN BIT(0)
48#define TBCTL_CTRMODE_UPDOWN BIT(1)
49#define TBCTL_CTRMODE_FREEZE (BIT(1) | BIT(0))
50
51#define TBCTL_HSPCLKDIV_SHIFT 7
52#define TBCTL_CLKDIV_SHIFT 10
53
54#define CLKDIV_MAX 7
55#define HSPCLKDIV_MAX 7
56#define PERIOD_MAX 0xFFFF
57
58/* compare module registers */
59#define CMPA 0x12
60#define CMPB 0x14
61
62/* Action qualifier module registers */
63#define AQCTLA 0x16
64#define AQCTLB 0x18
65#define AQSFRC 0x1A
66#define AQCSFRC 0x1C
67
68#define AQCTL_CBU_MASK (BIT(9) | BIT(8))
69#define AQCTL_CBU_FRCLOW BIT(8)
70#define AQCTL_CBU_FRCHIGH BIT(9)
71#define AQCTL_CBU_FRCTOGGLE (BIT(9) | BIT(8))
72#define AQCTL_CAU_MASK (BIT(5) | BIT(4))
73#define AQCTL_CAU_FRCLOW BIT(4)
74#define AQCTL_CAU_FRCHIGH BIT(5)
75#define AQCTL_CAU_FRCTOGGLE (BIT(5) | BIT(4))
76#define AQCTL_PRD_MASK (BIT(3) | BIT(2))
77#define AQCTL_PRD_FRCLOW BIT(2)
78#define AQCTL_PRD_FRCHIGH BIT(3)
79#define AQCTL_PRD_FRCTOGGLE (BIT(3) | BIT(2))
80#define AQCTL_ZRO_MASK (BIT(1) | BIT(0))
81#define AQCTL_ZRO_FRCLOW BIT(0)
82#define AQCTL_ZRO_FRCHIGH BIT(1)
83#define AQCTL_ZRO_FRCTOGGLE (BIT(1) | BIT(0))
84
85#define AQCTL_CHANA_POLNORMAL (AQCTL_CAU_FRCLOW | AQCTL_PRD_FRCHIGH | \
86 AQCTL_ZRO_FRCHIGH)
87#define AQCTL_CHANA_POLINVERSED (AQCTL_CAU_FRCHIGH | AQCTL_PRD_FRCLOW | \
88 AQCTL_ZRO_FRCLOW)
89#define AQCTL_CHANB_POLNORMAL (AQCTL_CBU_FRCLOW | AQCTL_PRD_FRCHIGH | \
90 AQCTL_ZRO_FRCHIGH)
91#define AQCTL_CHANB_POLINVERSED (AQCTL_CBU_FRCHIGH | AQCTL_PRD_FRCLOW | \
92 AQCTL_ZRO_FRCLOW)
93
94#define AQSFRC_RLDCSF_MASK (BIT(7) | BIT(6))
95#define AQSFRC_RLDCSF_ZRO 0
96#define AQSFRC_RLDCSF_PRD BIT(6)
97#define AQSFRC_RLDCSF_ZROPRD BIT(7)
98#define AQSFRC_RLDCSF_IMDT (BIT(7) | BIT(6))
99
100#define AQCSFRC_CSFB_MASK (BIT(3) | BIT(2))
101#define AQCSFRC_CSFB_FRCDIS 0
102#define AQCSFRC_CSFB_FRCLOW BIT(2)
103#define AQCSFRC_CSFB_FRCHIGH BIT(3)
104#define AQCSFRC_CSFB_DISSWFRC (BIT(3) | BIT(2))
105#define AQCSFRC_CSFA_MASK (BIT(1) | BIT(0))
106#define AQCSFRC_CSFA_FRCDIS 0
107#define AQCSFRC_CSFA_FRCLOW BIT(0)
108#define AQCSFRC_CSFA_FRCHIGH BIT(1)
109#define AQCSFRC_CSFA_DISSWFRC (BIT(1) | BIT(0))
110
111#define NUM_PWM_CHANNEL 2 /* EHRPWM channels */
112
113struct ehrpwm_context {
114 u16 tbctl;
115 u16 tbprd;
116 u16 cmpa;
117 u16 cmpb;
118 u16 aqctla;
119 u16 aqctlb;
120 u16 aqsfrc;
121 u16 aqcsfrc;
122};
123
124struct ehrpwm_pwm_chip {
125 struct pwm_chip chip;
126 unsigned int clk_rate;
127 void __iomem *mmio_base;
128 unsigned long period_cycles[NUM_PWM_CHANNEL];
129 enum pwm_polarity polarity[NUM_PWM_CHANNEL];
130 struct clk *tbclk;
131 struct ehrpwm_context ctx;
132};
133
134static inline struct ehrpwm_pwm_chip *to_ehrpwm_pwm_chip(struct pwm_chip *chip)
135{
136 return container_of(chip, struct ehrpwm_pwm_chip, chip);
137}
138
139static inline u16 ehrpwm_read(void __iomem *base, int offset)
140{
141 return readw(base + offset);
142}
143
144static inline void ehrpwm_write(void __iomem *base, int offset, unsigned int val)
145{
146 writew(val & 0xFFFF, base + offset);
147}
148
149static void ehrpwm_modify(void __iomem *base, int offset,
150 unsigned short mask, unsigned short val)
151{
152 unsigned short regval;
153
154 regval = readw(base + offset);
155 regval &= ~mask;
156 regval |= val & mask;
157 writew(regval, base + offset);
158}
159
160/**
161 * set_prescale_div - Set up the prescaler divider function
162 * @rqst_prescaler: prescaler value min
163 * @prescale_div: prescaler value set
164 * @tb_clk_div: Time Base Control prescaler bits
165 */
166static int set_prescale_div(unsigned long rqst_prescaler,
167 unsigned short *prescale_div, unsigned short *tb_clk_div)
168{
169 unsigned int clkdiv, hspclkdiv;
170
171 for (clkdiv = 0; clkdiv <= CLKDIV_MAX; clkdiv++) {
172 for (hspclkdiv = 0; hspclkdiv <= HSPCLKDIV_MAX; hspclkdiv++) {
173
174 /*
175 * calculations for prescaler value :
176 * prescale_div = HSPCLKDIVIDER * CLKDIVIDER.
177 * HSPCLKDIVIDER = 2 ** hspclkdiv
178 * CLKDIVIDER = (1), if clkdiv == 0 *OR*
179 * (2 * clkdiv), if clkdiv != 0
180 *
181 * Configure prescale_div value such that period
182 * register value is less than 65535.
183 */
184
185 *prescale_div = (1 << clkdiv) *
186 (hspclkdiv ? (hspclkdiv * 2) : 1);
187 if (*prescale_div > rqst_prescaler) {
188 *tb_clk_div = (clkdiv << TBCTL_CLKDIV_SHIFT) |
189 (hspclkdiv << TBCTL_HSPCLKDIV_SHIFT);
190 return 0;
191 }
192 }
193 }
194 return 1;
195}
196
197static void configure_polarity(struct ehrpwm_pwm_chip *pc, int chan)
198{
199 int aqctl_reg;
200 unsigned short aqctl_val, aqctl_mask;
201
202 /*
203 * Configure PWM output to HIGH/LOW level on counter
204 * reaches compare register value and LOW/HIGH level
205 * on counter value reaches period register value and
206 * zero value on counter
207 */
208 if (chan == 1) {
209 aqctl_reg = AQCTLB;
210 aqctl_mask = AQCTL_CBU_MASK;
211
212 if (pc->polarity[chan] == PWM_POLARITY_INVERSED)
213 aqctl_val = AQCTL_CHANB_POLINVERSED;
214 else
215 aqctl_val = AQCTL_CHANB_POLNORMAL;
216 } else {
217 aqctl_reg = AQCTLA;
218 aqctl_mask = AQCTL_CAU_MASK;
219
220 if (pc->polarity[chan] == PWM_POLARITY_INVERSED)
221 aqctl_val = AQCTL_CHANA_POLINVERSED;
222 else
223 aqctl_val = AQCTL_CHANA_POLNORMAL;
224 }
225
226 aqctl_mask |= AQCTL_PRD_MASK | AQCTL_ZRO_MASK;
227 ehrpwm_modify(pc->mmio_base, aqctl_reg, aqctl_mask, aqctl_val);
228}
229
230/*
231 * period_ns = 10^9 * (ps_divval * period_cycles) / PWM_CLK_RATE
232 * duty_ns = 10^9 * (ps_divval * duty_cycles) / PWM_CLK_RATE
233 */
234static int ehrpwm_pwm_config(struct pwm_chip *chip, struct pwm_device *pwm,
235 int duty_ns, int period_ns)
236{
237 struct ehrpwm_pwm_chip *pc = to_ehrpwm_pwm_chip(chip);
238 unsigned long long c;
239 unsigned long period_cycles, duty_cycles;
240 unsigned short ps_divval, tb_divval;
241 int i, cmp_reg;
242
243 if (period_ns > NSEC_PER_SEC)
244 return -ERANGE;
245
246 c = pc->clk_rate;
247 c = c * period_ns;
248 do_div(c, NSEC_PER_SEC);
249 period_cycles = (unsigned long)c;
250
251 if (period_cycles < 1) {
252 period_cycles = 1;
253 duty_cycles = 1;
254 } else {
255 c = pc->clk_rate;
256 c = c * duty_ns;
257 do_div(c, NSEC_PER_SEC);
258 duty_cycles = (unsigned long)c;
259 }
260
261 /*
262 * Period values should be same for multiple PWM channels as IP uses
263 * same period register for multiple channels.
264 */
265 for (i = 0; i < NUM_PWM_CHANNEL; i++) {
266 if (pc->period_cycles[i] &&
267 (pc->period_cycles[i] != period_cycles)) {
268 /*
269 * Allow channel to reconfigure period if no other
270 * channels being configured.
271 */
272 if (i == pwm->hwpwm)
273 continue;
274
275 dev_err(chip->dev, "Period value conflicts with channel %d\n",
276 i);
277 return -EINVAL;
278 }
279 }
280
281 pc->period_cycles[pwm->hwpwm] = period_cycles;
282
283 /* Configure clock prescaler to support Low frequency PWM wave */
284 if (set_prescale_div(period_cycles/PERIOD_MAX, &ps_divval,
285 &tb_divval)) {
286 dev_err(chip->dev, "Unsupported values\n");
287 return -EINVAL;
288 }
289
290 pm_runtime_get_sync(chip->dev);
291
292 /* Update clock prescaler values */
293 ehrpwm_modify(pc->mmio_base, TBCTL, TBCTL_CLKDIV_MASK, tb_divval);
294
295 /* Update period & duty cycle with presacler division */
296 period_cycles = period_cycles / ps_divval;
297 duty_cycles = duty_cycles / ps_divval;
298
299 /* Configure shadow loading on Period register */
300 ehrpwm_modify(pc->mmio_base, TBCTL, TBCTL_PRDLD_MASK, TBCTL_PRDLD_SHDW);
301
302 ehrpwm_write(pc->mmio_base, TBPRD, period_cycles);
303
304 /* Configure ehrpwm counter for up-count mode */
305 ehrpwm_modify(pc->mmio_base, TBCTL, TBCTL_CTRMODE_MASK,
306 TBCTL_CTRMODE_UP);
307
308 if (pwm->hwpwm == 1)
309 /* Channel 1 configured with compare B register */
310 cmp_reg = CMPB;
311 else
312 /* Channel 0 configured with compare A register */
313 cmp_reg = CMPA;
314
315 ehrpwm_write(pc->mmio_base, cmp_reg, duty_cycles);
316
317 pm_runtime_put_sync(chip->dev);
318 return 0;
319}
320
321static int ehrpwm_pwm_set_polarity(struct pwm_chip *chip,
322 struct pwm_device *pwm, enum pwm_polarity polarity)
323{
324 struct ehrpwm_pwm_chip *pc = to_ehrpwm_pwm_chip(chip);
325
326 /* Configuration of polarity in hardware delayed, do at enable */
327 pc->polarity[pwm->hwpwm] = polarity;
328 return 0;
329}
330
331static int ehrpwm_pwm_enable(struct pwm_chip *chip, struct pwm_device *pwm)
332{
333 struct ehrpwm_pwm_chip *pc = to_ehrpwm_pwm_chip(chip);
334 unsigned short aqcsfrc_val, aqcsfrc_mask;
335 int ret;
336
337 /* Leave clock enabled on enabling PWM */
338 pm_runtime_get_sync(chip->dev);
339
340 /* Disabling Action Qualifier on PWM output */
341 if (pwm->hwpwm) {
342 aqcsfrc_val = AQCSFRC_CSFB_FRCDIS;
343 aqcsfrc_mask = AQCSFRC_CSFB_MASK;
344 } else {
345 aqcsfrc_val = AQCSFRC_CSFA_FRCDIS;
346 aqcsfrc_mask = AQCSFRC_CSFA_MASK;
347 }
348
349 /* Changes to shadow mode */
350 ehrpwm_modify(pc->mmio_base, AQSFRC, AQSFRC_RLDCSF_MASK,
351 AQSFRC_RLDCSF_ZRO);
352
353 ehrpwm_modify(pc->mmio_base, AQCSFRC, aqcsfrc_mask, aqcsfrc_val);
354
355 /* Channels polarity can be configured from action qualifier module */
356 configure_polarity(pc, pwm->hwpwm);
357
358 /* Enable TBCLK before enabling PWM device */
359 ret = clk_enable(pc->tbclk);
360 if (ret) {
361 dev_err(chip->dev, "Failed to enable TBCLK for %s\n",
362 dev_name(pc->chip.dev));
363 return ret;
364 }
365
366 /* Enable time counter for free_run */
367 ehrpwm_modify(pc->mmio_base, TBCTL, TBCTL_RUN_MASK, TBCTL_FREE_RUN);
368 return 0;
369}
370
371static void ehrpwm_pwm_disable(struct pwm_chip *chip, struct pwm_device *pwm)
372{
373 struct ehrpwm_pwm_chip *pc = to_ehrpwm_pwm_chip(chip);
374 unsigned short aqcsfrc_val, aqcsfrc_mask;
375
376 /* Action Qualifier puts PWM output low forcefully */
377 if (pwm->hwpwm) {
378 aqcsfrc_val = AQCSFRC_CSFB_FRCLOW;
379 aqcsfrc_mask = AQCSFRC_CSFB_MASK;
380 } else {
381 aqcsfrc_val = AQCSFRC_CSFA_FRCLOW;
382 aqcsfrc_mask = AQCSFRC_CSFA_MASK;
383 }
384
385 /*
386 * Changes to immediate action on Action Qualifier. This puts
387 * Action Qualifier control on PWM output from next TBCLK
388 */
389 ehrpwm_modify(pc->mmio_base, AQSFRC, AQSFRC_RLDCSF_MASK,
390 AQSFRC_RLDCSF_IMDT);
391
392 ehrpwm_modify(pc->mmio_base, AQCSFRC, aqcsfrc_mask, aqcsfrc_val);
393
394 /* Disabling TBCLK on PWM disable */
395 clk_disable(pc->tbclk);
396
397 /* Stop Time base counter */
398 ehrpwm_modify(pc->mmio_base, TBCTL, TBCTL_RUN_MASK, TBCTL_STOP_NEXT);
399
400 /* Disable clock on PWM disable */
401 pm_runtime_put_sync(chip->dev);
402}
403
404static void ehrpwm_pwm_free(struct pwm_chip *chip, struct pwm_device *pwm)
405{
406 struct ehrpwm_pwm_chip *pc = to_ehrpwm_pwm_chip(chip);
407
408 if (pwm_is_enabled(pwm)) {
409 dev_warn(chip->dev, "Removing PWM device without disabling\n");
410 pm_runtime_put_sync(chip->dev);
411 }
412
413 /* set period value to zero on free */
414 pc->period_cycles[pwm->hwpwm] = 0;
415}
416
417static const struct pwm_ops ehrpwm_pwm_ops = {
418 .free = ehrpwm_pwm_free,
419 .config = ehrpwm_pwm_config,
420 .set_polarity = ehrpwm_pwm_set_polarity,
421 .enable = ehrpwm_pwm_enable,
422 .disable = ehrpwm_pwm_disable,
423 .owner = THIS_MODULE,
424};
425
426static const struct of_device_id ehrpwm_of_match[] = {
427 { .compatible = "ti,am3352-ehrpwm" },
428 { .compatible = "ti,am33xx-ehrpwm" },
429 {},
430};
431MODULE_DEVICE_TABLE(of, ehrpwm_of_match);
432
433static int ehrpwm_pwm_probe(struct platform_device *pdev)
434{
435 struct device_node *np = pdev->dev.of_node;
436 int ret;
437 struct resource *r;
438 struct clk *clk;
439 struct ehrpwm_pwm_chip *pc;
440
441 pc = devm_kzalloc(&pdev->dev, sizeof(*pc), GFP_KERNEL);
442 if (!pc)
443 return -ENOMEM;
444
445 clk = devm_clk_get(&pdev->dev, "fck");
446 if (IS_ERR(clk)) {
447 if (of_device_is_compatible(np, "ti,am33xx-ecap")) {
448 dev_warn(&pdev->dev, "Binding is obsolete.\n");
449 clk = devm_clk_get(pdev->dev.parent, "fck");
450 }
451 }
452
453 if (IS_ERR(clk)) {
454 dev_err(&pdev->dev, "failed to get clock\n");
455 return PTR_ERR(clk);
456 }
457
458 pc->clk_rate = clk_get_rate(clk);
459 if (!pc->clk_rate) {
460 dev_err(&pdev->dev, "failed to get clock rate\n");
461 return -EINVAL;
462 }
463
464 pc->chip.dev = &pdev->dev;
465 pc->chip.ops = &ehrpwm_pwm_ops;
466 pc->chip.of_xlate = of_pwm_xlate_with_flags;
467 pc->chip.of_pwm_n_cells = 3;
468 pc->chip.base = -1;
469 pc->chip.npwm = NUM_PWM_CHANNEL;
470
471 r = platform_get_resource(pdev, IORESOURCE_MEM, 0);
472 pc->mmio_base = devm_ioremap_resource(&pdev->dev, r);
473 if (IS_ERR(pc->mmio_base))
474 return PTR_ERR(pc->mmio_base);
475
476 /* Acquire tbclk for Time Base EHRPWM submodule */
477 pc->tbclk = devm_clk_get(&pdev->dev, "tbclk");
478 if (IS_ERR(pc->tbclk)) {
479 dev_err(&pdev->dev, "Failed to get tbclk\n");
480 return PTR_ERR(pc->tbclk);
481 }
482
483 ret = clk_prepare(pc->tbclk);
484 if (ret < 0) {
485 dev_err(&pdev->dev, "clk_prepare() failed: %d\n", ret);
486 return ret;
487 }
488
489 ret = pwmchip_add(&pc->chip);
490 if (ret < 0) {
491 dev_err(&pdev->dev, "pwmchip_add() failed: %d\n", ret);
492 return ret;
493 }
494
495 pm_runtime_enable(&pdev->dev);
496
497 platform_set_drvdata(pdev, pc);
498 return 0;
499}
500
501static int ehrpwm_pwm_remove(struct platform_device *pdev)
502{
503 struct ehrpwm_pwm_chip *pc = platform_get_drvdata(pdev);
504
505 clk_unprepare(pc->tbclk);
506
507 pm_runtime_put_sync(&pdev->dev);
508 pm_runtime_disable(&pdev->dev);
509 return pwmchip_remove(&pc->chip);
510}
511
512#ifdef CONFIG_PM_SLEEP
513static void ehrpwm_pwm_save_context(struct ehrpwm_pwm_chip *pc)
514{
515 pm_runtime_get_sync(pc->chip.dev);
516 pc->ctx.tbctl = ehrpwm_read(pc->mmio_base, TBCTL);
517 pc->ctx.tbprd = ehrpwm_read(pc->mmio_base, TBPRD);
518 pc->ctx.cmpa = ehrpwm_read(pc->mmio_base, CMPA);
519 pc->ctx.cmpb = ehrpwm_read(pc->mmio_base, CMPB);
520 pc->ctx.aqctla = ehrpwm_read(pc->mmio_base, AQCTLA);
521 pc->ctx.aqctlb = ehrpwm_read(pc->mmio_base, AQCTLB);
522 pc->ctx.aqsfrc = ehrpwm_read(pc->mmio_base, AQSFRC);
523 pc->ctx.aqcsfrc = ehrpwm_read(pc->mmio_base, AQCSFRC);
524 pm_runtime_put_sync(pc->chip.dev);
525}
526
527static void ehrpwm_pwm_restore_context(struct ehrpwm_pwm_chip *pc)
528{
529 ehrpwm_write(pc->mmio_base, TBPRD, pc->ctx.tbprd);
530 ehrpwm_write(pc->mmio_base, CMPA, pc->ctx.cmpa);
531 ehrpwm_write(pc->mmio_base, CMPB, pc->ctx.cmpb);
532 ehrpwm_write(pc->mmio_base, AQCTLA, pc->ctx.aqctla);
533 ehrpwm_write(pc->mmio_base, AQCTLB, pc->ctx.aqctlb);
534 ehrpwm_write(pc->mmio_base, AQSFRC, pc->ctx.aqsfrc);
535 ehrpwm_write(pc->mmio_base, AQCSFRC, pc->ctx.aqcsfrc);
536 ehrpwm_write(pc->mmio_base, TBCTL, pc->ctx.tbctl);
537}
538
539static int ehrpwm_pwm_suspend(struct device *dev)
540{
541 struct ehrpwm_pwm_chip *pc = dev_get_drvdata(dev);
542 int i;
543
544 ehrpwm_pwm_save_context(pc);
545 for (i = 0; i < pc->chip.npwm; i++) {
546 struct pwm_device *pwm = &pc->chip.pwms[i];
547
548 if (!pwm_is_enabled(pwm))
549 continue;
550
551 /* Disable explicitly if PWM is running */
552 pm_runtime_put_sync(dev);
553 }
554 return 0;
555}
556
557static int ehrpwm_pwm_resume(struct device *dev)
558{
559 struct ehrpwm_pwm_chip *pc = dev_get_drvdata(dev);
560 int i;
561
562 for (i = 0; i < pc->chip.npwm; i++) {
563 struct pwm_device *pwm = &pc->chip.pwms[i];
564
565 if (!pwm_is_enabled(pwm))
566 continue;
567
568 /* Enable explicitly if PWM was running */
569 pm_runtime_get_sync(dev);
570 }
571 ehrpwm_pwm_restore_context(pc);
572 return 0;
573}
574#endif
575
576static SIMPLE_DEV_PM_OPS(ehrpwm_pwm_pm_ops, ehrpwm_pwm_suspend,
577 ehrpwm_pwm_resume);
578
579static struct platform_driver ehrpwm_pwm_driver = {
580 .driver = {
581 .name = "ehrpwm",
582 .of_match_table = ehrpwm_of_match,
583 .pm = &ehrpwm_pwm_pm_ops,
584 },
585 .probe = ehrpwm_pwm_probe,
586 .remove = ehrpwm_pwm_remove,
587};
588
589module_platform_driver(ehrpwm_pwm_driver);
590
591MODULE_DESCRIPTION("EHRPWM PWM driver");
592MODULE_AUTHOR("Texas Instruments");
593MODULE_LICENSE("GPL");