niScope Configure Trigger (poly)

Configures the digitizer for different types of triggering.

When you initiate an acquisition, the digitizer waits for the start trigger, which is configured through the Acquisition Arm Source (Start Trigger Source) property. The default is immediate. Upon receiving the start trigger, the digitizer begins sampling pretrigger points. After the digitizer finishes sampling pretrigger points, the digitizer waits for a reference (stop) trigger that you specify with a Configure Trigger VI. Upon receiving the reference trigger, the digitizer finishes the acquisition after completing posttrigger sampling. With each Configure Trigger VI, you specify configuration parameters such as the trigger source and the amount of trigger delay.

Notes   For multirecord acquisitions, all records after the first record are started by using the Advance Trigger Source. The default is immediate. You can adjust the amount of pretrigger and posttrigger samples using the reference position parameter in niScope Configure Horizontal Timing. The default is half of the record length. Some features are not supported by all digitizers. Refer to Features Supported by Device for more information.

Use the pull-down menu to select an instance of this VI.

Analog Edge Ref Trigger

Configures common properties for edge triggering.

	trigger coupling specifies how to couple the trigger signal. Refer to Trigger Coupling for defined values.
	trigger slope specifies either a rising edge or a falling edge to trigger the digitizer. Refer to Trigger Slope for defined values.
	instrument handle identifies a particular instrument session.
	trigger source passes the source you want the digitizer to monitor for a trigger. Default Value: Channel 0 Refer to Trigger Source for defined values.
	trigger level specifies the voltage threshold for the trigger. Default Value: 0.0 V
	error in describes error conditions that occur before this VI runs. The default input of this cluster is no error. If an error already occurred, this VI returns the value of error in in error out. The VI runs normally only if no incoming error exists. Otherwise, the VI passes the error in value to error out. The error in cluster contains the following parameters: status is TRUE (X) if an error occurred before this VI or function ran or FALSE (checkmark) to indicate a warning or that no error occurred before this VI or function ran. The default is FALSE. code is the error or warning code. The default is 0. If status is TRUE, code is a negative error code. If status is FALSE, code is 0 or a warning code. source identifies where an error occurred. The source string includes the name of the VI that produced the error, what inputs are in error, and how to eliminate the error.
	trigger holdoff specifies the length of time the digitizer waits after detecting a trigger before enabling NI-SCOPE to detect another trigger. Default Value: 0.0 s
	trigger delay specifies how long the digitizer waits after it receives the trigger to start acquiring data. Default Value: 0.0 s
	instrument handle out has the same value as the instrument handle.
	error out contains error information. If error in indicates that an error occurred before this VI or function ran, error out contains the same error information. Otherwise, it describes the error status that this VI or function produces. status is TRUE (X) if an error occurred or FALSE (checkmark) to indicate a warning or that no error occurred. code is the error or warning code. If status is TRUE, code is a nonzero error code. If status is FALSE, code is 0 or a warning code. source identifies where and why an error occurred. The source string includes the name of the VI that produced the error, what inputs are in error, and how to eliminate the error.

Analog Hysteresis Ref Trigger

