VTI Instruments EX1629 - Vtex1629_Get_Euconv_Dynamic_Excitation_Enabled

www.vtiinstruments.com
EX1629 Command Set 153
vtex1629_get_euconv_dynamic_excitation_enabled
FUNCTION PROTOTYPE
ViStatus vtex1629_get_euconv_dynamic_excitation_enabled (ViSession vi, ViInt32 channel, ViPBoolean
enabled);
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 EU conversion type will be returned. Valid
input values: 0 to 47.
enabled = a Boolean return value indicating the enabled status of the excitation source. A returned value of “1”
indicates that the excitation source for the given channel is enabled.
DATA ITEM RESET VALUE
Not applicable to this function.
DESCRIPTION
This function queries and returns the dynamic excitation EU conversion state. In this mode of operation, the EX1629
uses the excitation voltage measured by the confidence ADC (in real time) in its calculations. This mode is available
for bridge sampling frequencies (f
s
) less than or equal to 1 kHz. While in this mode, it is advised to give the
confidence filters at least 1.5 s to settle, from the time the confidence source for excitation voltage is enabled or the
excitation value is changed.
The vtex1629_measure_excitation_voltage interface uses the confidence subsystem to measure the excitation
voltage. It returns these voltages to the calling function. Optionally, it can update the excitation voltage value used
for the strain EU conversion. The dynamic excitation EU conversion is slightly different. It is a mode of operation
that essentially does the same operations as vtex1629_measure_excitation_voltage, measuring the excitation voltage
using the confidence subsystem and updating the excitation voltage value used in the EU conversion in real-time.
This is a Boolean mode of operation, selectable per channel. If the user enables this mode, the set excitation voltage
EU function should return an error (users should not be able to manually set the excitation voltage EU value when in
this automatic mode). If the user queries the excitation voltage EU value, the result is the latest, real-time value.
EXAMPLE
ViSession instrumentHandle;
ViInt32 channel = 5;
ViBoolean get_enabled = VI_TRUE;
status = vtex1629_get_euconv_dynamic_excitation_enabled (instrumentHandle,
channel,
&get_enabled);