3156B User Manual
Programming Reference 5-48
Racal Instrument © 2005
Ri3156b_set(query)_square_wave_duty_cycle
Description
Programs only the duty cycle of the standard square wave. This function does NOT select the square wave as
the active waveform. 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 square wave parameters at once, by using the ri3156B_apply_square_wave() function, or by
using the individual functions.
Channel Dependency: Independent
C Syntax
ViStatus ri3156b_set_square_wave_duty_cycle (ViSession instrHandle, ViReal64 dutyCycle)
ViStatus ri3156b_query_square_wave_duty_cycle (ViSession instrHandle, ViReal64 * dutyCycle)
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.
dutyCycle
ViReal64
Selects the duty cycle of the square wave.
Valid range: 0 to 99.99 (%)
Default: 50
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.
