niHSDIO Configure Trigger VI

NI Digital Waveform Generator/Analyzer Help

Edition Date: June 2013

Part Number: 370520P-01

»View Product Info
Download Help (Windows Only)
Installed With: NI-HSDIO

Configures the specified trigger.

Related Topics

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

Digital Edge Start Trigger

This instance of niHSDIO Configure Trigger configures the Start trigger for digital edge triggering.

niHSDIO Configure Digital Edge Start Trigger

/images/reference/en-XX/help/370520P-01/civrn.gif

instrument handle identifies your instrument session. instrument handle is obtained from the niHSDIO Init Acquisition Session VI, the niHSDIO Init Generation Session VI, or the niHSDIO Init Ext Cal VI.

/images/reference/en-XX/help/370520P-01/cstr.gif

source specifies the trigger source. You can choose PFI <0..3>, PFI <24..31>, PXI Trigger Line/RTSI <0..7>, PXI STAR Line, or PXIe DStarB.

Note  Only NI 6555/6556 devices support PFI <24..31> and PXIe DStarB.
/images/reference/en-XX/help/370520P-01/ci32.gif

edge specifies the edge to detect.

Rising Edge (12)

The trigger asserts on the rising edge of the digital signal.

Falling Edge (13)

The trigger asserts on the falling edge of the digital signal.

/images/reference/en-XX/help/370520P-01/cerrcodeclst.gif

error in (no error) describes error conditions that occur before this node runs. This input provides standard error in functionality.

/images/reference/en-XX/help/370520P-01/cbool.gif

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.

/images/reference/en-XX/help/370520P-01/ci32.gif

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.

/images/reference/en-XX/help/370520P-01/cstr.gif

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.

/images/reference/en-XX/help/370520P-01/iivrn.gif

instrument handle out passes a reference to your instrument session to the next VI. instrument handle is obtained from the niHSDIO Init Acquisition Session VI or the niHSDIO Init Generation Session VI.

/images/reference/en-XX/help/370520P-01/ierrcodeclst.gif

error out contains error information. This output provides standard error out functionality.

/images/reference/en-XX/help/370520P-01/ibool.gif

status is TRUE (X) if an error occurred or FALSE (checkmark) to indicate a warning or that no error occurred.

/images/reference/en-XX/help/370520P-01/ii32.gif

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.

/images/reference/en-XX/help/370520P-01/istr.gif

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.

Pattern Match Start Trigger (String)

This instance of niHSDIO Configure Trigger configures the Start trigger for pattern match triggering. This VI is valid only for acquisition sessions.

niHSDIO Configure Pattern Match Start Trigger

/images/reference/en-XX/help/370520P-01/civrn.gif

instrument handle identifies your instrument session. instrument handle is obtained from the niHSDIO Init Acquisition Session VI, the niHSDIO Init Generation Session VI, or the niHSDIO Init Ext Cal VI.

/images/reference/en-XX/help/370520P-01/cstr.gif

channel list specifies which channels are configured for pattern matching using the pattern array value.

/images/reference/en-XX/help/370520P-01/cstr.gif

pattern specifies the binary pattern that activates the pattern match trigger under the conditions specified in trigger when.

This string expression creates a mask for the pattern. This expression is composed of characters:

  • X or x: Ignore the channel
  • 1: Match on a logic 1
  • 0: Match on a logic 0
  • R or r: Match on a rising edge
  • F or f: Match on a falling edge
  • E or e: Match on either edge

The first character in the expression corresponds to the first channel in channel list. The number of characters in pattern must correspond to the number of channels specified in channel list or an error is returned.

For example, the following two examples are valid and achieve the same results:

  • channel list = 19-0 and pattern = 0000 0XXX XX11 1111 1111
  • channel list = 0-19 and pattern = 1111 1111 11XX XXX0 0000
/images/reference/en-XX/help/370520P-01/ci32.gif

trigger when specifies the conditions under which the trigger is sent.

Pattern Matches The trigger is asserted when the sampled pattern matches the pattern specified in pattern.
Pattern Does Not Match The trigger is asserted when the sampled pattern does not match the pattern specified in pattern.

Refer to the Pattern Match Trigger topic for an illustration of when your data is acquired when using a pattern match trigger for acquisitions.

/images/reference/en-XX/help/370520P-01/cerrcodeclst.gif

error in (no error) describes error conditions that occur before this node runs. This input provides standard error in functionality.

/images/reference/en-XX/help/370520P-01/cbool.gif

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.

/images/reference/en-XX/help/370520P-01/ci32.gif

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.

/images/reference/en-XX/help/370520P-01/cstr.gif

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.

/images/reference/en-XX/help/370520P-01/iivrn.gif

instrument handle out passes a reference to your instrument session to the next VI. instrument handle is obtained from the niHSDIO Init Acquisition Session VI or the niHSDIO Init Generation Session VI.

/images/reference/en-XX/help/370520P-01/ierrcodeclst.gif

error out contains error information. This output provides standard error out functionality.

/images/reference/en-XX/help/370520P-01/ibool.gif

status is TRUE (X) if an error occurred or FALSE (checkmark) to indicate a warning or that no error occurred.

/images/reference/en-XX/help/370520P-01/ii32.gif

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.

/images/reference/en-XX/help/370520P-01/istr.gif

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.

Pattern Match Start Trigger (U32)

This instance of niHSDIO Configure Trigger configures the Start trigger for pattern match triggering. This VI is valid only for acquisition sessions.

niHSDIO Configure Pattern Match Start Trigger (U32)

/images/reference/en-XX/help/370520P-01/civrn.gif

instrument handle identifies your instrument session. instrument handle is obtained from the niHSDIO Init Acquisition Session VI, the niHSDIO Init Generation Session VI, or the niHSDIO Init Ext Cal VI.

/images/reference/en-XX/help/370520P-01/cstr.gif

channel list specifies which channels are configured for pattern matching using the pattern array value.

/images/reference/en-XX/help/370520P-01/ci32.gif

pattern specifies the binary pattern that activates the pattern match trigger under the conditions specified in trigger when.

Bits on channels not specified in channel list are ignored.

/images/reference/en-XX/help/370520P-01/ci32.gif

trigger when specifies the conditions under which the trigger is sent.

Pattern Matches The trigger is asserted when the sampled pattern matches the pattern specified in pattern.
Pattern Does Not Match The trigger is asserted when the sampled pattern does not match the pattern specified in pattern.

Refer to the Pattern Match Trigger topic for an illustration of when your data is acquired when using a pattern match trigger for acquisitions.

/images/reference/en-XX/help/370520P-01/cerrcodeclst.gif

error in (no error) describes error conditions that occur before this node runs. This input provides standard error in functionality.

/images/reference/en-XX/help/370520P-01/cbool.gif

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.

/images/reference/en-XX/help/370520P-01/ci32.gif

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.

/images/reference/en-XX/help/370520P-01/cstr.gif

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.

/images/reference/en-XX/help/370520P-01/iivrn.gif

instrument handle out passes a reference to your instrument session to the next VI. instrument handle is obtained from the niHSDIO Init Acquisition Session VI or the niHSDIO Init Generation Session VI.

/images/reference/en-XX/help/370520P-01/ierrcodeclst.gif

error out contains error information. This output provides standard error out functionality.

/images/reference/en-XX/help/370520P-01/ibool.gif

status is TRUE (X) if an error occurred or FALSE (checkmark) to indicate a warning or that no error occurred.

/images/reference/en-XX/help/370520P-01/ii32.gif

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.

/images/reference/en-XX/help/370520P-01/istr.gif

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.

Multi-Sample Pattern Match Start Trigger (String)

This instance of niHSDIO Configure Trigger configures the Start trigger for multi-sample pattern match triggering. You can configure up to 32 channels with patterns of up to 10 samples per channel with this VI. For the channels specified in the channel list parameter, the pattern must match each pattern element specified in the pattern array parameter on consecutive clock cycles. After the last pattern element in the pattern array parameter is matched, the Start trigger is asserted.

This VI is valid only for acquisition sessions.

niHSDIO Configure Multi-Sample Pattern Match Start Trigger

/images/reference/en-XX/help/370520P-01/civrn.gif

instrument handle identifies your instrument session. instrument handle is obtained from the niHSDIO Init Acquisition Session VI.

/images/reference/en-XX/help/370520P-01/cstr.gif

channel list specifies which channels are configured for pattern matching using the pattern array value.

/images/reference/en-XX/help/370520P-01/cstr.gif

pattern array specifies the binary multi-sample pattern that activates the pattern match trigger. The first element in the array corresponds to the first pattern acquired.

This array of strings creates a mask for the multi-sample pattern. Each string is composed of the following characters:

  • X or x: Ignore the channel
  • 1: Match on a logic 1
  • 0: Match on a logic 0
  • R or r: Match on a rising edge
  • F or f: Match on a falling edge
  • E or e: Match on either edge
