Click or drag to resize

IFocuserV3Move Method

Moves the focuser by the specified amount or to the specified position depending on the value of the Absolute property.

Namespace:  ASCOM.DeviceInterface
Assembly:  ASCOM.DeviceInterfaces (in ASCOM.DeviceInterfaces.dll) Version: 3c9121baba46811fe6e53a58a05935662261416d
Syntax
void Move(
	int Position
)

Parameters

Position
Type: SystemInt32
Step distance or absolute position, depending on the value of the Absolute property.
Exceptions
ExceptionCondition
NotConnectedExceptionIf the device is not connected.
DriverExceptionMust throw an exception if the call was not successful
Remarks

Must be implemented

If the Absolute property is True, then this is an absolute positioning focuser. The Move command tells the focuser to move to an exact step position, and the Position parameter of the Move method is an integer between 0 and MaxStep.

If the Absolute property is False, then this is a relative positioning focuser. The Move command tells the focuser to move in a relative direction, and the Position parameter of the Move method (in this case, step distance) is an integer between minus MaxIncrement and plus MaxIncrement.

BEHAVIOURAL CHANGE - Platform 6.4

Prior to Platform 6.4, the interface specification mandated that drivers must throw an InvalidOperationException if a move was attempted when TempComp was True, even if the focuser was able to execute the move safely without disrupting temperature compensation.

Following discussion on ASCOM-Talk in January 2018, the Focuser interface specification has been revised to IFocuserV3, removing the requrement to throw the InvalidOperationException exception. IFocuserV3 compliant drivers are expected to execute Move requests when temperature compensation is active and to hide any specific actions required by the hardware from the client. For example this could be achieved by disabling temperature compensation, moving the focuser and re-enabling temperature compensation or simply by moving the focuser with compensation enabled if the hardware supports this.

Conform will continue to pass IFocuserV2 drivers that throw InvalidOperationException exceptions. However, Conform will now fail IFocuserV3 drivers that throw InvalidOperationException exceptions, in line with this revised specification.

See Also