android_kernel_xiaomi_sm8350/Documentation/watchdog/pcwd-watchdog.txt

Last reviewed: 10/05/2007

                     Berkshire Products PC Watchdog Card
                   Support for ISA Cards  Revision A and C
           Documentation and Driver by Ken Hollis <kenji@bitgate.com>

 The PC Watchdog is a card that offers the same type of functionality that
 the WDT card does, only it doesn't require an IRQ to run.  Furthermore,
 the Revision C card allows you to monitor any IO Port to automatically
 trigger the card into being reset.  This way you can make the card
 monitor hard drive status, or anything else you need.

 The Watchdog Driver has one basic role: to talk to the card and send
 signals to it so it doesn't reset your computer ... at least during
 normal operation.

 The Watchdog Driver will automatically find your watchdog card, and will
 attach a running driver for use with that card.  After the watchdog
 drivers have initialized, you can then talk to the card using a PC
 Watchdog program.

 I suggest putting a "watchdog -d" before the beginning of an fsck, and
 a "watchdog -e -t 1" immediately after the end of an fsck.  (Remember
 to run the program with an "&" to run it in the background!)

 If you want to write a program to be compatible with the PC Watchdog
 driver, simply use of modify the watchdog test program:
 Documentation/watchdog/src/watchdog-test.c


 Other IOCTL functions include:

	WDIOC_GETSUPPORT
		This returns the support of the card itself.  This
		returns in structure "PCWDS" which returns:
			options = WDIOS_TEMPPANIC
				  (This card supports temperature)
			firmware_version = xxxx
				  (Firmware version of the card)

	WDIOC_GETSTATUS
		This returns the status of the card, with the bits of
		WDIOF_* bitwise-anded into the value.  (The comments
		are in linux/pcwd.h)

	WDIOC_GETBOOTSTATUS
		This returns the status of the card that was reported
		at bootup.

	WDIOC_GETTEMP
		This returns the temperature of the card.  (You can also
		read /dev/watchdog, which gives a temperature update
		every second.)

	WDIOC_SETOPTIONS
		This lets you set the options of the card.  You can either
		enable or disable the card this way.

	WDIOC_KEEPALIVE
		This pings the card to tell it not to reset your computer.

 And that's all she wrote!

 -- Ken Hollis
    (kenji@bitgate.com)
[WATCHDOG] clean-up watchdog documentation Random sampling of some URLs in the Documentation tree to see how many were stale found that one watchdog driver was now a porn site. In fact if the watchdogs document directory was any older it would be written in latin Clean it up somewhat and add Last reviewed headers, something all the Documentation could do with IMHO. Signed-off-by: Alan Cox <alan@redhat.com> Signed-off-by: Andrew Morton <akpm@linux-foundation.org> Signed-off-by: Wim Van Sebroeck <wim@iguana.be> 2007-05-23 17:43:52 -04:00			`Last reviewed: 10/05/2007`

Linux-2.6.12-rc2 Initial git repository build. I'm not bothering with the full history, even though we have it. We can create a separate "historical" git archive of that later if we want to, and in the meantime it's about 3.2GB when imported into git - space that would just make the early git days unnecessarily complicated, when we don't have a lot of good infrastructure for it. Let it rip! 2005-04-16 18:20:36 -04:00			`Berkshire Products PC Watchdog Card`
			`Support for ISA Cards Revision A and C`
			`Documentation and Driver by Ken Hollis <kenji@bitgate.com>`

			`The PC Watchdog is a card that offers the same type of functionality that`
			`the WDT card does, only it doesn't require an IRQ to run. Furthermore,`
			`the Revision C card allows you to monitor any IO Port to automatically`
			`trigger the card into being reset. This way you can make the card`
			`monitor hard drive status, or anything else you need.`

			`The Watchdog Driver has one basic role: to talk to the card and send`
			`signals to it so it doesn't reset your computer ... at least during`
			`normal operation.`

			`The Watchdog Driver will automatically find your watchdog card, and will`
			`attach a running driver for use with that card. After the watchdog`
[WATCHDOG] clean-up watchdog documentation Random sampling of some URLs in the Documentation tree to see how many were stale found that one watchdog driver was now a porn site. In fact if the watchdogs document directory was any older it would be written in latin Clean it up somewhat and add Last reviewed headers, something all the Documentation could do with IMHO. Signed-off-by: Alan Cox <alan@redhat.com> Signed-off-by: Andrew Morton <akpm@linux-foundation.org> Signed-off-by: Wim Van Sebroeck <wim@iguana.be> 2007-05-23 17:43:52 -04:00			`drivers have initialized, you can then talk to the card using a PC`
			`Watchdog program.`
Linux-2.6.12-rc2 Initial git repository build. I'm not bothering with the full history, even though we have it. We can create a separate "historical" git archive of that later if we want to, and in the meantime it's about 3.2GB when imported into git - space that would just make the early git days unnecessarily complicated, when we don't have a lot of good infrastructure for it. Let it rip! 2005-04-16 18:20:36 -04:00
			`I suggest putting a "watchdog -d" before the beginning of an fsck, and`
			`a "watchdog -e -t 1" immediately after the end of an fsck. (Remember`
			`to run the program with an "&" to run it in the background!)`

			`If you want to write a program to be compatible with the PC Watchdog`
[WATCHDOG] Documentation/watchdog update Documentation/watchdog/: Expose example and tool source files in the Documentation/ directory in their own files instead of being buried (almost hidden) in readme/txt files. This will make them more visible/usable to users who may need to use them, to developers who may need to test with them, and to janitors who would update them if they were more visible. Also, if any of these possibly should not be in the kernel tree at all, it will be clearer that they are here and we can discuss if they should be removed. Signed-off-by: Randy Dunlap <rdunlap@xenotime.net> Signed-off-by: Wim Van Sebroeck <wim@iguana.be> Signed-off-by: Andrew Morton <akpm@osdl.org> 2006-05-21 23:58:10 -04:00			`driver, simply use of modify the watchdog test program:`
			`Documentation/watchdog/src/watchdog-test.c`
Linux-2.6.12-rc2 Initial git repository build. I'm not bothering with the full history, even though we have it. We can create a separate "historical" git archive of that later if we want to, and in the meantime it's about 3.2GB when imported into git - space that would just make the early git days unnecessarily complicated, when we don't have a lot of good infrastructure for it. Let it rip! 2005-04-16 18:20:36 -04:00

			`Other IOCTL functions include:`

			`WDIOC_GETSUPPORT`
			`This returns the support of the card itself. This`
			`returns in structure "PCWDS" which returns:`
			`options = WDIOS_TEMPPANIC`
			`(This card supports temperature)`
			`firmware_version = xxxx`
			`(Firmware version of the card)`

			`WDIOC_GETSTATUS`
			`This returns the status of the card, with the bits of`
			`WDIOF_* bitwise-anded into the value. (The comments`
			`are in linux/pcwd.h)`

			`WDIOC_GETBOOTSTATUS`
			`This returns the status of the card that was reported`
			`at bootup.`

			`WDIOC_GETTEMP`
			`This returns the temperature of the card. (You can also`
			`read /dev/watchdog, which gives a temperature update`
			`every second.)`

			`WDIOC_SETOPTIONS`
			`This lets you set the options of the card. You can either`
			`enable or disable the card this way.`

			`WDIOC_KEEPALIVE`
			`This pings the card to tell it not to reset your computer.`

			`And that's all she wrote!`

			`-- Ken Hollis`
			`(kenji@bitgate.com)`