VTI Instruments EX1629, User Manual

Page: 281 / 346

www.vtiinstruments.com
EX1629 Command Set 281
vtex1629_set_shunt_source
F
UNCTION
P
ROTOTYPE
ViStatus vtex1629_set_shunt_source (ViSession vi , ViInt32 _VI_FAR channels[] ,ViInt32 numberOfChannels ,
ViInt32 shuntSource );
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 shunt source will be set. Valid
input values: 0 to 47.
numberOfChannels = the size of the channels list. Valid input values: 1 to 48.
shuntSource = an integer input value indicating the shunt source to be set for the given list of channels. Valid input
values: 0 to 4.
D
ATA
I
TEM
R
ESET
V
ALUE
shuntSource = VTEX1629_INTERNAL_REMOTE
D
ESCRIPTION
This function sets the shunt source for a given list of channels. The following values are valid for the shuntSource
parameter:
Decimal
Value
Hex
Value
#define Symbol shuntSource Description
0 0x00 VTEX1629_SHUNT_SOURCE_FPS_REMOTE Front panel remote
1 0x01 VTEX1629_SHUNT_SOURCE_FPS_LOCAL Front panel local
2 0x02 VTEX1629_SHUNT_SOURCE_IS_REMOTE Internal remote
3 0x03 VTEX1629_SHUNT_SOURCE_IS_LOCAL Internal local
4 0x04 VTEX1629_SHUNT_SOURCE_TEDS TEDS remote
Local and Remote refer to how the shunt resistor is connected to the bridge. For “Local”, the connection is made
within the EX1629. For “Remote”, the connection is made externally, using the ±RCal signals.
Front Panel, Internal, and TEDS, refer to the three types of shunt sources supported. “Front Panel” refers to the
shunt resistors that may be connected directly to the front panel of the EX1629, which are shared by 16 channels (0
through 15, 16 through 31, and 32 through 47). Only one channel may be connected to the Front Panel shunt at a
time. “Internal” refers to the internal, per-channel shunt resistor. Since each channel has its own, all channels may be
shunted simultaneously when configured for Internal Remote or Internal Local. “TEDS” refers to a special shunt
resistor/TEDS (1-Wire) configuration. Only one channel may be shunted via the TEDS shunt at a time.
Bridge Type TEDS FPS – Local FPS – Remote IS – Local IS – Remote TEDS/ Remote
Quarter
No X X
Yes
X X X
Half
No
X X
Yes X
Full
No X X
Yes X
NOTE
: “X” denotes legal mode of operation.
NOTE
The configuration of the shunt source and its enabling are separate operations. Thus, setting a
shunt source using the vtex1629_set_shunt_source function does not guarantee that the shunt
source is enabled. That must be set with the vtex1629_set_shunt_enabled command.