1 // SPDX-License-Identifier: GPL-2.0+
3 * Industrial Computer Source WDT501 driver
5 * (c) Copyright 1996-1997 Alan Cox <alan@lxorguk.ukuu.org.uk>,
8 * Neither Alan Cox nor CymruNet Ltd. admit liability nor provide
9 * warranty for any of this software. This material is provided
10 * "AS-IS" and at no charge.
12 * (c) Copyright 1995 Alan Cox <alan@lxorguk.ukuu.org.uk>
17 * Dave Gregorich : Modularisation and minor bugs
18 * Alan Cox : Added the watchdog ioctl() stuff
19 * Alan Cox : Fixed the reboot problem (as noted by
21 * Alan Cox : Added wdt= boot option
22 * Alan Cox : Cleaned up copy/user stuff
23 * Tim Hockin : Added insmod parameters, comment
24 * cleanup, parameterized timeout
25 * Tigran Aivazian : Restructured wdt_init() to handle
27 * Joel Becker : Added WDIOC_GET/SETTIMEOUT
28 * Matt Domsch : Added nowayout module option
31 #define pr_fmt(fmt) KBUILD_MODNAME ": " fmt
33 #include <linux/interrupt.h>
34 #include <linux/module.h>
35 #include <linux/moduleparam.h>
36 #include <linux/types.h>
37 #include <linux/miscdevice.h>
38 #include <linux/watchdog.h>
40 #include <linux/ioport.h>
41 #include <linux/notifier.h>
42 #include <linux/reboot.h>
43 #include <linux/init.h>
45 #include <linux/uaccess.h>
49 static unsigned long wdt_is_open
;
50 static char expect_close
;
56 #define WD_TIMO 60 /* Default heartbeat = 60 seconds */
58 static int heartbeat
= WD_TIMO
;
59 static int wd_heartbeat
;
60 module_param(heartbeat
, int, 0);
61 MODULE_PARM_DESC(heartbeat
,
62 "Watchdog heartbeat in seconds. (0 < heartbeat < 65536, default="
63 __MODULE_STRING(WD_TIMO
) ")");
65 static bool nowayout
= WATCHDOG_NOWAYOUT
;
66 module_param(nowayout
, bool, 0);
67 MODULE_PARM_DESC(nowayout
,
68 "Watchdog cannot be stopped once started (default="
69 __MODULE_STRING(WATCHDOG_NOWAYOUT
) ")");
71 /* You must set these - there is no sane way to probe for this board. */
72 static int io
= 0x240;
75 static DEFINE_SPINLOCK(wdt_lock
);
77 module_param_hw(io
, int, ioport
, 0);
78 MODULE_PARM_DESC(io
, "WDT io port (default=0x240)");
79 module_param_hw(irq
, int, irq
, 0);
80 MODULE_PARM_DESC(irq
, "WDT irq (default=11)");
82 /* Support for the Fan Tachometer on the WDT501-P */
83 static int tachometer
;
84 module_param(tachometer
, int, 0);
85 MODULE_PARM_DESC(tachometer
,
86 "WDT501-P Fan Tachometer support (0=disable, default=0)");
88 static int type
= 500;
89 module_param(type
, int, 0);
90 MODULE_PARM_DESC(type
,
91 "WDT501-P Card type (500 or 501, default=500)");
97 static void wdt_ctr_mode(int ctr
, int mode
)
105 static void wdt_ctr_load(int ctr
, int val
)
107 outb_p(val
&0xFF, WDT_COUNT0
+ctr
);
108 outb_p(val
>>8, WDT_COUNT0
+ctr
);
114 * Start the watchdog driver.
117 static int wdt_start(void)
120 spin_lock_irqsave(&wdt_lock
, flags
);
121 inb_p(WDT_DC
); /* Disable watchdog */
122 wdt_ctr_mode(0, 3); /* Program CTR0 for Mode 3:
123 Square Wave Generator */
124 wdt_ctr_mode(1, 2); /* Program CTR1 for Mode 2:
126 wdt_ctr_mode(2, 0); /* Program CTR2 for Mode 0:
127 Pulse on Terminal Count */
128 wdt_ctr_load(0, 8948); /* Count at 100Hz */
129 wdt_ctr_load(1, wd_heartbeat
); /* Heartbeat */
130 wdt_ctr_load(2, 65535); /* Length of reset pulse */
131 outb_p(0, WDT_DC
); /* Enable watchdog */
132 spin_unlock_irqrestore(&wdt_lock
, flags
);
139 * Stop the watchdog driver.
142 static int wdt_stop(void)
145 spin_lock_irqsave(&wdt_lock
, flags
);
146 /* Turn the card off */
147 inb_p(WDT_DC
); /* Disable watchdog */
148 wdt_ctr_load(2, 0); /* 0 length reset pulses now */
149 spin_unlock_irqrestore(&wdt_lock
, flags
);
156 * Reload counter one with the watchdog heartbeat. We don't bother
157 * reloading the cascade counter.
160 static void wdt_ping(void)
163 spin_lock_irqsave(&wdt_lock
, flags
);
164 /* Write a watchdog value */
165 inb_p(WDT_DC
); /* Disable watchdog */
166 wdt_ctr_mode(1, 2); /* Re-Program CTR1 for Mode 2:
168 wdt_ctr_load(1, wd_heartbeat
); /* Heartbeat */
169 outb_p(0, WDT_DC
); /* Enable watchdog */
170 spin_unlock_irqrestore(&wdt_lock
, flags
);
175 * @t: the new heartbeat value that needs to be set.
177 * Set a new heartbeat value for the watchdog device. If the heartbeat
178 * value is incorrect we keep the old value and return -EINVAL. If
179 * successful we return 0.
182 static int wdt_set_heartbeat(int t
)
184 if (t
< 1 || t
> 65535)
188 wd_heartbeat
= t
* 100;
195 * Extract the status information from a WDT watchdog device. There are
196 * several board variants so we have to know which bits are valid. Some
197 * bits default to one and some to zero in order to be maximally painful.
199 * we then map the bits onto the status ioctl flags.
202 static int wdt_get_status(void)
204 unsigned char new_status
;
208 spin_lock_irqsave(&wdt_lock
, flags
);
209 new_status
= inb_p(WDT_SR
);
210 spin_unlock_irqrestore(&wdt_lock
, flags
);
212 if (new_status
& WDC_SR_ISOI0
)
213 status
|= WDIOF_EXTERN1
;
214 if (new_status
& WDC_SR_ISII1
)
215 status
|= WDIOF_EXTERN2
;
217 if (!(new_status
& WDC_SR_TGOOD
))
218 status
|= WDIOF_OVERHEAT
;
219 if (!(new_status
& WDC_SR_PSUOVER
))
220 status
|= WDIOF_POWEROVER
;
221 if (!(new_status
& WDC_SR_PSUUNDR
))
222 status
|= WDIOF_POWERUNDER
;
224 if (!(new_status
& WDC_SR_FANGOOD
))
225 status
|= WDIOF_FANFAULT
;
232 * wdt_get_temperature:
234 * Reports the temperature in degrees Fahrenheit. The API is in
235 * farenheit. It was designed by an imperial measurement luddite.
238 static int wdt_get_temperature(void)
243 spin_lock_irqsave(&wdt_lock
, flags
);
245 spin_unlock_irqrestore(&wdt_lock
, flags
);
246 return (c
* 11 / 15) + 7;
249 static void wdt_decode_501(int status
)
251 if (!(status
& WDC_SR_TGOOD
))
252 pr_crit("Overheat alarm (%d)\n", inb_p(WDT_RT
));
253 if (!(status
& WDC_SR_PSUOVER
))
254 pr_crit("PSU over voltage\n");
255 if (!(status
& WDC_SR_PSUUNDR
))
256 pr_crit("PSU under voltage\n");
261 * @irq: Interrupt number
262 * @dev_id: Unused as we don't allow multiple devices.
264 * Handle an interrupt from the board. These are raised when the status
265 * map changes in what the board considers an interesting way. That means
266 * a failure condition occurring.
269 static irqreturn_t
wdt_interrupt(int irq
, void *dev_id
)
272 * Read the status register see what is up and
275 unsigned char status
;
277 spin_lock(&wdt_lock
);
278 status
= inb_p(WDT_SR
);
280 pr_crit("WDT status %d\n", status
);
283 wdt_decode_501(status
);
285 if (!(status
& WDC_SR_FANGOOD
))
286 pr_crit("Possible fan fault\n");
289 if (!(status
& WDC_SR_WCCR
)) {
290 #ifdef SOFTWARE_REBOOT
292 pr_crit("Would Reboot\n");
294 pr_crit("Initiating system reboot\n");
298 pr_crit("Reset in 5ms\n");
301 spin_unlock(&wdt_lock
);
308 * @file: file handle to the watchdog
309 * @buf: buffer to write (unused as data does not matter here
310 * @count: count of bytes
311 * @ppos: pointer to the position to write. No seeks allowed
313 * A write to a watchdog device is defined as a keepalive signal. Any
314 * write of data will do, as we we don't define content meaning.
317 static ssize_t
wdt_write(struct file
*file
, const char __user
*buf
,
318 size_t count
, loff_t
*ppos
)
324 /* In case it was set long ago */
327 for (i
= 0; i
!= count
; i
++) {
329 if (get_user(c
, buf
+ i
))
342 * @file: file handle to the device
343 * @cmd: watchdog command
344 * @arg: argument pointer
346 * The watchdog API defines a common set of functions for all watchdogs
347 * according to their available features. We only actually usefully support
348 * querying capabilities and current status.
351 static long wdt_ioctl(struct file
*file
, unsigned int cmd
, unsigned long arg
)
353 void __user
*argp
= (void __user
*)arg
;
354 int __user
*p
= argp
;
358 struct watchdog_info ident
= {
359 .options
= WDIOF_SETTIMEOUT
|
362 .firmware_version
= 1,
363 .identity
= "WDT500/501",
366 /* Add options according to the card we have */
367 ident
.options
|= (WDIOF_EXTERN1
|WDIOF_EXTERN2
);
369 ident
.options
|= (WDIOF_OVERHEAT
|WDIOF_POWERUNDER
|
372 ident
.options
|= WDIOF_FANFAULT
;
376 case WDIOC_GETSUPPORT
:
377 return copy_to_user(argp
, &ident
, sizeof(ident
)) ? -EFAULT
: 0;
378 case WDIOC_GETSTATUS
:
379 status
= wdt_get_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 stream_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
);
441 pr_crit("WDT device closed unexpectedly. WDT will not stop!\n");
450 * @file: file handle to the watchdog board
451 * @buf: buffer to write 1 byte into
452 * @count: length of buffer
453 * @ptr: offset (no seek allowed)
455 * Temp_read reports the temperature in degrees Fahrenheit. The API is in
456 * farenheit. It was designed by an imperial measurement luddite.
459 static ssize_t
wdt_temp_read(struct file
*file
, char __user
*buf
,
460 size_t count
, loff_t
*ptr
)
462 int temperature
= wdt_get_temperature();
464 if (copy_to_user(buf
, &temperature
, 1))
472 * @inode: inode of device
473 * @file: file handle to device
475 * The temperature device has been opened.
478 static int wdt_temp_open(struct inode
*inode
, struct file
*file
)
480 return stream_open(inode
, file
);
485 * @inode: inode to board
486 * @file: file handle to board
488 * The temperature device has been closed.
491 static int wdt_temp_release(struct inode
*inode
, struct file
*file
)
498 * @this: our notifier block
499 * @code: the event being reported
502 * Our notifier is called on system shutdowns. We want to turn the card
503 * off at reboot otherwise the machine will reboot again during memory
504 * test or worse yet during the following fsck. This would suck, in fact
505 * trust me - if it happens it does suck.
508 static int wdt_notify_sys(struct notifier_block
*this, unsigned long code
,
511 if (code
== SYS_DOWN
|| code
== SYS_HALT
)
521 static const struct file_operations wdt_fops
= {
522 .owner
= THIS_MODULE
,
525 .unlocked_ioctl
= wdt_ioctl
,
527 .release
= wdt_release
,
530 static struct miscdevice wdt_miscdev
= {
531 .minor
= WATCHDOG_MINOR
,
536 static const struct file_operations wdt_temp_fops
= {
537 .owner
= THIS_MODULE
,
539 .read
= wdt_temp_read
,
540 .open
= wdt_temp_open
,
541 .release
= wdt_temp_release
,
544 static struct miscdevice temp_miscdev
= {
546 .name
= "temperature",
547 .fops
= &wdt_temp_fops
,
551 * The WDT card needs to learn about soft shutdowns in order to
552 * turn the timebomb registers off.
555 static struct notifier_block wdt_notifier
= {
556 .notifier_call
= wdt_notify_sys
,
562 * Unload the watchdog. You cannot do this with any file handles open.
563 * If your watchdog is set to continue ticking on close and you unload
564 * it, well it keeps ticking. We won't get the interrupt but the board
565 * will not touch PC memory so all is fine. You just have to load a new
566 * module in 60 seconds or reboot.
569 static void __exit
wdt_exit(void)
571 misc_deregister(&wdt_miscdev
);
573 misc_deregister(&temp_miscdev
);
574 unregister_reboot_notifier(&wdt_notifier
);
576 release_region(io
, 8);
582 * Set up the WDT watchdog board. All we have to do is grab the
583 * resources we require and bitch if anyone beat us to them.
584 * The open() function will actually kick the board off.
587 static int __init
wdt_init(void)
591 if (type
!= 500 && type
!= 501) {
592 pr_err("unknown card type '%d'\n", type
);
596 /* Check that the heartbeat value is within it's range;
597 if not reset to the default */
598 if (wdt_set_heartbeat(heartbeat
)) {
599 wdt_set_heartbeat(WD_TIMO
);
600 pr_info("heartbeat value must be 0 < heartbeat < 65536, using %d\n",
604 if (!request_region(io
, 8, "wdt501p")) {
605 pr_err("I/O address 0x%04x already in use\n", io
);
610 ret
= request_irq(irq
, wdt_interrupt
, 0, "wdt501p", NULL
);
612 pr_err("IRQ %d is not free\n", irq
);
616 ret
= register_reboot_notifier(&wdt_notifier
);
618 pr_err("cannot register reboot notifier (err=%d)\n", ret
);
623 ret
= misc_register(&temp_miscdev
);
625 pr_err("cannot register miscdev on minor=%d (err=%d)\n",
631 ret
= misc_register(&wdt_miscdev
);
633 pr_err("cannot register miscdev on minor=%d (err=%d)\n",
634 WATCHDOG_MINOR
, ret
);
638 pr_info("WDT500/501-P driver 0.10 at 0x%04x (Interrupt %d). heartbeat=%d sec (nowayout=%d)\n",
639 io
, irq
, heartbeat
, nowayout
);
641 pr_info("Fan Tachometer is %s\n",
642 tachometer
? "Enabled" : "Disabled");
647 misc_deregister(&temp_miscdev
);
649 unregister_reboot_notifier(&wdt_notifier
);
653 release_region(io
, 8);
658 module_init(wdt_init
);
659 module_exit(wdt_exit
);
661 MODULE_AUTHOR("Alan Cox");
662 MODULE_DESCRIPTION("Driver for ISA ICS watchdog cards (WDT500/501)");
663 MODULE_LICENSE("GPL");