Note  R, F, and E are supported only on the first sample.

The first character in the expression corresponds to the first channel in channel list. The number of characters in pattern must correspond to the number of channels specified in channel list or an error is returned.

For example, the following two examples are valid and achieve the same results:

  • channel list = 19-0 and pattern array = 0000 0XXX XX11 1111 1111
  • channel list = 0-19 and pattern array = 1111 1111 11XX XXX0 0000

The following example searches for ten consecutive samples on channel 0:

Sample 0 x
Sample 1 1
Sample ... ...
Sample 8 0
Sample 9 1

The following example searches for ten consecutive samples on channels 0 to 19:

Sample 0 0000 0000 0000 0000 0000
Sample 1 1111 1111 1111 1111 0000
Sample ... ...
Sample 8 0000 1111 1111 1111 1111
Sample 9 1111 1111 11XX XXX0 0000
/images/reference/en-XX/help/370520P-01/cerrcodeclst.gif

error in (no error) describes error conditions that occur before this node runs. This input provides standard error in functionality.

/images/reference/en-XX/help/370520P-01/cbool.gif

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.

/images/reference/en-XX/help/370520P-01/ci32.gif

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.

/images/reference/en-XX/help/370520P-01/cstr.gif

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.

/images/reference/en-XX/help/370520P-01/iivrn.gif

instrument handle out passes a reference to your instrument session to the next VI. instrument handle is obtained from the niHSDIO Init Acquisition Session VI.

/images/reference/en-XX/help/370520P-01/ierrcodeclst.gif

error out contains error information. This output provides standard error out functionality.

/images/reference/en-XX/help/370520P-01/ibool.gif

status is TRUE (X) if an error occurred or FALSE (checkmark) to indicate a warning or that no error occurred.

/images/reference/en-XX/help/370520P-01/ii32.gif

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.

/images/reference/en-XX/help/370520P-01/istr.gif

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.

Multi-Sample Pattern Match Start Trigger (U32)

This instance of niHSDIO Configure Trigger configures the Start trigger for multi-sample pattern match triggering. You can configure up to 32 channels with patterns of up to 10 samples per channel with this VI. For the channels specified in the channel list parameter, the pattern must match each pattern element specified in the pattern array parameter on consecutive clock cycles. After the last pattern element in the pattern array parameter is matched, the Start trigger is asserted.

This VI is valid only for acquisition sessions.

niHSDIO Configure Multi-Sample Pattern Match Start Trigger (U32)

/images/reference/en-XX/help/370520P-01/civrn.gif

instrument handle identifies your instrument session. instrument handle is obtained from the niHSDIO Init Acquisition Session VI.

/images/reference/en-XX/help/370520P-01/cstr.gif

channel list specifies which channels are configured for pattern matching using the pattern array value.

/images/reference/en-XX/help/370520P-01/cu32.gif

pattern array specifies the binary multi-sample pattern that activates the pattern match trigger. The first element in the array corresponds to the first pattern acquired.

Bits on channels not specified in channel list are ignored.

The following example searches for ten consecutive samples on channel 0:

Sample 0 0x0
Sample 1 0x1
Sample ... ...
Sample 8 0x0
Sample 9 0x1

The following example searches for ten consecutive samples on channels 0 to 19:

Sample 0 0xABCDE
Sample 1 0xFFFFF
Sample ... ...
Sample 8 0xFFFFF
Sample 9 0xABCDE
/images/reference/en-XX/help/370520P-01/cerrcodeclst.gif

error in (no error) describes error conditions that occur before this node runs. This input provides standard error in functionality.

/images/reference/en-XX/help/370520P-01/cbool.gif

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.

/images/reference/en-XX/help/370520P-01/ci32.gif

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.

/images/reference/en-XX/help/370520P-01/cstr.gif

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.

/images/reference/en-XX/help/370520P-01/iivrn.gif

instrument handle out passes a reference to your instrument session to the next VI. instrument handle is obtained from the niHSDIO Init Acquisition Session VI.

/images/reference/en-XX/help/370520P-01/ierrcodeclst.gif

error out contains error information. This output provides standard error out functionality.

/images/reference/en-XX/help/370520P-01/ibool.gif

status is TRUE (X) if an error occurred or FALSE (checkmark) to indicate a warning or that no error occurred.

/images/reference/en-XX/help/370520P-01/ii32.gif

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.

/images/reference/en-XX/help/370520P-01/istr.gif

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 Start Trigger

This instance of niHSDIO Configure Trigger configures the Start trigger for software triggering. Use the niHSDIO Send Software Edge Trigger VI to assert the trigger condition.

niHSDIO Configure Software Start Trigger

/images/reference/en-XX/help/370520P-01/civrn.gif

instrument handle identifies your instrument session. instrument handle is obtained from the niHSDIO Init Acquisition Session VI, the niHSDIO Init Generation Session VI, or the niHSDIO Init Ext Cal VI.

/images/reference/en-XX/help/370520P-01/cerrcodeclst.gif

error in (no error) describes error conditions that occur before this node runs. This input provides standard error in functionality.

/images/reference/en-XX/help/370520P-01/cbool.gif

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.

/images/reference/en-XX/help/370520P-01/ci32.gif

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.

/images/reference/en-XX/help/370520P-01/cstr.gif

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.

/images/reference/en-XX/help/370520P-01/iivrn.gif

instrument handle out passes a reference to your instrument session to the next VI. instrument handle is obtained from the niHSDIO Init Acquisition Session VI or the niHSDIO Init Generation Session VI.

/images/reference/en-XX/help/370520P-01/ierrcodeclst.gif

error out contains error information. This output provides standard error out functionality.

/images/reference/en-XX/help/370520P-01/ibool.gif

status is TRUE (X) if an error occurred or FALSE (checkmark) to indicate a warning or that no error occurred.

/images/reference/en-XX/help/370520P-01/ii32.gif

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.

/images/reference/en-XX/help/370520P-01/istr.gif

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.

Disable Start Trigger

This instance of niHSDIO Configure Trigger configures the instrument to not wait for a Start trigger after the niHSDIO Initiate VI is used. Using this VI is necessary only if you have configured a Start trigger and now want to disable it.

niHSDIO Disable Start Trigger

/images/reference/en-XX/help/370520P-01/civrn.gif

instrument handle identifies your instrument session. instrument handle is obtained from the niHSDIO Init Acquisition Session VI, the niHSDIO Init Generation Session VI, or the niHSDIO Init Ext Cal VI.

/images/reference/en-XX/help/370520P-01/cerrcodeclst.gif

error in (no error) describes error conditions that occur before this node runs. This input provides standard error in functionality.

/images/reference/en-XX/help/370520P-01/cbool.gif

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.

/images/reference/en-XX/help/370520P-01/ci32.gif

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.

/images/reference/en-XX/help/370520P-01/cstr.gif

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.

/images/reference/en-XX/help/370520P-01/iivrn.gif

instrument handle out passes a reference to your instrument session to the next VI. instrument handle is obtained from the niHSDIO Init Acquisition Session VI or the niHSDIO Init Generation Session VI.

/images/reference/en-XX/help/370520P-01/ierrcodeclst.gif

error out contains error information. This output provides standard error out functionality.

/images/reference/en-XX/help/370520P-01/ibool.gif

status is TRUE (X) if an error occurred or FALSE (checkmark) to indicate a warning or that no error occurred.

/images/reference/en-XX/help/370520P-01/ii32.gif

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.

/images/reference/en-XX/help/370520P-01/istr.gif

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

This instance of niHSDIO Configure Trigger configures the Reference trigger for digital edge triggering. If the Reference trigger is asserted before the required number of pretrigger samples are acquired, it is ignored. This VI is valid only for acquisition sessions.

niHSDIO Configure Digital Edge Ref Trigger

/images/reference/en-XX/help/370520P-01/civrn.gif

instrument handle identifies your instrument session. instrument handle is obtained from the niHSDIO Init Acquisition Session VI.

/images/reference/en-XX/help/370520P-01/ci32.gif

pretrig samples (500) specifies the number of pretrigger samples the device must receive before the Reference trigger is acknowledged.

/images/reference/en-XX/help/370520P-01/cstr.gif

source specifies the trigger source. You can choose PFI <0..3>, PFI <24..31>, PXI Trigger Line/RTSI <0..7>, PXI STAR Line, or PXIe DStarB.

Note  Only NI 6555/6556 devices support PFI <24..31> and PXIe DStarB.
/images/reference/en-XX/help/370520P-01/ci32.gif

edge specifies the edge to detect.

Rising Edge (12)

The trigger asserts on the rising edge of the digital signal.

Falling Edge (13)

The trigger asserts on the falling edge of the digital signal.

/images/reference/en-XX/help/370520P-01/cerrcodeclst.gif

error in (no error) describes error conditions that occur before this node runs. This input provides standard error in functionality.

/images/reference/en-XX/help/370520P-01/cbool.gif

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.

