Multipleaxespvtexecution - Newport XPS Programmer's Manual

XPS Unified
7.2.1.129

MultipleAxesPVTExecution

Name
MultipleAxesPVTExecution – Executes a PVT trajectory.
Input tests
- Refer to section 7.1: "Input Tests Common to all XPS Functions".
- Checks trajectory file name length: (-3)
- Checks group type (must be a MultipleAxes group): (-8)
- Checks input value (number of executions must >0): (-17)
- Checks group name: (-19)
- Group state must be "READY": (-22)
- Checks backlash (must not be enabled): (-46)
- Checks BaseVelocity (stages.ini, must = 0): (-48)
- Checks trajectory file existence or file reading: (-61)
- Checks message queue: (-71)
Description
This function executes a PVT (Position Velocity Time) trajectory. The trajectory file
must be stored in "\Admin\Public\Trajectory" folder of XPS controller. If the trajectory
cannot be initialized (message queue or task error), error (-72) is returned.
Before the trajectory execution, it is recommended to check whether the trajectory is
within the positioner motion capabilities by using "MultipleAxesPVTVerification" and
"MultipleAxesPVTVerificationResultGet" functions.
During the trajectory execution, if a positioner reaches one of its travel limits, the
trajectory execution stops and error (-25) error is generated under positioner errors.
In case of errors (-33), (-25) and (-44) , , the group state changes to DISABLE. To
help determine the error source, check the positioner errors, the hardware status
and the driver status.
Prototype
int MultipleAxesPVTExecution(
int SocketID,
char GroupName[250],
char FileName[250],
int ExecutionNumber
)
Input parameters
SocketID
GroupName
FileName
ExecutionNumber
NOTE
int Socket identifier gets by the
"TCP_ConnectToServer" function.
char * Group name.
char * Trajectory file name.
int Number of trajectory executions.
197
Programmer's Manual
EDH0373En1023 — 01/18