IDomeV2 Interface

Defines the IDome Interface

Definition

Namespace: ASCOM.Common.DeviceInterfaces
Assembly: ASCOM.Common (in ASCOM.Common.dll) Version: 2.2.1+77356f79b05b579f6d860a4edd5934fda9fe29e4
C#
public interface IDomeV2 : IAscomDevice
Implements
IAscomDevice

Remarks

This interface is used to handle a dome, with or without a controllable shutter, and also a roll off roof.

The dome implantation should be self explanatory.

A roll off roof is implemented using the shutter control as the roof. The properties and methods should be implemented as follows:

  • OpenShutter and CloseShutter open and close the roof.
  • CanFindHome, CanPark,CanSetAltitude, CanSetAzimuth, CanSetPark, CanSlave and CanSyncAzimuth all return false.
  • CanSetShutter returns true.
  • ShutterStatus is implemented.
  • Slewing always returns false.
  • AbortSlew should stop the shutter moving.
  • FindHome, Park, SetPark, SlewToAltitude, SlewToAzimuth and SyncToAzimuth all throw the NotImplementedException
  • Altitude and Azimuth throw the NotImplementedException.

Properties

Altitude The dome altitude (degrees, horizon zero and increasing positive to 90 zenith).
AtHome Indicates whether the dome is in the home position. Raises an error if not supported.

This is normally used following a FindHome operation. The value is reset with any azimuth slew operation that moves the dome away from the home position.

AtHome may also become true during normal slew operations, if the dome passes through the home position and the dome controller hardware is capable of detecting that; or at the end of a slew operation if the dome comes to rest at the home position.

AtPark True if the dome is in the programmed park position.
Azimuth The dome azimuth (degrees, North zero and increasing clockwise, i.e., 90 East, 180 South, 270 West)
CanFindHome True if driver can do a search for home position.
CanPark True if driver is capable of setting dome altitude.
CanSetAltitude True if driver is capable of setting dome altitude.
CanSetAzimuth True if driver is capable of setting dome azimuth.
CanSetPark True if driver can set the dome park position.
CanSetShutter True if driver is capable of automatically operating shutter.
CanSlave True if the dome hardware supports slaving to a telescope.
CanSyncAzimuth True if driver is capable of synchronizing the dome azimuth position using the SyncToAzimuth(Double) method.
Connected Set True to enable the link. Set False to disable the link. You can also read the property to check whether it is connected.
(Inherited from IAscomDevice)
Description Returns a description of the driver, such as manufacturer and model number.
(Inherited from IAscomDevice)
DriverInfo Descriptive and version information about this ASCOM driver.
(Inherited from IAscomDevice)
DriverVersion A string in the form "n.n" containing only the major and minor version of the driver.
(Inherited from IAscomDevice)
InterfaceVersion The interface version number that this device implements.
(Inherited from IAscomDevice)
Name The short name of the driver, for display purposes
(Inherited from IAscomDevice)
ShutterStatus Status of the dome shutter or roll-off roof.
Slaved True if the dome is slaved to the telescope in its hardware, else False.
Slewing True if any part of the dome is currently moving, False if all dome components are steady.
SupportedActions Returns the list of action names supported by this driver.
(Inherited from IAscomDevice)

Methods

AbortSlew Immediately cancel current dome operation.
Action Invokes the specified device-specific action.
(Inherited from IAscomDevice)
CloseShutter Close shutter or otherwise shield telescope from the sky.
CommandBlind Transmits an arbitrary string to the device and does not wait for a response. Optionally, protocol framing characters may be added to the string before transmission.
(Inherited from IAscomDevice)
CommandBool Transmits an arbitrary string to the device and waits for a boolean response. Optionally, protocol framing characters may be added to the string before transmission.
(Inherited from IAscomDevice)
CommandString Transmits an arbitrary string to the device and waits for a string response. Optionally, protocol framing characters may be added to the string before transmission.
(Inherited from IAscomDevice)
Dispose This method is a "clean-up" method that is primarily of use to drivers that are written in languages such as C# and VB.NET where resource clean-up is initially managed by the language's runtime garbage collection mechanic. Driver authors should take care to ensure that a client or runtime calling Dispose() does not adversely affect other connected clients. Applications should not call this method.
(Inherited from IAscomDevice)
FindHome Start operation to search for the dome home position.
OpenShutter Open shutter or otherwise expose telescope to the sky.
Park Rotate dome in azimuth to park position.
SetPark Set the current azimuth, altitude position of dome to be the park position.
SlewToAltitude Slew the dome to the given altitude position.
SlewToAzimuth Slew the dome to the given azimuth position.
SyncToAzimuth Synchronize the current position of the dome to the given azimuth.

Extension Methods

AbortSlewAsync Returns an awaitable, running, Task that halts all dome movement
(Defined by ClientExtensions)
CloseShutterAsync Returns an awaitable, running, Task that closes the dome shutter
(Defined by ClientExtensions)
FindHomeAsync Returns an awaitable, running, Task that moves the dome to the home position
(Defined by ClientExtensions)
OpenShutterAsync Returns an awaitable, running, Task that opens the dome shutter
(Defined by ClientExtensions)
ParkAsync Returns an awaitable, running, Task that parks the dome
(Defined by ClientExtensions)
SlewToAltitudeAsync Returns an awaitable, running, Task that slews the dome to the specified altitude
(Defined by ClientExtensions)
SlewToAzimuthAsync Returns an awaitable, running, Task that slews the dome to the specified azimuth
(Defined by ClientExtensions)

Version Information

.NET Standard

Supported in: 2.0

See Also