niHSDIO_ConfigurePatternMatchStartTriggerU32

NI Digital Waveform Generator/Analyzer

niHSDIO_ConfigurePatternMatchStartTriggerU32

Specific Function

C Function Prototype

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

Purpose

Configures the Start trigger for pattern-match triggering.

Unlike niHSDIO_ConfigurePatternMatchStartTrigger 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_ConfigurePatternMatchStartTrigger function.

This function is only valid for acquisition operations.

Note  The logic levels 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 will be configured for pattern matching using the pattern string. The order of channels in the list determines the order of the pattern string.
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 the 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