VTI Instruments EX1629, User Manual

Page: 241 / 346

www.vtiinstruments.com
EX1629 Command Set 241
vtex1629_set_completion_resistor
F
UNCTION
P
ROTOTYPE
ViStatus vtex1629_set_completion_resistor (ViSession vi , ViInt32 _VI_FAR channels[] ,ViInt32
numberOfChannels , ViInt32 completionResistorMode );
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 input integer array containing a list of channel numbers for which the completion resistor
configuration will be set. Valid input values: 0 to 47.
numberOfChannels = the size of the channels list. Valid input values: 1 to 48.
completionResistorMode = an integer input value indicating the desired completion resistor mode. See Description
below for possible values. Valid input values: 0, 3, 4, 120, or 350.
D
ATA
I
TEM
R
ESET
V
ALUE
completionResistorMode = 0 (Full)
D
ESCRIPTION
This function sets the mode of the completion resistor for a list of channels. The acceptable values for the
completionResistorMode parameter are as follows:
Decimal
Value
Hex
Value
#define Symbol Resistor Mode calibratedValue
0 0x00 VTEX1629_COMPRES_FULL Full 0.0 (N/A)
3 0x03 VTEX1629_COMPRES_USER User-Defined Actual value installed, 0.0 (N/A) otherwise
4 0x04 VTEX1629_COMPRES_OFF OFF 0.0 (N/A)
120 0x78 VTEX1629_COMPRES_120 120 Ω Actual value
350 0x15E VTEX1629_COMPRES_350 350 Ω Actual value
Referring to the “Full” completion resistor is a bit of a misnomer – it really represents a short in the leg of the bridge
circuit that contains the completion resistor. It is used in Full- and Half-Bridge mode.
E
XAMPLE
ViSession instrumentHandle;
ViStatus status;
ViInt32 channels[] = {0, 1, 2, 3, 4, 5, 6, 7};
ViInt32 numberOfChannels = 8;
…
status = vtex1629_set_completion_resistor(instrumentHandle,
channels,
numberOfChannels,
VTEX1629_COMPRES_350);