Moveabsolute - Newport XPS Programmer's Manual

XPS Unified
7.2.2.21

MoveAbsolute

Name
MoveAbsolute – Moves the stage to the end position. The positions are defined in um.
Input tests
- Refer to section 7.1: "Input Tests Common to all XPS Functions".
- Valids object type (group or positioner): (-8)
- Verifies target position in relation with the travel limits: (-17)
• TargetPosition ≥MinimumTargetPosition.
• TargetPosition ≤MaximumTargetPosition.
- Valids positioner name: (-18)
- Valids group name: (-19)
- Group status must be "READY" or "MOVING": (-22)
Description
This function executes an absolute motion to go to a target XY position. The group state
must be "READY" or "MOVING" else the (-22) error is returned. If the group is
"READY" then the group status becomes "MOVING".
Each "positioner" move refers to the acceleration, velocity, minimumTjerkTime and
maximumTjerkTime as defined in the "Stages.ini" file or as redefined by the
"PositionerSGammaParametersSet" function.
If a slave error or a following error is detected during the moving then (-25) or
ERR_SLAVE (-44) error is returned. In this case, the motion in progress is stopped and
the group status becomes "DISABLE".
If a "MotionDoneMode" is defined as "VelocityAndPositionWindowMotionDone" then
an (-33) error can be returned if the time out (defined by "MotionDoneTimeout" in the
stages.ini file) is reached before the motion done.
If "AbortMove" or "GroupMoveAbort" is done, an (-27) error is returned. In this case,
the motion in progress is stopped and the group status becomes "READY".
If a "GroupKill" command, an emergency brake or an emergency stop is occurred, an (-
26) error is returned. In this case, the motion in progress is stopped and the group status
becomes "NOT INITIALIZED".
The asynchronous moves for positioners of the same group are possible through
the use of different sockets to send the function.
Prototype
int MoveAbsolute(
int SocketID,
double PositonAbsoluteX_um,
double PositionAbsoluteY_um
)
NOTE
613
Programmer's Manual
EDH0373En1023 — 01/18