NI SCOPE Trigger Attributes - ni/grpc-device GitHub Wiki
- NISCOPE_ATTRIBUTE_TRIGGER_TYPE
- NISCOPE_ATTRIBUTE_TRIGGER_SOURCE
- NISCOPE_ATTRIBUTE_END_OF_RECORD_TO_ADVANCE_TRIGGER_HOLDOFF
- NISCOPE_ATTRIBUTE_EXPORTED_REF_TRIGGER_OUTPUT_TERMINAL
- NISCOPE_ATTRIBUTE_REF_TRIGGER_TERMINAL_NAME
- NISCOPE_ATTRIBUTE_TRIGGER_LEVEL
- NISCOPE_ATTRIBUTE_TRIGGER_MODIFIER
- NISCOPE_ATTRIBUTE_TRIGGER_AUTO_TRIGGERED
- NISCOPE_ATTRIBUTE_TRIGGER_HYSTERESIS
- NISCOPE_ATTRIBUTE_TRIGGER_DELAY_TIME
- NISCOPE_ATTRIBUTE_TRIGGER_HOLDOFF
- NISCOPE_ATTRIBUTE_TRIGGER_SLOPE
- NISCOPE_ATTRIBUTE_TRIGGER_COUPLING
- NISCOPE_ATTRIBUTE_TRIGGER_IMPEDANCE
- NISCOPE_ATTRIBUTE_START_TO_REF_TRIGGER_HOLDOFF
- NISCOPE_ATTRIBUTE_GLITCH_CONDITION
- NISCOPE_ATTRIBUTE_GLITCH_POLARITY
- NISCOPE_ATTRIBUTE_GLITCH_WIDTH
- NISCOPE_ATTRIBUTE_RUNT_HIGH_THRESHOLD
- NISCOPE_ATTRIBUTE_RUNT_LOW_THRESHOLD
- NISCOPE_ATTRIBUTE_RUNT_POLARITY
- NISCOPE_ATTRIBUTE_RUNT_TIME_CONDITION
- NISCOPE_ATTRIBUTE_RUNT_TIME_HIGH_LIMIT
- NISCOPE_ATTRIBUTE_RUNT_TIME_LOW_LIMIT
- NISCOPE_ATTRIBUTE_WIDTH_CONDITION
- NISCOPE_ATTRIBUTE_WIDTH_HIGH_THRESHOLD
- NISCOPE_ATTRIBUTE_WIDTH_LOW_THRESHOLD
- NISCOPE_ATTRIBUTE_WIDTH_POLARITY
- NISCOPE_ATTRIBUTE_TRIGGER_WINDOW_MODE
- NISCOPE_ATTRIBUTE_TRIGGER_WINDOW_LOW_LEVEL
- NISCOPE_ATTRIBUTE_TRIGGER_WINDOW_HIGH_LEVEL
- NISCOPE_ATTRIBUTE_TV_TRIGGER_SIGNAL_FORMAT
- NISCOPE_ATTRIBUTE_TV_TRIGGER_LINE_NUMBER
- NISCOPE_ATTRIBUTE_TV_TRIGGER_POLARITY
- NISCOPE_ATTRIBUTE_TV_TRIGGER_EVENT
- NISCOPE_ATTRIBUTE_ENABLE_DC_RESTORE
- NISCOPE_ATTRIBUTE_REF_TRIGGER_DETECTOR_LOCATION
- NISCOPE_ATTRIBUTE_REF_TRIGGER_MINIMUM_QUIET_TIME
Data type |
Access | Applies to | Coercion | High Level Functions |
---|---|---|---|---|
ViInt32 | R/W | N/A | None | None |
Specifies the type of trigger to use.
NISCOPE_VAL_DIGITAL_TRIGGER
NISCOPE_VAL_EDGE_TRIGGER
NISCOPE_VAL_GLITCH_TRIGGER
NISCOPE_VAL_HYSTERESIS_TRIGGER
NISCOPE_VAL_IMMEDIATE_TRIGGER
NISCOPE_VAL_RUNT_TRIGGER
NISCOPE_VAL_SOFTWARE_TRIGGER
NISCOPE_VAL_TV_TRIGGER
NISCOPE_VAL_WIDTH_TRIGGER
NISCOPE_VAL_WINDOW_TRIGGER
- Trigger Types
Data type |
Access | Applies to | Coercion | High Level Functions |
---|---|---|---|---|
ViString | R/W | N/A | None | niScope_ConfigureTriggerDigital niScope_ConfigureTriggerEdge niScope_ConfigureTriggerGlitch niScope_ConfigureTriggerHysteresis niScope_ConfigureTriggerRunt niScope_ConfigureTriggerVideo niScope_ConfigureTriggerWidth niScope_ConfigureTriggerWindow |
Specifies the source the digitizer monitors for the trigger event. Trigger sources vary for each digitizer model.
"0"
"1"
"2"
"3"
"4"
"5"
"6"
"7"
NISCOPE_VAL_IMMEDIATE ("VAL_IMMEDIATE")
NISCOPE_VAL_EXTERNAL ("VAL_EXTERNAL")
NISCOPE_VAL_SW_TRIG_FUNC ("VAL_SW_TRIG_FUNC")
NISCOPE_VAL_RTSI_0 ("VAL_RTSI_0")
NISCOPE_VAL_RTSI_1 ("VAL_RTSI_1")
NISCOPE_VAL_RTSI_2 ("VAL_RTSI_2")
NISCOPE_VAL_RTSI_3 ("VAL_RTSI_3")
NISCOPE_VAL_RTSI_4 ("VAL_RTSI_4")
NISCOPE_VAL_RTSI_5 ("VAL_RTSI_5")
NISCOPE_VAL_RTSI_6 ("VAL_RTSI_6")
NISCOPE_VAL_PFI_0 ("VAL_PFI_0")
NISCOPE_VAL_PFI_1 ("VAL_PFI_1")
NISCOPE_VAL_PFI_2 ("VAL_PFI_2")
NISCOPE_VAL_PFI_3 ("VAL_PFI_3")
NISCOPE_VAL_PFI_4 ("VAL_PFI_4")
NISCOPE_VAL_PFI_5 ("VAL_PFI_5")
NISCOPE_VAL_PFI_6 ("VAL_PFI_6")
NISCOPE_VAL_PFI_7 ("VAL_PFI_7")
NISCOPE_VAL_PXI_STAR ("VAL_PXI_STAR")
- Trigger Types
Data type |
Access | Applies to | Coercion | High Level Functions |
---|---|---|---|---|
ViReal64 | R/W | N/A | None | None |
Specifies the adjustable period of time between records that allows for fetching data from the digitizer during a multi-record acquisition. This attribute disables sampling and triggering.
![]() |
Note This attribute is only valid for the NI 5185/5186. |
---|
- Record Advance Holdoff
Data type | Access | Applies to | Coercion | High Level Functions |
---|---|---|---|---|
ViString | R/W | N/A | None | None |
Specifies the destination export for the Reference (Stop) trigger. Refer to the device specifications document for a list of valid destinations.
NISCOPE_VAL_RTSI_0 | ("VAL_RTSI_0") |
---|---|
NISCOPE_VAL_RTSI_1 | ("VAL_RTSI_1") |
NISCOPE_VAL_RTSI_2 | ("VAL_RTSI_2") |
NISCOPE_VAL_RTSI_3 | ("VAL_RTSI_3") |
NISCOPE_VAL_RTSI_4 | ("VAL_RTSI_4") |
NISCOPE_VAL_RTSI_5 | ("VAL_RTSI_5") |
NISCOPE_VAL_RTSI_6 | ("VAL_RTSI_6") |
NISCOPE_VAL_PFI_0 | ("VAL_PFI_0") |
NISCOPE_VAL_PFI_1 | ("VAL_PFI_1") |
NISCOPE_VAL_PFI_2 | ("VAL_PFI_2") |
NISCOPE_VAL_PFI_3 | ("VAL_PFI_3") |
NISCOPE_VAL_PFI_4 | ("VAL_PFI_4") |
NISCOPE_VAL_PFI_5 | ("VAL_PFI_5") |
NISCOPE_VAL_PFI_6 | ("VAL_PFI_6") |
NISCOPE_VAL_PFI_7 | ("VAL_PFI_7") |
NISCOPE_VAL_PXI_STAR | ("VAL_PXI_STAR") |
Data type |
Access | Applies to | Coercion | High Level Functions |
---|---|---|---|---|
ViString | R | N/A | None | N/A |
Returns the fully qualified name for the Reference Trigger terminal.
You can use this terminal as the source for a trigger.
Data type |
Access | Applies to | Coercion | High Level Functions |
---|---|---|---|---|
ViReal64 | R/W | N/A | None | niScope_ConfigureTriggerEdge niScope_ConfigureTriggerGlitch niScope_ConfigureTriggerHysteresis niScope_ConfigureTriggerWidth |
Specifies the voltage threshold for the trigger subsystem in volts. This attribute affects instrument behavior only when the NISCOPE_ATTRIBUTE_TRIGGER_TYPE is set to NISCOPE_VAL_EDGE, NISCOPE_VAL_HYSTERESIS, or NISCOPE_VAL_WINDOW.
Valid Values: The values of the range and offset parameters in niScope_ConfigureVertical determine the valid range for the trigger level on the channel you use as the Trigger Source. The value you pass for this parameter must meet the following conditions:
Trigger Level <= (Vertical Range/2) + Vertical Offset
Vertical Range >= (–Vertical Range/2) + Vertical Offset
- Edge Triggers
- Window Triggers
Data type |
Access | Applies to | Coercion | High Level Functions |
---|---|---|---|---|
ViInt32 | R/W | N/A | None | None |
Configures whether the device automatically completes an acquisition if a trigger is not received after a period of time.
![]() |
Note When NISCOPE_VAL_AUTO is selected, you may need to modify the timeout on calls to fetch data to ensure that the acquisition does not time out before the auto trigger time elapses. |
---|
NISCOPE_VAL_NO_TRIGGER_MOD (1)
NISCOPE_VAL_AUTO (2)
Data type |
Access | Applies to | Coercion | High Level Functions |
---|---|---|---|---|
ViBoolean | RO | N/A | None | None |
Specifies whether the acquisition was triggered automatically. Auto triggering occurs if the Trigger Modifier property is set to Auto Trigger and no trigger has been received for a certain amount of time.
TRUE
FALSE
Data type |
Access | Applies to | Coercion | High Level Functions |
---|---|---|---|---|
ViReal64 | R/W | N/A | None | None |
Specifies, in volts, the size of the hysteresis window on either side of the trigger level. The digitizer triggers when the trigger signal passes through the threshold you specify with the level control, has the slope you specify with the slope control, and passes through the hysteresis window that you specify with this attribute.
Valid Values
Positive trigger slope | 0 ≤ Hysteresis ≤ Trigger Level + (Vertical Range / 2) - Vertical Offset |
---|---|
Negative trigger slope | 0 ≤ Hysteresis ≤ (Vertical Range / 2) + Vertical Offset - Trigger Level |
- Hysteresis Triggers
Data type |
Access | Applies to | Coercion | High Level Functions |
---|---|---|---|---|
ViReal64 | R/W | N/A | None | niScope_ConfigureTriggerDigital niScope_ConfigureTriggerEdge niScope_ConfigureTriggerGlitch niScope_ConfigureTriggerHysteresis niScope_ConfigureTriggerRunt ConfigureTriggerSoftware ConfigureTriggerVideo ConfigureTriggerWidth ConfigureTriggerWindow |
Specifies the trigger delay time in seconds. The trigger delay time is the length of time the digitizer waits after receiving the trigger. The event that occurs when the trigger delay elapses is the Reference Event.
Data type |
Access | Applies to | Coercion | High Level Functions |
---|---|---|---|---|
ViReal64 | R/W | N/A | None | niScope_ConfigureTriggerDigital niScope_ConfigureTriggerEdge niScope_ConfigureTriggerGlitch niScope_ConfigureTriggerHysteresis niScope_ConfigureTriggerRunt ConfigureTriggerSoftware ConfigureTriggerVideo ConfigureTriggerWidth ConfigureTriggerWindow |
Specifies the length of time (in seconds) the digitizer waits after detecting a trigger before enabling the trigger subsystem to detect another trigger. This attribute affects instrument operation only when the digitizer requires multiple acquisitions to build a complete waveform. The digitizer requires multiple waveform acquisitions when it uses equivalent-time sampling or when the digitizer is configured for a multirecord acquisition through a call to niScope_ConfigureHorizontalTiming.
Valid Values: 0.0 – 171.8
- Trigger Holdoff
- Trigger Parameters
Data type |
Access | Applies to | Coercion | High Level Functions |
---|---|---|---|---|
ViInt32 | R/W | N/A | None | niScope_ConfigureTriggerDigital niScope_ConfigureTriggerEdge niScope_ConfigureTriggerHysteresis |
Specifies whether rising or a falling edge triggers the digitizer. This attribute affects instrument operation only when NISCOPE_ATTRIBUTE_TRIGGER_TYPE is set to NISCOPE_VAL_EDGE_TRIGGER, NISCOPE_VAL_HYSTERESIS_TRIGGER, or NISCOPE_VAL_DIGITAL_TRIGGER.
NISCOPE_VAL_POSITIVE
NISCOPE_VAL_NEGATIVE
- Edge Triggers
- Window Triggers
Data type |
Access | Applies to | Coercion | High Level Functions |
---|---|---|---|---|
ViInt32 | R/W | N/A | None | None |
Specifies how the digitizer couples the trigger source. This attribute affects instrument operation only when NISCOPE_ATTRIBUTE_TRIGGER_TYPE is set to NISCOPE_VAL_EDGE, NISCOPE_VAL_HYSTERESIS, or NISCOPE_VAL_WINDOW.
NISCOPE_VAL_AC (0)
NISCOPE_VAL_DC (1)
NISCOPE_VAL_HF_REJECT (2)
NISCOPE_VAL_LF_REJECT (3)
NISCOPE_VAL_AC_PLUS_HF_REJECT (1001)
- Input Coupling
- Trigger Coupling
Data type |
Access | Applies to | Coercion | High Level Functions |
---|---|---|---|---|
ViReal64 | R/W | N/A | None | None |
Specifies the input impedance for the external analog trigger channel in Ohms.
NISCOPE_VAL_50_OHMS (50)
NISCOPE_VAL_1_MEG_OHM (1000000)
- PXIe5160
- PXIe5162
- Impedance and Impedance Matching
Data type |
Access | Applies to | Coercion | High Level Functions |
---|---|---|---|---|
ViReal64 | R/W | N/A | None | None |
The length of time you want the digitizer to wait after it starts acquiring data until the digitizer enables the trigger system to detect a reference (stop) trigger.
Units: Seconds
Valid Values: 0.0 – 171.8
- SMC-Based Digitizers Acquisition Engine State Diagram
Data type |
Access | Applies to | Coercion | High Level Functions |
---|---|---|---|---|
ViInt32 | R/W | N/A | None | niScope_ConfigureTriggerGlitch |
Specifies whether the oscilloscope triggers on pulses of duration less than or greater than the value specified by the NISCOPE_ATTRIBUTE_GLITCH_WIDTH attribute.
Default Value: NISCOPE_VAL_GLITCH_GREATER_THAN
NISCOPE_VAL_GLITCH_GREATER_THAN | (1) | The oscilloscope triggers on pulses with a duration longer than the specified glitch width. |
---|---|---|
NISCOPE_VAL_GLITCH_LESS_THAN | (2) | The oscilloscope triggers on pulses with a duration shorter than the specified glitch width. |
- Glitch Triggers
Data type |
Access | Applies to | Coercion | High Level Functions |
---|---|---|---|---|
ViInt32 | R/W | N/A | None | niScope_ConfigureTriggerGlitch |
Specifies the polarity of pulses that trigger the oscilloscope for glitch triggering.
Default Value: NISCOPE_VAL_GLITCH_POSITIVE
NISCOPE_VAL_GLITCH_POSITIVE | (1) | The oscilloscope triggers on pulses of positive polarity relative to the trigger threshold. |
---|---|---|
NISCOPE_VAL_GLITCH_NEGATIVE | (2) | The oscilloscope triggers on pulses of negative polarity relative to the trigger threshold. |
NISCOPE_VAL_GLITCH_EITHER | (3) | The oscilloscope triggers on pulses of either positive or negative polarity. |
- Glitch Triggers
Data type |
Access | Applies to | Coercion | High Level Functions |
---|---|---|---|---|
ViReal64 | R/W | N/A | None | niScope_ConfigureTriggerGlitch |
Specifies the glitch duration, in seconds.
The oscilloscope triggers when it detects a pulse of duration either less than or greater than this value depending on the value of the NISCOPE_ATTRIBUTE_GLITCH_CONDITION attribute.
Default Value: 0.0
- Glitch Triggers
Data type |
Access | Applies to | Coercion | High Level Functions |
---|---|---|---|---|
ViReal64 | R/W | N/A | None | niScope_ConfigureTriggerRunt |
Specifies the higher of two thresholds, in volts, that bound the vertical range to examine for runt pulses.
The runt threshold that causes the oscilloscope to trigger depends on the runt polarity you select. Refer to the NISCOPE_ATTRIBUTE_RUNT_POLARITY attribute for more information.
Default Value: 0.0
- Runt Triggers
Data type |
Access | Applies to | Coercion | High Level Functions |
---|---|---|---|---|
ViReal64 | R/W | N/A | None | niScope_ConfigureTriggerRunt |
Specifies the lower of two thresholds, in volts, that bound the vertical range to examine for runt pulses.
The runt threshold that causes the oscilloscope to trigger depends on the runt polarity you select. Refer to the NISCOPE_ATTRIBUTE_RUNT_POLARITY attribute for more information.
Default Value: 0.0
- Runt Triggers
Data type |
Access | Applies to | Coercion | High Level Functions |
---|---|---|---|---|
ViInt32 | R/W | N/A | None | niScope_ConfigureTriggerRunt |
Specifies the polarity of pulses that trigger the oscilloscope for runt triggering.
This attribute determines how the oscilloscope triggers relative to the runt thresholds you set.
When set to NISCOPE_VAL_RUNT_POSITIVE, the oscilloscope triggers when the following conditions are met:
- The leading edge of a pulse crosses the NISCOPE_ATTRIBUTE_RUNT_LOW_THRESHOLD in a positive direction;
- The trailing edge of the pulse crosses the NISCOPE_ATTRIBUTE_RUNT_LOW_THRESHOLD in a negative direction; and
- No portion of the pulse crosses the NISCOPE_ATTRIBUTE_RUNT_HIGH_THRESHOLD.
When set to NISCOPE_VAL_RUNT_NEGATIVE, the oscilloscope triggers when the following conditions are met:
- The leading edge of a pulse crosses the NISCOPE_ATTRIBUTE_RUNT_HIGH_THRESHOLD in a negative direction;
- The trailing edge of the pulse crosses the NISCOPE_ATTRIBUTE_RUNT_HIGH_THRESHOLD in a positive direction; and
- No portion of the pulse crosses the NISCOPE_ATTRIBUTE_RUNT_LOW_THRESHOLD.
When set to NISCOPE_VAL_RUNT_EITHER, the oscilloscope triggers in either case.
Default Value: NISCOPE_VAL_RUNT_POSITIVE
NISCOPE_VAL_RUNT_POSITIVE | (1) | The oscilloscope triggers on pulses of positive polarity relative to NISCOPE_ATTRIBUTE_RUNT_LOW_THRESHOLD that do not cross NISCOPE_ATTRIBUTE_RUNT_HIGH_THRESHOLD. |
---|---|---|
NISCOPE_VAL_RUNT_NEGATIVE | (2) | The oscilloscope triggers on pulses of negative polarity relative to NISCOPE_ATTRIBUTE_RUNT_HIGH_THRESHOLD that do not cross NISCOPE_ATTRIBUTE_RUNT_LOW_THRESHOLD. |
NISCOPE_VAL_RUNT_EITHER | (3) | The oscilloscope triggers on pulses of either positive or negative polarity. |
- Runt Triggers
Data type |
Access | Applies to | Coercion | High Level Functions |
---|---|---|---|---|
ViInt32 | R/W | N/A | None | None |
Specifies whether runt triggers are time qualified, and if so, how the oscilloscope triggers in relation to the duration range bounded by the NISCOPE_ATTRIBUTE_RUNT_TIME_LOW_LIMIT and NISCOPE_ATTRIBUTE_RUNT_TIME_HIGH_LIMIT attributes.
Default Value: NISCOPE_VAL_RUNT_TIME_CONDITION_NONE
NISCOPE_VAL_RUNT_TIME_CONDITION_NONE | (0) | Time qualification is disabled. The oscilloscope triggers on runt pulses based solely on the voltage level of the pulses. |
---|---|---|
NISCOPE_VAL_RUNT_TIME_CONDITION_WITHIN | (1) | The oscilloscope triggers on pulses that, in addition to meeting runt voltage criteria, have a duration within the range bounded by NISCOPE_ATTRIBUTE_RUNT_TIME_LOW_LIMIT and NISCOPE_ATTRIBUTE_RUNT_TIME_HIGH_LIMIT. |
NISCOPE_VAL_RUNT_TIME_CONDITION_OUTSIDE | (2) | The oscilloscope triggers on pulses that, in addition to meeting runt voltage criteria, have a duration not within the range bounded by NISCOPE_ATTRIBUTE_RUNT_TIME_LOW_LIMIT and NISCOPE_ATTRIBUTE_RUNT_TIME_HIGH_LIMIT. |
- Runt Triggers
Data type |
Access | Applies to | Coercion | High Level Functions |
---|---|---|---|---|
ViReal64 | R/W | N/A | None | None |
Specifies, in seconds, the high runt threshold time.
This attribute sets the upper bound on the duration of runt pulses that may trigger the oscilloscope. The NISCOPE_ATTRIBUTE_RUNT_TIME_CONDITION attribute determines how the oscilloscope triggers in relation to the runt time limits.
Default Value: 0.0
- Runt Triggers
Data type |
Access | Applies to | Coercion | High Level Functions |
---|---|---|---|---|
ViReal64 | R/W | N/A | None | None |
Specifies, in seconds, the low runt threshold time.
This attribute sets the lower bound on the duration of runt pulses that may trigger the oscilloscope. The NISCOPE_ATTRIBUTE_RUNT_TIME_CONDITION attribute determines how the oscilloscope triggers in relation to the runt time limits.
Default Value: 0.0
- Runt Triggers
Data type |
Access | Applies to | Coercion | High Level Functions |
---|---|---|---|---|
ViInt32 | R/W | N/A | None | niScope_ConfigureTriggerWidth |
Specifies whether the oscilloscope triggers on pulses within or outside the duration range bounded by the NISCOPE_ATTRIBUTE_WIDTH_LOW_THRESHOLD and NISCOPE_ATTRIBUTE_WIDTH_HIGH_THRESHOLD attributes.
Default Value: NISCOPE_VAL_WIDTH_WITHIN
NISCOPE_VAL_WIDTH_WITHIN | (1) | The oscilloscope triggers on pulses with a duration within the range bounded by NISCOPE_ATTRIBUTE_WIDTH_LOW_THRESHOLD and NISCOPE_ATTRIBUTE_WIDTH_HIGH_THRESHOLD. |
---|---|---|
NISCOPE_VAL_WIDTH_OUTSIDE | (2) | The oscilloscope triggers on pulses with a duration not within the range bounded by NISCOPE_ATTRIBUTE_WIDTH_LOW_THRESHOLD and NISCOPE_ATTRIBUTE_WIDTH_HIGH_THRESHOLD. |
- Width Triggers
Data type |
Access | Applies to | Coercion | High Level Functions |
---|---|---|---|---|
ViReal64 | R/W | N/A | None | niScope_ConfigureTriggerWidth |
Specifies the high width threshold, in seconds.
This attribute sets the upper bound on the duration range that triggers the oscilloscope. The NISCOPE_ATTRIBUTE_WIDTH_CONDITION attribute determines how the oscilloscope triggers in relation to the width thresholds.
Default Value: 0.0
- Width Triggers
Data type |
Access | Applies to | Coercion | High Level Functions |
---|---|---|---|---|
ViReal64 | R/W | N/A | None | niScope_ConfigureTriggerWidth |
Specifies the low width threshold, in seconds.
This attribute sets the lower bound on the duration range that triggers the oscilloscope. The NISCOPE_ATTRIBUTE_WIDTH_CONDITION attribute determines how the oscilloscope triggers in relation to the width thresholds.
Default Value: 0.0
- Width Triggers
Data type |
Access | Applies to | Coercion | High Level Functions |
---|---|---|---|---|
ViInt32 | R/W | N/A | None | niScope_ConfigureTriggerWidth |
Specifies the polarity of pulses that trigger the oscilloscope for width triggering.
Default Value: NISCOPE_VAL_POSITIVE
NISCOPE_VAL_WIDTH_POSITIVE | (1) | The oscilloscope triggers on pulses of positive polarity relative to the trigger threshold. |
---|---|---|
NISCOPE_VAL_WIDTH_NEGATIVE | (2) | The oscilloscope triggers on pulses of negative polarity relative to the trigger threshold. |
NISCOPE_VAL_WIDTH_EITHER | (3) | The oscilloscope triggers on pulses of either positive or negative polarity. |
- Width Triggers
Data type |
Access | Applies to | Coercion | High Level Functions |
---|---|---|---|---|
ViInt32 | R/W | N/A | None | niScope_ConfigureTriggerWindow |
Specifies whether you want a trigger to occur when the signal enters or leaves the window specified by NISCOPE_ATTRIBUTE_TRIGGER_WINDOW_LOW_LEVEL, or NISCOPE_ATTRIBUTE_TRIGGER_WINDOW_HIGH_LEVEL.
NISCOPE_VAL_ENTERING_WINDOW (0)
NISCOPE_VAL_LEAVING_WINDOW (1)
- Window Triggers
Data type |
Access | Applies to | Coercion | High Level Functions |
---|---|---|---|---|
ViReal64 | R/W | N/A | None | niScope_ConfigureTriggerWindow |
The lower voltage threshold you want the digitizer to use for window triggering.
The digitizer triggers when the trigger signal enters or leaves the window you specify with this attribute and NISCOPE_ATTRIBUTE_TRIGGER_WINDOW_HIGH_LEVEL.
Valid Values: The value you pass for this attribute must meet the following conditions:
Low Trigger Level <= Vertical Range/2 + Vertical Offset
Low Trigger Level >= (–Vertical Range/2) + Vertical Offset
Low Trigger Level < High Trigger Level
- Window Triggers
Data type |
Access | Applies to | Coercion | High Level Functions |
---|---|---|---|---|
ViReal64 | R/W | N/A | None | niScope_ConfigureTriggerWindow |
The upper voltage threshold you want the digitizer to use for window triggering.
The digitizer triggers when the trigger signal enters or leaves the window you specify with NISCOPE_ATTRIBUTE_TRIGGER_WINDOW_LOW_LEVEL and this attribute.
Valid Values: The value you pass for this parameter must meet the following conditions:
High Trigger Level <= Vertical Range/2 + Vertical Offset
High Trigger Level >= (–Vertical Range/2) + Vertical Offset
High Trigger Level > Low Trigger Level
- Window Triggers
Data type |
Access | Applies to | Coercion | High Level Functions |
---|---|---|---|---|
ViInt32 | R/W | N/A | None | niScope_ConfigureTriggerVideo |
Specifies the type of video signal.
SDTV
NISCOPE_VAL_NTSC (1)
NISCOPE_VAL_PAL (2)
NISCOPE_VAL_SECAM (3)
NISCOPE_VAL_M_PAL (1001)
EDTV
NISCOPE_VAL_480I_59_94_FIELDS_PER_SECOND (1010)
NISCOPE_VAL_480I_60_FIELDS_PER_SECOND (1011)
NISCOPE_VAL_480P_59_94_FRAMES_PER_SECOND (1015)
NISCOPE_VAL_480P_60_FRAMES_PER_SECOND (1016)
NISCOPE_VAL_576I_50_FIELDS_PER_SECOND (1020)
NISCOPE_VAL_576P_50_FRAMES_PER_SECOND (1025)
HDTV
NISCOPE_VAL_720P_50_FRAMES_PER_SECOND (1031)
NISCOPE_VAL_720P_59_94_FRAMES_PER_SECOND (1032)
NISCOPE_VAL_720P_60_FRAMES_PER_SECOND (1033)
NISCOPE_VAL_1080I_50_FIELDS_PER_SECOND (1040)
NISCOPE_VAL_1080I_59_94_FIELDS_PER_SECOND (1041)
NISCOPE_VAL_1080I_60_FIELDS_PER_SECOND (1042)
NISCOPE_VAL_1080P_24_FRAMES_PER_SECOND (1045)
Data type |
Access | Applies to | Coercion | High Level Functions |
---|---|---|---|---|
ViInt32 | R/W | N/A | None | niScope_ConfigureTriggerVideo |
Specifies the line on which to trigger, if NISCOPE_ATTRIBUTE_TV_TRIGGER_EVENT is set to NISCOPE_VAL_TV_EVENT_LINE_NUMBER. The valid range of the attribute depends on the signal format selected.
Signal Format | Line Numbers |
---|---|
M-NTSC, 480i, 480p | 1 to 525 |
BG/PAL, SECAM, 576i, 576p | 1 to 625 |
720p | 1 to 750 |
1080i,1080p | 1 to 1,125 |
Data type |
Access | Applies to | Coercion | High Level Functions |
---|---|---|---|---|
ViInt32 | R/W | N/A | None | niScope_ConfigureTriggerVideo |
Specifies whether the video signal sync is positive or negative.
NISCOPE_VAL_TV_POSITIVE (1)
NISCOPE_VAL_TV_NEGATIVE (2)
Data type |
Access | Applies to | Coercion | High Level Functions |
---|---|---|---|---|
ViInt32 | R/W | N/A | None | niScope_ConfigureTriggerVideo |
Specifies the condition in the video signal that causes the digitizer to trigger.
NISCOPE_VAL_TV_EVENT_FIELD1 (1)
NISCOPE_VAL_TV_EVENT_FIELD2 (2)
NISCOPE_VAL_TV_EVENT_ANY_FIELD (3)
NISCOPE_VAL_TV_EVENT_ANY_LINE (4)
NISCOPE_VAL_TV_EVENT_LINE_NUMBER (5)
Data type |
Access | Applies to | Coercion | High Level Functions |
---|---|---|---|---|
ViBoolean | R/W | N/A | None | niScope_ConfigureTriggerVideo |
Restores the video-triggered data retrieved by the digitizer to the video signal's zero reference point.
VI_TRUE—Enable DC restore.
VI_FALSE—Disable DC restore.
Data type |
Access | Applies to | Coercion | High Level Functions |
---|---|---|---|---|
ViInt32 | R/W | N/A | None | None |
Indicates which reference trigger detection circuitry to use on the device.
![]() |
Note This attribute can be used only with high-speed digitizers that support onboard signal processing (OSP). NI-SCOPE returns an error if you use this attribute with a device that does not support OSP. |
---|---|
Default Value: NISCOPE_VAL_ANALOG_DETECTION_CIRCUIT |
NISCOPE_VAL_DDC_OUTPUT—Use the onboard signal processing logic to implement the reference trigger. This option detects trigger conditions by analyzing the processed digital signal.
NISCOPE_VAL_ANALOG_DETECTION_CIRCUIT—Use the hardware analog circuitry to implement the reference trigger. This option detects trigger conditions by analyzing the unprocessed analog signal.
Data type |
Access | Applies to | Coercion | High Level Functions |
---|---|---|---|---|
ViReal64 | R/W | N/A | None | None |
Specifies the amount of time (in seconds) the trigger circuit must not detect a signal above the trigger level (or below the trigger level if the trigger slope is negative) before the trigger is armed. This attribute is useful for triggering at the beginning of signal bursts instead of in the middle of signal bursts.
![]() |
Note This attribute can be used only with high-speed digitizers that support onboard signal processing (OSP). NI-SCOPE returns an error if you use this attribute with a device that does not support OSP. |
---|---|
Default value: 0 |
Any value greater than or equal to 0.
Burst Triggers