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

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

www.vtiinstruments.com
EX1629 Command Set 243
vtex1629_set_confidence_limit
F
UNCTION
P
ROTOTYPE
ViStatus vtex1629_set_confidence_limit (ViSession vi , ViInt32 confSrcEnum , ViInt32 numberOfChannels ,
ViInt32 _VI_FAR channelsArray[] , ViReal64 _VI_FAR min[] , ViReal64 _VI_FAR max[] );
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.
confSrcEnum = confidence source for which to set the minimum and maximum limits. Valid input values: 0 to 12.
numberOfChannels = a return integer value indicating the number of channels currently included in the scan list.
Valid return values: 1 to 48.
channelsArray[] = the size of the confElements list. Valid input values: 0 to 12.
min[] = an array of minimum confidence limit values.
max[] = an array of minimum confidence limit values.
D
ATA
I
TEM
R
ESET
V
ALUE
min[] = -infinity (in floating point) max[] = +infinity (in floating point)
D
ESCRIPTION
This function sets the minimum and maximum values for confidence data limit checking. Confidence limit checking
mode is only valid for main bridge sampling frequencies less than 1 kHz. Returned values in the datapage
correspond to the confidence channels for channels in the active scanlist. There exists a confidence limit check result
summary field (shown in the diagram below) which indicates if any of the limits on all active confidence sources for
a particular channel were exceeded or not. This is a 16-bit field, stored in the least-significant 16 bits of a UINT32
variable.
0 = Confidence Data within Limits
1 = Confidence Data Limit
exceeded for CH 15
0 = Confidence Data
within Limits
1 = Confidence Data
Limit exceeded for CH 0
31 0 15
MSW
(Unused)
LSW
(Confidence Limit exceeded status)
Confidence Limit Check Result summary (Available per Analog Board)
A detailed confidence limit check result (shown in the diagram below) is also available which returns two bits per
channel per confidence source – that is, MAX Limit Exceeded and MIN Limit Exceeded, per channel, per
confidence source. There is one UINT32 entry per bridge channel in the bridge scanlist. This UINT32 has two bits
per confidence source (CONF_NUM_SRC sources per bridge channel), one to represent MAX limit exceeded and
one to represent MIN limit exceeded. The MSW (lower CONF_NUM_SRC of the upper 16-bits) represent the MAX
Limit Exceeded status for each of the CONF_NUM_SRC confidence sources, and the LSW (lower
CONF_NUM_SRC bits of the lower 16-bits) represent the MIN Limit Exceeded status for each of the
CONF_NUM_SRC confidence sources. Bit 0 represents the MIN Limit Exceeded status for source 0. Bit 16
represents the MAX Limit Exceeded status for source 0. Bit (CONF_NUM_SRC-1) represents the MIN Limit
Exceeded status for source (CONF_NUM_SRC-1). Bit (16+CONF_NUM_SRC-1) represents the MAX Limit
Exceeded status for source CONF_NUM_SRC. The rest of the sources follow the same pattern.