stella.roof
Interface DomeOperating

All Superinterfaces:

Sheltering, StatusProviding

All Known Implementing Classes:

DomeReceiver

public interface DomeOperating
extends Sheltering

An interface describing the functionality of a roof server. It allows installing of a driver object allowing the software to drive the roof hardware.
Concrete implementations should also provide the connecting part of a environment command launcher, see CommandLaunching.

Method Summary

boolean	antiSun() Follows with the dome a position that is always opposite of the sun
void	clearLastError() Clears the last error event generated.
boolean	closeHatch() Directly closes the left roof.
boolean	closeSlit() Directly closes the right roof.
boolean	follow(double ra, double de) Follows with the dome the indicated right ascension, declination in current equinox.
ErrorEvent	getLastError() Returns the last error generated as a result of on of the open/close etc.
boolean	home() Move the dome to a home position, if it has one.
boolean	openHatch() Directly opens the hatch, if possible.
boolean	openSlit() Directly opens the main slit of the dome.
boolean	position(double azdeg) Moves the dome to the required azimuth position and stops there.
boolean	powerOff() Directly powers down the roof.
boolean	powerOn() Directly powers up the roof.
boolean	stop() Stops all dome movements.

Methods inherited from interface stella.roof.Sheltering

close, getLastCloseTime, getLastOpenTime, isClosed, isOpen, open

Methods inherited from interface util.StatusProviding

provideStatus

Method Detail

getLastError

ErrorEvent getLastError()

Returns the last error generated as a result of on of the open/close etc. commands. The result is transfered as an {link ErrorEvent}

clearLastError

void clearLastError()

Clears the last error event generated.

openHatch

boolean openHatch()

Directly opens the hatch, if possible. Throws UnsupportedOperationException

Returns:

True if opening was successful.

openSlit

boolean openSlit()

Directly opens the main slit of the dome. Blocks until the roof is open.

Returns:

True if opening was successful.

closeHatch

boolean closeHatch()

Directly closes the left roof. Blocks until the roof is closed.

Returns:

True if closing was successful

closeSlit

boolean closeSlit()

Directly closes the right roof. Blocks until the roof is closed.

Returns:

True if closing was successful

powerOn

boolean powerOn()

Directly powers up the roof.

Returns:

True on success

powerOff

boolean powerOff()

Directly powers down the roof.

Returns:

True on success

position

boolean position(double azdeg)

Moves the dome to the required azimuth position and stops there.

Parameters:

azdeg - The astronomical azimuth in degrees, S=0, W=+90.

follow

boolean follow(double ra,
               double de)

Follows with the dome the indicated right ascension, declination in current equinox.

Parameters:

ra - Right ascension, degrees, apparent equinox.

de - Declination, degress, apparent equinox.

antiSun

boolean antiSun()

Follows with the dome a position that is always opposite of the sun

Parameters:

ra - Right ascension, degrees, apparent equinox.

de - Declination, degress, apparent equinox.

stop

boolean stop()

Stops all dome movements.

home

boolean home()

Move the dome to a home position, if it has one.