3156B User Manual
Programming Reference 5-82
Racal Instrument © 2005
Ri3156b_apply_arb_waveform
Description
Programs the generator to output an arbitrary waveform. This command lets you specify segment number,
sampling clock, amplitude and offset and sets arbitrary to be the active waveform mode. You cannot use this
function to load waveforms to memory segments.
Channel Dependency: Independent
C Syntax
ViStatus ri3156b_apply_arb_waveform (ViSession instrHandle, ViInt16 segmentNumber,
ViReal64 samplingClock, ViReal64 amplitude, ViReal64 offset)
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.
segmentNumber
ViInt16
Select the segment number to become active
Valid range: 1 to 16k
Default: 1
samplingClock
ViReal64
Programs the sample clock frequency for the 3156B.
Valid range: 1 to 200e6 (S/s)
Default: 50e6
amplitude
ViReal64
Programs the amplitude for the selected function
Valid range: 10e-3 to 10 (V, into 50
Ω
)
Default:5
offset
ViReal64
Programs the offset for the selected function
Valid range: -4.995 to 4.995 (V, into 50
Ω
)
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.