/images/reference/en-XX/help/370520P-01/ci32.gif

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.

/images/reference/en-XX/help/370520P-01/cstr.gif

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.

/images/reference/en-XX/help/370520P-01/iivrn.gif

instrument handle out passes a reference to your instrument session to the next VI. instrument handle is obtained from the niHSDIO Init Acquisition Session VI or the niHSDIO Init Generation Session VI.

/images/reference/en-XX/help/370520P-01/ierrcodeclst.gif

error out contains error information. This output provides standard error out functionality.

/images/reference/en-XX/help/370520P-01/ibool.gif

status is TRUE (X) if an error occurred or FALSE (checkmark) to indicate a warning or that no error occurred.

/images/reference/en-XX/help/370520P-01/ii32.gif

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.

/images/reference/en-XX/help/370520P-01/istr.gif

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.

Pattern Match Ref Trigger (String)

This instance of niHSDIO Configure Trigger configures the Reference trigger for pattern match triggering. If the Reference trigger asserts before the required number of pretrigger samples are acquired, it is ignored. This VI is valid only for acquisition sessions.

niHSDIO Configure Pattern Match Ref Trigger

/images/reference/en-XX/help/370520P-01/civrn.gif

instrument handle identifies your instrument session. instrument handle is obtained from the niHSDIO Init Acquisition Session VI.

/images/reference/en-XX/help/370520P-01/ci32.gif

trigger when specifies the conditions under which the trigger is sent.

Pattern Matches The trigger is asserted when the sampled pattern matches the pattern specified in pattern.
Pattern Does Not Match The trigger is asserted when the sampled pattern does not match the pattern specified in pattern.

Refer to the Pattern Match Trigger topic for an illustration of when your data is acquired when using a pattern match trigger for acquisitions.

/images/reference/en-XX/help/370520P-01/ci32.gif

pretrig samples (500) specifies the number of pretrigger samples the device must receive before the Reference trigger is acknowledged.

/images/reference/en-XX/help/370520P-01/cstr.gif

channel list specifies which channels are configured for pattern matching using the pattern array value.

/images/reference/en-XX/help/370520P-01/cstr.gif

pattern specifies the binary pattern that activates the pattern match trigger under the conditions specified in trigger when.

This string expression creates a mask for the pattern. This expression is composed of characters:

  • X or x: Ignore the channel
  • 1: Match on a logic 1
  • 0: Match on a logic 0
  • R or r: Match on a rising edge
  • F or f: Match on a falling edge
  • E or e: Match on either edge

The first character in the expression corresponds to the first channel in channel list. The number of characters in pattern must correspond to the number of channels specified in channel list or an error is returned.

For example, the following two examples are valid and achieve the same results:

  • channel list = 19-0 and pattern = 0000 0XXX XX11 1111 1111
  • channel list = 0-19 and pattern = 1111 1111 11XX XXX0 0000
/images/reference/en-XX/help/370520P-01/cerrcodeclst.gif

error in (no error) describes error conditions that occur before this node runs. This input provides standard error in functionality.

/images/reference/en-XX/help/370520P-01/cbool.gif

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.

/images/reference/en-XX/help/370520P-01/ci32.gif

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.

/images/reference/en-XX/help/370520P-01/cstr.gif

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.

/images/reference/en-XX/help/370520P-01/iivrn.gif

instrument handle out passes a reference to your instrument session to the next VI. instrument handle is obtained from the niHSDIO Init Acquisition Session VI or the niHSDIO Init Generation Session VI.

/images/reference/en-XX/help/370520P-01/ierrcodeclst.gif

error out contains error information. This output provides standard error out functionality.

/images/reference/en-XX/help/370520P-01/ibool.gif

status is TRUE (X) if an error occurred or FALSE (checkmark) to indicate a warning or that no error occurred.

/images/reference/en-XX/help/370520P-01/ii32.gif

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.

/images/reference/en-XX/help/370520P-01/istr.gif

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.

Pattern Match Ref Trigger (U32)

This instance of niHSDIO Configure Trigger configures the Reference trigger for pattern match triggering. If the Reference trigger asserts before the required number of pretrigger samples are acquired, it is ignored. This VI is valid only for acquisition sessions.

niHSDIO Configure Pattern Match Ref Trigger (U32)

/images/reference/en-XX/help/370520P-01/civrn.gif

instrument handle identifies your instrument session. instrument handle is obtained from the niHSDIO Init Acquisition Session VI.

/images/reference/en-XX/help/370520P-01/ci32.gif

trigger when specifies the conditions under which the trigger is sent.

Pattern Matches The trigger is asserted when the sampled pattern matches the pattern specified in pattern.
Pattern Does Not Match The trigger is asserted when the sampled pattern does not match the pattern specified in pattern.

Refer to the Pattern Match Trigger topic for an illustration of when your data is acquired when using a pattern match trigger for acquisitions.

/images/reference/en-XX/help/370520P-01/ci32.gif

pretrig samples (500) specifies the number of pretrigger samples the device must receive before the Reference trigger is acknowledged.

/images/reference/en-XX/help/370520P-01/cstr.gif

channel list specifies which channels are configured for pattern matching using the pattern array value.

/images/reference/en-XX/help/370520P-01/ci32.gif

pattern specifies the binary pattern that activates the pattern match trigger under the conditions specified in trigger when.

Bits on channels not specified in channel list are ignored.

/images/reference/en-XX/help/370520P-01/cerrcodeclst.gif

error in (no error) describes error conditions that occur before this node runs. This input provides standard error in functionality.

/images/reference/en-XX/help/370520P-01/cbool.gif

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.

/images/reference/en-XX/help/370520P-01/ci32.gif

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.

/images/reference/en-XX/help/370520P-01/cstr.gif

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.

/images/reference/en-XX/help/370520P-01/iivrn.gif

instrument handle out passes a reference to your instrument session to the next VI. instrument handle is obtained from the niHSDIO Init Acquisition Session VI or the niHSDIO Init Generation Session VI.

/images/reference/en-XX/help/370520P-01/ierrcodeclst.gif

error out contains error information. This output provides standard error out functionality.

/images/reference/en-XX/help/370520P-01/ibool.gif

status is TRUE (X) if an error occurred or FALSE (checkmark) to indicate a warning or that no error occurred.

/images/reference/en-XX/help/370520P-01/ii32.gif

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.

/images/reference/en-XX/help/370520P-01/istr.gif

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.

Multi-Sample Pattern Match Ref Trigger (String)

This instance of niHSDIO Configure Trigger configures the Reference trigger for multi-sample pattern match triggering. You can configure up to 32 channels with patterns of up to 10 samples per channel with this VI. For the channels specified in the channel list parameter, the pattern must match each pattern element specified in the pattern array parameter on consecutive clock cycles. After the last pattern element in the pattern array parameter is matched, the Reference trigger is asserted.

This VI is valid only for acquisition sessions.

niHSDIO Configure Multi-Sample Pattern Match Reference Trigger

/images/reference/en-XX/help/370520P-01/civrn.gif

instrument handle identifies your instrument session. instrument handle is obtained from the niHSDIO Init Acquisition Session VI.

/images/reference/en-XX/help/370520P-01/cstr.gif

channel list specifies which channels are configured for pattern matching using the pattern array value.

/images/reference/en-XX/help/370520P-01/cstr.gif

pattern array specifies the binary multi-sample pattern that activates the pattern match trigger. The first element in the array corresponds to the first pattern acquired.

This array of strings creates a mask for the multi-sample pattern. Each string is composed of the following characters:

  • X or x: Ignore the channel
  • 1: Match on a logic 1
  • 0: Match on a logic 0
  • R or r: Match on a rising edge
  • F or f: Match on a falling edge
  • E or e: Match on either edge
Note  R, F, and E are supported only on the first sample.

The first character in the expression corresponds to the first channel in channel list. The number of characters in pattern must correspond to the number of channels specified in channel list or an error is returned.

For example, the following two examples are valid and achieve the same results:

  • channel list = 19-0 and pattern array = 0000 0XXX XX11 1111 1111
  • channel list = 0-19 and pattern array = 1111 1111 11XX XXX0 0000

The following example searches for ten consecutive samples on channel 0:

Sample 0 x
Sample 1 1
Sample ... ...
Sample 8 0
Sample 9 1

The following example searches for ten consecutive samples on channels 0 to 19:

Sample 0 0000 0000 0000 0000 0000
Sample 1 1111 1111 1111 1111 0000
Sample ... ...
Sample 8 0000 1111 1111 1111 1111
Sample 9 1111 1111 11XX XXX0 0000
/images/reference/en-XX/help/370520P-01/ci32.gif

pretrig samples (500) specifies the number of pretrigger samples the device must receive before the Reference trigger is acknowledged.

/images/reference/en-XX/help/370520P-01/cerrcodeclst.gif

error in (no error) describes error conditions that occur before this node runs. This input provides standard error in functionality.

