circuitpython/docs/library/machine.WDT.rst

36 lines
1.1 KiB
ReStructuredText
Raw Normal View History

.. currentmodule:: machine
class WDT -- watchdog timer
===========================
The WDT is used to restart the system when the application crashes and ends
up into a non recoverable state. Once started it cannot be stopped or
reconfigured in any way. After enabling, the application must "feed" the
watchdog periodically to prevent it from expiring and resetting the system.
Example usage::
from machine import WDT
wdt = WDT(timeout=2000) # enable it with a timeout of 2s
2015-09-13 11:06:12 -04:00
wdt.feed()
Availability of this class: WiPy.
Constructors
------------
.. class:: WDT(id=0, timeout=5000)
2015-09-13 11:06:12 -04:00
Create a WDT object and start it. The timeout must be given in seconds and
the minimum value that is accepted is 1 second. Once it is running the timeout
cannot be changed and the WDT cannot be stopped either.
Methods
-------
2015-09-13 11:06:12 -04:00
.. method:: wdt.feed()
2015-09-13 11:06:12 -04:00
Feed the WDT to prevent it from resetting the system. The application
should place this call in a sensible place ensuring that the WDT is
2015-09-13 11:06:12 -04:00
only fed after verifying that everything is functioning correctly.