NI FGEN Triggering Attributes - ni/grpc-device GitHub Wiki

Triggering Attributes

NIFGEN_ATTRIBUTE_TRIGGER_MODE

Specific Attribute

Numeric Value Data Type Access Applies to Coercion High-Level Functions
1150108 ViInt32 R/W Channel None niFgen_ConfigureTriggerMode

Description

Controls the trigger mode.

Note:  Refer to the Trigger Modes section for your device in the NI Signal Generators Help for descriptions of the signal generator's specific behavior for supported trigger modes.

Defined Values

NIFGEN_VAL_SINGLE **Single Trigger Mode-**The waveform you describe in the sequence list is generated only once by going through the entire staging list. Only one trigger is required to start the waveform generation. You can use single trigger mode with the output mode in any mode. After a trigger is received, the waveform generation starts from the first stage and continues through to the last stage. Then, the last stage generates repeatedly until you stop the waveform generation.
NIFGEN_VAL_CONTINUOUS **Continuous Trigger Mode-**The waveform you describe in the staging list generates infinitely by repeatedly cycling through the staging list. After a trigger is received, the waveform generation starts from the first stage and continues through to the last stage. After the last stage completes, the waveform generation loops back to the start of the first stage and continues until it is stopped. Only one trigger is required to start the waveform generation.
NIFGEN_VAL_STEPPED **Stepped Trigger Mode-**After a Start Trigger is received, the waveform described by the first stage generates. Then, the device waits for the next trigger signal. On the next trigger, the waveform described by the second stage generates, and so on. After the staging list completes, the waveform generation returns to the first stage and continues in a cyclic fashion. After any stage has generated completely, the first eight samples of the next stage are repeated continuously until the next trigger is received.

Note: In frequency list mode, stepped trigger mode is the same as burst trigger mode.
NIFGEN_VAL_BURST **Burst Trigger Mode-**After a Start Trigger is received, the waveform described by the first stage generates until another trigger is received. At the next trigger, the buffer of the previous stage completes, and then the waveform described by the second stage generates. After the staging list completes, the waveform generation returns to the first stage and continues in a cyclic fashion. In frequency list mode, the duration instruction is ignored, and the trigger switches the frequency to the next frequency in the list.

Note: In frequency list mode, stepped trigger mode is the same a burst trigger mode.

Default Value: NIFGEN_VAL_CONTINUOUS

NIFGEN_ATTRIBUTE_START_TRIGGER_TYPE

Specific Attribute

Numeric Value Data
type
Access Applies to Coercion High Level Functions
1150280 ViInt32 R/W N/A None None

Description

Specifies the type of Start trigger you want to use. You can also choose NIFGEN_VAL_TRIG_NONE as the value for this attribute.

Defined Values:

NIFGEN_VAL_TRIG_NONE No trigger is configured. Signal generation starts immediately.
NIFGEN_VAL_DIGITAL_EDGE Operation begins when a digital edge is detected.
NIFGEN_VAL_SOFTWARE_EDGE Operation begins when a software edge is detected.
NIFGEN_VAL_P2P_ENDPOINT_FULLNESS Operation begins when the FIFO reaches a threshold specified in the NIFGEN_ATTRIBUTE_P2P_ENDPOINT_FULLNESS_START_TRIGGER_LEVEL.

NIFGEN_ATTRIBUTE_EXPORTED_START_TRIGGER_OUTPUT_TERMINAL

Specific Attribute

Numeric Value Data
type
Access Applies to Coercion High Level Functions
1150283 ViString R/W N/A None niFgen_ExportSignal

Description

Specifies the destination terminal for exporting the Start trigger. For a list of the terminals available on your device, refer to the Routes topic for your device or the Device Routes tab in MAX.

NIFGEN_ATTRIBUTE_DIGITAL_EDGE_START_TRIGGER_SOURCE

Specific Attribute

Numeric Value Data
type
Access Applies to Coercion High Level Functions
1150281 ViString R/W N/A None None

Description

Specifies the source terminal for the Start trigger. This attribute is used only when the NIFGEN_ATTRIBUTE_START_TRIGGER_TYPE attribute is set to NIFGEN_VAL_DIGITAL_EDGE.

You can specify any valid source terminal for this property. Refer to the Routes topic for your device or the the Device Routes tab in MAX for a list of valid sources.

Source terminals can be specified in two ways. If your device is named Dev1 and your terminal is PFI 0, the terminal can be specified as a fully qualified terminal name, /Dev1/PFI0. You can also specify the terminal using PFI 0.

NIFGEN_ATTRIBUTE_DIGITAL_EDGE_START_TRIGGER_EDGE

Specific Attribute

Numeric Value Data
type
Access Applies to Coercion High Level Functions
1150282 ViInt32 R/W N/A None None

Description

Specifies the active edge for the Start trigger. This attribute is used only when the NIFGEN_ATTRIBUTE_START_TRIGGER_TYPE attribute is set to NIFGEN_VAL_DIGITAL_EDGE.

