3156B User Manual
Racal Instrument © 2005
Programming Reference 5-111
Ri3156b_set(query)_hop_dwell_time
Description
This selects the dwell time for frequency hops when the selected mode is Fixed dwell time hops. The dwell time
table in this case does not contain the dwell time per step parameters and therefore, the value which is
programmed with this function remains constant for the entire hop sequence.
Channel Dependency: independent
C Syntax
ViStatus ri3156b_set_hop_dwell_time (ViSession instrHandle, ViReal64 hopDwellTime)
ViStatus ri3156b_query_hop_dwell_time (ViSession instrHandle, ViReal64 * hopDwellTime)
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.
hopDwellTime
ViReal64
Programs dwell time for the fixed dwell-time frequency
hop function. The same dwell time will be valid for each
frequency hop.
NOTE
: Dwell time is programmed in units of
μ
s
(microsecond). For example, to program 1.37ms dwell
time, enter the value as follows: 1370
Valid range: 0.5 to 21e6 (
μ
s)
Default: 0.5
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.