VTI Instruments EX1629 - Vtex1629_Get_Cal_Coefficients

www.vtiinstruments.com
EX1629 Command Set 131
vtex1629_get_cal_coefficients
FUNCTION PROTOTYPE
ViStatus vtex1629_get_cal_coefficients (ViSession vi, ViInt32 caltype, ViInt32 coefficientSelector, ViInt32
_VI_FAR channelList[],ViInt32 numberOfChannels, ViReal64 _VI_FAR coefficientOutputArray[]);
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.
calType = file type for which to query the coefficients. Valid values are 1 through 3. See Description below for
more details.
coefficientSelector = an integer input value indicating the desired coefficient to query. Valid values are from
VTEX1629_CALSRC_0 (0x00) through VTEX1629_SUPPLY_EXCITE_OUT_POS_OFFSET (0x3F).
channelList[] = an integer array containing a list of channel numbers for which to query the coefficient. Acceptable
values for this array are VTEX1629_MIN_CHANNEL(0) to VTEX1629_MAX_CHANNEL(47), inclusive.
NOTE Since the calibration sources VTEX1629_CALSRC_0 (0x00) through
VTEX1629_CALSRC_ALL (0x13) are global across all channels, if the value of the
coefficientSelector parameter is within the aforementioned range, the API will not query the
channels listed in this channelList array.
numberOfChannels = a return integer value indicating the number of channels currently included in the scan list.
Valid return values: 1 to 48.
coefficientOutputArray[] = Return array of the queried coefficients. See the Description section below for valid
return values.
DATA ITEM RESET VALUE
Not applicable to this function.
DESCRIPTION
This function queries and returns the value of a selected calibration coefficient for one or more channels.
The calType parameter has the following valid input values:
Decimal
Value
Hex
Value
#define Symbol
Description
1
0x01
VTEX1629_CAL_DATA_SELF
Returns self-calibration data
2
0x02
VTEX1629_CAL_DATA_FACTORY
Returns factory calibration data
3
0x03
VTEX1629_CAL_DATA_COMBINED_XML
Returns factory and self-calibration data in XML
format.
If one of the above values is not defined for the calType parameter, an error of VI_ERROR_PARAMETER2 will be
returned.
The coefficientSelector parameter has the following valid input values:
Decimal
Value
Hex
Value
#define Symbol
19
0x13
VTEX1629_CALSRC_ALL
20
0x14
VTEX1629_MAIN_ADC_X1_GAIN
21
0x15
VTEX1629_MAIN_ADC_X1_OFFSET
22
0x16
VTEX1629_MAIN_ADC_X10_GAIN
23
0x17
VTEX1629_MAIN_ADC_X10_OFFSET
24
0x18
VTEX1629_MAIN_ADC_X100_GAIN
25
0x19
VTEX1629_MAIN_ADC_X100_OFFSET
26
0x1A
VTEX1629_WAGNER_VOLT
27
0x1B
VTEX1629_COMP_RESISTOR_350
28
0x1C
VTEX1629_COMP_RESISTOR_120