VTI Instruments EX1629 - Vtex1629_Zero_Cal

VTI Instruments Corp.
302 EX1629 Command Set
vtex1629_zero_cal
FUNCTION PROTOTYPE
ViStatus vtex1629_zero_cal (ViSession vi, ViPInt32 overRide, ViPInt32 recommendedUpTime, ViPInt32
currentUpTime);
FUNCTION PARAMETERS
vi = contains a session handle to the instrument. This handle is obtained by the function and remains valid until the
session is closed.
overRide = a returned integer value indicating the over ride value.
recommendedUpTime = an integer return value indicating the recommended amount of time, in seconds, the
EX1629 should be powered up attempting a zero calibration.
currentUpTime = an integer return value indicating the amount of time, in seconds, that the EX1629 has been
powered up.
DATA ITEM RESET VALUE
Not applicable to this function.
DESCRIPTION
This function resets the offset values of the unit before a measurement is taken. It is designed to be a shorter
calibration process than self-calibration.
The overRide parameter is used in the case where a zero calibration is attempted on a unit that has not been
powered on for a sufficient amount of time. In this special case, the first call to this function will return an error, but
will also populate this over ride variable with a unique integer value in memory. The vtex1629_self_cal_init
function can then be called a second time using this unique value. The second call to the function will successfully
initiate a self-calibration on a unit that has not been powered up for the recommended duration of time.
EXAMPLE
ViSession instrumentHandle;
ViStatus status;
ViInt32 overRide = 0;
ViInt32 recommendedUpTime = 0;
ViInt32 currentUpTime = 0;
status = vtex1629_zero_cal(instrumentHandle,
&overRide,
&recommendedUpTime,
&currentUpTime);