drivers/pwm/pwm-atmel.c

   1 /*
   2  * Driver for Atmel Pulse Width Modulation Controller
   3  *
   4  * Copyright (C) 2013 Atmel Corporation
   5  *               Bo Shen <voice.shen@atmel.com>
   6  *
   7  * Licensed under GPLv2.
   8  */
   9
  10 #include <linux/clk.h>
  11 #include <linux/delay.h>
  12 #include <linux/err.h>
  13 #include <linux/io.h>
  14 #include <linux/module.h>
  15 #include <linux/mutex.h>
  16 #include <linux/of.h>
  17 #include <linux/of_device.h>
  18 #include <linux/platform_device.h>
  19 #include <linux/pwm.h>
  20 #include <linux/slab.h>
  21
  22 /* The following is global registers for PWM controller */
  23 #define PWM_ENA                 0x04
  24 #define PWM_DIS                 0x08
  25 #define PWM_SR                  0x0C
  26 #define PWM_ISR                 0x1C
  27 /* Bit field in SR */
  28 #define PWM_SR_ALL_CH_ON        0x0F
  29
  30 /* The following register is PWM channel related registers */
  31 #define PWM_CH_REG_OFFSET       0x200
  32 #define PWM_CH_REG_SIZE         0x20
  33
  34 #define PWM_CMR                 0x0
  35 /* Bit field in CMR */
  36 #define PWM_CMR_CPOL            (1 << 9)
  37 #define PWM_CMR_UPD_CDTY        (1 << 10)
  38 #define PWM_CMR_CPRE_MSK        0xF
  39
  40 /* The following registers for PWM v1 */
  41 #define PWMV1_CDTY              0x04
  42 #define PWMV1_CPRD              0x08
  43 #define PWMV1_CUPD              0x10
  44
  45 /* The following registers for PWM v2 */
  46 #define PWMV2_CDTY              0x04
  47 #define PWMV2_CDTYUPD           0x08
  48 #define PWMV2_CPRD              0x0C
  49 #define PWMV2_CPRDUPD           0x10
  50
  51 struct atmel_pwm_registers {
  52         u8 period;
  53         u8 period_upd;
  54         u8 duty;
  55         u8 duty_upd;
  56 };
  57
  58 struct atmel_pwm_config {
  59         u32 max_period;
  60         u32 max_pres;
  61 };
  62
  63 struct atmel_pwm_data {
  64         struct atmel_pwm_registers regs;
  65         struct atmel_pwm_config cfg;
  66 };
  67
  68 struct atmel_pwm_chip {
  69         struct pwm_chip chip;
  70         struct clk *clk;
  71         void __iomem *base;
  72         const struct atmel_pwm_data *data;
  73
  74         unsigned int updated_pwms;
  75         /* ISR is cleared when read, ensure only one thread does that */
  76         struct mutex isr_lock;
  77 };
  78
  79 static inline struct atmel_pwm_chip *to_atmel_pwm_chip(struct pwm_chip *chip)
  80 {
  81         return container_of(chip, struct atmel_pwm_chip, chip);
  82 }
  83
  84 static inline u32 atmel_pwm_readl(struct atmel_pwm_chip *chip,
  85                                   unsigned long offset)
  86 {
  87         return readl_relaxed(chip->base + offset);
  88 }
  89
  90 static inline void atmel_pwm_writel(struct atmel_pwm_chip *chip,
  91                                     unsigned long offset, unsigned long val)
  92 {
  93         writel_relaxed(val, chip->base + offset);
  94 }
  95
  96 static inline u32 atmel_pwm_ch_readl(struct atmel_pwm_chip *chip,
  97                                      unsigned int ch, unsigned long offset)
  98 {
  99         unsigned long base = PWM_CH_REG_OFFSET + ch * PWM_CH_REG_SIZE;
 100
 101         return readl_relaxed(chip->base + base + offset);
 102 }
 103
 104 static inline void atmel_pwm_ch_writel(struct atmel_pwm_chip *chip,
 105                                        unsigned int ch, unsigned long offset,
 106                                        unsigned long val)
 107 {
 108         unsigned long base = PWM_CH_REG_OFFSET + ch * PWM_CH_REG_SIZE;
 109
 110         writel_relaxed(val, chip->base + base + offset);
 111 }
 112
 113 static int atmel_pwm_calculate_cprd_and_pres(struct pwm_chip *chip,
 114                                              const struct pwm_state *state,
 115                                              unsigned long *cprd, u32 *pres)
 116 {
 117         struct atmel_pwm_chip *atmel_pwm = to_atmel_pwm_chip(chip);
 118         unsigned long long cycles = state->period;
 119
 120         /* Calculate the period cycles and prescale value */
 121         cycles *= clk_get_rate(atmel_pwm->clk);
 122         do_div(cycles, NSEC_PER_SEC);
 123
 124         for (*pres = 0; cycles > atmel_pwm->data->cfg.max_period; cycles >>= 1)
 125                 (*pres)++;
 126
 127         if (*pres > atmel_pwm->data->cfg.max_pres) {
 128                 dev_err(chip->dev, "pres exceeds the maximum value\n");
 129                 return -EINVAL;
 130         }
 131
 132         *cprd = cycles;
 133
 134         return 0;
 135 }
 136
 137 static void atmel_pwm_calculate_cdty(const struct pwm_state *state,
 138                                      unsigned long cprd, unsigned long *cdty)
 139 {
 140         unsigned long long cycles = state->duty_cycle;
 141
 142         cycles *= cprd;
 143         do_div(cycles, state->period);
 144         *cdty = cprd - cycles;
 145 }
 146
 147 static void atmel_pwm_update_cdty(struct pwm_chip *chip, struct pwm_device *pwm,
 148                                   unsigned long cdty)
 149 {
 150         struct atmel_pwm_chip *atmel_pwm = to_atmel_pwm_chip(chip);
 151         u32 val;
 152
 153         if (atmel_pwm->data->regs.duty_upd ==
 154             atmel_pwm->data->regs.period_upd) {
 155                 val = atmel_pwm_ch_readl(atmel_pwm, pwm->hwpwm, PWM_CMR);
 156                 val &= ~PWM_CMR_UPD_CDTY;
 157                 atmel_pwm_ch_writel(atmel_pwm, pwm->hwpwm, PWM_CMR, val);
 158         }
 159
 160         atmel_pwm_ch_writel(atmel_pwm, pwm->hwpwm,
 161                             atmel_pwm->data->regs.duty_upd, cdty);
 162 }
 163
 164 static void atmel_pwm_set_cprd_cdty(struct pwm_chip *chip,
 165                                     struct pwm_device *pwm,
 166                                     unsigned long cprd, unsigned long cdty)
 167 {
 168         struct atmel_pwm_chip *atmel_pwm = to_atmel_pwm_chip(chip);
 169
 170         atmel_pwm_ch_writel(atmel_pwm, pwm->hwpwm,
 171                             atmel_pwm->data->regs.duty, cdty);
 172         atmel_pwm_ch_writel(atmel_pwm, pwm->hwpwm,
 173                             atmel_pwm->data->regs.period, cprd);
 174 }
 175
 176 static void atmel_pwm_disable(struct pwm_chip *chip, struct pwm_device *pwm,
 177                               bool disable_clk)
 178 {
 179         struct atmel_pwm_chip *atmel_pwm = to_atmel_pwm_chip(chip);
 180         unsigned long timeout = jiffies + 2 * HZ;
 181
 182         /*
 183          * Wait for at least a complete period to have passed before disabling a
 184          * channel to be sure that CDTY has been updated
 185          */
 186         mutex_lock(&atmel_pwm->isr_lock);
 187         atmel_pwm->updated_pwms |= atmel_pwm_readl(atmel_pwm, PWM_ISR);
 188
 189         while (!(atmel_pwm->updated_pwms & (1 << pwm->hwpwm)) &&
 190                time_before(jiffies, timeout)) {
 191                 usleep_range(10, 100);
 192                 atmel_pwm->updated_pwms |= atmel_pwm_readl(atmel_pwm, PWM_ISR);
 193         }
 194
 195         mutex_unlock(&atmel_pwm->isr_lock);
 196         atmel_pwm_writel(atmel_pwm, PWM_DIS, 1 << pwm->hwpwm);
 197
 198         /*
 199          * Wait for the PWM channel disable operation to be effective before
 200          * stopping the clock.
 201          */
 202         timeout = jiffies + 2 * HZ;
 203
 204         while ((atmel_pwm_readl(atmel_pwm, PWM_SR) & (1 << pwm->hwpwm)) &&
 205                time_before(jiffies, timeout))
 206                 usleep_range(10, 100);
 207
 208         if (disable_clk)
 209                 clk_disable(atmel_pwm->clk);
 210 }
 211
 212 static int atmel_pwm_apply(struct pwm_chip *chip, struct pwm_device *pwm,
 213                            struct pwm_state *state)
 214 {
 215         struct atmel_pwm_chip *atmel_pwm = to_atmel_pwm_chip(chip);
 216         struct pwm_state cstate;
 217         unsigned long cprd, cdty;
 218         u32 pres, val;
 219         int ret;
 220
 221         pwm_get_state(pwm, &cstate);
 222
 223         if (state->enabled) {
 224                 if (cstate.enabled &&
 225                     cstate.polarity == state->polarity &&
 226                     cstate.period == state->period) {
 227                         cprd = atmel_pwm_ch_readl(atmel_pwm, pwm->hwpwm,
 228                                                   atmel_pwm->data->regs.period);
 229                         atmel_pwm_calculate_cdty(state, cprd, &cdty);
 230                         atmel_pwm_update_cdty(chip, pwm, cdty);
 231                         return 0;
 232                 }
 233
 234                 ret = atmel_pwm_calculate_cprd_and_pres(chip, state, &cprd,
 235                                                         &pres);
 236                 if (ret) {
 237                         dev_err(chip->dev,
 238                                 "failed to calculate cprd and prescaler\n");
 239                         return ret;
 240                 }
 241
 242                 atmel_pwm_calculate_cdty(state, cprd, &cdty);
 243
 244                 if (cstate.enabled) {
 245                         atmel_pwm_disable(chip, pwm, false);
 246                 } else {
 247                         ret = clk_enable(atmel_pwm->clk);
 248                         if (ret) {
 249                                 dev_err(chip->dev, "failed to enable clock\n");
 250                                 return ret;
 251                         }
 252                 }
 253
 254                 /* It is necessary to preserve CPOL, inside CMR */
 255                 val = atmel_pwm_ch_readl(atmel_pwm, pwm->hwpwm, PWM_CMR);
 256                 val = (val & ~PWM_CMR_CPRE_MSK) | (pres & PWM_CMR_CPRE_MSK);
 257                 if (state->polarity == PWM_POLARITY_NORMAL)
 258                         val &= ~PWM_CMR_CPOL;
 259                 else
 260                         val |= PWM_CMR_CPOL;
 261                 atmel_pwm_ch_writel(atmel_pwm, pwm->hwpwm, PWM_CMR, val);
 262                 atmel_pwm_set_cprd_cdty(chip, pwm, cprd, cdty);
 263                 mutex_lock(&atmel_pwm->isr_lock);
 264                 atmel_pwm->updated_pwms |= atmel_pwm_readl(atmel_pwm, PWM_ISR);
 265                 atmel_pwm->updated_pwms &= ~(1 << pwm->hwpwm);
 266                 mutex_unlock(&atmel_pwm->isr_lock);
 267                 atmel_pwm_writel(atmel_pwm, PWM_ENA, 1 << pwm->hwpwm);
 268         } else if (cstate.enabled) {
 269                 atmel_pwm_disable(chip, pwm, true);
 270         }
 271
 272         return 0;
 273 }
 274
 275 static const struct pwm_ops atmel_pwm_ops = {
 276         .apply = atmel_pwm_apply,
 277         .owner = THIS_MODULE,
 278 };
 279
 280 static const struct atmel_pwm_data atmel_sam9rl_pwm_data = {
 281         .regs = {
 282                 .period         = PWMV1_CPRD,
 283                 .period_upd     = PWMV1_CUPD,
 284                 .duty           = PWMV1_CDTY,
 285                 .duty_upd       = PWMV1_CUPD,
 286         },
 287         .cfg = {
 288                 /* 16 bits to keep period and duty. */
 289                 .max_period     = 0xffff,
 290                 .max_pres       = 10,
 291         },
 292 };
 293
 294 static const struct atmel_pwm_data atmel_sama5_pwm_data = {
 295         .regs = {
 296                 .period         = PWMV2_CPRD,
 297                 .period_upd     = PWMV2_CPRDUPD,
 298                 .duty           = PWMV2_CDTY,
 299                 .duty_upd       = PWMV2_CDTYUPD,
 300         },
 301         .cfg = {
 302                 /* 16 bits to keep period and duty. */
 303                 .max_period     = 0xffff,
 304                 .max_pres       = 10,
 305         },
 306 };
 307
 308 static const struct atmel_pwm_data mchp_sam9x60_pwm_data = {
 309         .regs = {
 310                 .period         = PWMV1_CPRD,
 311                 .period_upd     = PWMV1_CUPD,
 312                 .duty           = PWMV1_CDTY,
 313                 .duty_upd       = PWMV1_CUPD,
 314         },
 315         .cfg = {
 316                 /* 32 bits to keep period and duty. */
 317                 .max_period     = 0xffffffff,
 318                 .max_pres       = 10,
 319         },
 320 };
 321
 322 static const struct platform_device_id atmel_pwm_devtypes[] = {
 323         {
 324                 .name = "at91sam9rl-pwm",
 325                 .driver_data = (kernel_ulong_t)&atmel_sam9rl_pwm_data,
 326         }, {
 327                 .name = "sama5d3-pwm",
 328                 .driver_data = (kernel_ulong_t)&atmel_sama5_pwm_data,
 329         }, {
 330                 /* sentinel */
 331         },
 332 };
 333 MODULE_DEVICE_TABLE(platform, atmel_pwm_devtypes);
 334
 335 static const struct of_device_id atmel_pwm_dt_ids[] = {
 336         {
 337                 .compatible = "atmel,at91sam9rl-pwm",
 338                 .data = &atmel_sam9rl_pwm_data,
 339         }, {
 340                 .compatible = "atmel,sama5d3-pwm",
 341                 .data = &atmel_sama5_pwm_data,
 342         }, {
 343                 .compatible = "atmel,sama5d2-pwm",
 344                 .data = &atmel_sama5_pwm_data,
 345         }, {
 346                 .compatible = "microchip,sam9x60-pwm",
 347                 .data = &mchp_sam9x60_pwm_data,
 348         }, {
 349                 /* sentinel */
 350         },
 351 };
 352 MODULE_DEVICE_TABLE(of, atmel_pwm_dt_ids);
 353
 354 static inline const struct atmel_pwm_data *
 355 atmel_pwm_get_driver_data(struct platform_device *pdev)
 356 {
 357         const struct platform_device_id *id;
 358
 359         if (pdev->dev.of_node)
 360                 return of_device_get_match_data(&pdev->dev);
 361
 362         id = platform_get_device_id(pdev);
 363
 364         return (struct atmel_pwm_data *)id->driver_data;
 365 }
 366
 367 static int atmel_pwm_probe(struct platform_device *pdev)
 368 {
 369         const struct atmel_pwm_data *data;
 370         struct atmel_pwm_chip *atmel_pwm;
 371         struct resource *res;
 372         int ret;
 373
 374         data = atmel_pwm_get_driver_data(pdev);
 375         if (!data)
 376                 return -ENODEV;
 377
 378         atmel_pwm = devm_kzalloc(&pdev->dev, sizeof(*atmel_pwm), GFP_KERNEL);
 379         if (!atmel_pwm)
 380                 return -ENOMEM;
 381
 382         res = platform_get_resource(pdev, IORESOURCE_MEM, 0);
 383         atmel_pwm->base = devm_ioremap_resource(&pdev->dev, res);
 384         if (IS_ERR(atmel_pwm->base))
 385                 return PTR_ERR(atmel_pwm->base);
 386
 387         atmel_pwm->clk = devm_clk_get(&pdev->dev, NULL);
 388         if (IS_ERR(atmel_pwm->clk))
 389                 return PTR_ERR(atmel_pwm->clk);
 390
 391         ret = clk_prepare(atmel_pwm->clk);
 392         if (ret) {
 393                 dev_err(&pdev->dev, "failed to prepare PWM clock\n");
 394                 return ret;
 395         }
 396
 397         atmel_pwm->chip.dev = &pdev->dev;
 398         atmel_pwm->chip.ops = &atmel_pwm_ops;
 399
 400         if (pdev->dev.of_node) {
 401                 atmel_pwm->chip.of_xlate = of_pwm_xlate_with_flags;
 402                 atmel_pwm->chip.of_pwm_n_cells = 3;
 403         }
 404
 405         atmel_pwm->chip.base = -1;
 406         atmel_pwm->chip.npwm = 4;
 407         atmel_pwm->data = data;
 408         atmel_pwm->updated_pwms = 0;
 409         mutex_init(&atmel_pwm->isr_lock);
 410
 411         ret = pwmchip_add(&atmel_pwm->chip);
 412         if (ret < 0) {
 413                 dev_err(&pdev->dev, "failed to add PWM chip %d\n", ret);
 414                 goto unprepare_clk;
 415         }
 416
 417         platform_set_drvdata(pdev, atmel_pwm);
 418
 419         return ret;
 420
 421 unprepare_clk:
 422         clk_unprepare(atmel_pwm->clk);
 423         return ret;
 424 }
 425
 426 static int atmel_pwm_remove(struct platform_device *pdev)
 427 {
 428         struct atmel_pwm_chip *atmel_pwm = platform_get_drvdata(pdev);
 429
 430         clk_unprepare(atmel_pwm->clk);
 431         mutex_destroy(&atmel_pwm->isr_lock);
 432
 433         return pwmchip_remove(&atmel_pwm->chip);
 434 }
 435
 436 static struct platform_driver atmel_pwm_driver = {
 437         .driver = {
 438                 .name = "atmel-pwm",
 439                 .of_match_table = of_match_ptr(atmel_pwm_dt_ids),
 440         },
 441         .id_table = atmel_pwm_devtypes,
 442         .probe = atmel_pwm_probe,
 443         .remove = atmel_pwm_remove,
 444 };
 445 module_platform_driver(atmel_pwm_driver);
 446
 447 MODULE_ALIAS("platform:atmel-pwm");
 448 MODULE_AUTHOR("Bo Shen <voice.shen@atmel.com>");
 449 MODULE_DESCRIPTION("Atmel PWM driver");
 450 MODULE_LICENSE("GPL v2");