niTuner_configAdvanceTrigger

Function Prototype

int niTuner_configAdvanceTrigger (int taskID, unsigned int signalSource, unsigned int signalType, unsigned int signalPolarity);

Purpose

This function configures the scan advance trigger input. The advance trigger tells the NI PXI-5600 downconverter to advance to the next frequency in the scan list. The ready signal is generated after the downconverter has settled to a frequency.

Parameters

Name	Type	Description
taskID	int	The Task ID obtained from niTuner_init that identifies the session of a particular device.
signalSource	unsigned int	Identifies the source of the scan advance trigger signal. Hardware triggers are RTSI lines <0..6 >. Defined Values: NITUNER_SIGNAL_SOFTWARE NITUNER_SIGNAL_RTSI0 NITUNER_SIGNAL_RTSI1 NITUNER_SIGNAL_RTSI2 NITUNER_SIGNAL_RTSI3 NITUNER_SIGNAL_RTSI4 NITUNER_SIGNAL_RTSI5 NITUNER_SIGNAL_RTSI6 Default Value: NITUNER_SIGNAL_SOFTWARE
signalType	unsigned int	Configures the RF downconverter to advance to the next frequency in the scan list when a pulse or a level signal is detected. Defined Values: NITUNER_SIGNAL_PULSE NITUNER_SIGNAL_LEVEL Default Value: NITUNER_SIGNAL_PULSE If selected, the expected pulse must be in the direction of the signalPolarity. If selected, the level (while the PXI-5600 downconverter is not expected to trigger) will be in the direction of the signalPolarity.
signalPolarity	unsigned int	Configures the PXI-5600 downconverter to advance to the next frequency in the scan list on the specified polarity change. Defined Values: NITUNER_SIGNAL_ACTIVE_LOW NITUNER_SIGNAL_ACTIVE_HIGH Default Value: NITUNER_SIGNAL_ACTIVE_LOW

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.