com.oracle.deviceaccess.watchdog

Interface WindowedWatchdogTimer

All Superinterfaces:

Peripheral, WatchdogTimer

public interface WindowedWatchdogTimer
extends WatchdogTimer

The 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.

Field Summary

Fields inherited from interface com.oracle.deviceaccess.Peripheral

BIG_ENDIAN, LITTLE_ENDIAN, MIXED_ENDIAN, UNDEFINED_ID

Method Summary

Methods

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.

Methods inherited from interface com.oracle.deviceaccess.watchdog.WatchdogTimer

causedLastReboot, getMaxTimeout, getTimeout, refresh, stop

Methods inherited from interface com.oracle.deviceaccess.Peripheral

close, getID, getName, getProperties, isOpen

Method Detail

getClosedWindowTimeout

long getClosedWindowTimeout()
                            throws java.io.IOException,
                                   PeripheralNotAvailableException

Get the current closed window delay for the watchdog timer.

Returns:

the delay (in milliseconds) until the watchdog timer can be refreshed.

Throws:

java.io.IOException - if an IO error occurred.

PeripheralNotAvailableException - if the peripheral is not currently available (has been closed).

start

void start(long timeout)
           throws java.io.IOException,
                  PeripheralNotAvailableException

Starts the watchdog timer with the specified timeout and with a closed window delay set to 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).

Specified by:

start in interface WatchdogTimer

Parameters:

timeout - the time interval (in milliseconds) until watchdog times out.

Throws:

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).

start

void start(long closedWindowDelay,
         long timeout)
           throws java.io.IOException,
                  PeripheralNotAvailableException

Starts the windowed watchdog timer with the specified closed window time and timeout. If the 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).

Parameters:

closedWindowDelay - the delay (in milliseconds) until the watchdog timer can be refreshed.

timeout - the time interval (in milliseconds) until watchdog times out.

Throws:

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).