1 // SPDX-License-Identifier: GPL-2.0+
3 * intel TCO vendor specific watchdog driver support
5 * (c) Copyright 2006-2009 Wim Van Sebroeck <wim@iguana.be>.
7 * Neither Wim Van Sebroeck nor Iguana vzw. admit liability nor
8 * provide warranty for any of this software. This material is
9 * provided "AS-IS" and at no charge.
13 * Includes, defines, variables, module parameters, ...
16 #define pr_fmt(fmt) KBUILD_MODNAME ": " fmt
18 /* Module and version information */
19 #define DRV_NAME "iTCO_vendor_support"
20 #define DRV_VERSION "1.04"
23 #include <linux/module.h> /* For module specific items */
24 #include <linux/moduleparam.h> /* For new moduleparam's */
25 #include <linux/types.h> /* For standard types (like size_t) */
26 #include <linux/errno.h> /* For the -ENODEV/... values */
27 #include <linux/kernel.h> /* For printk/panic/... */
28 #include <linux/init.h> /* For __init/__exit/... */
29 #include <linux/ioport.h> /* For io-port access */
30 #include <linux/io.h> /* For inb/outb/... */
32 #include "iTCO_vendor.h"
34 /* List of vendor support modes */
35 /* SuperMicro Pentium 3 Era 370SSE+-OEM1/P3TSSE */
36 #define SUPERMICRO_OLD_BOARD 1
37 /* SuperMicro Pentium 4 / Xeon 4 / EMT64T Era Systems - no longer supported */
38 #define SUPERMICRO_NEW_BOARD 2
40 #define BROKEN_BIOS 911
42 int iTCO_vendorsupport;
43 EXPORT_SYMBOL(iTCO_vendorsupport);
45 module_param_named(vendorsupport, iTCO_vendorsupport, int, 0);
46 MODULE_PARM_DESC(vendorsupport, "iTCO vendor specific support mode, default="
47 "0 (none), 1=SuperMicro Pent3, 911=Broken SMI BIOS");
50 * Vendor Specific Support
55 * Board: Super Micro Computer Inc. 370SSE+-OEM1/P3TSSE
58 * Code contributed by: R. Seretny <lkpatches@paypc.com>
59 * Documentation obtained by R. Seretny from SuperMicro Technical Support
61 * To enable Watchdog function:
62 * BIOS setup -> Power -> TCO Logic SMI Enable -> Within5Minutes
63 * This setting enables SMI to clear the watchdog expired flag.
64 * If BIOS or CPU fail which may cause SMI hang, then system will
65 * reboot. When application starts to use watchdog function,
66 * application has to take over the control from SMI.
68 * For P3TSSE, J36 jumper needs to be removed to enable the Watchdog
71 * Note: The system will reboot when Expire Flag is set TWICE.
72 * So, if the watchdog timer is 20 seconds, then the maximum hang
73 * time is about 40 seconds, and the minimum hang time is about
77 static void supermicro_old_pre_start(struct resource *smires)
81 /* Bit 13: TCO_EN -> 0 = Disables TCO logic generating an SMI# */
82 val32 = inl(smires->start);
83 val32 &= 0xffffdfff; /* Turn off SMI clearing watchdog */
84 outl(val32, smires->start); /* Needed to activate watchdog */
87 static void supermicro_old_pre_stop(struct resource *smires)
91 /* Bit 13: TCO_EN -> 1 = Enables the TCO logic to generate SMI# */
92 val32 = inl(smires->start);
93 val32 |= 0x00002000; /* Turn on SMI clearing watchdog */
94 outl(val32, smires->start); /* Needed to deactivate watchdog */
99 * Board: Some Intel ICHx based motherboards
100 * iTCO chipset: ICH7+
102 * Some Intel motherboards have a broken BIOS implementation: i.e.
103 * the SMI handler clear's the TIMEOUT bit in the TC01_STS register
104 * and does not reload the time. Thus the TCO watchdog does not reboot
107 * These are the conclusions of Andriy Gapon <avg@icyb.net.ua> after
108 * debugging: the SMI handler is quite simple - it tests value in
109 * TCO1_CNT against 0x800, i.e. checks TCO_TMR_HLT. If the bit is set
110 * the handler goes into an infinite loop, apparently to allow the
111 * second timeout and reboot. Otherwise it simply clears TIMEOUT bit
112 * in TCO1_STS and that's it.
113 * So the logic seems to be reversed, because it is hard to see how
114 * TIMEOUT can get set to 1 and SMI generated when TCO_TMR_HLT is set
115 * (other than a transitional effect).
117 * The only fix found to get the motherboard(s) to reboot is to put
118 * the glb_smi_en bit to 0. This is a dirty hack that bypasses the
119 * broken code by disabling Global SMI.
121 * WARNING: globally disabling SMI could possibly lead to dramatic
122 * problems, especially on laptops! I.e. various ACPI things where
123 * SMI is used for communication between OS and firmware.
125 * Don't use this fix if you don't need to!!!
128 static void broken_bios_start(struct resource *smires)
132 val32 = inl(smires->start);
133 /* Bit 13: TCO_EN -> 0 = Disables TCO logic generating an SMI#
134 Bit 0: GBL_SMI_EN -> 0 = No SMI# will be generated by ICH. */
136 outl(val32, smires->start);
139 static void broken_bios_stop(struct resource *smires)
143 val32 = inl(smires->start);
144 /* Bit 13: TCO_EN -> 1 = Enables TCO logic generating an SMI#
145 Bit 0: GBL_SMI_EN -> 1 = Turn global SMI on again. */
147 outl(val32, smires->start);
151 * Generic Support Functions
154 void iTCO_vendor_pre_start(struct resource *smires,
155 unsigned int heartbeat)
157 switch (iTCO_vendorsupport) {
158 case SUPERMICRO_OLD_BOARD:
159 supermicro_old_pre_start(smires);
162 broken_bios_start(smires);
166 EXPORT_SYMBOL(iTCO_vendor_pre_start);
168 void iTCO_vendor_pre_stop(struct resource *smires)
170 switch (iTCO_vendorsupport) {
171 case SUPERMICRO_OLD_BOARD:
172 supermicro_old_pre_stop(smires);
175 broken_bios_stop(smires);
179 EXPORT_SYMBOL(iTCO_vendor_pre_stop);
181 int iTCO_vendor_check_noreboot_on(void)
183 switch (iTCO_vendorsupport) {
184 case SUPERMICRO_OLD_BOARD:
190 EXPORT_SYMBOL(iTCO_vendor_check_noreboot_on);
192 static int __init iTCO_vendor_init_module(void)
194 if (iTCO_vendorsupport == SUPERMICRO_NEW_BOARD) {
195 pr_warn("Option vendorsupport=%d is no longer supported, "
196 "please use the w83627hf_wdt driver instead\n",
197 SUPERMICRO_NEW_BOARD);
200 pr_info("vendor-support=%d\n", iTCO_vendorsupport);
204 static void __exit iTCO_vendor_exit_module(void)
206 pr_info("Module Unloaded\n");
209 module_init(iTCO_vendor_init_module);
210 module_exit(iTCO_vendor_exit_module);
212 MODULE_AUTHOR("Wim Van Sebroeck <wim@iguana.be>, "
213 "R. Seretny <lkpatches@paypc.com>");
214 MODULE_DESCRIPTION("Intel TCO Vendor Specific WatchDog Timer Driver Support");
215 MODULE_VERSION(DRV_VERSION);
216 MODULE_LICENSE("GPL");