drivers/pwm/pwm-tiecap.c

   1 // SPDX-License-Identifier: GPL-2.0-or-later
   2 /*
   3  * ECAP 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/io.h>
  11 #include <linux/err.h>
  12 #include <linux/clk.h>
  13 #include <linux/pm_runtime.h>
  14 #include <linux/pwm.h>
  15 #include <linux/of_device.h>
  16
  17 /* ECAP registers and bits definitions */
  18 #define CAP1                    0x08
  19 #define CAP2                    0x0C
  20 #define CAP3                    0x10
  21 #define CAP4                    0x14
  22 #define ECCTL2                  0x2A
  23 #define ECCTL2_APWM_POL_LOW     BIT(10)
  24 #define ECCTL2_APWM_MODE        BIT(9)
  25 #define ECCTL2_SYNC_SEL_DISA    (BIT(7) | BIT(6))
  26 #define ECCTL2_TSCTR_FREERUN    BIT(4)
  27
  28 struct ecap_context {
  29         u32 cap3;
  30         u32 cap4;
  31         u16 ecctl2;
  32 };
  33
  34 struct ecap_pwm_chip {
  35         struct pwm_chip chip;
  36         unsigned int clk_rate;
  37         void __iomem *mmio_base;
  38         struct ecap_context ctx;
  39 };
  40
  41 static inline struct ecap_pwm_chip *to_ecap_pwm_chip(struct pwm_chip *chip)
  42 {
  43         return container_of(chip, struct ecap_pwm_chip, chip);
  44 }
  45
  46 /*
  47  * period_ns = 10^9 * period_cycles / PWM_CLK_RATE
  48  * duty_ns   = 10^9 * duty_cycles / PWM_CLK_RATE
  49  */
  50 static int ecap_pwm_config(struct pwm_chip *chip, struct pwm_device *pwm,
  51                 int duty_ns, int period_ns)
  52 {
  53         struct ecap_pwm_chip *pc = to_ecap_pwm_chip(chip);
  54         u32 period_cycles, duty_cycles;
  55         unsigned long long c;
  56         u16 value;
  57
  58         if (period_ns > NSEC_PER_SEC)
  59                 return -ERANGE;
  60
  61         c = pc->clk_rate;
  62         c = c * period_ns;
  63         do_div(c, NSEC_PER_SEC);
  64         period_cycles = (u32)c;
  65
  66         if (period_cycles < 1) {
  67                 period_cycles = 1;
  68                 duty_cycles = 1;
  69         } else {
  70                 c = pc->clk_rate;
  71                 c = c * duty_ns;
  72                 do_div(c, NSEC_PER_SEC);
  73                 duty_cycles = (u32)c;
  74         }
  75
  76         pm_runtime_get_sync(pc->chip.dev);
  77
  78         value = readw(pc->mmio_base + ECCTL2);
  79
  80         /* Configure APWM mode & disable sync option */
  81         value |= ECCTL2_APWM_MODE | ECCTL2_SYNC_SEL_DISA;
  82
  83         writew(value, pc->mmio_base + ECCTL2);
  84
  85         if (!pwm_is_enabled(pwm)) {
  86                 /* Update active registers if not running */
  87                 writel(duty_cycles, pc->mmio_base + CAP2);
  88                 writel(period_cycles, pc->mmio_base + CAP1);
  89         } else {
  90                 /*
  91                  * Update shadow registers to configure period and
  92                  * compare values. This helps current PWM period to
  93                  * complete on reconfiguring
  94                  */
  95                 writel(duty_cycles, pc->mmio_base + CAP4);
  96                 writel(period_cycles, pc->mmio_base + CAP3);
  97         }
  98
  99         if (!pwm_is_enabled(pwm)) {
 100                 value = readw(pc->mmio_base + ECCTL2);
 101                 /* Disable APWM mode to put APWM output Low */
 102                 value &= ~ECCTL2_APWM_MODE;
 103                 writew(value, pc->mmio_base + ECCTL2);
 104         }
 105
 106         pm_runtime_put_sync(pc->chip.dev);
 107
 108         return 0;
 109 }
 110
 111 static int ecap_pwm_set_polarity(struct pwm_chip *chip, struct pwm_device *pwm,
 112                                  enum pwm_polarity polarity)
 113 {
 114         struct ecap_pwm_chip *pc = to_ecap_pwm_chip(chip);
 115         u16 value;
 116
 117         pm_runtime_get_sync(pc->chip.dev);
 118
 119         value = readw(pc->mmio_base + ECCTL2);
 120
 121         if (polarity == PWM_POLARITY_INVERSED)
 122                 /* Duty cycle defines LOW period of PWM */
 123                 value |= ECCTL2_APWM_POL_LOW;
 124         else
 125                 /* Duty cycle defines HIGH period of PWM */
 126                 value &= ~ECCTL2_APWM_POL_LOW;
 127
 128         writew(value, pc->mmio_base + ECCTL2);
 129
 130         pm_runtime_put_sync(pc->chip.dev);
 131
 132         return 0;
 133 }
 134
 135 static int ecap_pwm_enable(struct pwm_chip *chip, struct pwm_device *pwm)
 136 {
 137         struct ecap_pwm_chip *pc = to_ecap_pwm_chip(chip);
 138         u16 value;
 139
 140         /* Leave clock enabled on enabling PWM */
 141         pm_runtime_get_sync(pc->chip.dev);
 142
 143         /*
 144          * Enable 'Free run Time stamp counter mode' to start counter
 145          * and  'APWM mode' to enable APWM output
 146          */
 147         value = readw(pc->mmio_base + ECCTL2);
 148         value |= ECCTL2_TSCTR_FREERUN | ECCTL2_APWM_MODE;
 149         writew(value, pc->mmio_base + ECCTL2);
 150
 151         return 0;
 152 }
 153
 154 static void ecap_pwm_disable(struct pwm_chip *chip, struct pwm_device *pwm)
 155 {
 156         struct ecap_pwm_chip *pc = to_ecap_pwm_chip(chip);
 157         u16 value;
 158
 159         /*
 160          * Disable 'Free run Time stamp counter mode' to stop counter
 161          * and 'APWM mode' to put APWM output to low
 162          */
 163         value = readw(pc->mmio_base + ECCTL2);
 164         value &= ~(ECCTL2_TSCTR_FREERUN | ECCTL2_APWM_MODE);
 165         writew(value, pc->mmio_base + ECCTL2);
 166
 167         /* Disable clock on PWM disable */
 168         pm_runtime_put_sync(pc->chip.dev);
 169 }
 170
 171 static void ecap_pwm_free(struct pwm_chip *chip, struct pwm_device *pwm)
 172 {
 173         if (pwm_is_enabled(pwm)) {
 174                 dev_warn(chip->dev, "Removing PWM device without disabling\n");
 175                 pm_runtime_put_sync(chip->dev);
 176         }
 177 }
 178
 179 static const struct pwm_ops ecap_pwm_ops = {
 180         .free = ecap_pwm_free,
 181         .config = ecap_pwm_config,
 182         .set_polarity = ecap_pwm_set_polarity,
 183         .enable = ecap_pwm_enable,
 184         .disable = ecap_pwm_disable,
 185         .owner = THIS_MODULE,
 186 };
 187
 188 static const struct of_device_id ecap_of_match[] = {
 189         { .compatible   = "ti,am3352-ecap" },
 190         { .compatible   = "ti,am33xx-ecap" },
 191         {},
 192 };
 193 MODULE_DEVICE_TABLE(of, ecap_of_match);
 194
 195 static int ecap_pwm_probe(struct platform_device *pdev)
 196 {
 197         struct device_node *np = pdev->dev.of_node;
 198         struct ecap_pwm_chip *pc;
 199         struct clk *clk;
 200         int ret;
 201
 202         pc = devm_kzalloc(&pdev->dev, sizeof(*pc), GFP_KERNEL);
 203         if (!pc)
 204                 return -ENOMEM;
 205
 206         clk = devm_clk_get(&pdev->dev, "fck");
 207         if (IS_ERR(clk)) {
 208                 if (of_device_is_compatible(np, "ti,am33xx-ecap")) {
 209                         dev_warn(&pdev->dev, "Binding is obsolete.\n");
 210                         clk = devm_clk_get(pdev->dev.parent, "fck");
 211                 }
 212         }
 213
 214         if (IS_ERR(clk)) {
 215                 dev_err(&pdev->dev, "failed to get clock\n");
 216                 return PTR_ERR(clk);
 217         }
 218
 219         pc->clk_rate = clk_get_rate(clk);
 220         if (!pc->clk_rate) {
 221                 dev_err(&pdev->dev, "failed to get clock rate\n");
 222                 return -EINVAL;
 223         }
 224
 225         pc->chip.dev = &pdev->dev;
 226         pc->chip.ops = &ecap_pwm_ops;
 227         pc->chip.of_xlate = of_pwm_xlate_with_flags;
 228         pc->chip.of_pwm_n_cells = 3;
 229         pc->chip.base = -1;
 230         pc->chip.npwm = 1;
 231
 232         pc->mmio_base = devm_platform_ioremap_resource(pdev, 0);
 233         if (IS_ERR(pc->mmio_base))
 234                 return PTR_ERR(pc->mmio_base);
 235
 236         ret = pwmchip_add(&pc->chip);
 237         if (ret < 0) {
 238                 dev_err(&pdev->dev, "pwmchip_add() failed: %d\n", ret);
 239                 return ret;
 240         }
 241
 242         platform_set_drvdata(pdev, pc);
 243         pm_runtime_enable(&pdev->dev);
 244
 245         return 0;
 246 }
 247
 248 static int ecap_pwm_remove(struct platform_device *pdev)
 249 {
 250         struct ecap_pwm_chip *pc = platform_get_drvdata(pdev);
 251
 252         pm_runtime_disable(&pdev->dev);
 253
 254         return pwmchip_remove(&pc->chip);
 255 }
 256
 257 #ifdef CONFIG_PM_SLEEP
 258 static void ecap_pwm_save_context(struct ecap_pwm_chip *pc)
 259 {
 260         pm_runtime_get_sync(pc->chip.dev);
 261         pc->ctx.ecctl2 = readw(pc->mmio_base + ECCTL2);
 262         pc->ctx.cap4 = readl(pc->mmio_base + CAP4);
 263         pc->ctx.cap3 = readl(pc->mmio_base + CAP3);
 264         pm_runtime_put_sync(pc->chip.dev);
 265 }
 266
 267 static void ecap_pwm_restore_context(struct ecap_pwm_chip *pc)
 268 {
 269         writel(pc->ctx.cap3, pc->mmio_base + CAP3);
 270         writel(pc->ctx.cap4, pc->mmio_base + CAP4);
 271         writew(pc->ctx.ecctl2, pc->mmio_base + ECCTL2);
 272 }
 273
 274 static int ecap_pwm_suspend(struct device *dev)
 275 {
 276         struct ecap_pwm_chip *pc = dev_get_drvdata(dev);
 277         struct pwm_device *pwm = pc->chip.pwms;
 278
 279         ecap_pwm_save_context(pc);
 280
 281         /* Disable explicitly if PWM is running */
 282         if (pwm_is_enabled(pwm))
 283                 pm_runtime_put_sync(dev);
 284
 285         return 0;
 286 }
 287
 288 static int ecap_pwm_resume(struct device *dev)
 289 {
 290         struct ecap_pwm_chip *pc = dev_get_drvdata(dev);
 291         struct pwm_device *pwm = pc->chip.pwms;
 292
 293         /* Enable explicitly if PWM was running */
 294         if (pwm_is_enabled(pwm))
 295                 pm_runtime_get_sync(dev);
 296
 297         ecap_pwm_restore_context(pc);
 298         return 0;
 299 }
 300 #endif
 301
 302 static SIMPLE_DEV_PM_OPS(ecap_pwm_pm_ops, ecap_pwm_suspend, ecap_pwm_resume);
 303
 304 static struct platform_driver ecap_pwm_driver = {
 305         .driver = {
 306                 .name = "ecap",
 307                 .of_match_table = ecap_of_match,
 308                 .pm = &ecap_pwm_pm_ops,
 309         },
 310         .probe = ecap_pwm_probe,
 311         .remove = ecap_pwm_remove,
 312 };
 313 module_platform_driver(ecap_pwm_driver);
 314
 315 MODULE_DESCRIPTION("ECAP PWM driver");
 316 MODULE_AUTHOR("Texas Instruments");
 317 MODULE_LICENSE("GPL");