3156B User Manual
Programming Reference 5-84
Racal Instrument © 2005
Ri3156b_define_sequence_step
Description
Sequenced waveforms are made of a number of arbitrary waveforms, which can be linked and looped in user-
programmable order. Sequenced waveforms are generated form waveforms stored in a library of memory
segments (sequence table). Before using a sequence of waveforms, load arbitrary memory with the required
waveforms. Note that this function call defines one step at a time. To define the sequence table in one shot, use
the ri3156B_load_sequence_table() function call.
Channel Dependency: Independent
C Syntax
ViStatus ri3156b_define_sequence_step (ViSession instrHandle, ViInt16 number_ofStep, ViInt16
segmentNumber, ViInt32 repeatSegment)
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.
number_ofStep
ViInt16
Selects the step (link) number to be programmed in the
sequence table.
Valid range: 1 to 4096
segmentNumber
ViInt16
Assigns a waveform segment to the selected step (link)
number.
Valid range: Valid range: 1 to 16k
repeatSegment
ViInt32
Assigns a repeat count (loops) to the selected step (link)
number.
Valid range: Valid range: 1 to 1M
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.
