NI SCOPE Trigger Attributes

Trigger Attributes

• 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

NISCOPE_ATTRIBUTE_TRIGGER_TYPE

Specific Attribute

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

Description

Specifies the type of trigger to use.

Defined Values

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

Related topics:

• Trigger Types

NISCOPE_ATTRIBUTE_TRIGGER_SOURCE

Specific Attribute

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

Description

Specifies the source the digitizer monitors for the trigger event. Trigger sources vary for each digitizer model.

Defined Values

"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")

Related topics:

• Trigger Types

NISCOPE_ATTRIBUTE_END_OF_RECORD_TO_ADVANCE_TRIGGER_HOLDOFF

Specific Attribute

Data type	Access	Applies to	Coercion	High Level Functions
ViReal64	R/W	N/A	None	None

Description

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.

Related topics:

• Record Advance Holdoff

NISCOPE_ATTRIBUTE_EXPORTED_REF_TRIGGER_OUTPUT_TERMINAL

Specific Attribute

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

Description

Specifies the destination export for the Reference (Stop) trigger. Refer to the device specifications document for a list of valid destinations.

Defined Values

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")

NISCOPE_ATTRIBUTE_REF_TRIGGER_TERMINAL_NAME

Specific Attribute

Data type	Access	Applies to	Coercion	High Level Functions
ViString	R	N/A	None	N/A

Description

Returns the fully qualified name for the Reference Trigger terminal.

You can use this terminal as the source for a trigger.

NISCOPE_ATTRIBUTE_TRIGGER_LEVEL

Specific Attribute

Data type	Access	Applies to	Coercion	High Level Functions
ViReal64	R/W	N/A	None	niScope_ConfigureTriggerEdge niScope_ConfigureTriggerGlitch niScope_ConfigureTriggerHysteresis niScope_ConfigureTriggerWidth

Description

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

Related topics:

• Edge Triggers
• Window Triggers

NISCOPE_ATTRIBUTE_TRIGGER_MODIFIER

Specific Attribute

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

Description

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.

Defined Values

NISCOPE_VAL_NO_TRIGGER_MOD (1)

NISCOPE_VAL_AUTO (2)

NISCOPE_ATTRIBUTE_TRIGGER_AUTO_TRIGGERED

Specific Attribute

Data type	Access	Applies to	Coercion	High Level Functions
ViBoolean	RO	N/A	None	None

Description

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.

Defined Values

TRUE

FALSE

NISCOPE_ATTRIBUTE_TRIGGER_HYSTERESIS

Specific Attribute

Data type	Access	Applies to	Coercion	High Level Functions
ViReal64	R/W	N/A	None	None

Description

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

Related topics:

• Hysteresis Triggers

NISCOPE_ATTRIBUTE_TRIGGER_DELAY_TIME

Specific Attribute

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

Description

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.

NISCOPE_ATTRIBUTE_TRIGGER_HOLDOFF

Specific Attribute

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

Description

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

Related topics:

• Trigger Holdoff
• Trigger Parameters

NISCOPE_ATTRIBUTE_TRIGGER_SLOPE

Specific Attribute

Data type	Access	Applies to	Coercion	High Level Functions
ViInt32	R/W	N/A	None	niScope_ConfigureTriggerDigital niScope_ConfigureTriggerEdge niScope_ConfigureTriggerHysteresis

Description

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.

Defined Values

NISCOPE_VAL_POSITIVE

NISCOPE_VAL_NEGATIVE

Related topics:

• Edge Triggers
• Window Triggers

NISCOPE_ATTRIBUTE_TRIGGER_COUPLING

Specific Attribute

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

Description

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.

Defined Values

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)

Related topics:

• Input Coupling
• Trigger Coupling

NISCOPE_ATTRIBUTE_TRIGGER_IMPEDANCE

Specific Attribute

Data type	Access	Applies to	Coercion	High Level Functions
ViReal64	R/W	N/A	None	None

Description

Specifies the input impedance for the external analog trigger channel in Ohms.

Defined Values

NISCOPE_VAL_50_OHMS (50)

NISCOPE_VAL_1_MEG_OHM (1000000)

Supported Devices

• PXIe5160
• PXIe5162

Related topics:

• Impedance and Impedance Matching

NISCOPE_ATTRIBUTE_START_TO_REF_TRIGGER_HOLDOFF

Specific Attribute

Data type	Access	Applies to	Coercion	High Level Functions
ViReal64	R/W	N/A	None	None

Description

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

Related topics:

• SMC-Based Digitizers Acquisition Engine State Diagram

NISCOPE_ATTRIBUTE_GLITCH_CONDITION

Specific Attribute

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

Description

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

Defined Values

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.

Related topics:

• Glitch Triggers

NISCOPE_ATTRIBUTE_GLITCH_POLARITY

Specific Attribute

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

Description

Specifies the polarity of pulses that trigger the oscilloscope for glitch triggering.

Default Value: NISCOPE_VAL_GLITCH_POSITIVE

Defined Values

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.

Related topics:

• Glitch Triggers

NISCOPE_ATTRIBUTE_GLITCH_WIDTH

Specific Attribute

Data type	Access	Applies to	Coercion	High Level Functions
ViReal64	R/W	N/A	None	niScope_ConfigureTriggerGlitch