Configures common properties for hysteresis triggering. This kind of trigger specifies an additional value, specified in the hysteresis parameter, that a signal must pass through before a trigger can occur. This additional value acts as a buffer zone that keeps noise from triggering an acquisition.

	trigger coupling specifies how to couple the trigger signal. Refer to Trigger Coupling for defined values.
	trigger slope specifies either a rising edge or a falling edge to trigger the digitizer. Refer to Trigger Slope for defined values.
	instrument handle identifies a particular instrument session.
	trigger source passes the source you want the digitizer to monitor for a trigger. Default Value: Channel 0 Refer to Trigger Source for defined values.
	hysteresis specifies the size of the hysteresis window on either side of the trigger level in volts. The digitizer triggers when the trigger signal passes through the hysteresis value you specify with this parameter, has the slope you specify with the trigger slope, and passes through the trigger level. Default Value: 0.05 V Valid Values: Min Value: 0 Max Value for positive trigger slope: Hysteresis – trigger level >= –(vertical range/2) + vertical offset Max value for negative trigger slope: Hysteresis + trigger level <= (vertical range/2) + vertical offset
	trigger level specifies the voltage threshold for the trigger. Default Value: 0.0 V
	error in describes error conditions that occur before this VI runs. The default input of this cluster is no error. If an error already occurred, this VI returns the value of error in in error out. The VI runs normally only if no incoming error exists. Otherwise, the VI passes the error in value to error out. The error in cluster contains the following parameters: status is TRUE (X) if an error occurred before this VI or function ran or FALSE (checkmark) to indicate a warning or that no error occurred before this VI or function ran. The default is FALSE. code is the error or warning code. The default is 0. If status is TRUE, code is a negative error code. If status is FALSE, code is 0 or a warning code. source identifies where an error occurred. The source string includes the name of the VI that produced the error, what inputs are in error, and how to eliminate the error.
	trigger holdoff specifies the length of time the digitizer waits after detecting a trigger before enabling NI-SCOPE to detect another trigger. Default Value: 0.0 s
	trigger delay specifies how long the digitizer waits after it receives the trigger to start acquiring data. Default Value: 0.0 s
	instrument handle out has the same value as the instrument handle.
	error out contains error information. If error in indicates that an error occurred before this VI or function ran, error out contains the same error information. Otherwise, it describes the error status that this VI or function produces. status is TRUE (X) if an error occurred or FALSE (checkmark) to indicate a warning or that no error occurred. code is the error or warning code. If status is TRUE, code is a nonzero error code. If status is FALSE, code is 0 or a warning code. source identifies where and why an error occurred. The source string includes the name of the VI that produced the error, what inputs are in error, and how to eliminate the error.

Video Ref Trigger

Configures the common properties specific to video triggering, such as trigger coupling, trigger source, trigger holdoff, and trigger delay. The video triggering properties are polarity, enable DC restore, signal format, event, and line number. A video trigger occurs when the digitizer finds a valid video signal sync. Use the trigger holdoff to skip a specific number of frames between acquisitions. For example, to acquire a specific line number multiple times and repeat the same chroma phase, skip 1 frame in NTSC (121 ms < holdoff < 159 ms) and 5 frames in SECAM (201 ms < holdoff < 239 ms).

	TV event specifies what TV event to trigger on. Refer to the Event property for defined values.
	trigger coupling specifies how to couple the trigger signal. Refer to Trigger Coupling for defined values.
	polarity specifies the polarity of the video sync. Default Value: negative Defined Values: positive negative
	instrument handle identifies a particular instrument session.
	trigger source passes the source you want the digitizer to monitor for a trigger. Default Value: Channel 0 Refer to Trigger Source for defined values.
	enable DC restore offsets each video line so the clamping level (the portion of the video line between the color burst and the beginning of the active image) is moved to zero volt. Default Value: FALSE
	signal format specifies the video format to use. Refer to Signal Format for defined values.
	error in describes error conditions that occur before this VI runs. The default input of this cluster is no error. If an error already occurred, this VI returns the value of error in in error out. The VI runs normally only if no incoming error exists. Otherwise, the VI passes the error in value to error out. The error in cluster contains the following parameters: status is TRUE (X) if an error occurred before this VI or function ran or FALSE (checkmark) to indicate a warning or that no error occurred before this VI or function ran. The default is FALSE. code is the error or warning code. The default is 0. If status is TRUE, code is a negative error code. If status is FALSE, code is 0 or a warning code. source identifies where an error occurred. The source string includes the name of the VI that produced the error, what inputs are in error, and how to eliminate the error.
	trigger holdoff specifies the length of time the digitizer waits after detecting a trigger before enabling NI-SCOPE to detect another trigger. Default Value: 0.0 s
	trigger delay specifies how long the digitizer waits after it receives the trigger to start acquiring data. Default Value: 0.0 s
	line number specifies the line number to trigger on. The line number range covers an entire frame and is referenced as shown in Vertical Blanking and Synchronization Signal. The number of lines available depends on the format. For valid ranges, refer to the Line Number property. Default value: 1
	instrument handle out has the same value as the instrument handle.
	error out contains error information. If error in indicates that an error occurred before this VI or function ran, error out contains the same error information. Otherwise, it describes the error status that this VI or function produces. status is TRUE (X) if an error occurred or FALSE (checkmark) to indicate a warning or that no error occurred. code is the error or warning code. If status is TRUE, code is a nonzero error code. If status is FALSE, code is 0 or a warning code. source identifies where and why an error occurred. The source string includes the name of the VI that produced the error, what inputs are in error, and how to eliminate the error.

