Vtex1629_Set_Conf_Scanlist - VTI Instruments EX1629 User Manual

VTI Instruments Corp.
F P
UNCTION ROTOTYPE
ViStatus vtex1629_set_conf_scanlist (ViSession vi, ViInt32 _VI_FAR confElements[],ViInt32
numConfElements);
F P
UNCTION 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 = an integer input array indicating which confidence data elements will be measured. Valid input
values: 0 to 12.
numConfElements = the size of the confElements list. Valid input values: 0 to 12.
D I R V
ATA TEM ESET ALUE
confElements = None
D
ESCRIPTION
This function sets the 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 Hex
Value Value
0 0x00 VTEX1629_CONFSRC_BRIDGE_POS
1 0x01 VTEX1629_CONFSRC_BRIDGE_COMM
2 0x02 VTEX1629_CONFSRC_BRIDGE_NEG
3 0x03 VTEX1629_CONFSRC_EXCITE_POS
4 0x04 VTEX1629_CONFSRC_EXCITE_NEG
5 0x05 VTEX1629_CONFSRC_EXCITE_NEG_SENSE
6 0x06 VTEX1629_CONFSRC_EXCITE_POS_SENSE
7 0x07 VTEX1629_CONFSRC_EXCITE_POS_CURR
8 0x08 VTEX1629_CONFSRC_EXCITE_NEG_CURR
9 0x09 VTEX1629_CONFSRC_POS_CAL
10 0x0A VTEX1629_CONFSRC_NEG_CAL
11 0x0B VTEX1629_CONFSRC_GND
12 0x0C VTEX1629_CONFSRC_EXCITEOUT_BUFF
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.
In order to clear the confidence scan list, a value of 0 should be set for the numConfElements parameter. In this
case, the value of the confElements parameter is arbitrary.
NOTE The confidence data is filtered by a transfer function represented by the following differential
equation: y(n) = 0.01x(n) + 0.99y(n-1), where y(n) is the filtered confidence data and x(n) is the
measured confidence data. This function serves to reduce noise variance.
E
XAMPLE
ViSession instrumentHandle;
ViStatus status;
ViInt32 confchannels[] = {3, 4, 5, 6};
ViInt32 numberOfChannels = 4;
...
status = vtex1629_set_conf_scanlist (instrumentHandle,
242

vtex1629_set_conf_scanlist

#define Symbol
confchannels,
numberOfChannels);
confElements Description
Bridge (+)
Bridge (common mode)
Bridge (-)
Excite (+)
Excite (-)
Excite Sense (-)
Excite Sense (+)
Excite Current (+)
Excite Current (-)
Calibration Bus (+)
Calibration Bus (-)
Ground
Excite Out (Buffered)
EX1629 Command Set