Positioneranalogtrackingvelocityparametersset - Newport XPS Programmer's Manual

XPS Unified
EDH0373En1023 — 01/18
7.2.1.142

PositionerAnalogTrackingVelocityParametersSet

Name
PositionerAnalogTrackingVelocityParametersSet – Sets the parameters of tcurrent
tracking velocity mode.
Input tests
- Refer to section 7.1: "Input Tests Common to all XPS Functions".
- Checks GPIO type (ADC): (-8)
- Checks Positioner: (-8), (-18)
- Checks velocity and acceleration: (-17)
Description
This function allows modifying the GPIO name, offset, scale, deadband threshold and
the order used by analog tracking velocity mode. To use this function the group state
must be READY, otherwise error (-22) is returned.
The "velocity" and "acceleration" define the maximum velocity and acceleration used
in the velocity tracking mode.
The target tracking velocity is defined as follows:
InputValue = GPIOAnalogInput – Offset
MaxADCAmplitude = 10/GPIOAnalogGain
if (InputValue ≥0) then
InputValue = InputValue - DeadBandThreshold
if (InputValue <0) then InputValue = 0
else
InputValue = AnalogInputValue + DeadBandThreshold
if (InputValue >0) then InputValue = 0
OutputValue = (|InputValue|/MaxADCAmplitude)
TrackingVelocity = Sign(InputValue) * OutputValue * Scale * MaxADCAmplitude
The analog tracking velocity mode can be reset if the "GPIOName" parameter is
blank.
Prototype
int PositionerAnalogTrackingVelocityParametersSet(
int SocketID,
char * FullPositionerName,
char * GPIOName,
double Offset,
double Scale,
double DeadBandThreshold,
int Order,
double Velocity,
double Acceleration
)
NOTE
218
Programmer's Manual
Order