Analog Window Ref Trigger

Configures common properties for window triggering. A window trigger occurs when a signal enters or leaves a window you specify with the high level or low level parameters.

	trigger coupling specifies how to couple the trigger signal. Refer to Trigger Coupling for defined values.
	trigger window mode specifies whether the trigger should occur when the signal is entering or leaving a window. Default Value: Entering
	instrument handle identifies a particular instrument session.
	trigger source passes the source you want the digitizer to monitor for a trigger. Default Value: Channel 0 Refer to Trigger Source for defined values.
	low level passes the voltage threshold for the digitizer to use for low triggering. Default Value: 0 V
	high level passes the voltage threshold for the digitizer to use for high triggering. Default Value: 0.10 V
	error in describes error conditions that occur before this VI runs. The default input of this cluster is no error. If an error already occurred, this VI returns the value of error in in error out. The VI runs normally only if no incoming error exists. Otherwise, the VI passes the error in value to error out. The error in cluster contains the following parameters: status is TRUE (X) if an error occurred before this VI or function ran or FALSE (checkmark) to indicate a warning or that no error occurred before this VI or function ran. The default is FALSE. code is the error or warning code. The default is 0. If status is TRUE, code is a negative error code. If status is FALSE, code is 0 or a warning code. source identifies where an error occurred. The source string includes the name of the VI that produced the error, what inputs are in error, and how to eliminate the error.
	trigger holdoff specifies the length of time the digitizer waits after detecting a trigger before enabling NI-SCOPE to detect another trigger. Default Value: 0.0 s
	trigger delay specifies how long the digitizer waits after it receives the trigger to start acquiring data. Default Value: 0.0 s
	instrument handle out has the same value as the instrument handle.
	error out contains error information. If error in indicates that an error occurred before this VI or function ran, error out contains the same error information. Otherwise, it describes the error status that this VI or function produces. status is TRUE (X) if an error occurred or FALSE (checkmark) to indicate a warning or that no error occurred. code is the error or warning code. If status is TRUE, code is a nonzero error code. If status is FALSE, code is 0 or a warning code. source identifies where and why an error occurred. The source string includes the name of the VI that produced the error, what inputs are in error, and how to eliminate the error.

Digital Edge Ref Trigger

