root/drivers/watchdog/sbsa_gwdt.c

/* [<][>][^][v][top][bottom][index][help] */

DEFINITIONS

This source file includes following definitions.
  1. sbsa_gwdt_set_timeout
  2. sbsa_gwdt_get_timeleft
  3. sbsa_gwdt_keepalive
  4. sbsa_gwdt_start
  5. sbsa_gwdt_stop
  6. sbsa_gwdt_interrupt
  7. sbsa_gwdt_probe
  8. sbsa_gwdt_suspend
  9. sbsa_gwdt_resume

   1 // SPDX-License-Identifier: GPL-2.0-only
   2 /*
   3  * SBSA(Server Base System Architecture) Generic Watchdog driver
   4  *
   5  * Copyright (c) 2015, Linaro Ltd.
   6  * Author: Fu Wei <fu.wei@linaro.org>
   7  *         Suravee Suthikulpanit <Suravee.Suthikulpanit@amd.com>
   8  *         Al Stone <al.stone@linaro.org>
   9  *         Timur Tabi <timur@codeaurora.org>
  10  *
  11  * ARM SBSA Generic Watchdog has two stage timeouts:
  12  * the first signal (WS0) is for alerting the system by interrupt,
  13  * the second one (WS1) is a real hardware reset.
  14  * More details about the hardware specification of this device:
  15  * ARM DEN0029B - Server Base System Architecture (SBSA)
  16  *
  17  * This driver can operate ARM SBSA Generic Watchdog as a single stage watchdog
  18  * or a two stages watchdog, it's set up by the module parameter "action".
  19  * In the single stage mode, when the timeout is reached, your system
  20  * will be reset by WS1. The first signal (WS0) is ignored.
  21  * In the two stages mode, when the timeout is reached, the first signal (WS0)
  22  * will trigger panic. If the system is getting into trouble and cannot be reset
  23  * by panic or restart properly by the kdump kernel(if supported), then the
  24  * second stage (as long as the first stage) will be reached, system will be
  25  * reset by WS1. This function can help administrator to backup the system
  26  * context info by panic console output or kdump.
  27  *
  28  * SBSA GWDT:
  29  * if action is 1 (the two stages mode):
  30  * |--------WOR-------WS0--------WOR-------WS1
  31  * |----timeout-----(panic)----timeout-----reset
  32  *
  33  * if action is 0 (the single stage mode):
  34  * |------WOR-----WS0(ignored)-----WOR------WS1
  35  * |--------------timeout-------------------reset
  36  *
  37  * Note: Since this watchdog timer has two stages, and each stage is determined
  38  * by WOR, in the single stage mode, the timeout is (WOR * 2); in the two
  39  * stages mode, the timeout is WOR. The maximum timeout in the two stages mode
  40  * is half of that in the single stage mode.
  41  */
  42 
  43 #include <linux/io.h>
  44 #include <linux/io-64-nonatomic-lo-hi.h>
  45 #include <linux/interrupt.h>
  46 #include <linux/module.h>
  47 #include <linux/moduleparam.h>
  48 #include <linux/of.h>
  49 #include <linux/of_device.h>
  50 #include <linux/platform_device.h>
  51 #include <linux/uaccess.h>
  52 #include <linux/watchdog.h>
  53 #include <asm/arch_timer.h>
  54 
  55 #define DRV_NAME                "sbsa-gwdt"
  56 #define WATCHDOG_NAME           "SBSA Generic Watchdog"
  57 
  58 /* SBSA Generic Watchdog register definitions */
  59 /* refresh frame */
  60 #define SBSA_GWDT_WRR           0x000
  61 
  62 /* control frame */
  63 #define SBSA_GWDT_WCS           0x000
  64 #define SBSA_GWDT_WOR           0x008
  65 #define SBSA_GWDT_WCV           0x010
  66 
  67 /* refresh/control frame */
  68 #define SBSA_GWDT_W_IIDR        0xfcc
  69 #define SBSA_GWDT_IDR           0xfd0
  70 
  71 /* Watchdog Control and Status Register */
  72 #define SBSA_GWDT_WCS_EN        BIT(0)
  73 #define SBSA_GWDT_WCS_WS0       BIT(1)
  74 #define SBSA_GWDT_WCS_WS1       BIT(2)
  75 
  76 /**
  77  * struct sbsa_gwdt - Internal representation of the SBSA GWDT
  78  * @wdd:                kernel watchdog_device structure
  79  * @clk:                store the System Counter clock frequency, in Hz.
  80  * @refresh_base:       Virtual address of the watchdog refresh frame
  81  * @control_base:       Virtual address of the watchdog control frame
  82  */
  83 struct sbsa_gwdt {
  84         struct watchdog_device  wdd;
  85         u32                     clk;
  86         void __iomem            *refresh_base;
  87         void __iomem            *control_base;
  88 };
  89 
  90 #define DEFAULT_TIMEOUT         10 /* seconds */
  91 
  92 static unsigned int timeout;
  93 module_param(timeout, uint, 0);
  94 MODULE_PARM_DESC(timeout,
  95                  "Watchdog timeout in seconds. (>=0, default="
  96                  __MODULE_STRING(DEFAULT_TIMEOUT) ")");
  97 
  98 /*
  99  * action refers to action taken when watchdog gets WS0
 100  * 0 = skip
 101  * 1 = panic
 102  * defaults to skip (0)
 103  */
 104 static int action;
 105 module_param(action, int, 0);
 106 MODULE_PARM_DESC(action, "after watchdog gets WS0 interrupt, do: "
 107                  "0 = skip(*)  1 = panic");
 108 
 109 static bool nowayout = WATCHDOG_NOWAYOUT;
 110 module_param(nowayout, bool, S_IRUGO);
 111 MODULE_PARM_DESC(nowayout,
 112                  "Watchdog cannot be stopped once started (default="
 113                  __MODULE_STRING(WATCHDOG_NOWAYOUT) ")");
 114 
 115 /*
 116  * watchdog operation functions
 117  */
 118 static int sbsa_gwdt_set_timeout(struct watchdog_device *wdd,
 119                                  unsigned int timeout)
 120 {
 121         struct sbsa_gwdt *gwdt = watchdog_get_drvdata(wdd);
 122 
 123         wdd->timeout = timeout;
 124 
 125         if (action)
 126                 writel(gwdt->clk * timeout,
 127                        gwdt->control_base + SBSA_GWDT_WOR);
 128         else
 129                 /*
 130                  * In the single stage mode, The first signal (WS0) is ignored,
 131                  * the timeout is (WOR * 2), so the WOR should be configured
 132                  * to half value of timeout.
 133                  */
 134                 writel(gwdt->clk / 2 * timeout,
 135                        gwdt->control_base + SBSA_GWDT_WOR);
 136 
 137         return 0;
 138 }
 139 
 140 static unsigned int sbsa_gwdt_get_timeleft(struct watchdog_device *wdd)
 141 {
 142         struct sbsa_gwdt *gwdt = watchdog_get_drvdata(wdd);
 143         u64 timeleft = 0;
 144 
 145         /*
 146          * In the single stage mode, if WS0 is deasserted
 147          * (watchdog is in the first stage),
 148          * timeleft = WOR + (WCV - system counter)
 149          */
 150         if (!action &&
 151             !(readl(gwdt->control_base + SBSA_GWDT_WCS) & SBSA_GWDT_WCS_WS0))
 152                 timeleft += readl(gwdt->control_base + SBSA_GWDT_WOR);
 153 
 154         timeleft += lo_hi_readq(gwdt->control_base + SBSA_GWDT_WCV) -
 155                     arch_timer_read_counter();
 156 
 157         do_div(timeleft, gwdt->clk);
 158 
 159         return timeleft;
 160 }
 161 
 162 static int sbsa_gwdt_keepalive(struct watchdog_device *wdd)
 163 {
 164         struct sbsa_gwdt *gwdt = watchdog_get_drvdata(wdd);
 165 
 166         /*
 167          * Writing WRR for an explicit watchdog refresh.
 168          * You can write anyting (like 0).
 169          */
 170         writel(0, gwdt->refresh_base + SBSA_GWDT_WRR);
 171 
 172         return 0;
 173 }
 174 
 175 static int sbsa_gwdt_start(struct watchdog_device *wdd)
 176 {
 177         struct sbsa_gwdt *gwdt = watchdog_get_drvdata(wdd);
 178 
 179         /* writing WCS will cause an explicit watchdog refresh */
 180         writel(SBSA_GWDT_WCS_EN, gwdt->control_base + SBSA_GWDT_WCS);
 181 
 182         return 0;
 183 }
 184 
 185 static int sbsa_gwdt_stop(struct watchdog_device *wdd)
 186 {
 187         struct sbsa_gwdt *gwdt = watchdog_get_drvdata(wdd);
 188 
 189         /* Simply write 0 to WCS to clean WCS_EN bit */
 190         writel(0, gwdt->control_base + SBSA_GWDT_WCS);
 191 
 192         return 0;
 193 }
 194 
 195 static irqreturn_t sbsa_gwdt_interrupt(int irq, void *dev_id)
 196 {
 197         panic(WATCHDOG_NAME " timeout");
 198 
 199         return IRQ_HANDLED;
 200 }
 201 
 202 static const struct watchdog_info sbsa_gwdt_info = {
 203         .identity       = WATCHDOG_NAME,
 204         .options        = WDIOF_SETTIMEOUT |
 205                           WDIOF_KEEPALIVEPING |
 206                           WDIOF_MAGICCLOSE |
 207                           WDIOF_CARDRESET,
 208 };
 209 
 210 static const struct watchdog_ops sbsa_gwdt_ops = {
 211         .owner          = THIS_MODULE,
 212         .start          = sbsa_gwdt_start,
 213         .stop           = sbsa_gwdt_stop,
 214         .ping           = sbsa_gwdt_keepalive,
 215         .set_timeout    = sbsa_gwdt_set_timeout,
 216         .get_timeleft   = sbsa_gwdt_get_timeleft,
 217 };
 218 
 219 static int sbsa_gwdt_probe(struct platform_device *pdev)
 220 {
 221         void __iomem *rf_base, *cf_base;
 222         struct device *dev = &pdev->dev;
 223         struct watchdog_device *wdd;
 224         struct sbsa_gwdt *gwdt;
 225         int ret, irq;
 226         u32 status;
 227 
 228         gwdt = devm_kzalloc(dev, sizeof(*gwdt), GFP_KERNEL);
 229         if (!gwdt)
 230                 return -ENOMEM;
 231         platform_set_drvdata(pdev, gwdt);
 232 
 233         cf_base = devm_platform_ioremap_resource(pdev, 0);
 234         if (IS_ERR(cf_base))
 235                 return PTR_ERR(cf_base);
 236 
 237         rf_base = devm_platform_ioremap_resource(pdev, 1);
 238         if (IS_ERR(rf_base))
 239                 return PTR_ERR(rf_base);
 240 
 241         /*
 242          * Get the frequency of system counter from the cp15 interface of ARM
 243          * Generic timer. We don't need to check it, because if it returns "0",
 244          * system would panic in very early stage.
 245          */
 246         gwdt->clk = arch_timer_get_cntfrq();
 247         gwdt->refresh_base = rf_base;
 248         gwdt->control_base = cf_base;
 249 
 250         wdd = &gwdt->wdd;
 251         wdd->parent = dev;
 252         wdd->info = &sbsa_gwdt_info;
 253         wdd->ops = &sbsa_gwdt_ops;
 254         wdd->min_timeout = 1;
 255         wdd->max_hw_heartbeat_ms = U32_MAX / gwdt->clk * 1000;
 256         wdd->timeout = DEFAULT_TIMEOUT;
 257         watchdog_set_drvdata(wdd, gwdt);
 258         watchdog_set_nowayout(wdd, nowayout);
 259 
 260         status = readl(cf_base + SBSA_GWDT_WCS);
 261         if (status & SBSA_GWDT_WCS_WS1) {
 262                 dev_warn(dev, "System reset by WDT.\n");
 263                 wdd->bootstatus |= WDIOF_CARDRESET;
 264         }
 265         if (status & SBSA_GWDT_WCS_EN)
 266                 set_bit(WDOG_HW_RUNNING, &wdd->status);
 267 
 268         if (action) {
 269                 irq = platform_get_irq(pdev, 0);
 270                 if (irq < 0) {
 271                         action = 0;
 272                         dev_warn(dev, "unable to get ws0 interrupt.\n");
 273                 } else {
 274                         /*
 275                          * In case there is a pending ws0 interrupt, just ping
 276                          * the watchdog before registering the interrupt routine
 277                          */
 278                         writel(0, rf_base + SBSA_GWDT_WRR);
 279                         if (devm_request_irq(dev, irq, sbsa_gwdt_interrupt, 0,
 280                                              pdev->name, gwdt)) {
 281                                 action = 0;
 282                                 dev_warn(dev, "unable to request IRQ %d.\n",
 283                                          irq);
 284                         }
 285                 }
 286                 if (!action)
 287                         dev_warn(dev, "falling back to single stage mode.\n");
 288         }
 289         /*
 290          * In the single stage mode, The first signal (WS0) is ignored,
 291          * the timeout is (WOR * 2), so the maximum timeout should be doubled.
 292          */
 293         if (!action)
 294                 wdd->max_hw_heartbeat_ms *= 2;
 295 
 296         watchdog_init_timeout(wdd, timeout, dev);
 297         /*
 298          * Update timeout to WOR.
 299          * Because of the explicit watchdog refresh mechanism,
 300          * it's also a ping, if watchdog is enabled.
 301          */
 302         sbsa_gwdt_set_timeout(wdd, wdd->timeout);
 303 
 304         watchdog_stop_on_reboot(wdd);
 305         ret = devm_watchdog_register_device(dev, wdd);
 306         if (ret)
 307                 return ret;
 308 
 309         dev_info(dev, "Initialized with %ds timeout @ %u Hz, action=%d.%s\n",
 310                  wdd->timeout, gwdt->clk, action,
 311                  status & SBSA_GWDT_WCS_EN ? " [enabled]" : "");
 312 
 313         return 0;
 314 }
 315 
 316 /* Disable watchdog if it is active during suspend */
 317 static int __maybe_unused sbsa_gwdt_suspend(struct device *dev)
 318 {
 319         struct sbsa_gwdt *gwdt = dev_get_drvdata(dev);
 320 
 321         if (watchdog_active(&gwdt->wdd))
 322                 sbsa_gwdt_stop(&gwdt->wdd);
 323 
 324         return 0;
 325 }
 326 
 327 /* Enable watchdog if necessary */
 328 static int __maybe_unused sbsa_gwdt_resume(struct device *dev)
 329 {
 330         struct sbsa_gwdt *gwdt = dev_get_drvdata(dev);
 331 
 332         if (watchdog_active(&gwdt->wdd))
 333                 sbsa_gwdt_start(&gwdt->wdd);
 334 
 335         return 0;
 336 }
 337 
 338 static const struct dev_pm_ops sbsa_gwdt_pm_ops = {
 339         SET_SYSTEM_SLEEP_PM_OPS(sbsa_gwdt_suspend, sbsa_gwdt_resume)
 340 };
 341 
 342 static const struct of_device_id sbsa_gwdt_of_match[] = {
 343         { .compatible = "arm,sbsa-gwdt", },
 344         {},
 345 };
 346 MODULE_DEVICE_TABLE(of, sbsa_gwdt_of_match);
 347 
 348 static const struct platform_device_id sbsa_gwdt_pdev_match[] = {
 349         { .name = DRV_NAME, },
 350         {},
 351 };
 352 MODULE_DEVICE_TABLE(platform, sbsa_gwdt_pdev_match);
 353 
 354 static struct platform_driver sbsa_gwdt_driver = {
 355         .driver = {
 356                 .name = DRV_NAME,
 357                 .pm = &sbsa_gwdt_pm_ops,
 358                 .of_match_table = sbsa_gwdt_of_match,
 359         },
 360         .probe = sbsa_gwdt_probe,
 361         .id_table = sbsa_gwdt_pdev_match,
 362 };
 363 
 364 module_platform_driver(sbsa_gwdt_driver);
 365 
 366 MODULE_DESCRIPTION("SBSA Generic Watchdog Driver");
 367 MODULE_AUTHOR("Fu Wei <fu.wei@linaro.org>");
 368 MODULE_AUTHOR("Suravee Suthikulpanit <Suravee.Suthikulpanit@amd.com>");
 369 MODULE_AUTHOR("Al Stone <al.stone@linaro.org>");
 370 MODULE_AUTHOR("Timur Tabi <timur@codeaurora.org>");
 371 MODULE_LICENSE("GPL v2");
 372 MODULE_ALIAS("platform:" DRV_NAME);

/* [<][>][^][v][top][bottom][index][help] */