NI FGEN Triggering Attributes - ni/grpc-device GitHub Wiki
- NIFGEN_ATTRIBUTE_TRIGGER_MODE
- NIFGEN_ATTRIBUTE_START_TRIGGER_TYPE
- NIFGEN_ATTRIBUTE_EXPORTED_START_TRIGGER_OUTPUT_TERMINAL
- NIFGEN_ATTRIBUTE_DIGITAL_EDGE_START_TRIGGER_SOURCE
- NIFGEN_ATTRIBUTE_DIGITAL_EDGE_START_TRIGGER_EDGE
- NIFGEN_ATTRIBUTE_P2P_ENDPOINT_FULLNESS_START_TRIGGER_LEVEL
- NIFGEN_ATTRIBUTE_SCRIPT_TRIGGER_TYPE
- NIFGEN_ATTRIBUTE_EXPORTED_SCRIPT_TRIGGER_OUTPUT_TERMINAL
- NIFGEN_ATTRIBUTE_DIGITAL_EDGE_SCRIPT_TRIGGER_SOURCE
- NIFGEN_ATTRIBUTE_DIGITAL_EDGE_SCRIPT_TRIGGER_EDGE
- NIFGEN_ATTRIBUTE_DIGITAL_LEVEL_SCRIPT_TRIGGER_SOURCE
- NIFGEN_ATTRIBUTE_DIGITAL_LEVEL_SCRIPT_TRIGGER_ACTIVE_LEVEL
Numeric Value | Data Type | Access | Applies to | Coercion | High-Level Functions |
---|---|---|---|---|---|
1150108 | ViInt32 | R/W | Channel | None | niFgen_ConfigureTriggerMode |
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
Numeric Value | Data type |
Access | Applies to | Coercion | High Level Functions |
---|---|---|---|---|---|
1150280 | ViInt32 | R/W | N/A | None | None |
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. |
Numeric Value | Data type |
Access | Applies to | Coercion | High Level Functions |
---|---|---|---|---|---|
1150283 | ViString | R/W | N/A | None | niFgen_ExportSignal |
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.
Numeric Value | Data type |
Access | Applies to | Coercion | High Level Functions |
---|---|---|---|---|---|
1150281 | ViString | R/W | N/A | None | None |
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.
Numeric Value | Data type |
Access | Applies to | Coercion | High Level Functions |
---|---|---|---|---|---|
1150282 | ViInt32 | R/W | N/A | None | None |
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. |
Numeric Value | Data Type | Access | Applies to | Coercion | High-Level Functions |
---|---|---|---|---|---|
1150410 | ViInt32 | R/W | Channel | Yes | None |
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.
Numeric Value | Data type |
Access | Applies to | Coercion | High Level Functions |
---|---|---|---|---|---|
1150290 | ViInt32 | R/W | N/A | None | None |
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. |
Numeric Value | Data type |
Access | Applies to | Coercion | High Level Functions |
---|---|---|---|---|---|
1150295 | ViString | R/W | N/A | None | niFgen_ExportSignal |
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.
Numeric Value | Data type |
Access | Applies to | Coercion | High Level Functions |
---|---|---|---|---|---|
1150291 | ViString | R/W | N/A | None | None |
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.
Numeric Value | Data type |
Access | Applies to | Coercion | High Level Functions |
---|---|---|---|---|---|
1150292 | ViInt32 | R/W | N/A | None | None |
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. |
Numeric Value | Data type |
Access | Applies to | Coercion | High Level Functions |
---|---|---|---|---|---|
1150293 | ViString | R/W | N/A | None | None |
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.
Numeric Value | Data type |
Access | Applies to | Coercion | High Level Functions |
---|---|---|---|---|---|
1150294 | ViInt32 | R/W | N/A | None | None |
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. |