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.
29 #define pr_fmt(fmt) KBUILD_MODNAME ": " fmt
32 #include <linux/init.h>
33 #include <linux/kernel.h>
34 #include <linux/miscdevice.h>
35 #include <linux/module.h>
36 #include <linux/notifier.h>
37 #include <linux/reboot.h>
38 #include <linux/types.h>
39 #include <linux/watchdog.h>
40 #include <linux/uaccess.h>
44 #define WDRTAS_MAGIC_CHAR 42
45 #define WDRTAS_SUPPORTED_MASK (WDIOF_SETTIMEOUT | \
48 MODULE_AUTHOR("Utz Bacher <utz.bacher@de.ibm.com>");
49 MODULE_DESCRIPTION("RTAS watchdog driver");
50 MODULE_LICENSE("GPL");
52 static bool wdrtas_nowayout
= WATCHDOG_NOWAYOUT
;
53 static atomic_t wdrtas_miscdev_open
= ATOMIC_INIT(0);
54 static char wdrtas_expect_close
;
56 static int wdrtas_interval
;
58 #define WDRTAS_THERMAL_SENSOR 3
59 static int wdrtas_token_get_sensor_state
;
60 #define WDRTAS_SURVEILLANCE_IND 9000
61 static int wdrtas_token_set_indicator
;
62 #define WDRTAS_SP_SPI 28
63 static int wdrtas_token_get_sp
;
64 static int wdrtas_token_event_scan
;
66 #define WDRTAS_DEFAULT_INTERVAL 300
68 #define WDRTAS_LOGBUFFER_LEN 128
69 static char wdrtas_logbuffer
[WDRTAS_LOGBUFFER_LEN
];
72 /*** watchdog access functions */
75 * wdrtas_set_interval - sets the watchdog interval
76 * @interval: new interval
78 * returns 0 on success, <0 on failures
80 * wdrtas_set_interval sets the watchdog keepalive interval by calling the
81 * RTAS function set-indicator (surveillance). The unit of interval is
85 static int wdrtas_set_interval(int interval
)
88 static int print_msg
= 10;
90 /* rtas uses minutes */
91 interval
= (interval
+ 59) / 60;
93 result
= rtas_call(wdrtas_token_set_indicator
, 3, 1, NULL
,
94 WDRTAS_SURVEILLANCE_IND
, 0, interval
);
95 if (result
< 0 && print_msg
) {
96 pr_err("setting the watchdog to %i timeout failed: %li\n",
104 #define WDRTAS_SP_SPI_LEN 4
107 * wdrtas_get_interval - returns the current watchdog interval
108 * @fallback_value: value (in seconds) to use, if the RTAS call fails
110 * returns the interval
112 * wdrtas_get_interval returns the current watchdog keepalive interval
113 * as reported by the RTAS function ibm,get-system-parameter. The unit
114 * of the return value is seconds.
116 static int wdrtas_get_interval(int fallback_value
)
119 char value
[WDRTAS_SP_SPI_LEN
];
121 spin_lock(&rtas_data_buf_lock
);
122 memset(rtas_data_buf
, 0, WDRTAS_SP_SPI_LEN
);
123 result
= rtas_call(wdrtas_token_get_sp
, 3, 1, NULL
,
124 WDRTAS_SP_SPI
, __pa(rtas_data_buf
),
127 memcpy(value
, rtas_data_buf
, WDRTAS_SP_SPI_LEN
);
128 spin_unlock(&rtas_data_buf_lock
);
130 if (value
[0] != 0 || value
[1] != 2 || value
[3] != 0 || result
< 0) {
131 pr_warn("could not get sp_spi watchdog timeout (%li). Continuing\n",
133 return fallback_value
;
136 /* rtas uses minutes */
137 return ((int)value
[2]) * 60;
141 * wdrtas_timer_start - starts watchdog
143 * wdrtas_timer_start starts the watchdog by calling the RTAS function
144 * set-interval (surveillance)
146 static void wdrtas_timer_start(void)
148 wdrtas_set_interval(wdrtas_interval
);
152 * wdrtas_timer_stop - stops watchdog
154 * wdrtas_timer_stop stops the watchdog timer by calling the RTAS function
155 * set-interval (surveillance)
157 static void wdrtas_timer_stop(void)
159 wdrtas_set_interval(0);
163 * wdrtas_timer_keepalive - resets watchdog timer to keep system alive
165 * wdrtas_timer_keepalive restarts the watchdog timer by calling the
166 * RTAS function event-scan and repeats these calls as long as there are
167 * events available. All events will be dumped.
169 static void wdrtas_timer_keepalive(void)
174 result
= rtas_call(wdrtas_token_event_scan
, 4, 1, NULL
,
175 RTAS_EVENT_SCAN_ALL_EVENTS
, 0,
176 (void *)__pa(wdrtas_logbuffer
),
177 WDRTAS_LOGBUFFER_LEN
);
179 pr_err("event-scan failed: %li\n", result
);
181 print_hex_dump(KERN_INFO
, "dumping event, data: ",
182 DUMP_PREFIX_OFFSET
, 16, 1,
183 wdrtas_logbuffer
, WDRTAS_LOGBUFFER_LEN
, false);
184 } while (result
== 0);
188 * wdrtas_get_temperature - returns current temperature
190 * returns temperature or <0 on failures
192 * wdrtas_get_temperature returns the current temperature in Fahrenheit. It
193 * uses the RTAS call get-sensor-state, token 3 to do so
195 static int wdrtas_get_temperature(void)
200 result
= rtas_get_sensor(WDRTAS_THERMAL_SENSOR
, 0, &temperature
);
203 pr_warn("reading the thermal sensor failed: %i\n", result
);
205 temperature
= ((temperature
* 9) / 5) + 32; /* fahrenheit */
211 * wdrtas_get_status - returns the status of the watchdog
213 * returns a bitmask of defines WDIOF_... as defined in
214 * include/linux/watchdog.h
216 static int wdrtas_get_status(void)
222 * wdrtas_get_boot_status - returns the reason for the last boot
224 * returns a bitmask of defines WDIOF_... as defined in
225 * include/linux/watchdog.h, indicating why the watchdog rebooted the system
227 static int wdrtas_get_boot_status(void)
232 /*** watchdog API and operations stuff */
234 /* wdrtas_write - called when watchdog device is written to
235 * @file: file structure
236 * @buf: user buffer with data
237 * @len: amount to data written
238 * @ppos: position in file
240 * returns the number of successfully processed characters, which is always
241 * the number of bytes passed to this function
243 * wdrtas_write processes all the data given to it and looks for the magic
244 * character 'V'. This character allows the watchdog device to be closed
247 static ssize_t
wdrtas_write(struct file
*file
, const char __user
*buf
,
248 size_t len
, loff_t
*ppos
)
256 if (!wdrtas_nowayout
) {
257 wdrtas_expect_close
= 0;
259 for (i
= 0; i
< len
; i
++) {
260 if (get_user(c
, buf
+ i
))
262 /* allow to close device */
264 wdrtas_expect_close
= WDRTAS_MAGIC_CHAR
;
268 wdrtas_timer_keepalive();
275 * wdrtas_ioctl - ioctl function for the watchdog device
276 * @file: file structure
277 * @cmd: command for ioctl
278 * @arg: argument pointer
280 * returns 0 on success, <0 on failure
282 * wdrtas_ioctl implements the watchdog API ioctls
285 static long wdrtas_ioctl(struct file
*file
, unsigned int cmd
,
288 int __user
*argp
= (void __user
*)arg
;
290 static const struct watchdog_info wdinfo
= {
291 .options
= WDRTAS_SUPPORTED_MASK
,
292 .firmware_version
= 0,
293 .identity
= "wdrtas",
297 case WDIOC_GETSUPPORT
:
298 if (copy_to_user(argp
, &wdinfo
, sizeof(wdinfo
)))
302 case WDIOC_GETSTATUS
:
303 i
= wdrtas_get_status();
304 return put_user(i
, argp
);
306 case WDIOC_GETBOOTSTATUS
:
307 i
= wdrtas_get_boot_status();
308 return put_user(i
, argp
);
311 if (wdrtas_token_get_sensor_state
== RTAS_UNKNOWN_SERVICE
)
314 i
= wdrtas_get_temperature();
315 return put_user(i
, argp
);
317 case WDIOC_SETOPTIONS
:
318 if (get_user(i
, argp
))
320 if (i
& WDIOS_DISABLECARD
)
322 if (i
& WDIOS_ENABLECARD
) {
323 wdrtas_timer_keepalive();
324 wdrtas_timer_start();
326 /* not implemented. Done by H8
327 if (i & WDIOS_TEMPPANIC) {
331 case WDIOC_KEEPALIVE
:
332 wdrtas_timer_keepalive();
335 case WDIOC_SETTIMEOUT
:
336 if (get_user(i
, argp
))
339 if (wdrtas_set_interval(i
))
342 wdrtas_timer_keepalive();
344 if (wdrtas_token_get_sp
== RTAS_UNKNOWN_SERVICE
)
347 wdrtas_interval
= wdrtas_get_interval(i
);
350 case WDIOC_GETTIMEOUT
:
351 return put_user(wdrtas_interval
, argp
);
359 * wdrtas_open - open function of watchdog device
360 * @inode: inode structure
361 * @file: file structure
363 * returns 0 on success, -EBUSY if the file has been opened already, <0 on
366 * function called when watchdog device is opened
368 static int wdrtas_open(struct inode
*inode
, struct file
*file
)
371 if (atomic_inc_return(&wdrtas_miscdev_open
) > 1) {
372 atomic_dec(&wdrtas_miscdev_open
);
376 wdrtas_timer_start();
377 wdrtas_timer_keepalive();
379 return nonseekable_open(inode
, file
);
383 * wdrtas_close - close function of watchdog device
384 * @inode: inode structure
385 * @file: file structure
387 * returns 0 on success
389 * close function. Always succeeds
391 static int wdrtas_close(struct inode
*inode
, struct file
*file
)
393 /* only stop watchdog, if this was announced using 'V' before */
394 if (wdrtas_expect_close
== WDRTAS_MAGIC_CHAR
)
397 pr_warn("got unexpected close. Watchdog not stopped.\n");
398 wdrtas_timer_keepalive();
401 wdrtas_expect_close
= 0;
402 atomic_dec(&wdrtas_miscdev_open
);
407 * wdrtas_temp_read - gives back the temperature in fahrenheit
408 * @file: file structure
410 * @count: number of bytes to be read
411 * @ppos: position in file
413 * returns always 1 or -EFAULT in case of user space copy failures, <0 on
416 * wdrtas_temp_read gives the temperature to the users by copying this
417 * value as one byte into the user space buffer. The unit is Fahrenheit...
419 static ssize_t
wdrtas_temp_read(struct file
*file
, char __user
*buf
,
420 size_t count
, loff_t
*ppos
)
424 temperature
= wdrtas_get_temperature();
428 if (copy_to_user(buf
, &temperature
, 1))
435 * wdrtas_temp_open - open function of temperature device
436 * @inode: inode structure
437 * @file: file structure
439 * returns 0 on success, <0 on failure
441 * function called when temperature device is opened
443 static int wdrtas_temp_open(struct inode
*inode
, struct file
*file
)
445 return nonseekable_open(inode
, file
);
449 * wdrtas_temp_close - close function of temperature device
450 * @inode: inode structure
451 * @file: file structure
453 * returns 0 on success
455 * close function. Always succeeds
457 static int wdrtas_temp_close(struct inode
*inode
, struct file
*file
)
463 * wdrtas_reboot - reboot notifier function
464 * @nb: notifier block structure
468 * returns NOTIFY_DONE
470 * wdrtas_reboot stops the watchdog in case of a reboot
472 static int wdrtas_reboot(struct notifier_block
*this,
473 unsigned long code
, void *ptr
)
475 if (code
== SYS_DOWN
|| code
== SYS_HALT
)
481 /*** initialization stuff */
483 static const struct file_operations wdrtas_fops
= {
484 .owner
= THIS_MODULE
,
486 .write
= wdrtas_write
,
487 .unlocked_ioctl
= wdrtas_ioctl
,
489 .release
= wdrtas_close
,
492 static struct miscdevice wdrtas_miscdev
= {
493 .minor
= WATCHDOG_MINOR
,
495 .fops
= &wdrtas_fops
,
498 static const struct file_operations wdrtas_temp_fops
= {
499 .owner
= THIS_MODULE
,
501 .read
= wdrtas_temp_read
,
502 .open
= wdrtas_temp_open
,
503 .release
= wdrtas_temp_close
,
506 static struct miscdevice wdrtas_tempdev
= {
508 .name
= "temperature",
509 .fops
= &wdrtas_temp_fops
,
512 static struct notifier_block wdrtas_notifier
= {
513 .notifier_call
= wdrtas_reboot
,
517 * wdrtas_get_tokens - reads in RTAS tokens
519 * returns 0 on success, <0 on failure
521 * wdrtas_get_tokens reads in the tokens for the RTAS calls used in
522 * this watchdog driver. It tolerates, if "get-sensor-state" and
523 * "ibm,get-system-parameter" are not available.
525 static int wdrtas_get_tokens(void)
527 wdrtas_token_get_sensor_state
= rtas_token("get-sensor-state");
528 if (wdrtas_token_get_sensor_state
== RTAS_UNKNOWN_SERVICE
) {
529 pr_warn("couldn't get token for get-sensor-state. Trying to continue without temperature support.\n");
532 wdrtas_token_get_sp
= rtas_token("ibm,get-system-parameter");
533 if (wdrtas_token_get_sp
== RTAS_UNKNOWN_SERVICE
) {
534 pr_warn("couldn't get token for ibm,get-system-parameter. Trying to continue with a default timeout value of %i seconds.\n",
535 WDRTAS_DEFAULT_INTERVAL
);
538 wdrtas_token_set_indicator
= rtas_token("set-indicator");
539 if (wdrtas_token_set_indicator
== RTAS_UNKNOWN_SERVICE
) {
540 pr_err("couldn't get token for set-indicator. Terminating watchdog code.\n");
544 wdrtas_token_event_scan
= rtas_token("event-scan");
545 if (wdrtas_token_event_scan
== RTAS_UNKNOWN_SERVICE
) {
546 pr_err("couldn't get token for event-scan. Terminating watchdog code.\n");
554 * wdrtas_unregister_devs - unregisters the misc dev handlers
556 * wdrtas_register_devs unregisters the watchdog and temperature watchdog
559 static void wdrtas_unregister_devs(void)
561 misc_deregister(&wdrtas_miscdev
);
562 if (wdrtas_token_get_sensor_state
!= RTAS_UNKNOWN_SERVICE
)
563 misc_deregister(&wdrtas_tempdev
);
567 * wdrtas_register_devs - registers the misc dev handlers
569 * returns 0 on success, <0 on failure
571 * wdrtas_register_devs registers the watchdog and temperature watchdog
574 static int wdrtas_register_devs(void)
578 result
= misc_register(&wdrtas_miscdev
);
580 pr_err("couldn't register watchdog misc device. Terminating watchdog code.\n");
584 if (wdrtas_token_get_sensor_state
!= RTAS_UNKNOWN_SERVICE
) {
585 result
= misc_register(&wdrtas_tempdev
);
587 pr_warn("couldn't register watchdog temperature misc device. Continuing without temperature support.\n");
588 wdrtas_token_get_sensor_state
= RTAS_UNKNOWN_SERVICE
;
596 * wdrtas_init - init function of the watchdog driver
598 * returns 0 on success, <0 on failure
600 * registers the file handlers and the reboot notifier
602 static int __init
wdrtas_init(void)
604 if (wdrtas_get_tokens())
607 if (wdrtas_register_devs())
610 if (register_reboot_notifier(&wdrtas_notifier
)) {
611 pr_err("could not register reboot notifier. Terminating watchdog code.\n");
612 wdrtas_unregister_devs();
616 if (wdrtas_token_get_sp
== RTAS_UNKNOWN_SERVICE
)
617 wdrtas_interval
= WDRTAS_DEFAULT_INTERVAL
;
619 wdrtas_interval
= wdrtas_get_interval(WDRTAS_DEFAULT_INTERVAL
);
625 * wdrtas_exit - exit function of the watchdog driver
627 * unregisters the file handlers and the reboot notifier
629 static void __exit
wdrtas_exit(void)
631 if (!wdrtas_nowayout
)
634 wdrtas_unregister_devs();
636 unregister_reboot_notifier(&wdrtas_notifier
);
639 module_init(wdrtas_init
);
640 module_exit(wdrtas_exit
);