public interface WindowedWatchdogTimer extends WatchdogTimer
WindowedWatchdogTimer
interface provides methods for controlling a watchdog timer that can be used to
force the device to reboot (or depending on the platform, the Java Virtual Machine to restart).
The windowed watchdog timer must be refreshed within an open time window. If the watchdog is refreshed too soon -
during the closed window - or if it is refreshed too late - after the watchdog timeout has expired - the device will
be rebooted (or the JVM restarted).
A WindowedWatchdogTimer
instance may represent a virtual windowed watchdog timer. If the device has a single
physical windowed watchdog timer, all of the virtual watchdog timers are mapped onto this one physical watchdog
timer. It gets set with a refresh window starting when the virtual windowed watchdog with the longest closed window
delay is scheduled to end and ending when the virtual windowed watchdog with the earliest timeout is scheduled to
expire. The corresponding watchdog timer peripheral is therefore shared and several applications can concurrently
acquire the same watchdog timer peripheral.BIG_ENDIAN, LITTLE_ENDIAN, MIXED_ENDIAN, UNDEFINED_ID
Modifier and Type | Method and Description |
---|---|
long |
getClosedWindowTimeout()
Get the current closed window delay for the watchdog timer.
|
void |
start(long timeout)
Starts the watchdog timer with the specified timeout and with a closed window delay set to
0 . |
void |
start(long closedWindowDelay,
long timeout)
Starts the windowed watchdog timer with the specified closed window time and timeout.
|
causedLastReboot, getMaxTimeout, getTimeout, refresh, stop
close, getID, getName, getProperties, isOpen
long getClosedWindowTimeout() throws java.io.IOException, PeripheralNotAvailableException
java.io.IOException
- if an IO error occurred.PeripheralNotAvailableException
- if the peripheral is not currently available (has been closed).void start(long timeout) throws java.io.IOException, PeripheralNotAvailableException
0
. If the
watchdog timer is not refreshed by a call to WatchdogTimer.refresh()
prior to the watchdog timing out, the device will
be rebooted (or the JVM restarted).start
in interface WatchdogTimer
timeout
- the time interval (in milliseconds) until watchdog times out.java.io.IOException
- if an IO error occurred.java.lang.IllegalArgumentException
- if timeout
is not greater than 0
.PeripheralNotAvailableException
- if the peripheral is not currently available (has been closed).void start(long closedWindowDelay, long timeout) throws java.io.IOException, PeripheralNotAvailableException
WatchdogTimer.refresh()
method is called too soon, that is within the closed window delay, or too late, that is not called prior to the
watchdog timing out, the device will be rebooted (or the JVM restarted).closedWindowDelay
- the delay (in milliseconds) until the watchdog timer can be refreshed.timeout
- the time interval (in milliseconds) until watchdog times out.java.lang.IllegalArgumentException
- if timeout
is not greater than 0
or if closedWindowDelay
is negative or
closedWindowDelay
is greater than timeout
.java.io.IOException
- if an IO error occurred.PeripheralNotAvailableException
- if the peripheral is not currently available (has been closed).Copyright (c) 1990, 2013, Oracle and/or its affiliates. All rights reserved.