Agilent Technologies VXI E1439 - Manual (Page 147)

137
Agilent E1439 Programmer's Reference
Functions listed alphabetically
age1439_input_range_auto
Performs auto-ranging.
VXIplug&play Syntax
#include "age1439".h
ViStatus age1439_input_range_auto(ViSession id, ViReal64 sec);
Description
age1439_input_range_auto sets the range of a Agilent E1439 to the lowest value that does not
cause an ADC overload to occur. The algorithm starts at the lowest range and moves up until there
is no ADC overload.
Note
The baseband signalPath cannot be auto-ranged because it has only one range (-21 dBm).
Note
Calling this function deletes any saved state and halts any measurement or fiber transfer.
Parameters
id is the VXI instrument session pointer returned by the age1439_init function.
sec is the time in seconds to take data at each range to insure that an overload is detected. Setting this
parameter to 0.0 results in the time being set automatically according to an algorithm that depends
on block size and filter bandwidth.
AGE1439_RANGE_TIME_MIN selects the minimum autorange time.
AGE1439_RANGE_TIME_MAX selects the maximum autorange time.
Return Value
AGE1439_SUCCESS indicates that a function was successful.
Values other than AGE1439_SUCCESS indicate an error condition or other important status
condition. To determine the error message, pass the return value to
“age1439_error_message” on
page 102 .
See Also
“Commands which halt active measurements” on page 198 , “age1439_init” on page 132 ,
“age1439_input_setup” on page 141