niHSDIO_ConfigurePatternMatchPauseTriggerU32

NI Digital Waveform Generator/Analyzer

niHSDIO_ConfigurePatternMatchPauseTriggerU32

Specific Function

C Function Prototype

ViStatus niHSDIO_ConfigurePatternMatchPauseTriggerU32 (ViSession vi, ViConstString channelList, ViUInt32 pattern, ViInt32 triggerWhen);

Purpose

Configures the Pause trigger for pattern-match triggering.

Unlike niHSDIO_ConfigurePatternMatchPauseTrigger which uses a string, this function uses a binary format to only represent high and low. If you require more choices for your pattern, use the niHSDIO_ConfigurePatternMatchPauseTrigger function.

This function is valid only for acquisition sessions.

Note  The values seen by pattern matching are affected by data interpretation.

Parameters

Name Type Description
vi ViSession This handle identifies your instrument session. vi was obtained from niHSDIO_InitAcquisitionSession.
channelList ViConstString This string specifies which channels are configured for pattern matching using the pattern string. The order of channels in the list determines the order of the pattern string. Ex. "0-19" and "19-0" are reverse of one another.
pattern ViUInt32 Specifies the binary pattern that activates the pattern match trigger under the conditions specified in triggerWhen.

Bits on channels not specified in channelList are ignored.
triggerWhen ViInt32 Specifies when the trigger asserts.

Defined Values

NIHSDIO_VAL_PATTERN_MATCHES (36)—The trigger asserts when the pattern matches.
NIHSDIO_VAL_PATTERN_DOES_NOT_MATCH (37)—The trigger asserts when the pattern does not match.

Default Value: NIHSDIO_VAL_PATTERN_MATCHES

Return Value