xref: /linux/Documentation/watchdog/pcwd-watchdog.rst (revision 4b132aacb0768ac1e652cf517097ea6f237214b9)
1===================================
2Berkshire Products PC Watchdog Card
3===================================
4
5Last reviewed: 10/05/2007
6
7Support for ISA Cards  Revision A and C
8=======================================
9
10Documentation and Driver by Ken Hollis <kenji@bitgate.com>
11
12 The PC Watchdog is a card that offers the same type of functionality that
13 the WDT card does, only it doesn't require an IRQ to run.  Furthermore,
14 the Revision C card allows you to monitor any IO Port to automatically
15 trigger the card into being reset.  This way you can make the card
16 monitor hard drive status, or anything else you need.
17
18 The Watchdog Driver has one basic role: to talk to the card and send
19 signals to it so it doesn't reset your computer ... at least during
20 normal operation.
21
22 The Watchdog Driver will automatically find your watchdog card, and will
23 attach a running driver for use with that card.  After the watchdog
24 drivers have initialized, you can then talk to the card using a PC
25 Watchdog program.
26
27 I suggest putting a "watchdog -d" before the beginning of an fsck, and
28 a "watchdog -e -t 1" immediately after the end of an fsck.  (Remember
29 to run the program with an "&" to run it in the background!)
30
31 If you want to write a program to be compatible with the PC Watchdog
32 driver, simply use of modify the watchdog test program:
33 tools/testing/selftests/watchdog/watchdog-test.c
34
35
36 Other IOCTL functions include:
37
38	WDIOC_GETSUPPORT
39		This returns the support of the card itself.  This
40		returns in structure "PCWDS" which returns:
41
42			options = WDIOS_TEMPPANIC
43				  (This card supports temperature)
44			firmware_version = xxxx
45				  (Firmware version of the card)
46
47	WDIOC_GETSTATUS
48		This returns the status of the card, with the bits of
49		WDIOF_* bitwise-anded into the value.  (The comments
50		are in include/uapi/linux/watchdog.h)
51
52	WDIOC_GETBOOTSTATUS
53		This returns the status of the card that was reported
54		at bootup.
55
56	WDIOC_GETTEMP
57		This returns the temperature of the card.  (You can also
58		read /dev/watchdog, which gives a temperature update
59		every second.)
60
61	WDIOC_SETOPTIONS
62		This lets you set the options of the card.  You can either
63		enable or disable the card this way.
64
65	WDIOC_KEEPALIVE
66		This pings the card to tell it not to reset your computer.
67
68 And that's all she wrote!
69
70 -- Ken Hollis
71    (kenji@bitgate.com)
72