com.oracle.deviceaccess.watchdog

Interface WindowedWatchdogTimer

All Superinterfaces:

java.lang.AutoCloseable, java.nio.channels.Channel, java.io.Closeable, Peripheral<WatchdogTimer>, 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

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 delay 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, getDescriptor, isOpen, tryLock, unlock

Method Detail

getClosedWindowTimeout

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

Get the current closed window delay for the watchdog timer.

If the timer is disabled 0 is returned.

Returns:

the delay (in milliseconds) until the watchdog timer can be refreshed; or 0 if the timer is disabled.

Throws:

java.io.IOException - if some other I/O error occurs.

ClosedPeripheralException - if the peripheral has been closed.

start

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

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

Calling this method twice is equivalent to stopping the timer as per a call to WatchdogTimer.stop() and starting it again with the new specified timeout and with a closed window delay set to 0.

Specified by:

start in interface WatchdogTimer

Parameters:

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

Throws:

java.io.IOException - if some other I/O error occurs.

java.lang.IllegalArgumentException - if timeout is not greater than 0.

ClosedPeripheralException - if the peripheral has been closed.

start

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

Starts the windowed watchdog timer with the specified closed window delay 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).

Calling this method twice is equivalent to stopping the timer as per a call to WatchdogTimer.stop() and starting it again with the new specified closed window delay and timeout.

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 some other I/O error occurs.

ClosedPeripheralException - if the peripheral has been closed.