VTI Instruments EX1629, Руководство пользователя

Страница: 139 / 346

www.vtiinstruments.com
EX1629 Command Set 139
vtex1629_get_conf_scanlist
F
UNCTION
P
ROTOTYPE
ViStatus vtex1629_get_conf_scanlist (ViSession vi , ViInt32 _VI_FAR confElements[] , ViPInt32
numConfElements );
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.
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.
D
ATA
I
TEM
R
ESET
V
ALUE
Not applicable to this function.
D
ESCRIPTION
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 iEXCITEOUT and -EXCITELOW as well.
E
XAMPLE
ViSession instrumentHandle;
ViStatus status;
ViInt32 conf[12];
ViInt32 numelements;
…
status = vtex1629_get_conf_scanlist(instrumentHandle, conf, &numelements);