VTI Instruments EX1629 - Vtex1629_Get_Conf_Scanlist

www.vtiinstruments.com
EX1629 Command Set 139
vtex1629_get_conf_scanlist
FUNCTION PROTOTYPE
ViStatus vtex1629_get_conf_scanlist (ViSession vi, ViInt32 _VI_FAR confElements[], ViPInt32
numConfElements);
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.
confElements = a return array of integers indicating the enabled data elements in the confidence scan list. Valid
return values: 0 to 12. This array must be at least 12 elements long.
numConfElements = an integer return value indicating the size of the confElements list. Valid return values: 0 to
12.
DATA ITEM RESET VALUE
Not applicable to this function.
DESCRIPTION
This function queries and returns a list of confidence data elements that will be measured and returned along with
the main bridge data. The confidence data elements are the following:
Decimal
Value
Hex
Value
#define Symbol
confElements Description
0
0x00
VTEX1629_CONFSRC_BRIDGE_POS
Bridge (+)
1
0x01
VTEX1629_CONFSRC_BRIDGE_COMM
Bridge (common mode)
2
0x02
VTEX1629_CONFSRC_BRIDGE_NEG
Bridge (-)
3
0x03
VTEX1629_CONFSRC_EXCITE_POS
Excite (+)
4
0x04
VTEX1629_CONFSRC_EXCITE_NEG
Excite (-)
5
0x05
VTEX1629_CONFSRC_EXCITE_NEG_SENSE
Excite Sense (-)
6
0x06
VTEX1629_CONFSRC_EXCITE_POS_SENSE
Excite Sense (+)
7
0x07
VTEX1629_CONFSRC_EXCITE_POS_CURR
Excite Current (+)
8
0x08
VTEX1629_CONFSRC_EXCITE_NEG_CURR
Excite Current (-)
9
0x09
VTEX1629_CONFSRC_POS_CAL
Calibration Bus (+)
10
0x0A
VTEX1629_CONFSRC_NEG_CAL
Calibration Bus (-)
11
0x0B
VTEX1629_CONFSRC_GND
Ground
12
0x0C
VTEX1629_CONFSRC_EXCITEOUT_BUFF
Excite Out (Buffered)
NOTES 1) Confidence elements 9 through 11 are for system diagnostic use only and should not be
employed during normal operation.
2) Confidence element 12 can only be used on EX1629 with firmware version 1.0 or later.
A value of 0 for the numConfElements parameter indicates that the confidence scan list is empty. In this case, any
values in the confElements parameter are invalid.
NOTE The key restriction that MUST be enforced is that any confidence scan list that includes
+V_SENSE and -V_SENSE must also include +EXCITEOUT and -EXCITELOW as well.
EXAMPLE
ViSession instrumentHandle;
ViStatus status;
ViInt32 conf[12];
ViInt32 numelements;
…
status = vtex1629_get_conf_scanlist(instrumentHandle, conf, &numelements);