FocuserMove Method

public void Move(
	int Position
)

Public Sub Move ( 
	Position As Integer
)

public:
virtual void Move(
	int Position
) sealed

Parameters

Position

Type: SystemInt32
Step distance or absolute position, depending on the value of the Absolute property.

Implements

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 requirement 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.

Reference