xref: /openbmc/linux/drivers/watchdog/shwdt.c (revision 25985edc)
1 /*
2  * drivers/watchdog/shwdt.c
3  *
4  * Watchdog driver for integrated watchdog in the SuperH processors.
5  *
6  * Copyright (C) 2001 - 2010  Paul Mundt <lethal@linux-sh.org>
7  *
8  * This program is free software; you can redistribute it and/or modify it
9  * under the terms of the GNU General Public License as published by the
10  * Free Software Foundation; either version 2 of the License, or (at your
11  * option) any later version.
12  *
13  * 14-Dec-2001 Matt Domsch <Matt_Domsch@dell.com>
14  *     Added nowayout module option to override CONFIG_WATCHDOG_NOWAYOUT
15  *
16  * 19-Apr-2002 Rob Radez <rob@osinvestor.com>
17  *     Added expect close support, made emulated timeout runtime changeable
18  *     general cleanups, add some ioctls
19  */
20 #include <linux/module.h>
21 #include <linux/moduleparam.h>
22 #include <linux/platform_device.h>
23 #include <linux/init.h>
24 #include <linux/types.h>
25 #include <linux/miscdevice.h>
26 #include <linux/watchdog.h>
27 #include <linux/reboot.h>
28 #include <linux/notifier.h>
29 #include <linux/ioport.h>
30 #include <linux/fs.h>
31 #include <linux/mm.h>
32 #include <linux/slab.h>
33 #include <linux/io.h>
34 #include <linux/uaccess.h>
35 #include <asm/watchdog.h>
36 
37 #define DRV_NAME "sh-wdt"
38 
39 /*
40  * Default clock division ratio is 5.25 msecs. For an additional table of
41  * values, consult the asm-sh/watchdog.h. Overload this at module load
42  * time.
43  *
44  * In order for this to work reliably we need to have HZ set to 1000 or
45  * something quite higher than 100 (or we need a proper high-res timer
46  * implementation that will deal with this properly), otherwise the 10ms
47  * resolution of a jiffy is enough to trigger the overflow. For things like
48  * the SH-4 and SH-5, this isn't necessarily that big of a problem, though
49  * for the SH-2 and SH-3, this isn't recommended unless the WDT is absolutely
50  * necssary.
51  *
52  * As a result of this timing problem, the only modes that are particularly
53  * feasible are the 4096 and the 2048 divisors, which yield 5.25 and 2.62ms
54  * overflow periods respectively.
55  *
56  * Also, since we can't really expect userspace to be responsive enough
57  * before the overflow happens, we maintain two separate timers .. One in
58  * the kernel for clearing out WOVF every 2ms or so (again, this depends on
59  * HZ == 1000), and another for monitoring userspace writes to the WDT device.
60  *
61  * As such, we currently use a configurable heartbeat interval which defaults
62  * to 30s. In this case, the userspace daemon is only responsible for periodic
63  * writes to the device before the next heartbeat is scheduled. If the daemon
64  * misses its deadline, the kernel timer will allow the WDT to overflow.
65  */
66 static int clock_division_ratio = WTCSR_CKS_4096;
67 #define next_ping_period(cks)	msecs_to_jiffies(cks - 4)
68 
69 static const struct watchdog_info sh_wdt_info;
70 static struct platform_device *sh_wdt_dev;
71 static DEFINE_SPINLOCK(shwdt_lock);
72 
73 #define WATCHDOG_HEARTBEAT 30			/* 30 sec default heartbeat */
74 static int heartbeat = WATCHDOG_HEARTBEAT;	/* in seconds */
75 static int nowayout = WATCHDOG_NOWAYOUT;
76 static unsigned long next_heartbeat;
77 
78 struct sh_wdt {
79 	void __iomem		*base;
80 	struct device		*dev;
81 
82 	struct timer_list	timer;
83 
84 	unsigned long		enabled;
85 	char			expect_close;
86 };
87 
88 static void sh_wdt_start(struct sh_wdt *wdt)
89 {
90 	unsigned long flags;
91 	u8 csr;
92 
93 	spin_lock_irqsave(&shwdt_lock, flags);
94 
95 	next_heartbeat = jiffies + (heartbeat * HZ);
96 	mod_timer(&wdt->timer, next_ping_period(clock_division_ratio));
97 
98 	csr = sh_wdt_read_csr();
99 	csr |= WTCSR_WT | clock_division_ratio;
100 	sh_wdt_write_csr(csr);
101 
102 	sh_wdt_write_cnt(0);
103 
104 	/*
105 	 * These processors have a bit of an inconsistent initialization
106 	 * process.. starting with SH-3, RSTS was moved to WTCSR, and the
107 	 * RSTCSR register was removed.
108 	 *
109 	 * On the SH-2 however, in addition with bits being in different
110 	 * locations, we must deal with RSTCSR outright..
111 	 */
112 	csr = sh_wdt_read_csr();
113 	csr |= WTCSR_TME;
114 	csr &= ~WTCSR_RSTS;
115 	sh_wdt_write_csr(csr);
116 
117 #ifdef CONFIG_CPU_SH2
118 	csr = sh_wdt_read_rstcsr();
119 	csr &= ~RSTCSR_RSTS;
120 	sh_wdt_write_rstcsr(csr);
121 #endif
122 	spin_unlock_irqrestore(&shwdt_lock, flags);
123 }
124 
125 static void sh_wdt_stop(struct sh_wdt *wdt)
126 {
127 	unsigned long flags;
128 	u8 csr;
129 
130 	spin_lock_irqsave(&shwdt_lock, flags);
131 
132 	del_timer(&wdt->timer);
133 
134 	csr = sh_wdt_read_csr();
135 	csr &= ~WTCSR_TME;
136 	sh_wdt_write_csr(csr);
137 
138 	spin_unlock_irqrestore(&shwdt_lock, flags);
139 }
140 
141 static inline void sh_wdt_keepalive(struct sh_wdt *wdt)
142 {
143 	unsigned long flags;
144 
145 	spin_lock_irqsave(&shwdt_lock, flags);
146 	next_heartbeat = jiffies + (heartbeat * HZ);
147 	spin_unlock_irqrestore(&shwdt_lock, flags);
148 }
149 
150 static int sh_wdt_set_heartbeat(int t)
151 {
152 	unsigned long flags;
153 
154 	if (unlikely(t < 1 || t > 3600)) /* arbitrary upper limit */
155 		return -EINVAL;
156 
157 	spin_lock_irqsave(&shwdt_lock, flags);
158 	heartbeat = t;
159 	spin_unlock_irqrestore(&shwdt_lock, flags);
160 	return 0;
161 }
162 
163 static void sh_wdt_ping(unsigned long data)
164 {
165 	struct sh_wdt *wdt = (struct sh_wdt *)data;
166 	unsigned long flags;
167 
168 	spin_lock_irqsave(&shwdt_lock, flags);
169 	if (time_before(jiffies, next_heartbeat)) {
170 		u8 csr;
171 
172 		csr = sh_wdt_read_csr();
173 		csr &= ~WTCSR_IOVF;
174 		sh_wdt_write_csr(csr);
175 
176 		sh_wdt_write_cnt(0);
177 
178 		mod_timer(&wdt->timer, next_ping_period(clock_division_ratio));
179 	} else
180 		dev_warn(wdt->dev, "Heartbeat lost! Will not ping "
181 		         "the watchdog\n");
182 	spin_unlock_irqrestore(&shwdt_lock, flags);
183 }
184 
185 static int sh_wdt_open(struct inode *inode, struct file *file)
186 {
187 	struct sh_wdt *wdt = platform_get_drvdata(sh_wdt_dev);
188 
189 	if (test_and_set_bit(0, &wdt->enabled))
190 		return -EBUSY;
191 	if (nowayout)
192 		__module_get(THIS_MODULE);
193 
194 	file->private_data = wdt;
195 
196 	sh_wdt_start(wdt);
197 
198 	return nonseekable_open(inode, file);
199 }
200 
201 static int sh_wdt_close(struct inode *inode, struct file *file)
202 {
203 	struct sh_wdt *wdt = file->private_data;
204 
205 	if (wdt->expect_close == 42) {
206 		sh_wdt_stop(wdt);
207 	} else {
208 		dev_crit(wdt->dev, "Unexpected close, not "
209 		         "stopping watchdog!\n");
210 		sh_wdt_keepalive(wdt);
211 	}
212 
213 	clear_bit(0, &wdt->enabled);
214 	wdt->expect_close = 0;
215 
216 	return 0;
217 }
218 
219 static ssize_t sh_wdt_write(struct file *file, const char *buf,
220 			    size_t count, loff_t *ppos)
221 {
222 	struct sh_wdt *wdt = file->private_data;
223 
224 	if (count) {
225 		if (!nowayout) {
226 			size_t i;
227 
228 			wdt->expect_close = 0;
229 
230 			for (i = 0; i != count; i++) {
231 				char c;
232 				if (get_user(c, buf + i))
233 					return -EFAULT;
234 				if (c == 'V')
235 					wdt->expect_close = 42;
236 			}
237 		}
238 		sh_wdt_keepalive(wdt);
239 	}
240 
241 	return count;
242 }
243 
244 static long sh_wdt_ioctl(struct file *file, unsigned int cmd,
245 							unsigned long arg)
246 {
247 	struct sh_wdt *wdt = file->private_data;
248 	int new_heartbeat;
249 	int options, retval = -EINVAL;
250 
251 	switch (cmd) {
252 	case WDIOC_GETSUPPORT:
253 		return copy_to_user((struct watchdog_info *)arg,
254 			  &sh_wdt_info, sizeof(sh_wdt_info)) ? -EFAULT : 0;
255 	case WDIOC_GETSTATUS:
256 	case WDIOC_GETBOOTSTATUS:
257 		return put_user(0, (int *)arg);
258 	case WDIOC_SETOPTIONS:
259 		if (get_user(options, (int *)arg))
260 			return -EFAULT;
261 
262 		if (options & WDIOS_DISABLECARD) {
263 			sh_wdt_stop(wdt);
264 			retval = 0;
265 		}
266 
267 		if (options & WDIOS_ENABLECARD) {
268 			sh_wdt_start(wdt);
269 			retval = 0;
270 		}
271 
272 		return retval;
273 	case WDIOC_KEEPALIVE:
274 		sh_wdt_keepalive(wdt);
275 		return 0;
276 	case WDIOC_SETTIMEOUT:
277 		if (get_user(new_heartbeat, (int *)arg))
278 			return -EFAULT;
279 
280 		if (sh_wdt_set_heartbeat(new_heartbeat))
281 			return -EINVAL;
282 
283 		sh_wdt_keepalive(wdt);
284 		/* Fall */
285 	case WDIOC_GETTIMEOUT:
286 		return put_user(heartbeat, (int *)arg);
287 	default:
288 		return -ENOTTY;
289 	}
290 	return 0;
291 }
292 
293 static int sh_wdt_notify_sys(struct notifier_block *this,
294 			     unsigned long code, void *unused)
295 {
296 	struct sh_wdt *wdt = platform_get_drvdata(sh_wdt_dev);
297 
298 	if (code == SYS_DOWN || code == SYS_HALT)
299 		sh_wdt_stop(wdt);
300 
301 	return NOTIFY_DONE;
302 }
303 
304 static const struct file_operations sh_wdt_fops = {
305 	.owner		= THIS_MODULE,
306 	.llseek		= no_llseek,
307 	.write		= sh_wdt_write,
308 	.unlocked_ioctl	= sh_wdt_ioctl,
309 	.open		= sh_wdt_open,
310 	.release	= sh_wdt_close,
311 };
312 
313 static const struct watchdog_info sh_wdt_info = {
314 	.options		= WDIOF_KEEPALIVEPING | WDIOF_SETTIMEOUT |
315 				  WDIOF_MAGICCLOSE,
316 	.firmware_version	= 1,
317 	.identity		= "SH WDT",
318 };
319 
320 static struct notifier_block sh_wdt_notifier = {
321 	.notifier_call		= sh_wdt_notify_sys,
322 };
323 
324 static struct miscdevice sh_wdt_miscdev = {
325 	.minor		= WATCHDOG_MINOR,
326 	.name		= "watchdog",
327 	.fops		= &sh_wdt_fops,
328 };
329 
330 static int __devinit sh_wdt_probe(struct platform_device *pdev)
331 {
332 	struct sh_wdt *wdt;
333 	struct resource *res;
334 	int rc;
335 
336 	/*
337 	 * As this driver only covers the global watchdog case, reject
338 	 * any attempts to register per-CPU watchdogs.
339 	 */
340 	if (pdev->id != -1)
341 		return -EINVAL;
342 
343 	res = platform_get_resource(pdev, IORESOURCE_MEM, 0);
344 	if (unlikely(!res))
345 		return -EINVAL;
346 
347 	if (!devm_request_mem_region(&pdev->dev, res->start,
348 				     resource_size(res), DRV_NAME))
349 		return -EBUSY;
350 
351 	wdt = devm_kzalloc(&pdev->dev, sizeof(struct sh_wdt), GFP_KERNEL);
352 	if (unlikely(!wdt)) {
353 		rc = -ENOMEM;
354 		goto out_release;
355 	}
356 
357 	wdt->dev = &pdev->dev;
358 
359 	wdt->base = devm_ioremap(&pdev->dev, res->start, resource_size(res));
360 	if (unlikely(!wdt->base)) {
361 		rc = -ENXIO;
362 		goto out_err;
363 	}
364 
365 	rc = register_reboot_notifier(&sh_wdt_notifier);
366 	if (unlikely(rc)) {
367 		dev_err(&pdev->dev,
368 			"Can't register reboot notifier (err=%d)\n", rc);
369 		goto out_unmap;
370 	}
371 
372 	sh_wdt_miscdev.parent = wdt->dev;
373 
374 	rc = misc_register(&sh_wdt_miscdev);
375 	if (unlikely(rc)) {
376 		dev_err(&pdev->dev,
377 			"Can't register miscdev on minor=%d (err=%d)\n",
378 						sh_wdt_miscdev.minor, rc);
379 		goto out_unreg;
380 	}
381 
382 	init_timer(&wdt->timer);
383 	wdt->timer.function	= sh_wdt_ping;
384 	wdt->timer.data		= (unsigned long)wdt;
385 	wdt->timer.expires	= next_ping_period(clock_division_ratio);
386 
387 	platform_set_drvdata(pdev, wdt);
388 	sh_wdt_dev = pdev;
389 
390 	dev_info(&pdev->dev, "initialized.\n");
391 
392 	return 0;
393 
394 out_unreg:
395 	unregister_reboot_notifier(&sh_wdt_notifier);
396 out_unmap:
397 	devm_iounmap(&pdev->dev, wdt->base);
398 out_err:
399 	devm_kfree(&pdev->dev, wdt);
400 out_release:
401 	devm_release_mem_region(&pdev->dev, res->start, resource_size(res));
402 
403 	return rc;
404 }
405 
406 static int __devexit sh_wdt_remove(struct platform_device *pdev)
407 {
408 	struct sh_wdt *wdt = platform_get_drvdata(pdev);
409 	struct resource *res = platform_get_resource(pdev, IORESOURCE_MEM, 0);
410 
411 	platform_set_drvdata(pdev, NULL);
412 
413 	misc_deregister(&sh_wdt_miscdev);
414 
415 	sh_wdt_dev = NULL;
416 
417 	unregister_reboot_notifier(&sh_wdt_notifier);
418 	devm_release_mem_region(&pdev->dev, res->start, resource_size(res));
419 	devm_iounmap(&pdev->dev, wdt->base);
420 	devm_kfree(&pdev->dev, wdt);
421 
422 	return 0;
423 }
424 
425 static struct platform_driver sh_wdt_driver = {
426 	.driver		= {
427 		.name	= DRV_NAME,
428 		.owner	= THIS_MODULE,
429 	},
430 
431 	.probe	= sh_wdt_probe,
432 	.remove	= __devexit_p(sh_wdt_remove),
433 };
434 
435 static int __init sh_wdt_init(void)
436 {
437 	int rc;
438 
439 	if (unlikely(clock_division_ratio < 0x5 ||
440 		     clock_division_ratio > 0x7)) {
441 		clock_division_ratio = WTCSR_CKS_4096;
442 
443 		pr_info("%s: divisor must be 0x5<=x<=0x7, using %d\n",
444 			 DRV_NAME, clock_division_ratio);
445 	}
446 
447 	rc = sh_wdt_set_heartbeat(heartbeat);
448 	if (unlikely(rc)) {
449 		heartbeat = WATCHDOG_HEARTBEAT;
450 
451 		pr_info("%s: heartbeat value must be 1<=x<=3600, using %d\n",
452 			DRV_NAME, heartbeat);
453 	}
454 
455 	pr_info("%s: configured with heartbeat=%d sec (nowayout=%d)\n",
456 		DRV_NAME, heartbeat, nowayout);
457 
458 	return platform_driver_register(&sh_wdt_driver);
459 }
460 
461 static void __exit sh_wdt_exit(void)
462 {
463 	platform_driver_unregister(&sh_wdt_driver);
464 }
465 module_init(sh_wdt_init);
466 module_exit(sh_wdt_exit);
467 
468 MODULE_AUTHOR("Paul Mundt <lethal@linux-sh.org>");
469 MODULE_DESCRIPTION("SuperH watchdog driver");
470 MODULE_LICENSE("GPL");
471 MODULE_ALIAS("platform:" DRV_NAME);
472 MODULE_ALIAS_MISCDEV(WATCHDOG_MINOR);
473 
474 module_param(clock_division_ratio, int, 0);
475 MODULE_PARM_DESC(clock_division_ratio,
476 	"Clock division ratio. Valid ranges are from 0x5 (1.31ms) "
477 	"to 0x7 (5.25ms). (default=" __MODULE_STRING(WTCSR_CKS_4096) ")");
478 
479 module_param(heartbeat, int, 0);
480 MODULE_PARM_DESC(heartbeat,
481 	"Watchdog heartbeat in seconds. (1 <= heartbeat <= 3600, default="
482 				__MODULE_STRING(WATCHDOG_HEARTBEAT) ")");
483 
484 module_param(nowayout, int, 0);
485 MODULE_PARM_DESC(nowayout,
486 	"Watchdog cannot be stopped once started (default="
487 				__MODULE_STRING(WATCHDOG_NOWAYOUT) ")");
488