niFgen_ConfigureTriggerSource

NI-FGEN C Function

[OBSOLETE] niFgen_ConfigureTriggerSource

ViStatus niFgen_ConfigureTriggerSource (ViSession vi, ViConstString channelName, ViInt32 triggerSource);

Purpose

Configures the trigger source. The signal generator responds to a trigger depending on the operation mode in which the signal generator is operating.

Note   The signal generator must not be in the Generating state when you call this function.

Parameters

Input
Name Type Description
vi ViSession Identifies your instrument session. vi is obtained from the niFgen_init or the niFgen_InitWithOptions functions and identifies a particular instrument session.
channelName ViConstString Specifies the channel name for which you want to configure the trigger source.

Defined Value:"0"

triggerSource ViInt32 Controls which trigger source the signal generator uses.

Defined Values

NIFGEN_VAL_IMMEDIATE Immediate
NIFGEN_VAL_EXTERNAL External (maps to PFI 0)
NIFGEN_VAL_SOFTWARE_TRIG Software trigger
NIFGEN_VAL_PXI_STAR PXI Star
NIFGEN_VAL_RTSI_0 RTSI 0 or PXI_Trig 0
NIFGEN_VAL_RTSI_1 RTSI 1 or PXI_Trig 1
NIFGEN_VAL_RTSI_2 RTSI 2 or PXI_Trig 2
NIFGEN_VAL_RTSI_3 RTSI 3 or PXI_Trig 3
NIFGEN_VAL_RTSI_4 RTSI 4 or PXI_Trig 4
NIFGEN_VAL_RTSI_5 RTSI 5 or PXI_Trig 5
NIFGEN_VAL_RTSI_6 RTSI 6 or PXI_Trig 6
NIFGEN_VAL_RTSI_7 RTSI 7 or PXI_Trig 7
NIFGEN_VAL_TTL0 TTL 0
NIFGEN_VAL_TTL1 TTL 1
NIFGEN_VAL_TTL2 TTL 2
NIFGEN_VAL_TTL3 TTL 3
NIFGEN_VAL_TTL4 TTL 4
NIFGEN_VAL_TTL5 TTL 5
NIFGEN_VAL_TTL6 TTL 6
NIFGEN_VAL_PFI_0 PFI 0
NIFGEN_VAL_PFI_1 PFI 1
NIFGEN_VAL_PFI_2 PFI 2
NIFGEN_VAL_PFI_3 PFI 3

Default Value: NIFGEN_VAL_IMMEDIATE

Return Value

Name Type Description
Status ViStatus Returns the status code of this operation. The status code either indicates success or describes an error or warning condition. You can examine the status code from each call to an NI-FGEN function to determine if an error occurred. To obtain a text description of the status code, call the niFgen_error_message function. To obtain additional information about the error condition, call the niFgen_GetError function. To clear the error information from NI-FGEN, call the niFgen_ClearError function.

The general meaning of the status code is as follows:

Value Meaning
0 Success
Positive Values Warnings
Negative Values Errors