Difference between revisions of "Watchdog"

From ArmadeusWiki
Jump to: navigation, search
m
(Usage)
 
(20 intermediate revisions by 4 users not shown)
Line 1: Line 1:
{{Under_Construction}}
+
On this page, you will find usefull informations to configure and use the Watchdog of your APF boards.
 
+
For the time being there is no watchdog support on the [[APF9328]]. Help is welcome to integrate the watchdog on this board.
'''!! This page is under construction and Watchdog driver is still not integrated in current software version !!'''
+
 
+
On this page, you will find usefull informations to configure and use the Watchdog of your APF9328 board.
+
  
 
== Configuration ==
 
== Configuration ==
 
First be sure to have the Watchdog Linux driver activated:
 
First be sure to have the Watchdog Linux driver activated:
 +
<pre class="host">
 
  $ make linux-menuconfig
 
  $ make linux-menuconfig
 +
</pre>
  
[[Image:Watchdog_config.png]]
+
<pre class="config">
 +
[*] Watchdog Timer Support  --->
 +
    <*>  IMX2+  Watchdog
 +
</pre>
  
 +
<pre class="host">
 
  $ make
 
  $ make
 +
</pre>
  
 
== Installation ==
 
== Installation ==
If you choose to include driver in Linux kernel then reflash your kernel image.<br>
+
If you choose to include driver in Linux kernel then reflash your kernel image.
Else either copy the generated module through NFS to your board or reflash your rootfs.
+
 
 +
Otherwise either copy the generated module through NFS to your board or reflash your rootfs.
  
 
== Usage ==
 
== Usage ==
Load the module:
+
* If driver is statically linked to Linux, you can choose timeout value at boot time with:
# insmod /lib/modules/2.6.18.1/drivers/char/watchdog.ko
+
<pre class="apf">
or (if you have reflashed your rootfs):
+
BIOS> setenv extrabootargs imx2-wdt.timeout=5
# modprobe watchdog
+
</pre>
  
You can access the watchdog through /dev/misc/imx_wdt file
+
* Load the module if the watchdog is compiled as a module:
* to activate it, just open the file:
+
{{Note|On [[APF9328]]/[[APF27]]/[[APF28]]/[[APF51]]/[[OPOS6UL]] the watchdog driver is compiled within the kernel and do not need to be loaded at runtime.}}
  # cat /dev/misc/imx_wdt
+
<pre class="apf">
* then you will have to write to this file regularly or your system will be reseted
+
  # modprobe imx2-wdt timeout=5
  # echo 1 > /dev/misc/imx_wdt
+
</pre>
  
 +
You can now access the watchdog through ''/dev/watchdog'' or ''/dev/watchdog0'' device file (depending on your board, ''/dev/watchdog'' might be the 1 minute software Linux watchdog):
 +
* to activate it, just open the file, then you will have to write to this file regularly or your system will be reseted.
 +
{{Note|On [[APF27]] and [[APF51]] the watchdog is then unstoppable and will reset your board if you don't service it}}
 +
* there is a small daemon useful to periodically trig the watchdog and reset or reboot your board on timeout (here reset watchdog every 3 seconds and ask to reboot after 5s if not serviced):
 +
<pre class="apf">
 +
# watchdog -T 5 -t 3 /dev/watchdog
 +
</pre>
 +
If your system hangs, the daemon can't trig the watchdog and your system is reseted. To quickly check that you can do a:
 +
<pre class="apf">
 +
# kill -19 PID    (where PID is the one of watchdog process and -19 == SIGSTOP signal)
 +
</pre>
  
 
== Links ==
 
== Links ==
*  
+
* https://www.kernel.org/doc/Documentation/watchdog/watchdog-api.txt
*
+
 
 +
[[Category:Watchdog]]

Latest revision as of 13:52, 26 January 2018

On this page, you will find usefull informations to configure and use the Watchdog of your APF boards. For the time being there is no watchdog support on the APF9328. Help is welcome to integrate the watchdog on this board.

Configuration

First be sure to have the Watchdog Linux driver activated:

 $ make linux-menuconfig
[*] Watchdog Timer Support  --->
    <*>   IMX2+  Watchdog
 $ make

Installation

If you choose to include driver in Linux kernel then reflash your kernel image.

Otherwise either copy the generated module through NFS to your board or reflash your rootfs.

Usage

  • If driver is statically linked to Linux, you can choose timeout value at boot time with:
BIOS> setenv extrabootargs imx2-wdt.timeout=5
  • Load the module if the watchdog is compiled as a module:
Note Note: On APF9328/APF27/APF28/APF51/OPOS6UL the watchdog driver is compiled within the kernel and do not need to be loaded at runtime.
 # modprobe imx2-wdt timeout=5

You can now access the watchdog through /dev/watchdog or /dev/watchdog0 device file (depending on your board, /dev/watchdog might be the 1 minute software Linux watchdog):

  • to activate it, just open the file, then you will have to write to this file regularly or your system will be reseted.
Note Note: On APF27 and APF51 the watchdog is then unstoppable and will reset your board if you don't service it
  • there is a small daemon useful to periodically trig the watchdog and reset or reboot your board on timeout (here reset watchdog every 3 seconds and ask to reboot after 5s if not serviced):
 # watchdog -T 5 -t 3 /dev/watchdog

If your system hangs, the daemon can't trig the watchdog and your system is reseted. To quickly check that you can do a:

 # kill -19 PID     (where PID is the one of watchdog process and -19 == SIGSTOP signal)

Links