ITelescopeV4 Interface

Defines the ITelescopeV4 Interface

Definition

Namespace: ASCOM.Common.DeviceInterfaces
Assembly: ASCOM.Common (in ASCOM.Common.dll) Version: 3.0.0-rc.1+86c25ce733aebb4d8b1b8a62e84770ea5e972bea

public interface ITelescopeV4 : IAscomDeviceV2, 
	IAscomDevice, ITelescopeV3

Public Interface ITelescopeV4
	Inherits IAscomDeviceV2, IAscomDevice, ITelescopeV3

Implements: IAscomDevice, IAscomDeviceV2, ITelescopeV3

Properties

AlignmentMode	The alignment mode of the mount (Alt/Az, Polar, German Polar). (Inherited from ITelescopeV3)
Altitude	The Altitude above the local horizon of the telescope's current position (degrees, positive up) (Inherited from ITelescopeV3)
ApertureArea	The area of the telescope's aperture, taking into account any obstructions (square meters) (Inherited from ITelescopeV3)
ApertureDiameter	The telescope's effective aperture diameter (meters) (Inherited from ITelescopeV3)
AtHome	True if the telescope is stopped in the Home position. Set only following a FindHome operation, and reset with any slew operation. This property must be False if the telescope does not support homing.
AtPark	True if the telescope has been put into the parked state by the see Park method. Set False by calling the Unpark() method. (Inherited from ITelescopeV3)
Azimuth	The azimuth at the local horizon of the telescope's current position (degrees, North-referenced, positive East/clockwise). (Inherited from ITelescopeV3)
CanFindHome	True if this telescope is capable of programmed finding its home position (FindHome method). (Inherited from ITelescopeV3)
CanPark	True if this telescope is capable of programmed parking (Parkmethod) (Inherited from ITelescopeV3)
CanPulseGuide	True if this telescope is capable of software-pulsed guiding (via the PulseGuide(GuideDirection, Int32) method) (Inherited from ITelescopeV3)
CanSetDeclinationRate	True if the DeclinationRate property can be changed to provide offset tracking in the declination axis. (Inherited from ITelescopeV3)
CanSetGuideRates	True if the guide rate properties used for PulseGuide(GuideDirection, Int32) can be adjusted. (Inherited from ITelescopeV3)
CanSetPark	True if this telescope is capable of programmed setting of its park position (SetPark method) (Inherited from ITelescopeV3)
CanSetPierSide	True if the SideOfPier property can be set, meaning that the mount can be forced to flip. (Inherited from ITelescopeV3)
CanSetRightAscensionRate	True if the RightAscensionRate property can be changed to provide offset tracking in the right ascension axis. (Inherited from ITelescopeV3)
CanSetTracking	True if the Tracking property can be changed, turning telescope sidereal tracking on and off. (Inherited from ITelescopeV3)
CanSlew	True if this telescope is capable of programmed slewing (synchronous or asynchronous) to equatorial coordinates
CanSlewAltAz	True if this telescope is capable of programmed slewing (synchronous or asynchronous) to local horizontal coordinates
CanSlewAltAzAsync	True if this telescope is capable of programmed asynchronous slewing to local horizontal coordinates
CanSlewAsync	True if this telescope is capable of programmed asynchronous slewing to equatorial coordinates.
CanSync	True if this telescope is capable of programmed synching to equatorial coordinates. (Inherited from ITelescopeV3)
CanSyncAltAz	True if this telescope is capable of programmed synching to local horizontal coordinates (Inherited from ITelescopeV3)
CanUnpark	True if this telescope is capable of programmed unparking (Unpark method). (Inherited from ITelescopeV3)
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)
Connecting	Completion variable for asynchronous connect and disconnect operations (Inherited from IAscomDeviceV2)
Declination	The declination (degrees) of the telescope's current equatorial coordinates, in the coordinate system given by the EquatorialSystem property. Reading the property will raise an error if the value is unavailable. (Inherited from ITelescopeV3)
DeclinationRate	The declination tracking rate (arcseconds per SI second, default = 0.0) (Inherited from ITelescopeV3)
Description	Returns a description of the driver, such as manufacturer and model number. (Inherited from IAscomDevice)
DeviceState	Returns the device's operational state in a single call (Inherited from IAscomDeviceV2)
DoesRefraction	True if the telescope or driver applies atmospheric refraction to coordinates. (Inherited from ITelescopeV3)
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)
EquatorialSystem	Equatorial coordinate system used by this telescope (e.g. Topocentric or J2000). (Inherited from ITelescopeV3)
FocalLength	The telescope's focal length, meters (Inherited from ITelescopeV3)
GuideRateDeclination	The current Declination movement rate offset for telescope guiding (degrees/sec) (Inherited from ITelescopeV3)
GuideRateRightAscension	The current Right Ascension movement rate offset for telescope guiding (degrees/sec) (Inherited from ITelescopeV3)
InterfaceVersion	The interface version number that this device implements. (Inherited from IAscomDevice)
IsPulseGuiding	True if a PulseGuide(GuideDirection, Int32) command is in progress, False otherwise (Inherited from ITelescopeV3)
Name	The short name of the driver, for display purposes (Inherited from IAscomDevice)
RightAscension	The right ascension (hours) of the telescope's current equatorial coordinates, in the coordinate system given by the EquatorialSystem property (Inherited from ITelescopeV3)
RightAscensionRate	The right ascension tracking rate offset from sidereal (seconds per sidereal second, default = 0.0) (Inherited from ITelescopeV3)
SideOfPier	Indicates the pointing state of the mount.
SiderealTime	The local apparent sidereal time from the telescope's internal clock (hours, sidereal) (Inherited from ITelescopeV3)
SiteElevation	The elevation above mean sea level (meters) of the site at which the telescope is located (Inherited from ITelescopeV3)
SiteLatitude	The geodetic(map) latitude (degrees, positive North, WGS84) of the site at which the telescope is located. (Inherited from ITelescopeV3)
SiteLongitude	The longitude (degrees, positive East, WGS84) of the site at which the telescope is located. (Inherited from ITelescopeV3)
Slewing	True if telescope is currently moving in response to one of the Slew methods or the MoveAxis(TelescopeAxis, Double) method, False at all other times. (Inherited from ITelescopeV3)
SlewSettleTime	Specifies a post-slew settling time (sec.). (Inherited from ITelescopeV3)
SupportedActions	Returns the list of action names supported by this driver. (Inherited from IAscomDevice)
TargetDeclination	The declination (degrees, positive North) for the target of an equatorial slew or sync operation (Inherited from ITelescopeV3)
TargetRightAscension	The right ascension (hours) for the target of an equatorial slew or sync operation (Inherited from ITelescopeV3)
Tracking	The state of the telescope's sidereal tracking drive.
TrackingRate	The current tracking rate of the telescope's sidereal drive (Inherited from ITelescopeV3)
TrackingRates	Returns a collection of supported DriveRate values that describe the permissible values of the TrackingRate property for this telescope type. (Inherited from ITelescopeV3)
UTCDate	The UTC date/time of the telescope's internal clock (Inherited from ITelescopeV3)