/images/reference/en-XX/help/370520P-01/cbool.gif

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.

/images/reference/en-XX/help/370520P-01/ci32.gif

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.

/images/reference/en-XX/help/370520P-01/cstr.gif

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.

/images/reference/en-XX/help/370520P-01/iivrn.gif

instrument handle out passes a reference to your instrument session to the next VI. instrument handle is obtained from the niHSDIO Init Acquisition Session VI.

/images/reference/en-XX/help/370520P-01/ierrcodeclst.gif

error out contains error information. This output provides standard error out functionality.

/images/reference/en-XX/help/370520P-01/ibool.gif

status is TRUE (X) if an error occurred or FALSE (checkmark) to indicate a warning or that no error occurred.

/images/reference/en-XX/help/370520P-01/ii32.gif

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.

/images/reference/en-XX/help/370520P-01/istr.gif

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.

Multi-Sample Pattern Match Ref Trigger (U32)

This instance of niHSDIO Configure Trigger configures the Reference trigger for multi-sample pattern match triggering. You can configure up to 32 channels with patterns of up to 10 samples per channel with this VI. For the channels specified in the channel list parameter, the pattern must match each pattern element specified in the pattern array parameter on consecutive clock cycles. After the last pattern element in the pattern array parameter is matched, the Reference trigger is asserted.

This VI is valid only for acquisition sessions.

niHSDIO Configure Multi-Sample Pattern Match Reference Trigger (U32)

/images/reference/en-XX/help/370520P-01/civrn.gif

instrument handle identifies your instrument session. instrument handle is obtained from the niHSDIO Init Acquisition Session VI.

/images/reference/en-XX/help/370520P-01/cstr.gif

channel list specifies which channels are configured for pattern matching using the pattern array value.

/images/reference/en-XX/help/370520P-01/cu32.gif

pattern array specifies the binary multi-sample pattern that activates the pattern match trigger. The first element in the array corresponds to the first pattern acquired.

Bits on channels not specified in channel list are ignored.

The following example searches for ten consecutive samples on channel 0:

Sample 0 0x0
Sample 1 0x1
Sample ... ...
Sample 8 0x0
Sample 9 0x1

The following example searches for ten consecutive samples on channels 0 to 19:

Sample 0 0xABCDE
Sample 1 0xFFFFF
Sample ... ...
Sample 8 0xFFFFF
Sample 9 0xABCDE
/images/reference/en-XX/help/370520P-01/ci32.gif

pretrig samples (500) specifies the number of pretrigger samples the device must receive before the Reference trigger is acknowledged.

/images/reference/en-XX/help/370520P-01/cerrcodeclst.gif

error in (no error) describes error conditions that occur before this node runs. This input provides standard error in functionality.

/images/reference/en-XX/help/370520P-01/cbool.gif

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.

/images/reference/en-XX/help/370520P-01/ci32.gif

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.

/images/reference/en-XX/help/370520P-01/cstr.gif

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.

/images/reference/en-XX/help/370520P-01/iivrn.gif

instrument handle out passes a reference to your instrument session to the next VI. instrument handle is obtained from the niHSDIO Init Acquisition Session VI.

/images/reference/en-XX/help/370520P-01/ierrcodeclst.gif

error out contains error information. This output provides standard error out functionality.

/images/reference/en-XX/help/370520P-01/ibool.gif

status is TRUE (X) if an error occurred or FALSE (checkmark) to indicate a warning or that no error occurred.

/images/reference/en-XX/help/370520P-01/ii32.gif

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.

/images/reference/en-XX/help/370520P-01/istr.gif

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

This instance of niHSDIO Configure Trigger configures the Reference trigger for software triggering. If the Reference trigger asserts before the required number of pretrigger samples are acquired, it is ignored. Use the niHSDIO Send Software Edge Trigger VI to assert the trigger condition. This VI is valid only for acquisition sessions.

niHSDIO Configure Software Ref Trigger

/images/reference/en-XX/help/370520P-01/civrn.gif

instrument handle identifies your instrument session. instrument handle is obtained from the niHSDIO Init Acquisition Session VI.

/images/reference/en-XX/help/370520P-01/ci32.gif

pretrig samples (500) specifies the number of pretrigger samples the device must receive before the Reference trigger is acknowledged.

/images/reference/en-XX/help/370520P-01/cerrcodeclst.gif

error in (no error) describes error conditions that occur before this node runs. This input provides standard error in functionality.

/images/reference/en-XX/help/370520P-01/cbool.gif

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.

/images/reference/en-XX/help/370520P-01/ci32.gif

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.

/images/reference/en-XX/help/370520P-01/cstr.gif

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.

/images/reference/en-XX/help/370520P-01/iivrn.gif

instrument handle out passes a reference to your instrument session to the next VI. instrument handle is obtained from the niHSDIO Init Acquisition Session VI or the niHSDIO Init Generation Session VI.

/images/reference/en-XX/help/370520P-01/ierrcodeclst.gif

error out contains error information. This output provides standard error out functionality.

/images/reference/en-XX/help/370520P-01/ibool.gif

status is TRUE (X) if an error occurred or FALSE (checkmark) to indicate a warning or that no error occurred.

/images/reference/en-XX/help/370520P-01/ii32.gif

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.

/images/reference/en-XX/help/370520P-01/istr.gif

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.

Disable Ref Trigger

This instance of niHSDIO Configure Trigger configures the acquisition to have no Reference trigger. This VI is necessary only if you have configured a Reference trigger and now want to disable it. This VI is valid only for acquisition sessions.

niHSDIO Disable Ref Trigger

/images/reference/en-XX/help/370520P-01/civrn.gif

instrument handle identifies your instrument session. instrument handle is obtained from the niHSDIO Init Acquisition Session VI.

/images/reference/en-XX/help/370520P-01/cerrcodeclst.gif

error in (no error) describes error conditions that occur before this node runs. This input provides standard error in functionality.

/images/reference/en-XX/help/370520P-01/cbool.gif

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.

/images/reference/en-XX/help/370520P-01/ci32.gif

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.

/images/reference/en-XX/help/370520P-01/cstr.gif

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.

/images/reference/en-XX/help/370520P-01/iivrn.gif

instrument handle out passes a reference to your instrument session to the next VI. instrument handle is obtained from the niHSDIO Init Acquisition Session VI or the niHSDIO Init Generation Session VI.

/images/reference/en-XX/help/370520P-01/ierrcodeclst.gif

error out contains error information. This output provides standard error out functionality.

/images/reference/en-XX/help/370520P-01/ibool.gif

status is TRUE (X) if an error occurred or FALSE (checkmark) to indicate a warning or that no error occurred.

/images/reference/en-XX/help/370520P-01/ii32.gif

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.

/images/reference/en-XX/help/370520P-01/istr.gif

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 Advance Trigger

This instance of niHSDIO Configure Trigger configures the Advance trigger for digital edge triggering. This VI is valid only for acquisition sessions.

niHSDIO Configure Digital Edge Advance Trigger

/images/reference/en-XX/help/370520P-01/civrn.gif

instrument handle identifies your instrument session. instrument handle is obtained from the niHSDIO Init Acquisition Session VI.

/images/reference/en-XX/help/370520P-01/cstr.gif

source specifies the trigger source. You can choose PFI <0..3>, PFI <24..31>, PXI Trigger Line/RTSI <0..7>, PXI STAR Line, or PXIe DStarB.

Note  Only NI 6555/6556 devices support PFI <24..31> and PXIe DStarB.
/images/reference/en-XX/help/370520P-01/ci32.gif

edge specifies the edge to detect.

Rising Edge (12)

The trigger asserts on the rising edge of the digital signal.

Falling Edge (13)

The trigger asserts on the falling edge of the digital signal.

/images/reference/en-XX/help/370520P-01/cerrcodeclst.gif

error in (no error) describes error conditions that occur before this node runs. This input provides standard error in functionality.

/images/reference/en-XX/help/370520P-01/cbool.gif

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.

/images/reference/en-XX/help/370520P-01/ci32.gif

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.

/images/reference/en-XX/help/370520P-01/cstr.gif

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.

/images/reference/en-XX/help/370520P-01/iivrn.gif

instrument handle out passes a reference to your instrument session to the next VI. instrument handle is obtained from the niHSDIO Init Acquisition Session VI or the niHSDIO Init Generation Session VI.

/images/reference/en-XX/help/370520P-01/ierrcodeclst.gif

error out contains error information. This output provides standard error out functionality.

/images/reference/en-XX/help/370520P-01/ibool.gif

status is TRUE (X) if an error occurred or FALSE (checkmark) to indicate a warning or that no error occurred.

/images/reference/en-XX/help/370520P-01/ii32.gif

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.

/images/reference/en-XX/help/370520P-01/istr.gif

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.

Pattern Match Advance Trigger (String)

This instance of niHSDIO Configure Trigger configures the Advance trigger for pattern match triggering. This VI is valid only for acquisition sessions.

