VTI Instruments EX1000A, User Manual

Page: 246 / 320

VTI Instruments Corp.
246 EX10xxA/RX1032/EX1044 Function Calls
vtex10xxA_set_limit_set0
F
UNCTION
P
ROTOTYPE
ViStatus vtex10xxA_set_limit_set0(ViSession vi , ViInt32 channels[] , ViInt32 numChannels , ViReal64
lower_limit , ViReal64 upper_limit )
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.
channels = an array to receive the requested scan list. Valid input values: 0 through 47.
numChannels = an integer output value indicating how many channels are in the scan list. Valid input values: 1
through 48.
lower_limit = sets the value for the lower reading limit. The limit will be tripped if the applicable channel reading is
less than the lower reading limit. For proper operation, the limit value must be entered in the same units as the
channels with which it is associated. Valid input values: -6.6e-2 through 6.6e-2.
upper_limit = the value for the upper reading limit. The limit will be tripped if the applicable channel reading is
greater than the upper reading limit. For proper operation, the limit value must be entered in the same units as the
channels with which it is associated. Valid input values: -6.6e-2 through 6.6e-2.
D
ATA
I
TEM
R
ESET
V
ALUE
lower_limit = -6.6e-2 (for all channels) upper_limit = 6.6e-2 (for all channels)
D
ESCRIPTION
This function sets the limit set 0 values manually for the specified channels. A channel’s limit values can be set
regardless of its inclusion in the scan list, and multiple channels can be assigned to the same limit values with a
single function call. However, each unique combination of limit values must be set with a separate function call.
By default, the limit values for limit set 0 are set automatically, based on the EU conversion and units selection for
each channel. If manual limit control has been enabled with the vtex10xxA_set_limit_set0_manual function, user
defined limit values can be entered. If manual limit control is not enabled, execution of this function will not
generate an error, but the specified limit values will be ignored.
For proper operation, limit values must be entered and maintained in the same units as the channels with which they
are associated. Once entered, manual limit values are not automatically converted by subsequent changes in EU
conversion or units designations.
E
XAMPLE
// set channels 0-4 to manual limits of 0 and 100
ViInt32 e_channels[5] = { 0, 1, 2, 3, 4 };
vtex10xxA_set_limit_set0_manual(vi, e_channels, 5, 1);
vtex10xxA_set_limit_set0(vi, e_channels, 5, 0, 100);