Methods

AbortSlew	Stops a slew in progress.
Action	Invokes the specified device-specific action. (Inherited from IAscomDevice)
AxisRates	Determine the rates at which the telescope may be moved about the specified axis by the MoveAxis(TelescopeAxis, Double) method. (Inherited from ITelescopeV3)
CanMoveAxis	True if this telescope can move the requested axis (Inherited from ITelescopeV3)
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)
Connect	Connect to device asynchronously (Inherited from IAscomDeviceV2)
DestinationSideOfPier	Predict side of pier for German equatorial mounts (Inherited from ITelescopeV3)
Disconnect	Disconnect from device asynchronously (Inherited from IAscomDeviceV2)
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	Locates the telescope's "home" position
MoveAxis	Move the telescope in one axis at the given rate.
Park	Move the telescope to its park position, stop all motion (or restrict to a small safe range), and set AtPark to True.
PulseGuide	Moves the scope in the given direction for the given interval or time at the rate given by the corresponding guide rate property
SetPark	Sets the telescope's park position to be its current position. (Inherited from ITelescopeV3)
SlewToAltAz	Move the telescope to the given local horizontal coordinates, return when slew is complete
SlewToAltAzAsync	This Method must be implemented if CanSlewAltAzAsync returns True.
SlewToCoordinates	Move the telescope to the given equatorial coordinates, return when slew is complete
SlewToCoordinatesAsync	Move the telescope to the given equatorial coordinates, return immediately after starting the slew.
SlewToTarget	Move the telescope to the TargetRightAscension and TargetDeclination coordinates, return when slew complete.
SlewToTargetAsync	Move the telescope to the TargetRightAscension and TargetDeclination coordinates, returns immediately after starting the slew.
SyncToAltAz	Matches the scope's local horizontal coordinates to the given local horizontal coordinates. (Inherited from ITelescopeV3)
SyncToCoordinates	Matches the scope's equatorial coordinates to the given equatorial coordinates. (Inherited from ITelescopeV3)
SyncToTarget	Matches the scope's equatorial coordinates to the given equatorial coordinates. (Inherited from ITelescopeV3)
Unpark	Takes telescope out of the Parked state.

Extension Methods

AbortSlewAsync	Returns an awaitable, running, Task that stops telescope slewing movement (Defined by ClientExtensions)
ConnectAsync	Returns an awaitable, running, Task that connects to the device. (Polls IAscomDeviceV2.Connecting) (Defined by ClientExtensions)
DisconnectAsync	Returns an awaitable, running, Task that disconnects from the device. (Polls IAscomDeviceV2.Connecting) (Defined by ClientExtensions)
FindHomeAsync	Returns an awaitable, running, Task that moves the telescope to the home position (Defined by ClientExtensions)
ParkAsync	Returns an awaitable, running, Task that parks the telescope (Defined by ClientExtensions)
SlewToAltAzTaskAsync	Returns an awaitable, running, Task that slews the telescope to the specified altitude / azimuth coordinates (Defined by ClientExtensions)
SlewToCoordinatesTaskAsync	Returns an awaitable, running, Task that slews the telescope to the specified RA/Dec coordinates (Defined by ClientExtensions)
SlewToTargetTaskAsync	Returns an awaitable, running, Task that slews the telescope to the coordinates specified by the TargetRA and TargetDeclination properties (Defined by ClientExtensions)
UnparkAsync	Returns an awaitable, running, Task that un-parks the telescope (Defined by ClientExtensions)

Version Information

.NET Standard

Supported in: 2.0