2 * Industrial Computer Source WDT500/501 driver
4 * (c) Copyright 1996-1997 Alan Cox <alan@lxorguk.ukuu.org.uk>,
7 * This program is free software; you can redistribute it and/or
8 * modify it under the terms of the GNU General Public License
9 * as published by the Free Software Foundation; either version
10 * 2 of the License, or (at your option) any later version.
12 * Neither Alan Cox nor CymruNet Ltd. admit liability nor provide
13 * warranty for any of this software. This material is provided
14 * "AS-IS" and at no charge.
16 * (c) Copyright 1995 Alan Cox <alan@lxorguk.ukuu.org.uk>
21 * Dave Gregorich : Modularisation and minor bugs
22 * Alan Cox : Added the watchdog ioctl() stuff
23 * Alan Cox : Fixed the reboot problem (as noted by
25 * Alan Cox : Added wdt= boot option
26 * Alan Cox : Cleaned up copy/user stuff
27 * Tim Hockin : Added insmod parameters, comment
28 * cleanup, parameterized timeout
29 * Tigran Aivazian : Restructured wdt_init() to handle
31 * Joel Becker : Added WDIOC_GET/SETTIMEOUT
32 * Matt Domsch : Added nowayout module option
35 #include <linux/interrupt.h>
36 #include <linux/module.h>
37 #include <linux/moduleparam.h>
38 #include <linux/types.h>
39 #include <linux/miscdevice.h>
40 #include <linux/watchdog.h>
42 #include <linux/ioport.h>
43 #include <linux/notifier.h>
44 #include <linux/reboot.h>
45 #include <linux/init.h>
47 #include <linux/uaccess.h>
49 #include <asm/system.h>
52 static unsigned long wdt_is_open;
53 static char expect_close;
59 #define WD_TIMO 60 /* Default heartbeat = 60 seconds */
61 static int heartbeat = WD_TIMO;
62 static int wd_heartbeat;
63 module_param(heartbeat, int, 0);
64 MODULE_PARM_DESC(heartbeat,
65 "Watchdog heartbeat in seconds. (0 < heartbeat < 65536, default="
66 __MODULE_STRING(WD_TIMO) ")");
68 static int nowayout = WATCHDOG_NOWAYOUT;
69 module_param(nowayout, int, 0);
70 MODULE_PARM_DESC(nowayout,
71 "Watchdog cannot be stopped once started (default="
72 __MODULE_STRING(WATCHDOG_NOWAYOUT) ")");
74 /* You must set these - there is no sane way to probe for this board. */
75 static int io = 0x240;
78 static DEFINE_SPINLOCK(wdt_lock);
80 module_param(io, int, 0);
81 MODULE_PARM_DESC(io, "WDT io port (default=0x240)");
82 module_param(irq, int, 0);
83 MODULE_PARM_DESC(irq, "WDT irq (default=11)");
86 /* Support for the Fan Tachometer on the WDT501-P */
87 static int tachometer;
89 module_param(tachometer, int, 0);
90 MODULE_PARM_DESC(tachometer,
91 "WDT501-P Fan Tachometer support (0=disable, default=0)");
92 #endif /* CONFIG_WDT_501 */
98 static void wdt_ctr_mode(int ctr, int mode)
106 static void wdt_ctr_load(int ctr, int val)
108 outb_p(val&0xFF, WDT_COUNT0+ctr);
109 outb_p(val>>8, WDT_COUNT0+ctr);
115 * Start the watchdog driver.
118 static int wdt_start(void)
121 spin_lock_irqsave(&wdt_lock, flags);
122 inb_p(WDT_DC); /* Disable watchdog */
123 wdt_ctr_mode(0, 3); /* Program CTR0 for Mode 3:
124 Square Wave Generator */
125 wdt_ctr_mode(1, 2); /* Program CTR1 for Mode 2:
127 wdt_ctr_mode(2, 0); /* Program CTR2 for Mode 0:
128 Pulse on Terminal Count */
129 wdt_ctr_load(0, 8948); /* Count at 100Hz */
130 wdt_ctr_load(1, wd_heartbeat); /* Heartbeat */
131 wdt_ctr_load(2, 65535); /* Length of reset pulse */
132 outb_p(0, WDT_DC); /* Enable watchdog */
133 spin_unlock_irqrestore(&wdt_lock, flags);
140 * Stop the watchdog driver.
143 static int wdt_stop(void)
146 spin_lock_irqsave(&wdt_lock, flags);
147 /* Turn the card off */
148 inb_p(WDT_DC); /* Disable watchdog */
149 wdt_ctr_load(2, 0); /* 0 length reset pulses now */
150 spin_unlock_irqrestore(&wdt_lock, flags);
157 * Reload counter one with the watchdog heartbeat. We don't bother
158 * reloading the cascade counter.
161 static int wdt_ping(void)
164 spin_lock_irqsave(&wdt_lock, flags);
165 /* Write a watchdog value */
166 inb_p(WDT_DC); /* Disable watchdog */
167 wdt_ctr_mode(1, 2); /* Re-Program CTR1 for Mode 2:
169 wdt_ctr_load(1, wd_heartbeat); /* Heartbeat */
170 outb_p(0, WDT_DC); /* Enable watchdog */
171 spin_unlock_irqrestore(&wdt_lock, flags);
177 * @t: the new heartbeat value that needs to be set.
179 * Set a new heartbeat value for the watchdog device. If the heartbeat
180 * value is incorrect we keep the old value and return -EINVAL. If
181 * successful we return 0.
184 static int wdt_set_heartbeat(int t)
186 if (t < 1 || t > 65535)
190 wd_heartbeat = t * 100;
196 * @status: the new status.
198 * Extract the status information from a WDT watchdog device. There are
199 * several board variants so we have to know which bits are valid. Some
200 * bits default to one and some to zero in order to be maximally painful.
202 * we then map the bits onto the status ioctl flags.
205 static int wdt_get_status(int *status)
207 unsigned char new_status;
210 spin_lock_irqsave(&wdt_lock, flags);
211 new_status = inb_p(WDT_SR);
212 spin_unlock_irqrestore(&wdt_lock, flags);
215 if (new_status & WDC_SR_ISOI0)
216 *status |= WDIOF_EXTERN1;
217 if (new_status & WDC_SR_ISII1)
218 *status |= WDIOF_EXTERN2;
219 #ifdef CONFIG_WDT_501
220 if (!(new_status & WDC_SR_TGOOD))
221 *status |= WDIOF_OVERHEAT;
222 if (!(new_status & WDC_SR_PSUOVER))
223 *status |= WDIOF_POWEROVER;
224 if (!(new_status & WDC_SR_PSUUNDR))
225 *status |= WDIOF_POWERUNDER;
227 if (!(new_status & WDC_SR_FANGOOD))
228 *status |= WDIOF_FANFAULT;
230 #endif /* CONFIG_WDT_501 */
234 #ifdef CONFIG_WDT_501
236 * wdt_get_temperature:
238 * Reports the temperature in degrees Fahrenheit. The API is in
239 * farenheit. It was designed by an imperial measurement luddite.
242 static int wdt_get_temperature(int *temperature)
247 spin_lock_irqsave(&wdt_lock, flags);
249 spin_unlock_irqrestore(&wdt_lock, flags);
250 *temperature = (c * 11 / 15) + 7;
253 #endif /* CONFIG_WDT_501 */
257 * @irq: Interrupt number
258 * @dev_id: Unused as we don't allow multiple devices.
260 * Handle an interrupt from the board. These are raised when the status
261 * map changes in what the board considers an interesting way. That means
262 * a failure condition occurring.
265 static irqreturn_t wdt_interrupt(int irq, void *dev_id)
268 * Read the status register see what is up and
271 unsigned char status;
273 spin_lock(&wdt_lock);
274 status = inb_p(WDT_SR);
276 printk(KERN_CRIT "WDT status %d\n", status);
278 #ifdef CONFIG_WDT_501
279 if (!(status & WDC_SR_TGOOD))
280 printk(KERN_CRIT "Overheat alarm.(%d)\n", inb_p(WDT_RT));
281 if (!(status & WDC_SR_PSUOVER))
282 printk(KERN_CRIT "PSU over voltage.\n");
283 if (!(status & WDC_SR_PSUUNDR))
284 printk(KERN_CRIT "PSU under voltage.\n");
286 if (!(status & WDC_SR_FANGOOD))
287 printk(KERN_CRIT "Possible fan fault.\n");
289 #endif /* CONFIG_WDT_501 */
290 if (!(status & WDC_SR_WCCR)) {
291 #ifdef SOFTWARE_REBOOT
293 printk(KERN_CRIT "Would Reboot.\n");
295 printk(KERN_CRIT "Initiating system reboot.\n");
299 printk(KERN_CRIT "Reset in 5ms.\n");
302 spin_unlock(&wdt_lock);
309 * @file: file handle to the watchdog
310 * @buf: buffer to write (unused as data does not matter here
311 * @count: count of bytes
312 * @ppos: pointer to the position to write. No seeks allowed
314 * A write to a watchdog device is defined as a keepalive signal. Any
315 * write of data will do, as we we don't define content meaning.
318 static ssize_t wdt_write(struct file *file, const char __user *buf,
319 size_t count, loff_t *ppos)
325 /* In case it was set long ago */
328 for (i = 0; i != count; i++) {
330 if (get_user(c, buf + i))
343 * @file: file handle to the device
344 * @cmd: watchdog command
345 * @arg: argument pointer
347 * The watchdog API defines a common set of functions for all watchdogs
348 * according to their available features. We only actually usefully support
349 * querying capabilities and current status.
352 static long wdt_ioctl(struct file *file, unsigned int cmd, unsigned long arg)
354 void __user *argp = (void __user *)arg;
355 int __user *p = argp;
359 static struct watchdog_info ident = {
360 .options = WDIOF_SETTIMEOUT|
363 .firmware_version = 1,
364 .identity = "WDT500/501",
367 /* Add options according to the card we have */
368 ident.options |= (WDIOF_EXTERN1|WDIOF_EXTERN2);
369 #ifdef CONFIG_WDT_501
370 ident.options |= (WDIOF_OVERHEAT|WDIOF_POWERUNDER|WDIOF_POWEROVER);
372 ident.options |= WDIOF_FANFAULT;
373 #endif /* CONFIG_WDT_501 */
376 case WDIOC_GETSUPPORT:
377 return copy_to_user(argp, &ident, sizeof(ident)) ? -EFAULT : 0;
378 case WDIOC_GETSTATUS:
379 wdt_get_status(&status);
380 return put_user(status, p);
381 case WDIOC_GETBOOTSTATUS:
382 return put_user(0, p);
383 case WDIOC_KEEPALIVE:
386 case WDIOC_SETTIMEOUT:
387 if (get_user(new_heartbeat, p))
389 if (wdt_set_heartbeat(new_heartbeat))
393 case WDIOC_GETTIMEOUT:
394 return put_user(heartbeat, p);
402 * @inode: inode of device
403 * @file: file handle to device
405 * The watchdog device has been opened. The watchdog device is single
406 * open and on opening we load the counters. Counter zero is a 100Hz
407 * cascade, into counter 1 which downcounts to reboot. When the counter
408 * triggers counter 2 downcounts the length of the reset pulse which
409 * set set to be as long as possible.
412 static int wdt_open(struct inode *inode, struct file *file)
414 if (test_and_set_bit(0, &wdt_is_open))
420 return nonseekable_open(inode, file);
425 * @inode: inode to board
426 * @file: file handle to board
428 * The watchdog has a configurable API. There is a religious dispute
429 * between people who want their watchdog to be able to shut down and
430 * those who want to be sure if the watchdog manager dies the machine
431 * reboots. In the former case we disable the counters, in the latter
432 * case you have to open it again very soon.
435 static int wdt_release(struct inode *inode, struct file *file)
437 if (expect_close == 42) {
439 clear_bit(0, &wdt_is_open);
442 "wdt: WDT device closed unexpectedly. WDT will not stop!\n");
449 #ifdef CONFIG_WDT_501
452 * @file: file handle to the watchdog board
453 * @buf: buffer to write 1 byte into
454 * @count: length of buffer
455 * @ptr: offset (no seek allowed)
457 * Temp_read reports the temperature in degrees Fahrenheit. The API is in
458 * farenheit. It was designed by an imperial measurement luddite.
461 static ssize_t wdt_temp_read(struct file *file, char __user *buf,
462 size_t count, loff_t *ptr)
466 if (wdt_get_temperature(&temperature))
469 if (copy_to_user(buf, &temperature, 1))
477 * @inode: inode of device
478 * @file: file handle to device
480 * The temperature device has been opened.
483 static int wdt_temp_open(struct inode *inode, struct file *file)
485 return nonseekable_open(inode, file);
490 * @inode: inode to board
491 * @file: file handle to board
493 * The temperature device has been closed.
496 static int wdt_temp_release(struct inode *inode, struct file *file)
500 #endif /* CONFIG_WDT_501 */
504 * @this: our notifier block
505 * @code: the event being reported
508 * Our notifier is called on system shutdowns. We want to turn the card
509 * off at reboot otherwise the machine will reboot again during memory
510 * test or worse yet during the following fsck. This would suck, in fact
511 * trust me - if it happens it does suck.
514 static int wdt_notify_sys(struct notifier_block *this, unsigned long code,
517 if (code == SYS_DOWN || code == SYS_HALT)
527 static const struct file_operations wdt_fops = {
528 .owner = THIS_MODULE,
531 .unlocked_ioctl = wdt_ioctl,
533 .release = wdt_release,
536 static struct miscdevice wdt_miscdev = {
537 .minor = WATCHDOG_MINOR,
542 #ifdef CONFIG_WDT_501
543 static const struct file_operations wdt_temp_fops = {
544 .owner = THIS_MODULE,
546 .read = wdt_temp_read,
547 .open = wdt_temp_open,
548 .release = wdt_temp_release,
551 static struct miscdevice temp_miscdev = {
553 .name = "temperature",
554 .fops = &wdt_temp_fops,
556 #endif /* CONFIG_WDT_501 */
559 * The WDT card needs to learn about soft shutdowns in order to
560 * turn the timebomb registers off.
563 static struct notifier_block wdt_notifier = {
564 .notifier_call = wdt_notify_sys,
570 * Unload the watchdog. You cannot do this with any file handles open.
571 * If your watchdog is set to continue ticking on close and you unload
572 * it, well it keeps ticking. We won't get the interrupt but the board
573 * will not touch PC memory so all is fine. You just have to load a new
574 * module in 60 seconds or reboot.
577 static void __exit wdt_exit(void)
579 misc_deregister(&wdt_miscdev);
580 #ifdef CONFIG_WDT_501
581 misc_deregister(&temp_miscdev);
582 #endif /* CONFIG_WDT_501 */
583 unregister_reboot_notifier(&wdt_notifier);
585 release_region(io, 8);
591 * Set up the WDT watchdog board. All we have to do is grab the
592 * resources we require and bitch if anyone beat us to them.
593 * The open() function will actually kick the board off.
596 static int __init wdt_init(void)
600 /* Check that the heartbeat value is within it's range;
601 if not reset to the default */
602 if (wdt_set_heartbeat(heartbeat)) {
603 wdt_set_heartbeat(WD_TIMO);
604 printk(KERN_INFO "wdt: heartbeat value must be 0 < heartbeat < 65536, using %d\n",
608 if (!request_region(io, 8, "wdt501p")) {
610 "wdt: I/O address 0x%04x already in use\n", io);
615 ret = request_irq(irq, wdt_interrupt, IRQF_DISABLED, "wdt501p", NULL);
617 printk(KERN_ERR "wdt: IRQ %d is not free.\n", irq);
621 ret = register_reboot_notifier(&wdt_notifier);
624 "wdt: cannot register reboot notifier (err=%d)\n", ret);
628 #ifdef CONFIG_WDT_501
629 ret = misc_register(&temp_miscdev);
632 "wdt: cannot register miscdev on minor=%d (err=%d)\n",
636 #endif /* CONFIG_WDT_501 */
638 ret = misc_register(&wdt_miscdev);
641 "wdt: cannot register miscdev on minor=%d (err=%d)\n",
642 WATCHDOG_MINOR, ret);
647 printk(KERN_INFO "WDT500/501-P driver 0.10 at 0x%04x (Interrupt %d). heartbeat=%d sec (nowayout=%d)\n",
648 io, irq, heartbeat, nowayout);
649 #ifdef CONFIG_WDT_501
650 printk(KERN_INFO "wdt: Fan Tachometer is %s\n",
651 (tachometer ? "Enabled" : "Disabled"));
652 #endif /* CONFIG_WDT_501 */
658 #ifdef CONFIG_WDT_501
659 misc_deregister(&temp_miscdev);
661 #endif /* CONFIG_WDT_501 */
662 unregister_reboot_notifier(&wdt_notifier);
666 release_region(io, 8);
670 module_init(wdt_init);
671 module_exit(wdt_exit);
673 MODULE_AUTHOR("Alan Cox");
674 MODULE_DESCRIPTION("Driver for ISA ICS watchdog cards (WDT500/501)");
675 MODULE_ALIAS_MISCDEV(WATCHDOG_MINOR);
676 MODULE_ALIAS_MISCDEV(TEMP_MINOR);
677 MODULE_LICENSE("GPL");