drm/nouveau: fix kernel-doc comments
[drm/drm-misc.git] / drivers / watchdog / armada_37xx_wdt.c
bloba17a7911771ace2d4c36a8e3b2a616c433562191
1 // SPDX-License-Identifier: GPL-2.0+
2 /*
3 * Watchdog driver for Marvell Armada 37xx SoCs
5 * Author: Marek BehĂșn <kabel@kernel.org>
6 */
8 #include <linux/clk.h>
9 #include <linux/err.h>
10 #include <linux/interrupt.h>
11 #include <linux/io.h>
12 #include <linux/kernel.h>
13 #include <linux/mfd/syscon.h>
14 #include <linux/module.h>
15 #include <linux/moduleparam.h>
16 #include <linux/of.h>
17 #include <linux/platform_device.h>
18 #include <linux/regmap.h>
19 #include <linux/types.h>
20 #include <linux/watchdog.h>
23 * There are four counters that can be used for watchdog on Armada 37xx.
24 * The addresses for counter control registers are register base plus ID*0x10,
25 * where ID is 0, 1, 2 or 3.
27 * In this driver we use IDs 0 and 1. Counter ID 1 is used as watchdog counter,
28 * while counter ID 0 is used to implement pinging the watchdog: counter ID 1 is
29 * set to restart counting from initial value on counter ID 0 end count event.
30 * Pinging is done by forcing immediate end count event on counter ID 0.
31 * If only one counter was used, pinging would have to be implemented by
32 * disabling and enabling the counter, leaving the system in a vulnerable state
33 * for a (really) short period of time.
35 * Counters ID 2 and 3 are enabled by default even before U-Boot loads,
36 * therefore this driver does not provide a way to use them, eg. by setting a
37 * property in device tree.
40 #define CNTR_ID_RETRIGGER 0
41 #define CNTR_ID_WDOG 1
43 /* relative to cpu_misc */
44 #define WDT_TIMER_SELECT 0x64
45 #define WDT_TIMER_SELECT_MASK 0xf
46 #define WDT_TIMER_SELECT_VAL BIT(CNTR_ID_WDOG)
48 /* relative to reg */
49 #define CNTR_CTRL(id) ((id) * 0x10)
50 #define CNTR_CTRL_ENABLE 0x0001
51 #define CNTR_CTRL_ACTIVE 0x0002
52 #define CNTR_CTRL_MODE_MASK 0x000c
53 #define CNTR_CTRL_MODE_ONESHOT 0x0000
54 #define CNTR_CTRL_MODE_HWSIG 0x000c
55 #define CNTR_CTRL_TRIG_SRC_MASK 0x00f0
56 #define CNTR_CTRL_TRIG_SRC_PREV_CNTR 0x0050
57 #define CNTR_CTRL_PRESCALE_MASK 0xff00
58 #define CNTR_CTRL_PRESCALE_MIN 2
59 #define CNTR_CTRL_PRESCALE_SHIFT 8
61 #define CNTR_COUNT_LOW(id) (CNTR_CTRL(id) + 0x4)
62 #define CNTR_COUNT_HIGH(id) (CNTR_CTRL(id) + 0x8)
64 #define WATCHDOG_TIMEOUT 120
66 static unsigned int timeout;
67 module_param(timeout, int, 0);
68 MODULE_PARM_DESC(timeout, "Watchdog timeout in seconds");
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) ")");
75 struct armada_37xx_watchdog {
76 struct watchdog_device wdt;
77 struct regmap *cpu_misc;
78 void __iomem *reg;
79 u64 timeout; /* in clock ticks */
80 unsigned long clk_rate;
81 struct clk *clk;
84 static u64 get_counter_value(struct armada_37xx_watchdog *dev, int id)
86 u64 val;
89 * when low is read, high is latched into flip-flops so that it can be
90 * read consistently without using software debouncing
92 val = readl(dev->reg + CNTR_COUNT_LOW(id));
93 val |= ((u64)readl(dev->reg + CNTR_COUNT_HIGH(id))) << 32;
95 return val;
98 static void set_counter_value(struct armada_37xx_watchdog *dev, int id, u64 val)
100 writel(val & 0xffffffff, dev->reg + CNTR_COUNT_LOW(id));
101 writel(val >> 32, dev->reg + CNTR_COUNT_HIGH(id));
104 static void counter_enable(struct armada_37xx_watchdog *dev, int id)
106 u32 reg;
108 reg = readl(dev->reg + CNTR_CTRL(id));
109 reg |= CNTR_CTRL_ENABLE;
110 writel(reg, dev->reg + CNTR_CTRL(id));
113 static void counter_disable(struct armada_37xx_watchdog *dev, int id)
115 u32 reg;
117 reg = readl(dev->reg + CNTR_CTRL(id));
118 reg &= ~CNTR_CTRL_ENABLE;
119 writel(reg, dev->reg + CNTR_CTRL(id));
122 static void init_counter(struct armada_37xx_watchdog *dev, int id, u32 mode,
123 u32 trig_src)
125 u32 reg;
127 reg = readl(dev->reg + CNTR_CTRL(id));
129 reg &= ~(CNTR_CTRL_MODE_MASK | CNTR_CTRL_PRESCALE_MASK |
130 CNTR_CTRL_TRIG_SRC_MASK);
132 /* set mode */
133 reg |= mode & CNTR_CTRL_MODE_MASK;
135 /* set prescaler to the min value */
136 reg |= CNTR_CTRL_PRESCALE_MIN << CNTR_CTRL_PRESCALE_SHIFT;
138 /* set trigger source */
139 reg |= trig_src & CNTR_CTRL_TRIG_SRC_MASK;
141 writel(reg, dev->reg + CNTR_CTRL(id));
144 static int armada_37xx_wdt_ping(struct watchdog_device *wdt)
146 struct armada_37xx_watchdog *dev = watchdog_get_drvdata(wdt);
148 /* counter 1 is retriggered by forcing end count on counter 0 */
149 counter_disable(dev, CNTR_ID_RETRIGGER);
150 counter_enable(dev, CNTR_ID_RETRIGGER);
152 return 0;
155 static unsigned int armada_37xx_wdt_get_timeleft(struct watchdog_device *wdt)
157 struct armada_37xx_watchdog *dev = watchdog_get_drvdata(wdt);
158 u64 res;
160 res = get_counter_value(dev, CNTR_ID_WDOG) * CNTR_CTRL_PRESCALE_MIN;
161 do_div(res, dev->clk_rate);
163 return res;
166 static int armada_37xx_wdt_set_timeout(struct watchdog_device *wdt,
167 unsigned int timeout)
169 struct armada_37xx_watchdog *dev = watchdog_get_drvdata(wdt);
171 wdt->timeout = timeout;
174 * Compute the timeout in clock rate. We use smallest possible
175 * prescaler, which divides the clock rate by 2
176 * (CNTR_CTRL_PRESCALE_MIN).
178 dev->timeout = (u64)dev->clk_rate * timeout;
179 do_div(dev->timeout, CNTR_CTRL_PRESCALE_MIN);
181 set_counter_value(dev, CNTR_ID_WDOG, dev->timeout);
183 return 0;
186 static bool armada_37xx_wdt_is_running(struct armada_37xx_watchdog *dev)
188 u32 reg;
190 regmap_read(dev->cpu_misc, WDT_TIMER_SELECT, &reg);
191 if ((reg & WDT_TIMER_SELECT_MASK) != WDT_TIMER_SELECT_VAL)
192 return false;
194 reg = readl(dev->reg + CNTR_CTRL(CNTR_ID_WDOG));
195 return !!(reg & CNTR_CTRL_ACTIVE);
198 static int armada_37xx_wdt_start(struct watchdog_device *wdt)
200 struct armada_37xx_watchdog *dev = watchdog_get_drvdata(wdt);
202 /* select counter 1 as watchdog counter */
203 regmap_write(dev->cpu_misc, WDT_TIMER_SELECT, WDT_TIMER_SELECT_VAL);
205 /* init counter 0 as retrigger counter for counter 1 */
206 init_counter(dev, CNTR_ID_RETRIGGER, CNTR_CTRL_MODE_ONESHOT, 0);
207 set_counter_value(dev, CNTR_ID_RETRIGGER, 0);
209 /* init counter 1 to be retriggerable by counter 0 end count */
210 init_counter(dev, CNTR_ID_WDOG, CNTR_CTRL_MODE_HWSIG,
211 CNTR_CTRL_TRIG_SRC_PREV_CNTR);
212 set_counter_value(dev, CNTR_ID_WDOG, dev->timeout);
214 /* enable counter 1 */
215 counter_enable(dev, CNTR_ID_WDOG);
217 /* start counter 1 by forcing immediate end count on counter 0 */
218 counter_enable(dev, CNTR_ID_RETRIGGER);
220 return 0;
223 static int armada_37xx_wdt_stop(struct watchdog_device *wdt)
225 struct armada_37xx_watchdog *dev = watchdog_get_drvdata(wdt);
227 counter_disable(dev, CNTR_ID_WDOG);
228 counter_disable(dev, CNTR_ID_RETRIGGER);
229 regmap_write(dev->cpu_misc, WDT_TIMER_SELECT, 0);
231 return 0;
234 static const struct watchdog_info armada_37xx_wdt_info = {
235 .options = WDIOF_SETTIMEOUT | WDIOF_KEEPALIVEPING | WDIOF_MAGICCLOSE,
236 .identity = "Armada 37xx Watchdog",
239 static const struct watchdog_ops armada_37xx_wdt_ops = {
240 .owner = THIS_MODULE,
241 .start = armada_37xx_wdt_start,
242 .stop = armada_37xx_wdt_stop,
243 .ping = armada_37xx_wdt_ping,
244 .set_timeout = armada_37xx_wdt_set_timeout,
245 .get_timeleft = armada_37xx_wdt_get_timeleft,
248 static int armada_37xx_wdt_probe(struct platform_device *pdev)
250 struct armada_37xx_watchdog *dev;
251 struct regmap *regmap;
252 int ret;
254 dev = devm_kzalloc(&pdev->dev, sizeof(struct armada_37xx_watchdog),
255 GFP_KERNEL);
256 if (!dev)
257 return -ENOMEM;
259 dev->wdt.info = &armada_37xx_wdt_info;
260 dev->wdt.ops = &armada_37xx_wdt_ops;
262 regmap = syscon_regmap_lookup_by_phandle(pdev->dev.of_node,
263 "marvell,system-controller");
264 if (IS_ERR(regmap))
265 return PTR_ERR(regmap);
266 dev->cpu_misc = regmap;
268 dev->reg = devm_platform_ioremap_resource(pdev, 0);
269 if (IS_ERR(dev->reg))
270 return PTR_ERR(dev->reg);
272 /* init clock */
273 dev->clk = devm_clk_get_enabled(&pdev->dev, NULL);
274 if (IS_ERR(dev->clk))
275 return PTR_ERR(dev->clk);
277 dev->clk_rate = clk_get_rate(dev->clk);
278 if (!dev->clk_rate)
279 return -EINVAL;
282 * Since the timeout in seconds is given as 32 bit unsigned int, and
283 * the counters hold 64 bit values, even after multiplication by clock
284 * rate the counter can hold timeout of UINT_MAX seconds.
286 dev->wdt.min_timeout = 1;
287 dev->wdt.max_timeout = UINT_MAX;
288 dev->wdt.parent = &pdev->dev;
290 /* default value, possibly override by module parameter or dtb */
291 dev->wdt.timeout = WATCHDOG_TIMEOUT;
292 watchdog_init_timeout(&dev->wdt, timeout, &pdev->dev);
294 platform_set_drvdata(pdev, &dev->wdt);
295 watchdog_set_drvdata(&dev->wdt, dev);
297 armada_37xx_wdt_set_timeout(&dev->wdt, dev->wdt.timeout);
299 if (armada_37xx_wdt_is_running(dev))
300 set_bit(WDOG_HW_RUNNING, &dev->wdt.status);
302 watchdog_set_nowayout(&dev->wdt, nowayout);
303 watchdog_stop_on_reboot(&dev->wdt);
304 ret = devm_watchdog_register_device(&pdev->dev, &dev->wdt);
305 if (ret)
306 return ret;
308 dev_info(&pdev->dev, "Initial timeout %d sec%s\n",
309 dev->wdt.timeout, nowayout ? ", nowayout" : "");
311 return 0;
314 static int __maybe_unused armada_37xx_wdt_suspend(struct device *dev)
316 struct watchdog_device *wdt = dev_get_drvdata(dev);
318 return armada_37xx_wdt_stop(wdt);
321 static int __maybe_unused armada_37xx_wdt_resume(struct device *dev)
323 struct watchdog_device *wdt = dev_get_drvdata(dev);
325 if (watchdog_active(wdt))
326 return armada_37xx_wdt_start(wdt);
328 return 0;
331 static const struct dev_pm_ops armada_37xx_wdt_dev_pm_ops = {
332 SET_SYSTEM_SLEEP_PM_OPS(armada_37xx_wdt_suspend,
333 armada_37xx_wdt_resume)
336 #ifdef CONFIG_OF
337 static const struct of_device_id armada_37xx_wdt_match[] = {
338 { .compatible = "marvell,armada-3700-wdt", },
341 MODULE_DEVICE_TABLE(of, armada_37xx_wdt_match);
342 #endif
344 static struct platform_driver armada_37xx_wdt_driver = {
345 .probe = armada_37xx_wdt_probe,
346 .driver = {
347 .name = "armada_37xx_wdt",
348 .of_match_table = of_match_ptr(armada_37xx_wdt_match),
349 .pm = &armada_37xx_wdt_dev_pm_ops,
353 module_platform_driver(armada_37xx_wdt_driver);
355 MODULE_AUTHOR("Marek Behun <kabel@kernel.org>");
356 MODULE_DESCRIPTION("Armada 37xx CPU Watchdog");
358 MODULE_LICENSE("GPL v2");
359 MODULE_ALIAS("platform:armada_37xx_wdt");