2 * FIXME: add wdrtas_get_status and wdrtas_get_boot_status as soon as
3 * RTAS calls are available
9 * (C) Copyright IBM Corp. 2005
10 * device driver to exploit watchdog RTAS functions
12 * Authors : Utz Bacher <utz.bacher@de.ibm.com>
14 * This program is free software; you can redistribute it and/or modify
15 * it under the terms of the GNU General Public License as published by
16 * the Free Software Foundation; either version 2, or (at your option)
19 * This program is distributed in the hope that it will be useful,
20 * but WITHOUT ANY WARRANTY; without even the implied warranty of
21 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
22 * GNU General Public License for more details.
24 * You should have received a copy of the GNU General Public License
25 * along with this program; if not, write to the Free Software
26 * Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
30 #include <linux/init.h>
31 #include <linux/kernel.h>
32 #include <linux/miscdevice.h>
33 #include <linux/module.h>
34 #include <linux/notifier.h>
35 #include <linux/reboot.h>
36 #include <linux/types.h>
37 #include <linux/watchdog.h>
38 #include <linux/uaccess.h>
42 #define WDRTAS_MAGIC_CHAR 42
43 #define WDRTAS_SUPPORTED_MASK (WDIOF_SETTIMEOUT | \
46 MODULE_AUTHOR("Utz Bacher <utz.bacher@de.ibm.com>");
47 MODULE_DESCRIPTION("RTAS watchdog driver");
48 MODULE_LICENSE("GPL");
49 MODULE_ALIAS_MISCDEV(WATCHDOG_MINOR
);
50 MODULE_ALIAS_MISCDEV(TEMP_MINOR
);
52 #ifdef CONFIG_WATCHDOG_NOWAYOUT
53 static int wdrtas_nowayout
= 1;
55 static int wdrtas_nowayout
= 0;
58 static atomic_t wdrtas_miscdev_open
= ATOMIC_INIT(0);
59 static char wdrtas_expect_close
;
61 static int wdrtas_interval
;
63 #define WDRTAS_THERMAL_SENSOR 3
64 static int wdrtas_token_get_sensor_state
;
65 #define WDRTAS_SURVEILLANCE_IND 9000
66 static int wdrtas_token_set_indicator
;
67 #define WDRTAS_SP_SPI 28
68 static int wdrtas_token_get_sp
;
69 static int wdrtas_token_event_scan
;
71 #define WDRTAS_DEFAULT_INTERVAL 300
73 #define WDRTAS_LOGBUFFER_LEN 128
74 static char wdrtas_logbuffer
[WDRTAS_LOGBUFFER_LEN
];
77 /*** watchdog access functions */
80 * wdrtas_set_interval - sets the watchdog interval
81 * @interval: new interval
83 * returns 0 on success, <0 on failures
85 * wdrtas_set_interval sets the watchdog keepalive interval by calling the
86 * RTAS function set-indicator (surveillance). The unit of interval is
90 static int wdrtas_set_interval(int interval
)
93 static int print_msg
= 10;
95 /* rtas uses minutes */
96 interval
= (interval
+ 59) / 60;
98 result
= rtas_call(wdrtas_token_set_indicator
, 3, 1, NULL
,
99 WDRTAS_SURVEILLANCE_IND
, 0, interval
);
100 if (result
< 0 && print_msg
) {
101 printk(KERN_ERR
"wdrtas: setting the watchdog to %i "
102 "timeout failed: %li\n", interval
, result
);
110 * wdrtas_get_interval - returns the current watchdog interval
111 * @fallback_value: value (in seconds) to use, if the RTAS call fails
113 * returns the interval
115 * wdrtas_get_interval returns the current watchdog keepalive interval
116 * as reported by the RTAS function ibm,get-system-parameter. The unit
117 * of the return value is seconds.
119 static int wdrtas_get_interval(int fallback_value
)
124 result
= rtas_call(wdrtas_token_get_sp
, 3, 1, NULL
,
125 WDRTAS_SP_SPI
, (void *)__pa(&value
), 4);
126 if (value
[0] != 0 || value
[1] != 2 || value
[3] != 0 || result
< 0) {
127 printk(KERN_WARNING
"wdrtas: could not get sp_spi watchdog "
128 "timeout (%li). Continuing\n", result
);
129 return fallback_value
;
132 /* rtas uses minutes */
133 return ((int)value
[2]) * 60;
137 * wdrtas_timer_start - starts watchdog
139 * wdrtas_timer_start starts the watchdog by calling the RTAS function
140 * set-interval (surveillance)
142 static void wdrtas_timer_start(void)
144 wdrtas_set_interval(wdrtas_interval
);
148 * wdrtas_timer_stop - stops watchdog
150 * wdrtas_timer_stop stops the watchdog timer by calling the RTAS function
151 * set-interval (surveillance)
153 static void wdrtas_timer_stop(void)
155 wdrtas_set_interval(0);
159 * wdrtas_log_scanned_event - logs an event we received during keepalive
161 * wdrtas_log_scanned_event prints a message to the log buffer dumping
162 * the results of the last event-scan call
164 static void wdrtas_log_scanned_event(void)
168 for (i
= 0; i
< WDRTAS_LOGBUFFER_LEN
; i
+= 16)
169 printk(KERN_INFO
"wdrtas: dumping event (line %i/%i), data = "
170 "%02x %02x %02x %02x %02x %02x %02x %02x "
171 "%02x %02x %02x %02x %02x %02x %02x %02x\n",
172 (i
/ 16) + 1, (WDRTAS_LOGBUFFER_LEN
/ 16),
173 wdrtas_logbuffer
[i
+ 0], wdrtas_logbuffer
[i
+ 1],
174 wdrtas_logbuffer
[i
+ 2], wdrtas_logbuffer
[i
+ 3],
175 wdrtas_logbuffer
[i
+ 4], wdrtas_logbuffer
[i
+ 5],
176 wdrtas_logbuffer
[i
+ 6], wdrtas_logbuffer
[i
+ 7],
177 wdrtas_logbuffer
[i
+ 8], wdrtas_logbuffer
[i
+ 9],
178 wdrtas_logbuffer
[i
+ 10], wdrtas_logbuffer
[i
+ 11],
179 wdrtas_logbuffer
[i
+ 12], wdrtas_logbuffer
[i
+ 13],
180 wdrtas_logbuffer
[i
+ 14], wdrtas_logbuffer
[i
+ 15]);
184 * wdrtas_timer_keepalive - resets watchdog timer to keep system alive
186 * wdrtas_timer_keepalive restarts the watchdog timer by calling the
187 * RTAS function event-scan and repeats these calls as long as there are
188 * events available. All events will be dumped.
190 static void wdrtas_timer_keepalive(void)
195 result
= rtas_call(wdrtas_token_event_scan
, 4, 1, NULL
,
196 RTAS_EVENT_SCAN_ALL_EVENTS
, 0,
197 (void *)__pa(wdrtas_logbuffer
),
198 WDRTAS_LOGBUFFER_LEN
);
200 printk(KERN_ERR
"wdrtas: event-scan failed: %li\n",
203 wdrtas_log_scanned_event();
204 } while (result
== 0);
208 * wdrtas_get_temperature - returns current temperature
210 * returns temperature or <0 on failures
212 * wdrtas_get_temperature returns the current temperature in Fahrenheit. It
213 * uses the RTAS call get-sensor-state, token 3 to do so
215 static int wdrtas_get_temperature(void)
220 result
= rtas_call(wdrtas_token_get_sensor_state
, 2, 2,
221 (void *)__pa(&temperature
),
222 WDRTAS_THERMAL_SENSOR
, 0);
225 printk(KERN_WARNING
"wdrtas: reading the thermal sensor "
226 "faild: %li\n", result
);
228 temperature
= ((temperature
* 9) / 5) + 32; /* fahrenheit */
234 * wdrtas_get_status - returns the status of the watchdog
236 * returns a bitmask of defines WDIOF_... as defined in
237 * include/linux/watchdog.h
239 static int wdrtas_get_status(void)
245 * wdrtas_get_boot_status - returns the reason for the last boot
247 * returns a bitmask of defines WDIOF_... as defined in
248 * include/linux/watchdog.h, indicating why the watchdog rebooted the system
250 static int wdrtas_get_boot_status(void)
255 /*** watchdog API and operations stuff */
257 /* wdrtas_write - called when watchdog device is written to
258 * @file: file structure
259 * @buf: user buffer with data
260 * @len: amount to data written
261 * @ppos: position in file
263 * returns the number of successfully processed characters, which is always
264 * the number of bytes passed to this function
266 * wdrtas_write processes all the data given to it and looks for the magic
267 * character 'V'. This character allows the watchdog device to be closed
270 static ssize_t
wdrtas_write(struct file
*file
, const char __user
*buf
,
271 size_t len
, loff_t
*ppos
)
279 if (!wdrtas_nowayout
) {
280 wdrtas_expect_close
= 0;
282 for (i
= 0; i
< len
; i
++) {
283 if (get_user(c
, buf
+ i
))
285 /* allow to close device */
287 wdrtas_expect_close
= WDRTAS_MAGIC_CHAR
;
291 wdrtas_timer_keepalive();
298 * wdrtas_ioctl - ioctl function for the watchdog device
299 * @file: file structure
300 * @cmd: command for ioctl
301 * @arg: argument pointer
303 * returns 0 on success, <0 on failure
305 * wdrtas_ioctl implements the watchdog API ioctls
308 static long wdrtas_ioctl(struct file
*file
, unsigned int cmd
,
311 int __user
*argp
= (void __user
*)arg
;
313 static struct watchdog_info wdinfo
= {
314 .options
= WDRTAS_SUPPORTED_MASK
,
315 .firmware_version
= 0,
316 .identity
= "wdrtas",
320 case WDIOC_GETSUPPORT
:
321 if (copy_to_user(argp
, &wdinfo
, sizeof(wdinfo
)))
325 case WDIOC_GETSTATUS
:
326 i
= wdrtas_get_status();
327 return put_user(i
, argp
);
329 case WDIOC_GETBOOTSTATUS
:
330 i
= wdrtas_get_boot_status();
331 return put_user(i
, argp
);
334 if (wdrtas_token_get_sensor_state
== RTAS_UNKNOWN_SERVICE
)
337 i
= wdrtas_get_temperature();
338 return put_user(i
, argp
);
340 case WDIOC_SETOPTIONS
:
341 if (get_user(i
, argp
))
343 if (i
& WDIOS_DISABLECARD
)
345 if (i
& WDIOS_ENABLECARD
) {
346 wdrtas_timer_keepalive();
347 wdrtas_timer_start();
349 /* not implemented. Done by H8
350 if (i & WDIOS_TEMPPANIC) {
354 case WDIOC_KEEPALIVE
:
355 wdrtas_timer_keepalive();
358 case WDIOC_SETTIMEOUT
:
359 if (get_user(i
, argp
))
362 if (wdrtas_set_interval(i
))
365 wdrtas_timer_keepalive();
367 if (wdrtas_token_get_sp
== RTAS_UNKNOWN_SERVICE
)
370 wdrtas_interval
= wdrtas_get_interval(i
);
373 case WDIOC_GETTIMEOUT
:
374 return put_user(wdrtas_interval
, argp
);
382 * wdrtas_open - open function of watchdog device
383 * @inode: inode structure
384 * @file: file structure
386 * returns 0 on success, -EBUSY if the file has been opened already, <0 on
389 * function called when watchdog device is opened
391 static int wdrtas_open(struct inode
*inode
, struct file
*file
)
394 if (atomic_inc_return(&wdrtas_miscdev_open
) > 1) {
395 atomic_dec(&wdrtas_miscdev_open
);
399 wdrtas_timer_start();
400 wdrtas_timer_keepalive();
402 return nonseekable_open(inode
, file
);
406 * wdrtas_close - close function of watchdog device
407 * @inode: inode structure
408 * @file: file structure
410 * returns 0 on success
412 * close function. Always succeeds
414 static int wdrtas_close(struct inode
*inode
, struct file
*file
)
416 /* only stop watchdog, if this was announced using 'V' before */
417 if (wdrtas_expect_close
== WDRTAS_MAGIC_CHAR
)
420 printk(KERN_WARNING
"wdrtas: got unexpected close. Watchdog "
422 wdrtas_timer_keepalive();
425 wdrtas_expect_close
= 0;
426 atomic_dec(&wdrtas_miscdev_open
);
431 * wdrtas_temp_read - gives back the temperature in fahrenheit
432 * @file: file structure
434 * @count: number of bytes to be read
435 * @ppos: position in file
437 * returns always 1 or -EFAULT in case of user space copy failures, <0 on
440 * wdrtas_temp_read gives the temperature to the users by copying this
441 * value as one byte into the user space buffer. The unit is Fahrenheit...
443 static ssize_t
wdrtas_temp_read(struct file
*file
, char __user
*buf
,
444 size_t count
, loff_t
*ppos
)
448 temperature
= wdrtas_get_temperature();
452 if (copy_to_user(buf
, &temperature
, 1))
459 * wdrtas_temp_open - open function of temperature device
460 * @inode: inode structure
461 * @file: file structure
463 * returns 0 on success, <0 on failure
465 * function called when temperature device is opened
467 static int wdrtas_temp_open(struct inode
*inode
, struct file
*file
)
469 return nonseekable_open(inode
, file
);
473 * wdrtas_temp_close - close function of temperature device
474 * @inode: inode structure
475 * @file: file structure
477 * returns 0 on success
479 * close function. Always succeeds
481 static int wdrtas_temp_close(struct inode
*inode
, struct file
*file
)
487 * wdrtas_reboot - reboot notifier function
488 * @nb: notifier block structure
492 * returns NOTIFY_DONE
494 * wdrtas_reboot stops the watchdog in case of a reboot
496 static int wdrtas_reboot(struct notifier_block
*this,
497 unsigned long code
, void *ptr
)
499 if (code
== SYS_DOWN
|| code
== SYS_HALT
)
505 /*** initialization stuff */
507 static const struct file_operations wdrtas_fops
= {
508 .owner
= THIS_MODULE
,
510 .write
= wdrtas_write
,
511 .unlocked_ioctl
= wdrtas_ioctl
,
513 .release
= wdrtas_close
,
516 static struct miscdevice wdrtas_miscdev
= {
517 .minor
= WATCHDOG_MINOR
,
519 .fops
= &wdrtas_fops
,
522 static const struct file_operations wdrtas_temp_fops
= {
523 .owner
= THIS_MODULE
,
525 .read
= wdrtas_temp_read
,
526 .open
= wdrtas_temp_open
,
527 .release
= wdrtas_temp_close
,
530 static struct miscdevice wdrtas_tempdev
= {
532 .name
= "temperature",
533 .fops
= &wdrtas_temp_fops
,
536 static struct notifier_block wdrtas_notifier
= {
537 .notifier_call
= wdrtas_reboot
,
541 * wdrtas_get_tokens - reads in RTAS tokens
543 * returns 0 on succes, <0 on failure
545 * wdrtas_get_tokens reads in the tokens for the RTAS calls used in
546 * this watchdog driver. It tolerates, if "get-sensor-state" and
547 * "ibm,get-system-parameter" are not available.
549 static int wdrtas_get_tokens(void)
551 wdrtas_token_get_sensor_state
= rtas_token("get-sensor-state");
552 if (wdrtas_token_get_sensor_state
== RTAS_UNKNOWN_SERVICE
) {
553 printk(KERN_WARNING
"wdrtas: couldn't get token for "
554 "get-sensor-state. Trying to continue without "
555 "temperature support.\n");
558 wdrtas_token_get_sp
= rtas_token("ibm,get-system-parameter");
559 if (wdrtas_token_get_sp
== RTAS_UNKNOWN_SERVICE
) {
560 printk(KERN_WARNING
"wdrtas: couldn't get token for "
561 "ibm,get-system-parameter. Trying to continue with "
562 "a default timeout value of %i seconds.\n",
563 WDRTAS_DEFAULT_INTERVAL
);
566 wdrtas_token_set_indicator
= rtas_token("set-indicator");
567 if (wdrtas_token_set_indicator
== RTAS_UNKNOWN_SERVICE
) {
568 printk(KERN_ERR
"wdrtas: couldn't get token for "
569 "set-indicator. Terminating watchdog code.\n");
573 wdrtas_token_event_scan
= rtas_token("event-scan");
574 if (wdrtas_token_event_scan
== RTAS_UNKNOWN_SERVICE
) {
575 printk(KERN_ERR
"wdrtas: couldn't get token for event-scan. "
576 "Terminating watchdog code.\n");
584 * wdrtas_unregister_devs - unregisters the misc dev handlers
586 * wdrtas_register_devs unregisters the watchdog and temperature watchdog
589 static void wdrtas_unregister_devs(void)
591 misc_deregister(&wdrtas_miscdev
);
592 if (wdrtas_token_get_sensor_state
!= RTAS_UNKNOWN_SERVICE
)
593 misc_deregister(&wdrtas_tempdev
);
597 * wdrtas_register_devs - registers the misc dev handlers
599 * returns 0 on succes, <0 on failure
601 * wdrtas_register_devs registers the watchdog and temperature watchdog
604 static int wdrtas_register_devs(void)
608 result
= misc_register(&wdrtas_miscdev
);
610 printk(KERN_ERR
"wdrtas: couldn't register watchdog misc "
611 "device. Terminating watchdog code.\n");
615 if (wdrtas_token_get_sensor_state
!= RTAS_UNKNOWN_SERVICE
) {
616 result
= misc_register(&wdrtas_tempdev
);
618 printk(KERN_WARNING
"wdrtas: couldn't register "
619 "watchdog temperature misc device. Continuing "
620 "without temperature support.\n");
621 wdrtas_token_get_sensor_state
= RTAS_UNKNOWN_SERVICE
;
629 * wdrtas_init - init function of the watchdog driver
631 * returns 0 on succes, <0 on failure
633 * registers the file handlers and the reboot notifier
635 static int __init
wdrtas_init(void)
637 if (wdrtas_get_tokens())
640 if (wdrtas_register_devs())
643 if (register_reboot_notifier(&wdrtas_notifier
)) {
644 printk(KERN_ERR
"wdrtas: could not register reboot notifier. "
645 "Terminating watchdog code.\n");
646 wdrtas_unregister_devs();
650 if (wdrtas_token_get_sp
== RTAS_UNKNOWN_SERVICE
)
651 wdrtas_interval
= WDRTAS_DEFAULT_INTERVAL
;
653 wdrtas_interval
= wdrtas_get_interval(WDRTAS_DEFAULT_INTERVAL
);
659 * wdrtas_exit - exit function of the watchdog driver
661 * unregisters the file handlers and the reboot notifier
663 static void __exit
wdrtas_exit(void)
665 if (!wdrtas_nowayout
)
668 wdrtas_unregister_devs();
670 unregister_reboot_notifier(&wdrtas_notifier
);
673 module_init(wdrtas_init
);
674 module_exit(wdrtas_exit
);