Click or drag to resize

DomeAtHome Property

when 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 optionally 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.

Namespace:  ASCOM.DriverAccess
Assembly:  ASCOM.DriverAccess (in ASCOM.DriverAccess.dll) Version: 3351c4f3fa64146a7efd5b51ed4591e32a0a5484
Syntax
public bool AtHome { get; }

Property Value

Type: Boolean

Implements

IDomeV2AtHome
Exceptions
ExceptionCondition
PropertyNotImplementedExceptionIf the property is not implemented
NotConnectedExceptionIf the device is not connected.
DriverExceptionAn error occurred that is not described by one of the more specific ASCOM exceptions. The device did not successfully complete the request.
Remarks

The home position is normally defined by a hardware sensor positioned around the dome circumference and represents a fixed, known azimuth reference.

Applications should not rely on the reported azimuth position being identical each time AtHome is set . For some devices, the home position may encompass a small range of azimuth values, rather than a discrete value, since dome inertia, the resolution of the home position sensor and/or the azimuth encoder may be insufficient to return the exact same azimuth value on each occasion. On the other hand some dome controllers always force the azimuth reading to a fixed value whenever the home position sensor is active.

See Also