2 * Intel_SCU 0.2: An Intel SCU IOH Based Watchdog Device
6 * Copyright (C) 2009-2010 Intel Corporation. All rights reserved.
8 * This program is free software; you can redistribute it and/or
9 * modify it under the terms of version 2 of the GNU General
10 * Public License as published by the Free Software Foundation.
12 * This program is distributed in the hope that it will be
13 * useful, but WITHOUT ANY WARRANTY; without even the implied
14 * warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
15 * PURPOSE. See the GNU General Public License for more details.
16 * You should have received a copy of the GNU General Public
17 * License along with this program; if not, write to the Free
18 * Software Foundation, Inc., 59 Temple Place - Suite 330,
19 * Boston, MA 02111-1307, USA.
20 * The full GNU General Public License is included in this
21 * distribution in the file called COPYING.
25 #include <linux/compiler.h>
26 #include <linux/module.h>
27 #include <linux/kernel.h>
28 #include <linux/moduleparam.h>
29 #include <linux/types.h>
30 #include <linux/miscdevice.h>
31 #include <linux/watchdog.h>
33 #include <linux/notifier.h>
34 #include <linux/reboot.h>
35 #include <linux/init.h>
36 #include <linux/jiffies.h>
37 #include <linux/uaccess.h>
38 #include <linux/slab.h>
40 #include <linux/interrupt.h>
41 #include <linux/delay.h>
42 #include <linux/sched.h>
43 #include <linux/signal.h>
44 #include <linux/sfi.h>
45 #include <linux/types.h>
47 #include <asm/atomic.h>
48 #include <asm/intel_scu_ipc.h>
49 #include <asm/apb_timer.h>
52 #include "intel_scu_watchdog.h"
54 /* Bounds number of times we will retry loading time count */
55 /* This retry is a work around for a silicon bug. */
58 #define IPC_SET_WATCHDOG_TIMER 0xF8
60 static int timer_margin
= DEFAULT_SOFT_TO_HARD_MARGIN
;
61 module_param(timer_margin
, int, 0);
62 MODULE_PARM_DESC(timer_margin
,
63 "Watchdog timer margin"
64 "Time between interrupt and resetting the system"
65 "The range is from 1 to 160"
66 "This is the time for all keep alives to arrive");
68 static int timer_set
= DEFAULT_TIME
;
69 module_param(timer_set
, int, 0);
70 MODULE_PARM_DESC(timer_set
,
71 "Default Watchdog timer setting"
73 "The range is from 1 to 170"
74 "This is the time for all keep alives to arrive");
76 /* After watchdog device is closed, check force_boot. If:
77 * force_boot == 0, then force boot on next watchdog interrupt after close,
78 * force_boot == 1, then force boot immediately when device is closed.
80 static int force_boot
;
81 module_param(force_boot
, int, 0);
82 MODULE_PARM_DESC(force_boot
,
83 "A value of 1 means that the driver will reboot"
84 "the system immediately if the /dev/watchdog device is closed"
85 "A value of 0 means that when /dev/watchdog device is closed"
86 "the watchdog timer will be refreshed for one more interval"
87 "of length: timer_set. At the end of this interval, the"
88 "watchdog timer will reset the system."
91 /* there is only one device in the system now; this can be made into
92 * an array in the future if we have more than one device */
94 static struct intel_scu_watchdog_dev watchdog_device
;
96 /* Forces restart, if force_reboot is set */
97 static void watchdog_fire(void)
100 printk(KERN_CRIT PFX
"Initiating system reboot.\n");
102 printk(KERN_CRIT PFX
"Reboot didn't ?????\n");
106 printk(KERN_CRIT PFX
"Immediate Reboot Disabled\n");
108 "System will reset when watchdog timer times out!\n");
112 static int check_timer_margin(int new_margin
)
114 if ((new_margin
< MIN_TIME_CYCLE
) ||
115 (new_margin
> MAX_TIME
- timer_set
)) {
116 pr_debug("Watchdog timer: value of new_margin %d is out of the range %d to %d\n",
117 new_margin
, MIN_TIME_CYCLE
, MAX_TIME
- timer_set
);
126 static int watchdog_set_ipc(int soft_threshold
, int threshold
)
129 u8 cbuf
[16] = { '\0' };
132 ipc_wbuf
= (u32
*)&cbuf
;
133 ipc_wbuf
[0] = soft_threshold
;
134 ipc_wbuf
[1] = threshold
;
136 ipc_ret
= intel_scu_ipc_command(
137 IPC_SET_WATCHDOG_TIMER
,
145 pr_err("Error setting SCU watchdog timer: %x\n", ipc_ret
);
151 * Intel_SCU operations
154 /* timer interrupt handler */
155 static irqreturn_t
watchdog_timer_interrupt(int irq
, void *dev_id
)
158 int_status
= ioread32(watchdog_device
.timer_interrupt_status_addr
);
160 pr_debug("Watchdog timer: irq, int_status: %x\n", int_status
);
165 /* has the timer been started? If not, then this is spurious */
166 if (watchdog_device
.timer_started
== 0) {
167 pr_debug("Watchdog timer: spurious interrupt received\n");
171 /* temporarily disable the timer */
172 iowrite32(0x00000002, watchdog_device
.timer_control_addr
);
174 /* set the timer to the threshold */
175 iowrite32(watchdog_device
.threshold
,
176 watchdog_device
.timer_load_count_addr
);
178 /* allow the timer to run */
179 iowrite32(0x00000003, watchdog_device
.timer_control_addr
);
184 static int intel_scu_keepalive(void)
187 /* read eoi register - clears interrupt */
188 ioread32(watchdog_device
.timer_clear_interrupt_addr
);
190 /* temporarily disable the timer */
191 iowrite32(0x00000002, watchdog_device
.timer_control_addr
);
193 /* set the timer to the soft_threshold */
194 iowrite32(watchdog_device
.soft_threshold
,
195 watchdog_device
.timer_load_count_addr
);
197 /* allow the timer to run */
198 iowrite32(0x00000003, watchdog_device
.timer_control_addr
);
203 static int intel_scu_stop(void)
205 iowrite32(0, watchdog_device
.timer_control_addr
);
209 static int intel_scu_set_heartbeat(u32 t
)
217 watchdog_device
.timer_set
= t
;
218 watchdog_device
.threshold
=
219 timer_margin
* watchdog_device
.timer_tbl_ptr
->freq_hz
;
220 watchdog_device
.soft_threshold
=
221 (watchdog_device
.timer_set
- timer_margin
)
222 * watchdog_device
.timer_tbl_ptr
->freq_hz
;
224 pr_debug("Watchdog timer: set_heartbeat: timer freq is %d\n",
225 watchdog_device
.timer_tbl_ptr
->freq_hz
);
226 pr_debug("Watchdog timer: set_heartbeat: timer_set is %x (hex)\n",
227 watchdog_device
.timer_set
);
228 pr_debug("Watchdog timer: set_hearbeat: timer_margin is %x (hex)\n",
230 pr_debug("Watchdog timer: set_heartbeat: threshold is %x (hex)\n",
231 watchdog_device
.threshold
);
232 pr_debug("Watchdog timer: set_heartbeat: soft_threshold is %x (hex)\n",
233 watchdog_device
.soft_threshold
);
235 /* Adjust thresholds by FREQ_ADJUSTMENT factor, to make the */
236 /* watchdog timing come out right. */
237 watchdog_device
.threshold
=
238 watchdog_device
.threshold
/ FREQ_ADJUSTMENT
;
239 watchdog_device
.soft_threshold
=
240 watchdog_device
.soft_threshold
/ FREQ_ADJUSTMENT
;
242 /* temporarily disable the timer */
243 iowrite32(0x00000002, watchdog_device
.timer_control_addr
);
245 /* send the threshold and soft_threshold via IPC to the processor */
246 ipc_ret
= watchdog_set_ipc(watchdog_device
.soft_threshold
,
247 watchdog_device
.threshold
);
250 /* Make sure the watchdog timer is stopped */
255 /* Soft Threshold set loop. Early versions of silicon did */
256 /* not always set this count correctly. This loop checks */
257 /* the value and retries if it was not set correctly. */
260 soft_value
= watchdog_device
.soft_threshold
& 0xFFFF0000;
263 /* Make sure timer is stopped */
266 if (MAX_RETRY
< retry_count
++) {
267 /* Unable to set timer value */
268 pr_err("Watchdog timer: Unable to set timer\n");
272 /* set the timer to the soft threshold */
273 iowrite32(watchdog_device
.soft_threshold
,
274 watchdog_device
.timer_load_count_addr
);
276 /* read count value before starting timer */
277 hw_pre_value
= ioread32(watchdog_device
.timer_load_count_addr
);
278 hw_pre_value
= hw_pre_value
& 0xFFFF0000;
280 /* Start the timer */
281 iowrite32(0x00000003, watchdog_device
.timer_control_addr
);
283 /* read the value the time loaded into its count reg */
284 hw_value
= ioread32(watchdog_device
.timer_load_count_addr
);
285 hw_value
= hw_value
& 0xFFFF0000;
288 } while (soft_value
!= hw_value
);
290 watchdog_device
.timer_started
= 1;
296 * /dev/watchdog handling
299 static int intel_scu_open(struct inode
*inode
, struct file
*file
)
302 /* Set flag to indicate that watchdog device is open */
303 if (test_and_set_bit(0, &watchdog_device
.driver_open
))
306 /* Check for reopen of driver. Reopens are not allowed */
307 if (watchdog_device
.driver_closed
)
310 return nonseekable_open(inode
, file
);
313 static int intel_scu_release(struct inode
*inode
, struct file
*file
)
316 * This watchdog should not be closed, after the timer
317 * is started with the WDIPC_SETTIMEOUT ioctl
318 * If force_boot is set watchdog_fire() will cause an
319 * immediate reset. If force_boot is not set, the watchdog
320 * timer is refreshed for one more interval. At the end
321 * of that interval, the watchdog timer will reset the system.
324 if (!test_and_clear_bit(0, &watchdog_device
.driver_open
)) {
325 pr_debug("Watchdog timer: intel_scu_release, without open\n");
329 if (!watchdog_device
.timer_started
) {
330 /* Just close, since timer has not been started */
331 pr_debug("Watchdog timer: closed, without starting timer\n");
336 "Unexpected close of /dev/watchdog!\n");
338 /* Since the timer was started, prevent future reopens */
339 watchdog_device
.driver_closed
= 1;
341 /* Refresh the timer for one more interval */
342 intel_scu_keepalive();
344 /* Reboot system (if force_boot is set) */
347 /* We should only reach this point if force_boot is not set */
351 static ssize_t
intel_scu_write(struct file
*file
,
357 if (watchdog_device
.timer_started
)
358 /* Watchdog already started, keep it alive */
359 intel_scu_keepalive();
361 /* Start watchdog with timer value set by init */
362 intel_scu_set_heartbeat(watchdog_device
.timer_set
);
367 static long intel_scu_ioctl(struct file
*file
,
371 void __user
*argp
= (void __user
*)arg
;
372 u32 __user
*p
= argp
;
376 static const struct watchdog_info ident
= {
377 .options
= WDIOF_SETTIMEOUT
378 | WDIOF_KEEPALIVEPING
,
379 .firmware_version
= 0, /* @todo Get from SCU via
380 ipc_get_scu_fw_version()? */
381 .identity
= "Intel_SCU IOH Watchdog" /* len < 32 */
385 case WDIOC_GETSUPPORT
:
386 return copy_to_user(argp
,
388 sizeof(ident
)) ? -EFAULT
: 0;
389 case WDIOC_GETSTATUS
:
390 case WDIOC_GETBOOTSTATUS
:
391 return put_user(0, p
);
392 case WDIOC_KEEPALIVE
:
393 intel_scu_keepalive();
396 case WDIOC_SETTIMEOUT
:
397 if (get_user(new_margin
, p
))
400 if (check_timer_margin(new_margin
))
403 if (intel_scu_set_heartbeat(new_margin
))
406 case WDIOC_GETTIMEOUT
:
407 return put_user(watchdog_device
.soft_threshold
, p
);
415 * Notifier for system down
417 static int intel_scu_notify_sys(struct notifier_block
*this,
419 void *another_unused
)
421 if (code
== SYS_DOWN
|| code
== SYS_HALT
)
422 /* Turn off the watchdog timer. */
430 static const struct file_operations intel_scu_fops
= {
431 .owner
= THIS_MODULE
,
433 .write
= intel_scu_write
,
434 .unlocked_ioctl
= intel_scu_ioctl
,
435 .open
= intel_scu_open
,
436 .release
= intel_scu_release
,
439 static int __init
intel_scu_watchdog_init(void)
442 u32 __iomem
*tmp_addr
;
445 * We don't really need to check this as the SFI timer get will fail
446 * but if we do so we can exit with a clearer reason and no noise.
448 * If it isn't an intel MID device then it doesn't have this watchdog
450 if (!mrst_identify_cpu())
453 /* Check boot parameters to verify that their initial values */
455 /* Check value of timer_set boot parameter */
456 if ((timer_set
< MIN_TIME_CYCLE
) ||
457 (timer_set
> MAX_TIME
- MIN_TIME_CYCLE
)) {
458 pr_err("Watchdog timer: value of timer_set %x (hex) "
459 "is out of range from %x to %x (hex)\n",
460 timer_set
, MIN_TIME_CYCLE
, MAX_TIME
- MIN_TIME_CYCLE
);
464 /* Check value of timer_margin boot parameter */
465 if (check_timer_margin(timer_margin
))
468 watchdog_device
.timer_tbl_ptr
= sfi_get_mtmr(sfi_mtimer_num
-1);
470 if (watchdog_device
.timer_tbl_ptr
== NULL
) {
471 pr_debug("Watchdog timer - Intel SCU watchdog: timer is not available\n");
474 /* make sure the timer exists */
475 if (watchdog_device
.timer_tbl_ptr
->phys_addr
== 0) {
476 pr_debug("Watchdog timer - Intel SCU watchdog - timer %d does not have valid physical memory\n",
481 if (watchdog_device
.timer_tbl_ptr
->irq
== 0) {
482 pr_debug("Watchdog timer: timer %d invalid irq\n",
487 tmp_addr
= ioremap_nocache(watchdog_device
.timer_tbl_ptr
->phys_addr
,
490 if (tmp_addr
== NULL
) {
491 pr_debug("Watchdog timer: timer unable to ioremap\n");
495 watchdog_device
.timer_load_count_addr
= tmp_addr
++;
496 watchdog_device
.timer_current_value_addr
= tmp_addr
++;
497 watchdog_device
.timer_control_addr
= tmp_addr
++;
498 watchdog_device
.timer_clear_interrupt_addr
= tmp_addr
++;
499 watchdog_device
.timer_interrupt_status_addr
= tmp_addr
++;
501 /* Set the default time values in device structure */
503 watchdog_device
.timer_set
= timer_set
;
504 watchdog_device
.threshold
=
505 timer_margin
* watchdog_device
.timer_tbl_ptr
->freq_hz
;
506 watchdog_device
.soft_threshold
=
507 (watchdog_device
.timer_set
- timer_margin
)
508 * watchdog_device
.timer_tbl_ptr
->freq_hz
;
511 watchdog_device
.intel_scu_notifier
.notifier_call
=
512 intel_scu_notify_sys
;
514 ret
= register_reboot_notifier(&watchdog_device
.intel_scu_notifier
);
516 pr_err("Watchdog timer: cannot register notifier %d)\n", ret
);
517 goto register_reboot_error
;
520 watchdog_device
.miscdev
.minor
= WATCHDOG_MINOR
;
521 watchdog_device
.miscdev
.name
= "watchdog";
522 watchdog_device
.miscdev
.fops
= &intel_scu_fops
;
524 ret
= misc_register(&watchdog_device
.miscdev
);
526 pr_err("Watchdog timer: cannot register miscdev %d err =%d\n",
527 WATCHDOG_MINOR
, ret
);
528 goto misc_register_error
;
531 ret
= request_irq((unsigned int)watchdog_device
.timer_tbl_ptr
->irq
,
532 watchdog_timer_interrupt
,
533 IRQF_SHARED
, "watchdog",
534 &watchdog_device
.timer_load_count_addr
);
536 pr_err("Watchdog timer: error requesting irq %d\n", ret
);
537 goto request_irq_error
;
539 /* Make sure timer is disabled before returning */
546 misc_deregister(&watchdog_device
.miscdev
);
548 unregister_reboot_notifier(&watchdog_device
.intel_scu_notifier
);
549 register_reboot_error
:
551 iounmap(watchdog_device
.timer_load_count_addr
);
555 static void __exit
intel_scu_watchdog_exit(void)
558 misc_deregister(&watchdog_device
.miscdev
);
559 unregister_reboot_notifier(&watchdog_device
.intel_scu_notifier
);
560 /* disable the timer */
561 iowrite32(0x00000002, watchdog_device
.timer_control_addr
);
562 iounmap(watchdog_device
.timer_load_count_addr
);
565 late_initcall(intel_scu_watchdog_init
);
566 module_exit(intel_scu_watchdog_exit
);
568 MODULE_AUTHOR("Intel Corporation");
569 MODULE_DESCRIPTION("Intel SCU Watchdog Device Driver");
570 MODULE_LICENSE("GPL");
571 MODULE_ALIAS_MISCDEV(WATCHDOG_MINOR
);
572 MODULE_VERSION(WDT_VER
);