Defined Values

NIFGEN_VAL_RISING_EDGE Occurs when the signal transitions from low level to high level.
NIFGEN_VAL_FALLING_EDGE Occurs when the signal transitions from high level to low level.

NIFGEN_ATTRIBUTE_P2P_ENDPOINT_FULLNESS_START_TRIGGER_LEVEL

Specific Attribute

Numeric Value Data Type Access Applies to Coercion High-Level Functions
1150410 ViInt32 R/W Channel Yes None

Description

Specifies the number of samples the endpoint needs to receive before the signal generator starts generation. This attribute only applies when the NIFGEN_ATTRIBUTE_START_TRIGGER_TYPE attribute is set to NIFGEN_VAL_P2P_ENDPOINT_FULLNESS. Refer to the Flow Control topic in the NI Signal Generators Help for more information about peer-to-peer operations. This attribute is coerced down to 8-byte boundaries.

Note:  Due to an additional internal FIFO in the signal generator, the writer peer actually must write 2,304 bytes more than the quantity of data specified by this attribute to satisfy the trigger level.

NIFGEN_ATTRIBUTE_SCRIPT_TRIGGER_TYPE

Specific Attribute

Numeric Value Data
type
Access Applies to Coercion High Level Functions
1150290 ViInt32 R/W N/A None None

Description

Specifies the Script trigger type. Depending upon the value of this attribute, additional attributes may be needed to fully configure the trigger.

Defined Values:

NIFGEN_VAL_TRIG_NONE No trigger is configured. Signal generation starts immediately.
NIFGEN_VAL_DIGITAL_EDGE Trigger is asserted when a digital edge is detected.
NIFGEN_VAL_DIGITAL_LEVEL Trigger is asserted when a digital level is detected.
NIFGEN_VAL_SOFTWARE_EDGE Trigger is asserted when a software edge is detected.

NIFGEN_ATTRIBUTE_EXPORTED_SCRIPT_TRIGGER_OUTPUT_TERMINAL

Specific Attribute

Numeric Value Data
type
Access Applies to Coercion High Level Functions
1150295 ViString R/W N/A None niFgen_ExportSignal

Description

Specifies the output terminal for the exported Script trigger. Setting this attribute to an empty string means that when you commit the session, the signal is removed from that terminal and, if possible, the terminal is tristated. For a list of the terminals available on your device, refer to the Routes topic for your device or the Device Routes tab in MAX.

NIFGEN_ATTRIBUTE_DIGITAL_EDGE_SCRIPT_TRIGGER_SOURCE

Specific Attribute

Numeric Value Data
type
Access Applies to Coercion High Level Functions
1150291 ViString R/W N/A None None

Description

Specifies the source terminal for the Script trigger. This attribute is used when the NIFGEN_ATTRIBUTE_SCRIPT_TRIGGER_TYPE attribute is set to NIFGEN_VAL_DIGITAL_EDGE.

NIFGEN_ATTRIBUTE_DIGITAL_EDGE_SCRIPT_TRIGGER_EDGE

Specific Attribute

Numeric Value Data
type
Access Applies to Coercion High Level Functions
1150292 ViInt32 R/W N/A None None

Description

Specifies the active edge for the Script trigger. This attribute is used when the NIFGEN_ATTRIBUTE_SCRIPT_TRIGGER_TYPE attribute is set to NIFGEN_VAL_DIGITAL_EDGE.

Defined Values

NIFGEN_VAL_RISING_EDGE Occurs when the signal transitions from low level to high level.
NIFGEN_VAL_FALLING_EDGE Occurs when the signal transitions from high level to low level.

NIFGEN_ATTRIBUTE_DIGITAL_LEVEL_SCRIPT_TRIGGER_SOURCE

Specific Attribute

Numeric Value Data
type
Access Applies to Coercion High Level Functions
1150293 ViString R/W N/A None None

Description

Specifies the source terminal for the Script trigger. This attribute is used when the NIFGEN_ATTRIBUTE_SCRIPT_TRIGGER_TYPE attribute is set to NIFGEN_VAL_DIGITAL_LEVEL.

NIFGEN_ATTRIBUTE_DIGITAL_LEVEL_SCRIPT_TRIGGER_ACTIVE_LEVEL

Specific Attribute

Numeric Value Data
type
Access Applies to Coercion High Level Functions
1150294 ViInt32 R/W N/A None None

Description

Specifies the active level for the Script trigger. This attribute is used when the NIFGEN_ATTRIBUTE_SCRIPT_TRIGGER_TYPE attribute is set to NIFGEN_VAL_DIGITAL_LEVEL.

Defined Values

NIFGEN_VAL_ACTIVE_HIGH The high level is the active level.
NIFGEN_VAL_ACTIVE_LOW The low level is the active level.
⚠️ **GitHub.com Fallback** ⚠️