Configures the common properties of a digital trigger.

	trigger slope specifies either a rising edge or a falling edge to trigger the digitizer. Refer to Trigger Slope for defined values.
	instrument handle identifies a particular instrument session.
	trigger source passes the source you want the digitizer to monitor for a trigger. Default Value: Channel 0 Refer to Trigger Source for defined values.
	error in describes error conditions that occur before this VI runs. The default input of this cluster is no error. If an error already occurred, this VI returns the value of error in in error out. The VI runs normally only if no incoming error exists. Otherwise, the VI passes the error in value to error out. The error in cluster contains the following parameters: status is TRUE (X) if an error occurred before this VI or function ran or FALSE (checkmark) to indicate a warning or that no error occurred before this VI or function ran. The default is FALSE. code is the error or warning code. The default is 0. If status is TRUE, code is a negative error code. If status is FALSE, code is 0 or a warning code. source identifies where an error occurred. The source string includes the name of the VI that produced the error, what inputs are in error, and how to eliminate the error.
	trigger holdoff specifies the length of time the digitizer waits after detecting a trigger before enabling NI-SCOPE to detect another trigger. Default Value: 0.0 s
	trigger delay specifies how long the digitizer waits after it receives the trigger to start acquiring data. Default Value: 0.0 s
	instrument handle out has the same value as the instrument handle.
	error out contains error information. If error in indicates that an error occurred before this VI or function ran, error out contains the same error information. Otherwise, it describes the error status that this VI or function produces. status is TRUE (X) if an error occurred or FALSE (checkmark) to indicate a warning or that no error occurred. code is the error or warning code. If status is TRUE, code is a nonzero error code. If status is FALSE, code is 0 or a warning code. source identifies where and why an error occurred. The source string includes the name of the VI that produced the error, what inputs are in error, and how to eliminate the error.

Immediate Ref Trigger

Configures common properties for immediate triggering. Immediate triggering means the digitizer triggers itself.

	instrument handle identifies a particular instrument session.
	error in describes error conditions that occur before this VI runs. The default input of this cluster is no error. If an error already occurred, this VI returns the value of error in in error out. The VI runs normally only if no incoming error exists. Otherwise, the VI passes the error in value to error out. The error in cluster contains the following parameters: status is TRUE (X) if an error occurred before this VI or function ran or FALSE (checkmark) to indicate a warning or that no error occurred before this VI or function ran. The default is FALSE. code is the error or warning code. The default is 0. If status is TRUE, code is a negative error code. If status is FALSE, code is 0 or a warning code. source identifies where an error occurred. The source string includes the name of the VI that produced the error, what inputs are in error, and how to eliminate the error.
	instrument handle out has the same value as the instrument handle.
	error out contains error information. If error in indicates that an error occurred before this VI or function ran, error out contains the same error information. Otherwise, it describes the error status that this VI or function produces. status is TRUE (X) if an error occurred or FALSE (checkmark) to indicate a warning or that no error occurred. code is the error or warning code. If status is TRUE, code is a nonzero error code. If status is FALSE, code is 0 or a warning code. source identifies where and why an error occurred. The source string includes the name of the VI that produced the error, what inputs are in error, and how to eliminate the error.

Software Ref Trigger

Configures common properties for software triggering. This VI only works in an Initiate/Fetch operation.

	instrument handle identifies a particular instrument session.
	error in describes error conditions that occur before this VI runs. The default input of this cluster is no error. If an error already occurred, this VI returns the value of error in in error out. The VI runs normally only if no incoming error exists. Otherwise, the VI passes the error in value to error out. The error in cluster contains the following parameters: status is TRUE (X) if an error occurred before this VI or function ran or FALSE (checkmark) to indicate a warning or that no error occurred before this VI or function ran. The default is FALSE. code is the error or warning code. The default is 0. If status is TRUE, code is a negative error code. If status is FALSE, code is 0 or a warning code. source identifies where an error occurred. The source string includes the name of the VI that produced the error, what inputs are in error, and how to eliminate the error.
	trigger holdoff specifies the length of time the digitizer waits after detecting a trigger before enabling NI-SCOPE to detect another trigger. Default Value: 0.0 s
	trigger delay specifies how long the digitizer waits after it receives the trigger to start acquiring data. Default Value: 0.0 s
	instrument handle out has the same value as the instrument handle.
	error out contains error information. If error in indicates that an error occurred before this VI or function ran, error out contains the same error information. Otherwise, it describes the error status that this VI or function produces. status is TRUE (X) if an error occurred or FALSE (checkmark) to indicate a warning or that no error occurred. code is the error or warning code. If status is TRUE, code is a nonzero error code. If status is FALSE, code is 0 or a warning code. source identifies where and why an error occurred. The source string includes the name of the VI that produced the error, what inputs are in error, and how to eliminate the error.