niHSDIO Configure Pattern Match Advance Trigger

/images/reference/en-XX/help/370520P-01/civrn.gif

instrument handle identifies your instrument session. instrument handle is obtained from the niHSDIO Init Acquisition Session VI.

/images/reference/en-XX/help/370520P-01/ci32.gif

trigger when specifies the conditions under which the trigger is sent.

Pattern Matches The trigger is asserted when the sampled pattern matches the pattern specified in pattern.
Pattern Does Not Match The trigger is asserted when the sampled pattern does not match the pattern specified in pattern.

Refer to the Pattern Match Trigger topic for an illustration of when your data is acquired when using a pattern match trigger for acquisitions.

/images/reference/en-XX/help/370520P-01/cstr.gif

channel list specifies which channels are configured for pattern matching using the pattern array value.

/images/reference/en-XX/help/370520P-01/cstr.gif

pattern specifies the binary pattern that activates the pattern match trigger under the conditions specified in trigger when.

This string expression creates a mask for the pattern. This expression is composed of characters:

  • X or x: Ignore the channel
  • 1: Match on a logic 1
  • 0: Match on a logic 0
  • R or r: Match on a rising edge
  • F or f: Match on a falling edge
  • E or e: Match on either edge

The first character in the expression corresponds to the first channel in channel list. The number of characters in pattern must correspond to the number of channels specified in channel list or an error is returned.

For example, the following two examples are valid and achieve the same results:

  • channel list = 19-0 and pattern = 0000 0XXX XX11 1111 1111
  • channel list = 0-19 and pattern = 1111 1111 11XX XXX0 0000
/images/reference/en-XX/help/370520P-01/cerrcodeclst.gif

error in (no error) describes error conditions that occur before this node runs. This input provides standard error in functionality.

/images/reference/en-XX/help/370520P-01/cbool.gif

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.

/images/reference/en-XX/help/370520P-01/ci32.gif

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.

/images/reference/en-XX/help/370520P-01/cstr.gif

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.

/images/reference/en-XX/help/370520P-01/iivrn.gif

instrument handle out passes a reference to your instrument session to the next VI. instrument handle is obtained from the niHSDIO Init Acquisition Session VI or the niHSDIO Init Generation Session VI.

/images/reference/en-XX/help/370520P-01/ierrcodeclst.gif

error out contains error information. This output provides standard error out functionality.

/images/reference/en-XX/help/370520P-01/ibool.gif

status is TRUE (X) if an error occurred or FALSE (checkmark) to indicate a warning or that no error occurred.

/images/reference/en-XX/help/370520P-01/ii32.gif

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.

/images/reference/en-XX/help/370520P-01/istr.gif

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.

Pattern Match Advance Trigger (U32)

This instance of niHSDIO Configure Trigger configures the Advance trigger for pattern match triggering. This VI is valid only for acquisition sessions.

niHSDIO Configure Pattern Match Advance Trigger (U32)

/images/reference/en-XX/help/370520P-01/civrn.gif

instrument handle identifies your instrument session. instrument handle is obtained from the niHSDIO Init Acquisition Session VI.

/images/reference/en-XX/help/370520P-01/ci32.gif

trigger when specifies the conditions under which the trigger is sent.

Pattern Matches The trigger is asserted when the sampled pattern matches the pattern specified in pattern.
Pattern Does Not Match The trigger is asserted when the sampled pattern does not match the pattern specified in pattern.

Refer to the Pattern Match Trigger topic for an illustration of when your data is acquired when using a pattern match trigger for acquisitions.

/images/reference/en-XX/help/370520P-01/cstr.gif

channel list specifies which channels are configured for pattern matching using the pattern array value.

/images/reference/en-XX/help/370520P-01/ci32.gif

pattern specifies the binary pattern that activates the pattern match trigger under the conditions specified in trigger when.

Bits on channels not specified in channel list are ignored.

/images/reference/en-XX/help/370520P-01/cerrcodeclst.gif

error in (no error) describes error conditions that occur before this node runs. This input provides standard error in functionality.

/images/reference/en-XX/help/370520P-01/cbool.gif

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.

/images/reference/en-XX/help/370520P-01/ci32.gif

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.

/images/reference/en-XX/help/370520P-01/cstr.gif

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.

/images/reference/en-XX/help/370520P-01/iivrn.gif

instrument handle out passes a reference to your instrument session to the next VI. instrument handle is obtained from the niHSDIO Init Acquisition Session VI or the niHSDIO Init Generation Session VI.

/images/reference/en-XX/help/370520P-01/ierrcodeclst.gif

error out contains error information. This output provides standard error out functionality.

/images/reference/en-XX/help/370520P-01/ibool.gif

status is TRUE (X) if an error occurred or FALSE (checkmark) to indicate a warning or that no error occurred.

/images/reference/en-XX/help/370520P-01/ii32.gif

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.

/images/reference/en-XX/help/370520P-01/istr.gif

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.

Multi-Sample Pattern Match Advance Trigger (String)

This instance of niHSDIO Configure Trigger configures the Advance trigger for multi-sample pattern match triggering. You can configure up to 32 channels with patterns of up to 10 samples per channel with this VI. For the channels specified in the channel list parameter, the pattern must match each pattern element specified in the pattern array parameter on consecutive clock cycles. After the last pattern element in the pattern array parameter is matched, the Advance trigger is asserted.

This VI is valid only for acquisition sessions.

niHSDIO Configure Multi-Sample Pattern Match Advance Trigger

/images/reference/en-XX/help/370520P-01/civrn.gif

instrument handle identifies your instrument session. instrument handle is obtained from the niHSDIO Init Acquisition Session VI.

/images/reference/en-XX/help/370520P-01/cstr.gif

channel list specifies which channels are configured for pattern matching using the pattern array value.

/images/reference/en-XX/help/370520P-01/cstr.gif

pattern array specifies the binary multi-sample pattern that activates the pattern match trigger. The first element in the array corresponds to the first pattern acquired.

This array of strings creates a mask for the multi-sample pattern. Each string is composed of the following characters:

  • X or x: Ignore the channel
  • 1: Match on a logic 1
  • 0: Match on a logic 0
  • R or r: Match on a rising edge
  • F or f: Match on a falling edge
  • E or e: Match on either edge
Note  R, F, and E are supported only on the first sample.

The first character in the expression corresponds to the first channel in channel list. The number of characters in pattern must correspond to the number of channels specified in channel list or an error is returned.

For example, the following two examples are valid and achieve the same results:

  • channel list = 19-0 and pattern array = 0000 0XXX XX11 1111 1111
  • channel list = 0-19 and pattern array = 1111 1111 11XX XXX0 0000

The following example searches for ten consecutive samples on channel 0:

Sample 0 x
Sample 1 1
Sample ... ...
Sample 8 0
Sample 9 1

The following example searches for ten consecutive samples on channels 0 to 19:

Sample 0 0000 0000 0000 0000 0000
Sample 1 1111 1111 1111 1111 0000
Sample ... ...
Sample 8 0000 1111 1111 1111 1111
Sample 9 1111 1111 11XX XXX0 0000
/images/reference/en-XX/help/370520P-01/cerrcodeclst.gif

error in (no error) describes error conditions that occur before this node runs. This input provides standard error in functionality.

/images/reference/en-XX/help/370520P-01/cbool.gif

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.

/images/reference/en-XX/help/370520P-01/ci32.gif

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.

/images/reference/en-XX/help/370520P-01/cstr.gif

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.

/images/reference/en-XX/help/370520P-01/iivrn.gif

instrument handle out passes a reference to your instrument session to the next VI. instrument handle is obtained from the niHSDIO Init Acquisition Session VI.

/images/reference/en-XX/help/370520P-01/ierrcodeclst.gif

error out contains error information. This output provides standard error out functionality.

/images/reference/en-XX/help/370520P-01/ibool.gif

status is TRUE (X) if an error occurred or FALSE (checkmark) to indicate a warning or that no error occurred.

/images/reference/en-XX/help/370520P-01/ii32.gif

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.

/images/reference/en-XX/help/370520P-01/istr.gif

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.

Multi-Sample Pattern Match Advance Trigger (U32)

This instance of niHSDIO Configure Trigger configures the Advance trigger for multi-sample pattern match triggering. You can configure up to 32 channels with patterns of up to 10 samples per channel with this VI. For the channels specified in the channel list parameter, the pattern must match each pattern element specified in the pattern array parameter on consecutive clock cycles. After the last pattern element in the pattern array parameter is matched, the Advance trigger is asserted.

This VI is valid only for acquisition sessions.

niHSDIO Configure Multi-Sample Pattern Match Advance Trigger (U32)

/images/reference/en-XX/help/370520P-01/civrn.gif

instrument handle identifies your instrument session. instrument handle is obtained from the niHSDIO Init Acquisition Session VI.

