3156B User Manual
Programming Reference 5-20
Racal Instrument © 2005
ri3156b_set(query)_output
Description
This activates a relay that connects the output connector to the output circuit. Set Enable ON is required to start
generating waveforms. The active channel is selected from the Set Active Channel panel. Channel
Dependency: Independent
C Syntax
ViStatus ri3156b_set_output (ViSession instrHandle, ViBoolean outputSwitch)
ViStatus ri3156b_query_output (ViSession instrHandle, ViBoolean * outputSwitch)
Parameters
Name
Variable
Type
Description
instrHandle
ViSession
The Instrument Handle is used to identify the unique
session or communication channel between the driver
and the instrument. If more than one instrument of the
model type is used, this will be used to differentiate
between them. Note that the initialize function may be
used to associate multiple instrument handles with a
single instrument.
outputSwitch
ViBoolean This function activates a mechanical switch (relay) that
connects or disconnects the output connector to or from
the electrical circuit. In the OFF mode, the inner side of
the output connector is floating, thus representing high
impedance to the external device. In the ON position, the
output is driven from a 50
Ω
source. This function alone
will not cause the output to generate signals but must be
applied to have the signal path routed to the output
connector. Each channel has its own switch and
therefore each channel switch must be turned on
separately. Signal is generated at the output connector
only after an enable command is set true, in continuous
mode or a valid trigger signal is applied, in one of the
interrupted modes.
Valid Range: 0, 1 (Off, On)
Default Value: 0
Return Values
Displays the return status of the function call. If the function was successful, it will return a status of
VI_SUCCESS, otherwise it will return an error code. Passing the error code into the function
"ri3156B_error_message()" will return a string describing the error.
