drivers/watchdog/imx2_wdt.c

   1 // SPDX-License-Identifier: GPL-2.0
   2 /*
   3  * Watchdog driver for IMX2 and later processors
   4  *
   5  *  Copyright (C) 2010 Wolfram Sang, Pengutronix e.K. <w.sang@pengutronix.de>
   6  *  Copyright (C) 2014 Freescale Semiconductor, Inc.
   7  *
   8  * some parts adapted by similar drivers from Darius Augulis and Vladimir
   9  * Zapolskiy, additional improvements by Wim Van Sebroeck.
  10  *
  11  * NOTE: MX1 has a slightly different Watchdog than MX2 and later:
  12  *
  13  *                      MX1:            MX2+:
  14  *                      ----            -----
  15  * Registers:           32-bit          16-bit
  16  * Stopable timer:      Yes             No
  17  * Need to enable clk:  No              Yes
  18  * Halt on suspend:     Manual          Can be automatic
  19  */
  20
  21 #include <linux/clk.h>
  22 #include <linux/delay.h>
  23 #include <linux/init.h>
  24 #include <linux/interrupt.h>
  25 #include <linux/io.h>
  26 #include <linux/kernel.h>
  27 #include <linux/module.h>
  28 #include <linux/moduleparam.h>
  29 #include <linux/of_address.h>
  30 #include <linux/platform_device.h>
  31 #include <linux/regmap.h>
  32 #include <linux/watchdog.h>
  33
  34 #define DRIVER_NAME "imx2-wdt"
  35
  36 #define IMX2_WDT_WCR            0x00            /* Control Register */
  37 #define IMX2_WDT_WCR_WT         (0xFF << 8)     /* -> Watchdog Timeout Field */
  38 #define IMX2_WDT_WCR_WDA        BIT(5)          /* -> External Reset WDOG_B */
  39 #define IMX2_WDT_WCR_SRS        BIT(4)          /* -> Software Reset Signal */
  40 #define IMX2_WDT_WCR_WRE        BIT(3)          /* -> WDOG Reset Enable */
  41 #define IMX2_WDT_WCR_WDE        BIT(2)          /* -> Watchdog Enable */
  42 #define IMX2_WDT_WCR_WDZST      BIT(0)          /* -> Watchdog timer Suspend */
  43
  44 #define IMX2_WDT_WSR            0x02            /* Service Register */
  45 #define IMX2_WDT_SEQ1           0x5555          /* -> service sequence 1 */
  46 #define IMX2_WDT_SEQ2           0xAAAA          /* -> service sequence 2 */
  47
  48 #define IMX2_WDT_WRSR           0x04            /* Reset Status Register */
  49 #define IMX2_WDT_WRSR_TOUT      BIT(1)          /* -> Reset due to Timeout */
  50
  51 #define IMX2_WDT_WICR           0x06            /* Interrupt Control Register */
  52 #define IMX2_WDT_WICR_WIE       BIT(15)         /* -> Interrupt Enable */
  53 #define IMX2_WDT_WICR_WTIS      BIT(14)         /* -> Interrupt Status */
  54 #define IMX2_WDT_WICR_WICT      0xFF            /* -> Interrupt Count Timeout */
  55
  56 #define IMX2_WDT_WMCR           0x08            /* Misc Register */
  57
  58 #define IMX2_WDT_MAX_TIME       128U
  59 #define IMX2_WDT_DEFAULT_TIME   60              /* in seconds */
  60
  61 #define WDOG_SEC_TO_COUNT(s)    ((s * 2 - 1) << 8)
  62
  63 struct imx2_wdt_device {
  64         struct clk *clk;
  65         struct regmap *regmap;
  66         struct watchdog_device wdog;
  67         bool ext_reset;
  68 };
  69
  70 static bool nowayout = WATCHDOG_NOWAYOUT;
  71 module_param(nowayout, bool, 0);
  72 MODULE_PARM_DESC(nowayout, "Watchdog cannot be stopped once started (default="
  73                                 __MODULE_STRING(WATCHDOG_NOWAYOUT) ")");
  74
  75
  76 static unsigned timeout;
  77 module_param(timeout, uint, 0);
  78 MODULE_PARM_DESC(timeout, "Watchdog timeout in seconds (default="
  79                                 __MODULE_STRING(IMX2_WDT_DEFAULT_TIME) ")");
  80
  81 static const struct watchdog_info imx2_wdt_info = {
  82         .identity = "imx2+ watchdog",
  83         .options = WDIOF_KEEPALIVEPING | WDIOF_SETTIMEOUT | WDIOF_MAGICCLOSE,
  84 };
  85
  86 static const struct watchdog_info imx2_wdt_pretimeout_info = {
  87         .identity = "imx2+ watchdog",
  88         .options = WDIOF_KEEPALIVEPING | WDIOF_SETTIMEOUT | WDIOF_MAGICCLOSE |
  89                    WDIOF_PRETIMEOUT,
  90 };
  91
  92 static int imx2_wdt_restart(struct watchdog_device *wdog, unsigned long action,
  93                             void *data)
  94 {
  95         struct imx2_wdt_device *wdev = watchdog_get_drvdata(wdog);
  96         unsigned int wcr_enable = IMX2_WDT_WCR_WDE;
  97
  98         /* Use internal reset or external - not both */
  99         if (wdev->ext_reset)
 100                 wcr_enable |= IMX2_WDT_WCR_SRS; /* do not assert int reset */
 101         else
 102                 wcr_enable |= IMX2_WDT_WCR_WDA; /* do not assert ext-reset */
 103
 104         /* Assert SRS signal */
 105         regmap_write(wdev->regmap, IMX2_WDT_WCR, wcr_enable);
 106         /*
 107          * Due to imx6q errata ERR004346 (WDOG: WDOG SRS bit requires to be
 108          * written twice), we add another two writes to ensure there must be at
 109          * least two writes happen in the same one 32kHz clock period.  We save
 110          * the target check here, since the writes shouldn't be a huge burden
 111          * for other platforms.
 112          */
 113         regmap_write(wdev->regmap, IMX2_WDT_WCR, wcr_enable);
 114         regmap_write(wdev->regmap, IMX2_WDT_WCR, wcr_enable);
 115
 116         /* wait for reset to assert... */
 117         mdelay(500);
 118
 119         return 0;
 120 }
 121
 122 static inline void imx2_wdt_setup(struct watchdog_device *wdog)
 123 {
 124         struct imx2_wdt_device *wdev = watchdog_get_drvdata(wdog);
 125         u32 val;
 126
 127         regmap_read(wdev->regmap, IMX2_WDT_WCR, &val);
 128
 129         /* Suspend timer in low power mode, write once-only */
 130         val |= IMX2_WDT_WCR_WDZST;
 131         /* Strip the old watchdog Time-Out value */
 132         val &= ~IMX2_WDT_WCR_WT;
 133         /* Generate internal chip-level reset if WDOG times out */
 134         if (!wdev->ext_reset)
 135                 val &= ~IMX2_WDT_WCR_WRE;
 136         /* Or if external-reset assert WDOG_B reset only on time-out */
 137         else
 138                 val |= IMX2_WDT_WCR_WRE;
 139         /* Keep Watchdog Disabled */
 140         val &= ~IMX2_WDT_WCR_WDE;
 141         /* Set the watchdog's Time-Out value */
 142         val |= WDOG_SEC_TO_COUNT(wdog->timeout);
 143
 144         regmap_write(wdev->regmap, IMX2_WDT_WCR, val);
 145
 146         /* enable the watchdog */
 147         val |= IMX2_WDT_WCR_WDE;
 148         regmap_write(wdev->regmap, IMX2_WDT_WCR, val);
 149 }
 150
 151 static inline bool imx2_wdt_is_running(struct imx2_wdt_device *wdev)
 152 {
 153         u32 val;
 154
 155         regmap_read(wdev->regmap, IMX2_WDT_WCR, &val);
 156
 157         return val & IMX2_WDT_WCR_WDE;
 158 }
 159
 160 static int imx2_wdt_ping(struct watchdog_device *wdog)
 161 {
 162         struct imx2_wdt_device *wdev = watchdog_get_drvdata(wdog);
 163
 164         regmap_write(wdev->regmap, IMX2_WDT_WSR, IMX2_WDT_SEQ1);
 165         regmap_write(wdev->regmap, IMX2_WDT_WSR, IMX2_WDT_SEQ2);
 166         return 0;
 167 }
 168
 169 static void __imx2_wdt_set_timeout(struct watchdog_device *wdog,
 170                                    unsigned int new_timeout)
 171 {
 172         struct imx2_wdt_device *wdev = watchdog_get_drvdata(wdog);
 173
 174         regmap_update_bits(wdev->regmap, IMX2_WDT_WCR, IMX2_WDT_WCR_WT,
 175                            WDOG_SEC_TO_COUNT(new_timeout));
 176 }
 177
 178 static int imx2_wdt_set_timeout(struct watchdog_device *wdog,
 179                                 unsigned int new_timeout)
 180 {
 181         unsigned int actual;
 182
 183         actual = min(new_timeout, IMX2_WDT_MAX_TIME);
 184         __imx2_wdt_set_timeout(wdog, actual);
 185         wdog->timeout = new_timeout;
 186         return 0;
 187 }
 188
 189 static int imx2_wdt_set_pretimeout(struct watchdog_device *wdog,
 190                                    unsigned int new_pretimeout)
 191 {
 192         struct imx2_wdt_device *wdev = watchdog_get_drvdata(wdog);
 193
 194         if (new_pretimeout >= IMX2_WDT_MAX_TIME)
 195                 return -EINVAL;
 196
 197         wdog->pretimeout = new_pretimeout;
 198
 199         regmap_update_bits(wdev->regmap, IMX2_WDT_WICR,
 200                            IMX2_WDT_WICR_WIE | IMX2_WDT_WICR_WICT,
 201                            IMX2_WDT_WICR_WIE | (new_pretimeout << 1));
 202         return 0;
 203 }
 204
 205 static irqreturn_t imx2_wdt_isr(int irq, void *wdog_arg)
 206 {
 207         struct watchdog_device *wdog = wdog_arg;
 208         struct imx2_wdt_device *wdev = watchdog_get_drvdata(wdog);
 209
 210         regmap_write_bits(wdev->regmap, IMX2_WDT_WICR,
 211                           IMX2_WDT_WICR_WTIS, IMX2_WDT_WICR_WTIS);
 212
 213         watchdog_notify_pretimeout(wdog);
 214
 215         return IRQ_HANDLED;
 216 }
 217
 218 static int imx2_wdt_start(struct watchdog_device *wdog)
 219 {
 220         struct imx2_wdt_device *wdev = watchdog_get_drvdata(wdog);
 221
 222         if (imx2_wdt_is_running(wdev))
 223                 imx2_wdt_set_timeout(wdog, wdog->timeout);
 224         else
 225                 imx2_wdt_setup(wdog);
 226
 227         set_bit(WDOG_HW_RUNNING, &wdog->status);
 228
 229         return imx2_wdt_ping(wdog);
 230 }
 231
 232 static const struct watchdog_ops imx2_wdt_ops = {
 233         .owner = THIS_MODULE,
 234         .start = imx2_wdt_start,
 235         .ping = imx2_wdt_ping,
 236         .set_timeout = imx2_wdt_set_timeout,
 237         .set_pretimeout = imx2_wdt_set_pretimeout,
 238         .restart = imx2_wdt_restart,
 239 };
 240
 241 static const struct regmap_config imx2_wdt_regmap_config = {
 242         .reg_bits = 16,
 243         .reg_stride = 2,
 244         .val_bits = 16,
 245         .max_register = 0x8,
 246 };
 247
 248 static int __init imx2_wdt_probe(struct platform_device *pdev)
 249 {
 250         struct imx2_wdt_device *wdev;
 251         struct watchdog_device *wdog;
 252         struct resource *res;
 253         void __iomem *base;
 254         int ret;
 255         u32 val;
 256
 257         wdev = devm_kzalloc(&pdev->dev, sizeof(*wdev), GFP_KERNEL);
 258         if (!wdev)
 259                 return -ENOMEM;
 260
 261         res = platform_get_resource(pdev, IORESOURCE_MEM, 0);
 262         base = devm_ioremap_resource(&pdev->dev, res);
 263         if (IS_ERR(base))
 264                 return PTR_ERR(base);
 265
 266         wdev->regmap = devm_regmap_init_mmio_clk(&pdev->dev, NULL, base,
 267                                                  &imx2_wdt_regmap_config);
 268         if (IS_ERR(wdev->regmap)) {
 269                 dev_err(&pdev->dev, "regmap init failed\n");
 270                 return PTR_ERR(wdev->regmap);
 271         }
 272
 273         wdev->clk = devm_clk_get(&pdev->dev, NULL);
 274         if (IS_ERR(wdev->clk)) {
 275                 dev_err(&pdev->dev, "can't get Watchdog clock\n");
 276                 return PTR_ERR(wdev->clk);
 277         }
 278
 279         wdog                    = &wdev->wdog;
 280         wdog->info              = &imx2_wdt_info;
 281         wdog->ops               = &imx2_wdt_ops;
 282         wdog->min_timeout       = 1;
 283         wdog->timeout           = IMX2_WDT_DEFAULT_TIME;
 284         wdog->max_hw_heartbeat_ms = IMX2_WDT_MAX_TIME * 1000;
 285         wdog->parent            = &pdev->dev;
 286
 287         ret = platform_get_irq(pdev, 0);
 288         if (ret > 0)
 289                 if (!devm_request_irq(&pdev->dev, ret, imx2_wdt_isr, 0,
 290                                       dev_name(&pdev->dev), wdog))
 291                         wdog->info = &imx2_wdt_pretimeout_info;
 292
 293         ret = clk_prepare_enable(wdev->clk);
 294         if (ret)
 295                 return ret;
 296
 297         regmap_read(wdev->regmap, IMX2_WDT_WRSR, &val);
 298         wdog->bootstatus = val & IMX2_WDT_WRSR_TOUT ? WDIOF_CARDRESET : 0;
 299
 300         wdev->ext_reset = of_property_read_bool(pdev->dev.of_node,
 301                                                 "fsl,ext-reset-output");
 302         platform_set_drvdata(pdev, wdog);
 303         watchdog_set_drvdata(wdog, wdev);
 304         watchdog_set_nowayout(wdog, nowayout);
 305         watchdog_set_restart_priority(wdog, 128);
 306         watchdog_init_timeout(wdog, timeout, &pdev->dev);
 307
 308         if (imx2_wdt_is_running(wdev)) {
 309                 imx2_wdt_set_timeout(wdog, wdog->timeout);
 310                 set_bit(WDOG_HW_RUNNING, &wdog->status);
 311         }
 312
 313         /*
 314          * Disable the watchdog power down counter at boot. Otherwise the power
 315          * down counter will pull down the #WDOG interrupt line for one clock
 316          * cycle.
 317          */
 318         regmap_write(wdev->regmap, IMX2_WDT_WMCR, 0);
 319
 320         ret = watchdog_register_device(wdog);
 321         if (ret) {
 322                 dev_err(&pdev->dev, "cannot register watchdog device\n");
 323                 goto disable_clk;
 324         }
 325
 326         dev_info(&pdev->dev, "timeout %d sec (nowayout=%d)\n",
 327                  wdog->timeout, nowayout);
 328
 329         return 0;
 330
 331 disable_clk:
 332         clk_disable_unprepare(wdev->clk);
 333         return ret;
 334 }
 335
 336 static int __exit imx2_wdt_remove(struct platform_device *pdev)
 337 {
 338         struct watchdog_device *wdog = platform_get_drvdata(pdev);
 339         struct imx2_wdt_device *wdev = watchdog_get_drvdata(wdog);
 340
 341         watchdog_unregister_device(wdog);
 342
 343         if (imx2_wdt_is_running(wdev)) {
 344                 imx2_wdt_ping(wdog);
 345                 dev_crit(&pdev->dev, "Device removed: Expect reboot!\n");
 346         }
 347         return 0;
 348 }
 349
 350 static void imx2_wdt_shutdown(struct platform_device *pdev)
 351 {
 352         struct watchdog_device *wdog = platform_get_drvdata(pdev);
 353         struct imx2_wdt_device *wdev = watchdog_get_drvdata(wdog);
 354
 355         if (imx2_wdt_is_running(wdev)) {
 356                 /*
 357                  * We are running, configure max timeout before reboot
 358                  * will take place.
 359                  */
 360                 imx2_wdt_set_timeout(wdog, IMX2_WDT_MAX_TIME);
 361                 imx2_wdt_ping(wdog);
 362                 dev_crit(&pdev->dev, "Device shutdown: Expect reboot!\n");
 363         }
 364 }
 365
 366 #ifdef CONFIG_PM_SLEEP
 367 /* Disable watchdog if it is active or non-active but still running */
 368 static int imx2_wdt_suspend(struct device *dev)
 369 {
 370         struct watchdog_device *wdog = dev_get_drvdata(dev);
 371         struct imx2_wdt_device *wdev = watchdog_get_drvdata(wdog);
 372
 373         /* The watchdog IP block is running */
 374         if (imx2_wdt_is_running(wdev)) {
 375                 /*
 376                  * Don't update wdog->timeout, we'll restore the current value
 377                  * during resume.
 378                  */
 379                 __imx2_wdt_set_timeout(wdog, IMX2_WDT_MAX_TIME);
 380                 imx2_wdt_ping(wdog);
 381         }
 382
 383         clk_disable_unprepare(wdev->clk);
 384
 385         return 0;
 386 }
 387
 388 /* Enable watchdog and configure it if necessary */
 389 static int imx2_wdt_resume(struct device *dev)
 390 {
 391         struct watchdog_device *wdog = dev_get_drvdata(dev);
 392         struct imx2_wdt_device *wdev = watchdog_get_drvdata(wdog);
 393         int ret;
 394
 395         ret = clk_prepare_enable(wdev->clk);
 396         if (ret)
 397                 return ret;
 398
 399         if (watchdog_active(wdog) && !imx2_wdt_is_running(wdev)) {
 400                 /*
 401                  * If the watchdog is still active and resumes
 402                  * from deep sleep state, need to restart the
 403                  * watchdog again.
 404                  */
 405                 imx2_wdt_setup(wdog);
 406         }
 407         if (imx2_wdt_is_running(wdev)) {
 408                 imx2_wdt_set_timeout(wdog, wdog->timeout);
 409                 imx2_wdt_ping(wdog);
 410         }
 411
 412         return 0;
 413 }
 414 #endif
 415
 416 static SIMPLE_DEV_PM_OPS(imx2_wdt_pm_ops, imx2_wdt_suspend,
 417                          imx2_wdt_resume);
 418
 419 static const struct of_device_id imx2_wdt_dt_ids[] = {
 420         { .compatible = "fsl,imx21-wdt", },
 421         { /* sentinel */ }
 422 };
 423 MODULE_DEVICE_TABLE(of, imx2_wdt_dt_ids);
 424
 425 static struct platform_driver imx2_wdt_driver = {
 426         .remove         = __exit_p(imx2_wdt_remove),
 427         .shutdown       = imx2_wdt_shutdown,
 428         .driver         = {
 429                 .name   = DRIVER_NAME,
 430                 .pm     = &imx2_wdt_pm_ops,
 431                 .of_match_table = imx2_wdt_dt_ids,
 432         },
 433 };
 434
 435 module_platform_driver_probe(imx2_wdt_driver, imx2_wdt_probe);
 436
 437 MODULE_AUTHOR("Wolfram Sang");
 438 MODULE_DESCRIPTION("Watchdog driver for IMX2 and later");
 439 MODULE_LICENSE("GPL v2");
 440 MODULE_ALIAS("platform:" DRIVER_NAME);