1 // SPDX-License-Identifier: GPL-2.0-only
6 * SoftDog 0.05: A Software Watchdog Device
8 * (c) Copyright 2018 Hewlett Packard Enterprise Development LP
9 * Thomas Mingarelli <thomas.mingarelli@hpe.com>
12 #define pr_fmt(fmt) KBUILD_MODNAME ": " fmt
14 #include <linux/device.h>
16 #include <linux/kernel.h>
17 #include <linux/module.h>
18 #include <linux/moduleparam.h>
19 #include <linux/pci.h>
20 #include <linux/pci_ids.h>
21 #include <linux/types.h>
22 #include <linux/watchdog.h>
23 #ifdef CONFIG_HPWDT_NMI_DECODING
26 #include <linux/crash_dump.h>
28 #define HPWDT_VERSION "2.0.4"
29 #define SECS_TO_TICKS(secs) ((secs) * 1000 / 128)
30 #define TICKS_TO_SECS(ticks) ((ticks) * 128 / 1000)
31 #define HPWDT_MAX_TICKS 65535
32 #define HPWDT_MAX_TIMER TICKS_TO_SECS(HPWDT_MAX_TICKS)
33 #define DEFAULT_MARGIN 30
34 #define PRETIMEOUT_SEC 9
37 static unsigned int soft_margin = DEFAULT_MARGIN; /* in seconds */
38 static bool nowayout = WATCHDOG_NOWAYOUT;
39 static bool pretimeout = IS_ENABLED(CONFIG_HPWDT_NMI_DECODING);
40 static int kdumptimeout = -1;
42 static void __iomem *pci_mem_addr; /* the PCI-memory address */
43 static unsigned long __iomem *hpwdt_nmistat;
44 static unsigned long __iomem *hpwdt_timer_reg;
45 static unsigned long __iomem *hpwdt_timer_con;
47 static const struct pci_device_id hpwdt_devices[] = {
48 { PCI_DEVICE(PCI_VENDOR_ID_COMPAQ, 0xB203) }, /* iLO2 */
49 { PCI_DEVICE(PCI_VENDOR_ID_HP, 0x3306) }, /* iLO3 */
50 { PCI_DEVICE(PCI_VENDOR_ID_HP_3PAR, 0x0389) }, /* PCtrl */
51 {0}, /* terminate list */
53 MODULE_DEVICE_TABLE(pci, hpwdt_devices);
55 static const struct pci_device_id hpwdt_blacklist[] = {
56 { PCI_DEVICE_SUB(PCI_VENDOR_ID_HP, 0x3306, PCI_VENDOR_ID_HP, 0x1979) }, /* auxilary iLO */
57 { PCI_DEVICE_SUB(PCI_VENDOR_ID_HP, 0x3306, PCI_VENDOR_ID_HP_3PAR, 0x0289) }, /* CL */
58 {0}, /* terminate list */
61 static struct watchdog_device hpwdt_dev;
65 static int hpwdt_hw_is_running(void)
67 return ioread8(hpwdt_timer_con) & 0x01;
70 static int hpwdt_start(struct watchdog_device *wdd)
72 int control = 0x81 | (pretimeout ? 0x4 : 0);
73 int reload = SECS_TO_TICKS(min(wdd->timeout, wdd->max_hw_heartbeat_ms/1000));
75 dev_dbg(wdd->parent, "start watchdog 0x%08x:0x%08x:0x%02x\n", wdd->timeout, reload, control);
76 iowrite16(reload, hpwdt_timer_reg);
77 iowrite8(control, hpwdt_timer_con);
82 static void hpwdt_stop(void)
86 pr_debug("stop watchdog\n");
88 data = ioread8(hpwdt_timer_con);
90 iowrite8(data, hpwdt_timer_con);
93 static int hpwdt_stop_core(struct watchdog_device *wdd)
100 static void hpwdt_ping_ticks(int val)
102 val = min(val, HPWDT_MAX_TICKS);
103 iowrite16(val, hpwdt_timer_reg);
106 static int hpwdt_ping(struct watchdog_device *wdd)
108 int reload = SECS_TO_TICKS(min(wdd->timeout, wdd->max_hw_heartbeat_ms/1000));
110 dev_dbg(wdd->parent, "ping watchdog 0x%08x:0x%08x\n", wdd->timeout, reload);
111 hpwdt_ping_ticks(reload);
116 static unsigned int hpwdt_gettimeleft(struct watchdog_device *wdd)
118 return TICKS_TO_SECS(ioread16(hpwdt_timer_reg));
121 static int hpwdt_settimeout(struct watchdog_device *wdd, unsigned int val)
123 dev_dbg(wdd->parent, "set_timeout = %d\n", val);
126 if (val <= wdd->pretimeout) {
127 dev_dbg(wdd->parent, "pretimeout < timeout. Setting to zero\n");
130 if (watchdog_active(wdd))
138 #ifdef CONFIG_HPWDT_NMI_DECODING
139 static int hpwdt_set_pretimeout(struct watchdog_device *wdd, unsigned int req)
141 unsigned int val = 0;
143 dev_dbg(wdd->parent, "set_pretimeout = %d\n", req);
145 val = PRETIMEOUT_SEC;
146 if (val >= wdd->timeout)
151 dev_dbg(wdd->parent, "Rounding pretimeout to: %d\n", val);
153 wdd->pretimeout = val;
156 if (watchdog_active(wdd))
162 static int hpwdt_my_nmi(void)
164 return ioread8(hpwdt_nmistat) & 0x6;
170 static int hpwdt_pretimeout(unsigned int ulReason, struct pt_regs *regs)
172 unsigned int mynmi = hpwdt_my_nmi();
173 static char panic_msg[] =
174 "00: An NMI occurred. Depending on your system the reason "
175 "for the NMI is logged in any one of the following resources:\n"
176 "1. Integrated Management Log (IML)\n"
178 "3. OA Forward Progress Log\n"
181 if (ilo5 && ulReason == NMI_UNKNOWN && !mynmi)
184 if (ilo5 && !pretimeout && !mynmi)
187 if (kdumptimeout < 0)
189 else if (kdumptimeout == 0)
192 unsigned int val = max((unsigned int)kdumptimeout, hpwdt_dev.timeout);
193 hpwdt_ping_ticks(SECS_TO_TICKS(val));
196 hex_byte_pack(panic_msg, mynmi);
197 nmi_panic(regs, panic_msg);
201 #endif /* CONFIG_HPWDT_NMI_DECODING */
204 static const struct watchdog_info ident = {
205 .options = WDIOF_PRETIMEOUT |
207 WDIOF_KEEPALIVEPING |
209 .identity = "HPE iLO2+ HW Watchdog Timer",
216 static const struct watchdog_ops hpwdt_ops = {
217 .owner = THIS_MODULE,
218 .start = hpwdt_start,
219 .stop = hpwdt_stop_core,
221 .set_timeout = hpwdt_settimeout,
222 .get_timeleft = hpwdt_gettimeleft,
223 #ifdef CONFIG_HPWDT_NMI_DECODING
224 .set_pretimeout = hpwdt_set_pretimeout,
228 static struct watchdog_device hpwdt_dev = {
232 .timeout = DEFAULT_MARGIN,
233 .pretimeout = PRETIMEOUT_SEC,
234 .max_hw_heartbeat_ms = HPWDT_MAX_TIMER * 1000,
242 static int hpwdt_init_nmi_decoding(struct pci_dev *dev)
244 #ifdef CONFIG_HPWDT_NMI_DECODING
247 * Only one function can register for NMI_UNKNOWN
249 retval = register_nmi_handler(NMI_UNKNOWN, hpwdt_pretimeout, 0, "hpwdt");
252 retval = register_nmi_handler(NMI_SERR, hpwdt_pretimeout, 0, "hpwdt");
255 retval = register_nmi_handler(NMI_IO_CHECK, hpwdt_pretimeout, 0, "hpwdt");
260 "HPE Watchdog Timer Driver: NMI decoding initialized\n");
265 unregister_nmi_handler(NMI_SERR, "hpwdt");
267 unregister_nmi_handler(NMI_UNKNOWN, "hpwdt");
270 "Unable to register a die notifier (err=%d).\n",
273 #endif /* CONFIG_HPWDT_NMI_DECODING */
277 static void hpwdt_exit_nmi_decoding(void)
279 #ifdef CONFIG_HPWDT_NMI_DECODING
280 unregister_nmi_handler(NMI_UNKNOWN, "hpwdt");
281 unregister_nmi_handler(NMI_SERR, "hpwdt");
282 unregister_nmi_handler(NMI_IO_CHECK, "hpwdt");
286 static int hpwdt_init_one(struct pci_dev *dev,
287 const struct pci_device_id *ent)
292 * First let's find out if we are on an iLO2+ server. We will
293 * not run on a legacy ASM box.
294 * So we only support the G5 ProLiant servers and higher.
296 if (dev->subsystem_vendor != PCI_VENDOR_ID_HP &&
297 dev->subsystem_vendor != PCI_VENDOR_ID_HP_3PAR) {
299 "This server does not have an iLO2+ ASIC.\n");
303 if (pci_match_id(hpwdt_blacklist, dev)) {
304 dev_dbg(&dev->dev, "Not supported on this device\n");
308 if (pci_enable_device(dev)) {
310 "Not possible to enable PCI Device: 0x%x:0x%x.\n",
311 ent->vendor, ent->device);
315 pci_mem_addr = pci_iomap(dev, 1, 0x80);
318 "Unable to detect the iLO2+ server memory.\n");
320 goto error_pci_iomap;
322 hpwdt_nmistat = pci_mem_addr + 0x6e;
323 hpwdt_timer_reg = pci_mem_addr + 0x70;
324 hpwdt_timer_con = pci_mem_addr + 0x72;
326 /* Have the core update running timer until user space is ready */
327 if (hpwdt_hw_is_running()) {
328 dev_info(&dev->dev, "timer is running\n");
329 set_bit(WDOG_HW_RUNNING, &hpwdt_dev.status);
332 /* Initialize NMI Decoding functionality */
333 retval = hpwdt_init_nmi_decoding(dev);
335 goto error_init_nmi_decoding;
337 watchdog_stop_on_unregister(&hpwdt_dev);
338 watchdog_set_nowayout(&hpwdt_dev, nowayout);
339 watchdog_init_timeout(&hpwdt_dev, soft_margin, NULL);
341 if (is_kdump_kernel()) {
346 if (pretimeout && hpwdt_dev.timeout <= PRETIMEOUT_SEC) {
347 dev_warn(&dev->dev, "timeout <= pretimeout. Setting pretimeout to zero\n");
350 hpwdt_dev.pretimeout = pretimeout ? PRETIMEOUT_SEC : 0;
351 kdumptimeout = min(kdumptimeout, HPWDT_MAX_TIMER);
353 hpwdt_dev.parent = &dev->dev;
354 retval = watchdog_register_device(&hpwdt_dev);
356 goto error_wd_register;
358 dev_info(&dev->dev, "HPE Watchdog Timer Driver: Version: %s\n",
360 dev_info(&dev->dev, "timeout: %d seconds (nowayout=%d)\n",
361 hpwdt_dev.timeout, nowayout);
362 dev_info(&dev->dev, "pretimeout: %s.\n",
363 pretimeout ? "on" : "off");
364 dev_info(&dev->dev, "kdumptimeout: %d.\n", kdumptimeout);
366 if (dev->subsystem_vendor == PCI_VENDOR_ID_HP_3PAR)
372 hpwdt_exit_nmi_decoding();
373 error_init_nmi_decoding:
374 pci_iounmap(dev, pci_mem_addr);
376 pci_disable_device(dev);
380 static void hpwdt_exit(struct pci_dev *dev)
382 watchdog_unregister_device(&hpwdt_dev);
383 hpwdt_exit_nmi_decoding();
384 pci_iounmap(dev, pci_mem_addr);
385 pci_disable_device(dev);
388 static struct pci_driver hpwdt_driver = {
390 .id_table = hpwdt_devices,
391 .probe = hpwdt_init_one,
392 .remove = hpwdt_exit,
395 MODULE_AUTHOR("Tom Mingarelli");
396 MODULE_DESCRIPTION("hpe watchdog driver");
397 MODULE_LICENSE("GPL");
398 MODULE_VERSION(HPWDT_VERSION);
400 module_param(soft_margin, int, 0);
401 MODULE_PARM_DESC(soft_margin, "Watchdog timeout in seconds");
403 module_param_named(timeout, soft_margin, int, 0);
404 MODULE_PARM_DESC(timeout, "Alias of soft_margin");
406 module_param(nowayout, bool, 0);
407 MODULE_PARM_DESC(nowayout, "Watchdog cannot be stopped once started (default="
408 __MODULE_STRING(WATCHDOG_NOWAYOUT) ")");
410 module_param(kdumptimeout, int, 0444);
411 MODULE_PARM_DESC(kdumptimeout, "Timeout applied for crash kernel transition in seconds");
413 #ifdef CONFIG_HPWDT_NMI_DECODING
414 module_param(pretimeout, bool, 0);
415 MODULE_PARM_DESC(pretimeout, "Watchdog pretimeout enabled");
418 module_pci_driver(hpwdt_driver);