VTI Instruments EX1629 - Vtex1629_Get_Shunt_Source

www.vtiinstruments.com
EX1629 Command Set 185
vtex1629_get_shunt_source
FUNCTION PROTOTYPE
ViStatus vtex1629_get_shunt_source (ViSession vi, ViInt32 channel, ViPInt32 shuntSource)
FUNCTION PARAMETERS
vi = contains a session handle to the instrument. This handle is obtained by the function and remains valid until the
session is closed.
channel = an integer input value that specifies the channel for which the shunt source mode will be returned. Valid
input values: 0 to 47.
shuntSource = an integer return value that indicates the shunt source mode of the given channel. Valid return
values: 0 to 4.
DATA ITEM RESET VALUE
Not applicable to this function.
DESCRIPTION
This function queries and returns the shunt source mode for a particular channel. The shuntSource parameter
returns an integer value which correlates to the following sources:
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. “TEDS” refers to a special shunt resistor/TEDS (1-Wire) configuration. Only one channel
may be shunted via the TEDS shunt at a time.
NOTE The configuration of the shunt source and its enabling are separate operations. Thus, the return of
a shunt source using the vtex1629_get_shunt_source function does not guarantee that the shunt
source is enabled. That must be queried using the vtex1629_get_shunt_enabled function.
EXAMPLE
ViSession instrumentHandle;
ViStatus status;
ViInt32 shunt_src;
…
status = vtex1629_get_shunt_source(instrumentHandle, 0, &shunt_src);