Grouphomesearchandrelativemove - Newport XPS Programmer's Manual

XPS Unified
7.2.1.78

GroupHomeSearchAndRelativeMove

Name
GroupHomeSearchAndRelativeMove - Initiates a home search followed by a relative
move.
Input tests
- Refer to section 7.1: "Input Tests Common to all XPS Functions".
- Valids group name: (-19)
- Group status must be "Not referenced": (-22)
Description
This function initiates a home search followed by a relative move at the end of the home
search.
The group must be initialized and in "NOT REFERENCED" state otherwise (-22) error
is returned.
If there is no error, the group status changes to "HOMING".
The home search sequence can fail due to:
• a following error: (-25).
• a ZM detection error: (-49).
• a home search time out: (-33).
For all these errors, the group returns to "NOTINIT" state.
Once the home search is completed, a relative move is executed. After this sequence
each positioner is checked for error. If an error is detected, the hardware status register
is reset (motor on) and the positioner error is cleared before checking it again. If a
positioner error is always present, ERR_TRAVEL_LIMITS (-35) is returned and the
group state becomes "NOTINIT".
If the home search is successful, the group will be in "READY" state.
The home search routine for each positioner is defined in stages.ini file by
"HomeSearchSequenceType"parameter.
The home search time out is defined in stages.ini file by
"HomeSearchTimeOut"parameter.
The home search sequence is defined in system.ini file by
"InitializationAndHomeSearchSequence" parameter for each group with several
positioners:
XY group
The home search sequence can be "Together", "XthenY" or "YthenX" if the XY
group is standard configuration. If the XY group is Gantry (dual positioner on X
or on Y axis) only the "XthenY" or "YthenX" are allowed.
XYZ group
The home search sequence can be "Together" or "XthenYthenZ".
MultipleAxes group
The home search sequence can be "Together", "OneAfterAnother" or
"OneAfterAnotherInReverseOrder".
NOTES
127
Programmer's Manual
EDH0373En1023 — 01/18