3156B User Manual
Programming Reference 5-50
Racal Instrument © 2005
Ri3156b_set(query)_half_cycle_mode
Description
Programs the half cycle mode. Half cycles are available for sine, triangle and square waveforms only. This
function selects the half cycle as the active mode only if the 3156B is programmed to output one of these three
waveforms. Note: The frequency, amplitude, and offset may be varied by using the following functions:
ri3156B_set_frequency()
ri3156B_set_amplitude()
ri3156B_set_offset()
You may set all half cycle wave parameters at once, by using the ri3156B_apply_half_cycle_wave() function, or
by using the individual functions.
Channel Dependency: Independent
C Syntax
ViStatus ri3156b_set_half_cycle_mode (ViSession instrHandle, ViBoolean halfCycleMode)
ViStatus ri3156b_query_half_cycle_mode (ViSession instrHandle, ViBoolean * halfCycleMode)
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.
halfCycleMode
ViBoolean This function splits sine triangle and square waveforms to
two symmetrical sections.
Valid range: 0, 1 (Off, On
Default: 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.
