XPS Unified Programmer’s Manual
7.2.1.275 PositionerPositionCompareGet
Name
PositionerPositionCompareGet – Gets the position compare parameters.
Input tests
- Refer to section 7.1: “Input Tests Common to all XPS Functions”.
- Checks the positioner (must not be a secondary positioner): (-8)
- Checks the position compare parameters (must be configured): (-23)
- Checks the configured mode type (must be PositionCompare): (-24)
Description
This function returns the real value (without correction) of parameters of the position
compare output trigger and returns current state (enabled or disabled).
For a more thorough description of the position compare output, please refer to the XPS
Motion Tutorial section Triggers/Position Compare Output.
Prototype
int PositionerPositionCompareGet(
int SocketID,
char * FullPositionerName,
double * MinimumPosition,
double * MaximumPosition,
double * PositionStep,
bool * EnableState
)
Input parameters
SocketID int Socket identifier gets b the
“TCP_ConnectToServer” function.
FullPositionerName char * Positioner name.
Output parameters
MinimumPosition double * Minimum position (units).
MaximumPosition double * Maximum position (units).
PositionStep double * Position step (units).
EnableState bool * Position compare state (true = enabled or
false = disabled).
Return (In addition to the results of “Input Tests Common to all XPS
Functions”)
• 0: No error.
• -8: Wrong object type for this command.
• -23: Position compare not set.
• -24: Not available in this configuration (check hardware or configuration).
EDH0373En1023 — 01/18 414