/images/reference/en-XX/help/370520P-01/cstr.gif

channel list specifies which channels are configured for pattern matching using the pattern array value.

/images/reference/en-XX/help/370520P-01/cu32.gif

pattern array specifies the binary multi-sample pattern that activates the pattern match trigger. The first element in the array corresponds to the first pattern acquired.

Bits on channels not specified in channel list are ignored.

The following example searches for ten consecutive samples on channel 0:

Sample 0 0x0
Sample 1 0x1
Sample ... ...
Sample 8 0x0
Sample 9 0x1

The following example searches for ten consecutive samples on channels 0 to 19:

Sample 0 0xABCDE
Sample 1 0xFFFFF
Sample ... ...
Sample 8 0xFFFFF
Sample 9 0xABCDE
/images/reference/en-XX/help/370520P-01/cerrcodeclst.gif

error in (no error) describes error conditions that occur before this node runs. This input provides standard error in functionality.

/images/reference/en-XX/help/370520P-01/cbool.gif

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.

/images/reference/en-XX/help/370520P-01/ci32.gif

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.

/images/reference/en-XX/help/370520P-01/cstr.gif

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.

/images/reference/en-XX/help/370520P-01/iivrn.gif

instrument handle out passes a reference to your instrument session to the next VI. instrument handle is obtained from the niHSDIO Init Acquisition Session VI.

/images/reference/en-XX/help/370520P-01/ierrcodeclst.gif

error out contains error information. This output provides standard error out functionality.

/images/reference/en-XX/help/370520P-01/ibool.gif

status is TRUE (X) if an error occurred or FALSE (checkmark) to indicate a warning or that no error occurred.

/images/reference/en-XX/help/370520P-01/ii32.gif

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.

/images/reference/en-XX/help/370520P-01/istr.gif

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 Advance Trigger

This instance of niHSDIO Configure Trigger configures the Advance trigger for software triggering. Use the niHSDIO Send Software Edge Trigger VI to assert the trigger condition. This VI is valid only for acquisition sessions.

niHSDIO Configure Software Advance Trigger

/images/reference/en-XX/help/370520P-01/civrn.gif

instrument handle identifies your instrument session. instrument handle is obtained from the niHSDIO Init Acquisition Session VI.

/images/reference/en-XX/help/370520P-01/cerrcodeclst.gif

error in (no error) describes error conditions that occur before this node runs. This input provides standard error in functionality.

/images/reference/en-XX/help/370520P-01/cbool.gif

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.

/images/reference/en-XX/help/370520P-01/ci32.gif

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.

/images/reference/en-XX/help/370520P-01/cstr.gif

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.

/images/reference/en-XX/help/370520P-01/iivrn.gif

instrument handle out passes a reference to your instrument session to the next VI. instrument handle is obtained from the niHSDIO Init Acquisition Session VI or the niHSDIO Init Generation Session VI.

/images/reference/en-XX/help/370520P-01/ierrcodeclst.gif

error out contains error information. This output provides standard error out functionality.

/images/reference/en-XX/help/370520P-01/ibool.gif

status is TRUE (X) if an error occurred or FALSE (checkmark) to indicate a warning or that no error occurred.

/images/reference/en-XX/help/370520P-01/ii32.gif

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.

/images/reference/en-XX/help/370520P-01/istr.gif

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.

Disable Advance Trigger

This instance of niHSDIO Configure Trigger configures the acquisition to not use an Advance trigger. This VI is necessary only if you have configured an Advance trigger and now want to disable it. This VI is valid only for acquisition sessions.

niHSDIO Disable Advance Trigger

/images/reference/en-XX/help/370520P-01/civrn.gif

instrument handle identifies your instrument session. instrument handle is obtained from the niHSDIO Init Acquisition Session VI.

/images/reference/en-XX/help/370520P-01/cerrcodeclst.gif

error in (no error) describes error conditions that occur before this node runs. This input provides standard error in functionality.

/images/reference/en-XX/help/370520P-01/cbool.gif

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.

/images/reference/en-XX/help/370520P-01/ci32.gif

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.

/images/reference/en-XX/help/370520P-01/cstr.gif

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.

/images/reference/en-XX/help/370520P-01/iivrn.gif

instrument handle out passes a reference to your instrument session to the next VI. instrument handle is obtained from the niHSDIO Init Acquisition Session VI or the niHSDIO Init Generation Session VI.

/images/reference/en-XX/help/370520P-01/ierrcodeclst.gif

error out contains error information. This output provides standard error out functionality.

/images/reference/en-XX/help/370520P-01/ibool.gif

status is TRUE (X) if an error occurred or FALSE (checkmark) to indicate a warning or that no error occurred.

/images/reference/en-XX/help/370520P-01/ii32.gif

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.

/images/reference/en-XX/help/370520P-01/istr.gif

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 Script Trigger

This instance of niHSDIO Configure Trigger configures the Script trigger for digital edge triggering. This VI is valid only for generation sessions.

Note  Script Trigger 3 is not available when using the NI 6544/6545/6547/6548.

niHSDIO Configure Digital Edge Script Trigger

/images/reference/en-XX/help/370520P-01/civrn.gif

instrument handle identifies your instrument session. instrument handle is obtained from the niHSDIO Init Generation Session VI.

/images/reference/en-XX/help/370520P-01/cstr.gif

trigger id specifies the instance of the Script trigger.

You can choose Script Trigger 0, Script Trigger 1, Script Trigger 2, or Script Trigger 3 based on which trigger you are using for your Script.

/images/reference/en-XX/help/370520P-01/cstr.gif

source specifies the trigger source. You can choose PFI <0..3>, PFI <24..31>, PXI Trigger Line/RTSI <0..7>, PXI STAR Line, or PXIe DStarB.

Note  Only NI 6555/6556 devices support PFI <24..31> and PXIe DStarB.
/images/reference/en-XX/help/370520P-01/ci32.gif

edge specifies the edge to detect.

Rising Edge (12)

The trigger asserts on the rising edge of the digital signal.

Falling Edge (13)

The trigger asserts on the falling edge of the digital signal.

/images/reference/en-XX/help/370520P-01/cerrcodeclst.gif

error in (no error) describes error conditions that occur before this node runs. This input provides standard error in functionality.

/images/reference/en-XX/help/370520P-01/cbool.gif

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.

/images/reference/en-XX/help/370520P-01/ci32.gif

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.

/images/reference/en-XX/help/370520P-01/cstr.gif

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.

/images/reference/en-XX/help/370520P-01/iivrn.gif

instrument handle out passes a reference to your instrument session to the next VI. instrument handle is obtained from the niHSDIO Init Acquisition Session VI or the niHSDIO Init Generation Session VI.

/images/reference/en-XX/help/370520P-01/ierrcodeclst.gif

error out contains error information. This output provides standard error out functionality.

/images/reference/en-XX/help/370520P-01/ibool.gif

status is TRUE (X) if an error occurred or FALSE (checkmark) to indicate a warning or that no error occurred.

/images/reference/en-XX/help/370520P-01/ii32.gif

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.

/images/reference/en-XX/help/370520P-01/istr.gif

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 Level Script Trigger

This instance of niHSDIO Configure Trigger configures a Script trigger for level triggering. This VI is valid only for generation sessions.

Note  Script Trigger 3 is not available when using the NI 6544/6545/6547/6548.

niHSDIO Configure Digital Level Script Trigger

/images/reference/en-XX/help/370520P-01/civrn.gif

instrument handle identifies your instrument session. instrument handle is obtained from the niHSDIO Init Generation Session VI.

/images/reference/en-XX/help/370520P-01/cstr.gif

trigger id specifies the instance of the Script trigger.

You can choose Script Trigger 0, Script Trigger 1, Script Trigger 2, or Script Trigger 3 based on which trigger you are using for your Script.

/images/reference/en-XX/help/370520P-01/cstr.gif

source specifies the trigger source. You can choose PFI <0..3>, PFI <24..31>, PXI Trigger Line/RTSI <0..7>, PXI STAR Line, or PXIe DStarB.

Note  Only NI 6555/6556 devices support PFI <24..31> and PXIe DStarB.
/images/reference/en-XX/help/370520P-01/ci32.gif

trigger when specifies the active level for the desired trigger.

High Level Trigger is active while the signal specified by the source is high.
Low Level Trigger is active while the signal specified by the source is low.
/images/reference/en-XX/help/370520P-01/cerrcodeclst.gif

error in (no error) describes error conditions that occur before this node runs. This input provides standard error in functionality.

/images/reference/en-XX/help/370520P-01/cbool.gif

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.

/images/reference/en-XX/help/370520P-01/ci32.gif

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.

/images/reference/en-XX/help/370520P-01/cstr.gif

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.

/images/reference/en-XX/help/370520P-01/iivrn.gif

instrument handle out passes a reference to your instrument session to the next VI. instrument handle is obtained from the niHSDIO Init Acquisition Session VI or the niHSDIO Init Generation Session VI.

