niTuner_setFreqScanList

Function Prototype

int niTuner_setFreqScanList (int taskID, unsigned long numFreq, double desiredRFFrequencies[], double spans[], double actualIFFrequencies[], double actualRFTunedFrequencies[], double freqShifts[]);

Purpose

This function loads and prepares a scan list of up to 720 center frequencies between 9 kHz and 2.7 GHz. When triggered, the PXI-5600 downconverter tunes to these frequencies in succession. Each frequency is associated with a span.

Note  If new center frequencies of less than 15 MHz are specified after a call to this function, attenuation is automatically adjusted. This may add an additional 20 of dB attenuation. See the attenuation page for more information.

Parameters

Name	Type	Description
taskID	int	The Task ID obtained from niTuner_init that identifies the session of a particular device.
numFreq	unsigned long	Number of frequencies (up to 720) to load into the scan list.
desiredRFFrequencies	double[]	An array of the desired frequencies between 0 MHz and 2.7 GHz to which the PXI-5600 downconverter will tune. The array size is specified by numFreq. Pass a double array at least numFreq units in length.
spans	double[]	An array of frequency spans between 0 and 20 MHz of the size specified by numFreq. A span of 20 MHz is the default. Pass a double array at least numFreq elements in length.
actualIFFrequencies	double[]	An array of the actual IF center frequencies. Each frequency will be near or equal to 15 MHz, depending on the frequency step size determined from the associated span. The size of the array is numFreq. Pass a double array at least numFreq elements in length.
actualRFTunedFrequencies	double[]	An array of the actual RF tuned frequencies. Each frequency is the adjusted actual frequency to be tuned based on the frequency step size determined by the associated span. The size of the array is numFreq. Pass a double array at least numFreq elements in length.
freqShifts	double[]	An array of the differences between the actual RF center frequencies and the actual associated IF center frequencies. The size of the array is numFreq. Pass a double array at least numFreq elements in length.

Return Value

Returns the status of the function. To see an explanation of common error and warning codes, see Error and Status Codes. To see a text explanation of the status code, call niTuner_errorHandler.