Description

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

Related topics:

• Glitch Triggers

NISCOPE_ATTRIBUTE_RUNT_HIGH_THRESHOLD

Specific Attribute

Data type	Access	Applies to	Coercion	High Level Functions
ViReal64	R/W	N/A	None	niScope_ConfigureTriggerRunt

Description

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

Related topics:

• Runt Triggers

NISCOPE_ATTRIBUTE_RUNT_LOW_THRESHOLD

Specific Attribute

Data type	Access	Applies to	Coercion	High Level Functions
ViReal64	R/W	N/A	None	niScope_ConfigureTriggerRunt

Description

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

Related topics:

• Runt Triggers

NISCOPE_ATTRIBUTE_RUNT_POLARITY

Specific Attribute

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

Description

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

Defined Values

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.

Related topics:

• Runt Triggers

NISCOPE_ATTRIBUTE_RUNT_TIME_CONDITION

Specific Attribute

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

Description

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

Defined Values

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.

Related topics:

• Runt Triggers

NISCOPE_ATTRIBUTE_RUNT_TIME_HIGH_LIMIT

Specific Attribute

Data type	Access	Applies to	Coercion	High Level Functions
ViReal64	R/W	N/A	None	None

Description

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

Related topics:

• Runt Triggers

NISCOPE_ATTRIBUTE_RUNT_TIME_LOW_LIMIT

Specific Attribute

Data type	Access	Applies to	Coercion	High Level Functions
ViReal64	R/W	N/A	None	None

Description

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

Related topics:

• Runt Triggers

NISCOPE_ATTRIBUTE_WIDTH_CONDITION

Specific Attribute

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

Description

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

Defined Values

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.

Related topics:

• Width Triggers

NISCOPE_ATTRIBUTE_WIDTH_HIGH_THRESHOLD

Specific Attribute

Data type	Access	Applies to	Coercion	High Level Functions
ViReal64	R/W	N/A	None	niScope_ConfigureTriggerWidth

Description

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

Related topics:

• Width Triggers

NISCOPE_ATTRIBUTE_WIDTH_LOW_THRESHOLD

Specific Attribute

Data type	Access	Applies to	Coercion	High Level Functions
ViReal64	R/W	N/A	None	niScope_ConfigureTriggerWidth

Description

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

Related topics:

• Width Triggers

NISCOPE_ATTRIBUTE_WIDTH_POLARITY

Specific Attribute

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

Description

Specifies the polarity of pulses that trigger the oscilloscope for width triggering.

Default Value: NISCOPE_VAL_POSITIVE

Defined Values

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.

Related topics:

• Width Triggers

NISCOPE_ATTRIBUTE_TRIGGER_WINDOW_MODE

Specific Attribute

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

Description

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.

Defined Values

NISCOPE_VAL_ENTERING_WINDOW (0)

NISCOPE_VAL_LEAVING_WINDOW (1)

Related topics:

• Window Triggers

NISCOPE_ATTRIBUTE_TRIGGER_WINDOW_LOW_LEVEL

Specific Attribute

Data type	Access	Applies to	Coercion	High Level Functions
ViReal64	R/W	N/A	None	niScope_ConfigureTriggerWindow

Description

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

Related topics:

• Window Triggers

NISCOPE_ATTRIBUTE_TRIGGER_WINDOW_HIGH_LEVEL

Specific Attribute

Data type	Access	Applies to	Coercion	High Level Functions
ViReal64	R/W	N/A	None	niScope_ConfigureTriggerWindow

Description

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

Related topics:

• Window Triggers

NISCOPE_ATTRIBUTE_TV_TRIGGER_SIGNAL_FORMAT

Specific Attribute

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

Description

Specifies the type of video signal.

Defined Values

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)

NISCOPE_ATTRIBUTE_TV_TRIGGER_LINE_NUMBER

Specific Attribute

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

Description

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

NISCOPE_ATTRIBUTE_TV_TRIGGER_POLARITY

Specific Attribute

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

Description

Specifies whether the video signal sync is positive or negative.

Defined Values

NISCOPE_VAL_TV_POSITIVE (1)

NISCOPE_VAL_TV_NEGATIVE (2)

NISCOPE_ATTRIBUTE_TV_TRIGGER_EVENT

Specific Attribute

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

Description

Specifies the condition in the video signal that causes the digitizer to trigger.

Defined Values

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)

NISCOPE_ATTRIBUTE_ENABLE_DC_RESTORE

Specific Attribute

Data type	Access	Applies to	Coercion	High Level Functions
ViBoolean	R/W	N/A	None	niScope_ConfigureTriggerVideo

Description

Restores the video-triggered data retrieved by the digitizer to the video signal's zero reference point.

Defined Values

VI_TRUE—Enable DC restore.

VI_FALSE—Disable DC restore.

NISCOPE_ATTRIBUTE_REF_TRIGGER_DETECTOR_LOCATION

Specific Attribute

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

Description

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

Valid Values

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.

NISCOPE_ATTRIBUTE_REF_TRIGGER_MINIMUM_QUIET_TIME

Specific Attribute

Data type	Access	Applies to	Coercion	High Level Functions
ViReal64	R/W	N/A	None	None

Description

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

Valid Values

Any value greater than or equal to 0.

Related Topics

Burst Triggers