/images/reference/en-XX/help/370520P-01/ierrcodeclst.gif

error out contains error information. This output provides standard error out functionality.

/images/reference/en-XX/help/370520P-01/ibool.gif

status is TRUE (X) if an error occurred or FALSE (checkmark) to indicate a warning or that no error occurred.

/images/reference/en-XX/help/370520P-01/ii32.gif

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.

/images/reference/en-XX/help/370520P-01/istr.gif

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 Script Trigger

This instance of niHSDIO Configure Trigger configures the Script trigger for software triggering. Use the niHSDIO Send Software Edge Trigger VI to assert the trigger condition. This VI is valid only for generation sessions.

Note  Script Trigger 3 is not available when using the NI 6544/6545/6547/6548.

niHSDIO Configure Software Script Trigger

/images/reference/en-XX/help/370520P-01/civrn.gif

instrument handle identifies your instrument session. instrument handle is obtained from the niHSDIO Init Generation Session VI.

/images/reference/en-XX/help/370520P-01/cstr.gif

trigger id specifies the instance of the Script trigger.

You can choose Script Trigger 0, Script Trigger 1, Script Trigger 2, or Script Trigger 3 based on which trigger you are using for your Script.

/images/reference/en-XX/help/370520P-01/cerrcodeclst.gif

error in (no error) describes error conditions that occur before this node runs. This input provides standard error in functionality.

/images/reference/en-XX/help/370520P-01/cbool.gif

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.

/images/reference/en-XX/help/370520P-01/ci32.gif

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.

/images/reference/en-XX/help/370520P-01/cstr.gif

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.

/images/reference/en-XX/help/370520P-01/iivrn.gif

instrument handle out passes a reference to your instrument session to the next VI. instrument handle is obtained from the niHSDIO Init Acquisition Session VI or the niHSDIO Init Generation Session VI.

/images/reference/en-XX/help/370520P-01/ierrcodeclst.gif

error out contains error information. This output provides standard error out functionality.

/images/reference/en-XX/help/370520P-01/ibool.gif

status is TRUE (X) if an error occurred or FALSE (checkmark) to indicate a warning or that no error occurred.

/images/reference/en-XX/help/370520P-01/ii32.gif

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.

/images/reference/en-XX/help/370520P-01/istr.gif

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.

Disable Script Trigger

This instance of niHSDIO Configure Trigger disables a Script trigger. This VI is necessary only if you have configured a Script trigger and now want to disable it. This VI is valid only for generation sessions.

Note  Script Trigger 3 is not available when using the NI 6544/6545/6547/6548.

niHSDIO Disable Script Trigger

/images/reference/en-XX/help/370520P-01/civrn.gif

instrument handle identifies your instrument session. instrument handle is obtained from the niHSDIO Init Generation Session VI.

/images/reference/en-XX/help/370520P-01/cstr.gif

trigger id specifies the instance of the Script trigger.

You can choose Script Trigger 0, Script Trigger 1, Script Trigger 2, or Script Trigger 3 based on which trigger you are using for your Script.

/images/reference/en-XX/help/370520P-01/cerrcodeclst.gif

error in (no error) describes error conditions that occur before this node runs. This input provides standard error in functionality.

/images/reference/en-XX/help/370520P-01/cbool.gif

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.

/images/reference/en-XX/help/370520P-01/ci32.gif

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.

/images/reference/en-XX/help/370520P-01/cstr.gif

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.

/images/reference/en-XX/help/370520P-01/iivrn.gif

instrument handle out passes a reference to your instrument session to the next VI. instrument handle is obtained from the niHSDIO Init Acquisition Session VI or the niHSDIO Init Generation Session VI.

/images/reference/en-XX/help/370520P-01/ierrcodeclst.gif

error out contains error information. This output provides standard error out functionality.

/images/reference/en-XX/help/370520P-01/ibool.gif

status is TRUE (X) if an error occurred or FALSE (checkmark) to indicate a warning or that no error occurred.

/images/reference/en-XX/help/370520P-01/ii32.gif

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.

/images/reference/en-XX/help/370520P-01/istr.gif

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 Level Pause Trigger

This instance of niHSDIO Configure Trigger configures the Pause trigger as a level trigger.

niHSDIO Configure Digital Level Pause Trigger

/images/reference/en-XX/help/370520P-01/civrn.gif

instrument handle identifies your instrument session. instrument handle is obtained from the niHSDIO Init Acquisition Session VI, the niHSDIO Init Generation Session VI, or the niHSDIO Init Ext Cal VI.

/images/reference/en-XX/help/370520P-01/cstr.gif

source specifies the trigger source. You can choose PFI <0..3>, PFI <24..31>, PXI Trigger Line/RTSI <0..7>, PXI STAR Line, or PXIe DStarB.

Note  Only NI 6555/6556 devices support PFI <24..31> and PXIe DStarB.
/images/reference/en-XX/help/370520P-01/ci32.gif

trigger when specifies the active level for the desired trigger.

High Level Trigger is active while the signal specified by the source is high.
Low Level Trigger is active while the signal specified by the source is low.
/images/reference/en-XX/help/370520P-01/cerrcodeclst.gif

error in (no error) describes error conditions that occur before this node runs. This input provides standard error in functionality.

/images/reference/en-XX/help/370520P-01/cbool.gif

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.

/images/reference/en-XX/help/370520P-01/ci32.gif

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.

/images/reference/en-XX/help/370520P-01/cstr.gif

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.

/images/reference/en-XX/help/370520P-01/iivrn.gif

instrument handle out passes a reference to your instrument session to the next VI. instrument handle is obtained from the niHSDIO Init Acquisition Session VI or the niHSDIO Init Generation Session VI.

/images/reference/en-XX/help/370520P-01/ierrcodeclst.gif

error out contains error information. This output provides standard error out functionality.

/images/reference/en-XX/help/370520P-01/ibool.gif

status is TRUE (X) if an error occurred or FALSE (checkmark) to indicate a warning or that no error occurred.

/images/reference/en-XX/help/370520P-01/ii32.gif

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.

/images/reference/en-XX/help/370520P-01/istr.gif

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.

Pattern Match Pause Trigger (String)

This instance of niHSDIO Configure Trigger configures the Pause trigger for pattern match triggering. This VI is valid only for acquisition sessions.

niHSDIO Configure Pattern Match Pause Trigger

/images/reference/en-XX/help/370520P-01/civrn.gif

instrument handle identifies your instrument session. instrument handle is obtained from the niHSDIO Init Acquisition Session VI.

/images/reference/en-XX/help/370520P-01/ci32.gif

trigger when specifies the conditions under which the trigger is sent.

Pattern Matches The trigger is asserted when the sampled pattern matches the pattern specified in pattern.
Pattern Does Not Match The trigger is asserted when the sampled pattern does not match the pattern specified in pattern.

Refer to the Pattern Match Trigger topic for an illustration of when your data is acquired when using a pattern match trigger for acquisitions.

/images/reference/en-XX/help/370520P-01/cstr.gif

channel list specifies which channels are configured for pattern matching using the pattern array value.

/images/reference/en-XX/help/370520P-01/cstr.gif

pattern specifies the binary pattern that activates the pattern match trigger under the conditions specified in trigger when.

This string expression creates a mask for the pattern. This expression is composed of characters:

  • X or x: Ignore the channel
  • 1: Match on a logic 1
  • 0: Match on a logic 0
  • R or r: Match on a rising edge
  • F or f: Match on a falling edge
  • E or e: Match on either edge

The first character in the expression corresponds to the first channel in channel list. The number of characters in pattern must correspond to the number of channels specified in channel list or an error is returned.

For example, the following two examples are valid and achieve the same results:

  • channel list = 19-0 and pattern = 0000 0XXX XX11 1111 1111
  • channel list = 0-19 and pattern = 1111 1111 11XX XXX0 0000
/images/reference/en-XX/help/370520P-01/cerrcodeclst.gif

error in (no error) describes error conditions that occur before this node runs. This input provides standard error in functionality.

/images/reference/en-XX/help/370520P-01/cbool.gif

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.

/images/reference/en-XX/help/370520P-01/ci32.gif

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.

/images/reference/en-XX/help/370520P-01/cstr.gif

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.

/images/reference/en-XX/help/370520P-01/iivrn.gif

instrument handle out passes a reference to your instrument session to the next VI. instrument handle is obtained from the niHSDIO Init Acquisition Session VI or the niHSDIO Init Generation Session VI.

/images/reference/en-XX/help/370520P-01/ierrcodeclst.gif

error out contains error information. This output provides standard error out functionality.

/images/reference/en-XX/help/370520P-01/ibool.gif

status is TRUE (X) if an error occurred or FALSE (checkmark) to indicate a warning or that no error occurred.

/images/reference/en-XX/help/370520P-01/ii32.gif

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.

/images/reference/en-XX/help/370520P-01/istr.gif

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.

