VTI Instruments EX1629, User Manual

Page: 131 / 346

www.vtiinstruments.com
EX1629 Command Set 131
vtex1629_get_cal_coefficients
F
UNCTION
P
ROTOTYPE
ViStatus vtex1629_get_cal_coefficients (ViSession vi , ViInt32 caltype , ViInt32 coefficientSelector , ViInt32
_VI_FAR channelList[] ,ViInt32 numberOfChannels , ViReal64 _VI_FAR coefficientOutputArray[] );
F
UNCTION
P
ARAMETERS
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.
D
ATA
I
TEM
R
ESET
V
ALUE
Not applicable to this function.
D
ESCRIPTION
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