niHSDIO Configure Pattern Match Pause Trigger (U32)

This instance of niHSDIO Configure Trigger configures the Pause trigger for pattern match triggering. This VI is valid only for acquisition sessions.

niHSDIO Configure Pattern Match Pause Trigger (U32)

/images/reference/en-XX/help/370520P-01/civrn.gif

instrument handle identifies your instrument session. instrument handle is obtained from the niHSDIO Init Acquisition Session VI.

/images/reference/en-XX/help/370520P-01/ci32.gif

trigger when specifies the conditions under which the trigger is sent.

Pattern Matches The trigger is asserted when the sampled pattern matches the pattern specified in pattern.
Pattern Does Not Match The trigger is asserted when the sampled pattern does not match the pattern specified in pattern.

Refer to the Pattern Match Trigger topic for an illustration of when your data is acquired when using a pattern match trigger for acquisitions.

/images/reference/en-XX/help/370520P-01/cstr.gif

channel list specifies which channels are configured for pattern matching using the pattern array value.

/images/reference/en-XX/help/370520P-01/ci32.gif

pattern specifies the binary pattern that activates the pattern match trigger under the conditions specified in trigger when.

Bits on channels not specified in channel list are ignored.

/images/reference/en-XX/help/370520P-01/cerrcodeclst.gif

error in (no error) describes error conditions that occur before this node runs. This input provides standard error in functionality.

/images/reference/en-XX/help/370520P-01/cbool.gif

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.

/images/reference/en-XX/help/370520P-01/ci32.gif

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.

/images/reference/en-XX/help/370520P-01/cstr.gif

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.

/images/reference/en-XX/help/370520P-01/iivrn.gif

instrument handle out passes a reference to your instrument session to the next VI. instrument handle is obtained from the niHSDIO Init Acquisition Session VI or the niHSDIO Init Generation Session VI.

/images/reference/en-XX/help/370520P-01/ierrcodeclst.gif

error out contains error information. This output provides standard error out functionality.

/images/reference/en-XX/help/370520P-01/ibool.gif

status is TRUE (X) if an error occurred or FALSE (checkmark) to indicate a warning or that no error occurred.

/images/reference/en-XX/help/370520P-01/ii32.gif

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.

/images/reference/en-XX/help/370520P-01/istr.gif

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.

Disable Pause Trigger

This instance of niHSDIO Configure Trigger configures the data operation to have no Pause trigger. Using this VI is necessary only if you configured the Pause trigger and now want to disable it.

niHSDIO Disable Pause Trigger

/images/reference/en-XX/help/370520P-01/civrn.gif

instrument handle identifies your instrument session. instrument handle is obtained from the niHSDIO Init Acquisition Session VI, the niHSDIO Init Generation Session VI, or the niHSDIO Init Ext Cal VI.

/images/reference/en-XX/help/370520P-01/cerrcodeclst.gif

error in (no error) describes error conditions that occur before this node runs. This input provides standard error in functionality.

/images/reference/en-XX/help/370520P-01/cbool.gif

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.

/images/reference/en-XX/help/370520P-01/ci32.gif

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.

/images/reference/en-XX/help/370520P-01/cstr.gif

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.

/images/reference/en-XX/help/370520P-01/iivrn.gif

instrument handle out passes a reference to your instrument session to the next VI. instrument handle is obtained from the niHSDIO Init Acquisition Session VI or the niHSDIO Init Generation Session VI.

/images/reference/en-XX/help/370520P-01/ierrcodeclst.gif

error out contains error information. This output provides standard error out functionality.

/images/reference/en-XX/help/370520P-01/ibool.gif

status is TRUE (X) if an error occurred or FALSE (checkmark) to indicate a warning or that no error occurred.

/images/reference/en-XX/help/370520P-01/ii32.gif

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.

/images/reference/en-XX/help/370520P-01/istr.gif

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 Stop Trigger

This instance of niHSDIO Configure Trigger configures the Stop trigger for digital edge triggering. This VI is valid only for generation sessions.

niHSDIO Configure Digital Edge Stop Trigger

/images/reference/en-XX/help/370520P-01/civrn.gif

instrument handle identifies your instrument session. instrument handle is obtained from the niHSDIO Init Generation Session VI.

/images/reference/en-XX/help/370520P-01/cstr.gif

source specifies the trigger source. You can choose PFI <0..3>, PFI <24..31>, PXI Trigger Line/RTSI <0..7>, PXI STAR Line, or PXIe DStarB.

Note  Only NI 6555/6556 devices support PFI <24..31> and PXIe DStarB.
/images/reference/en-XX/help/370520P-01/ci32.gif

edge specifies the edge to detect.

Rising Edge (12)

The trigger asserts on the rising edge of the digital signal.

Falling Edge (13)

The trigger asserts on the falling edge of the digital signal.

/images/reference/en-XX/help/370520P-01/cerrcodeclst.gif

error in (no error) describes error conditions that occur before this node runs. This input provides standard error in functionality.

/images/reference/en-XX/help/370520P-01/cbool.gif

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.

/images/reference/en-XX/help/370520P-01/ci32.gif

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.

/images/reference/en-XX/help/370520P-01/cstr.gif

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.

/images/reference/en-XX/help/370520P-01/iivrn.gif

instrument handle out passes a reference to your instrument session to the next VI. instrument handle is obtained from the niHSDIO Init Acquisition Session VI or the niHSDIO Init Generation Session VI.

/images/reference/en-XX/help/370520P-01/ierrcodeclst.gif

error out contains error information. This output provides standard error out functionality.

/images/reference/en-XX/help/370520P-01/ibool.gif

status is TRUE (X) if an error occurred or FALSE (checkmark) to indicate a warning or that no error occurred.

/images/reference/en-XX/help/370520P-01/ii32.gif

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.

/images/reference/en-XX/help/370520P-01/istr.gif

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 Stop Trigger

This instance of niHSDIO Configure Trigger configures the Stop trigger for software triggering. Use the niHSDIO Send Software Edge Trigger VI to assert the trigger condition. This VI is valid only for generation sessions.

niHSDIO Configure Software Stop Trigger

/images/reference/en-XX/help/370520P-01/civrn.gif

instrument handle identifies your instrument session. instrument handle is obtained from the niHSDIO Init Generation Session VI.

/images/reference/en-XX/help/370520P-01/cerrcodeclst.gif

error in (no error) describes error conditions that occur before this node runs. This input provides standard error in functionality.

/images/reference/en-XX/help/370520P-01/cbool.gif

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.

/images/reference/en-XX/help/370520P-01/ci32.gif

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.

/images/reference/en-XX/help/370520P-01/cstr.gif

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.

/images/reference/en-XX/help/370520P-01/iivrn.gif

instrument handle out passes a reference to your instrument session to the next VI. instrument handle is obtained from the niHSDIO Init Acquisition Session VI or the niHSDIO Init Generation Session VI.

/images/reference/en-XX/help/370520P-01/ierrcodeclst.gif

error out contains error information. This output provides standard error out functionality.

/images/reference/en-XX/help/370520P-01/ibool.gif

status is TRUE (X) if an error occurred or FALSE (checkmark) to indicate a warning or that no error occurred.

/images/reference/en-XX/help/370520P-01/ii32.gif

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.

/images/reference/en-XX/help/370520P-01/istr.gif

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.

Disable Stop Trigger

This instance of niHSDIO Configure Trigger configures the instrument to not wait for a Stop trigger after the niHSDIO Initiate VI is used. This VI is necessary only if you have configured a Stop trigger and now want to disable it. This VI is valid only for generation sessions.

niHSDIO Disable Stop Trigger

/images/reference/en-XX/help/370520P-01/civrn.gif

instrument handle identifies your instrument session. instrument handle is obtained from the niHSDIO Init Generation Session VI.

/images/reference/en-XX/help/370520P-01/cerrcodeclst.gif

error in (no error) describes error conditions that occur before this node runs. This input provides standard error in functionality.

/images/reference/en-XX/help/370520P-01/cbool.gif

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.

/images/reference/en-XX/help/370520P-01/ci32.gif

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.

/images/reference/en-XX/help/370520P-01/cstr.gif

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.

/images/reference/en-XX/help/370520P-01/iivrn.gif

instrument handle out passes a reference to your instrument session to the next VI. instrument handle is obtained from the niHSDIO Init Acquisition Session VI or the niHSDIO Init Generation Session VI.

/images/reference/en-XX/help/370520P-01/ierrcodeclst.gif

error out contains error information. This output provides standard error out functionality.

/images/reference/en-XX/help/370520P-01/ibool.gif

status is TRUE (X) if an error occurred or FALSE (checkmark) to indicate a warning or that no error occurred.

/images/reference/en-XX/help/370520P-01/ii32.gif

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.

/images/reference/en-XX/help/370520P-01/istr.gif

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.

WAS THIS ARTICLE HELPFUL?

Not Helpful