Configure Pattern Match Ref Trigger
- Updated2023-02-17
- 3 minute(s) read
Configure Pattern Match Ref 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 node is valid only for acquisition sessions.
Inputs/Outputs
channel list
The channels that are configured for pattern matching using the pattern array value.
session in
Instrument session obtained from the Initialize Acquisition Sessionnode, the Initialize Generation Sessionnode, or the Initialize External Calibrationnode.
error in
Error conditions that occur before this node runs.
The node responds to this input according to standard error behavior.
Default value: No error
pattern
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.
Examples of valid expressions
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
trigger when
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. |
Default value: Pattern matches
pretrigger samples
The number of pretrigger samples the device must receive before the Reference trigger is acknowledged.
Default value: 500
session out
Handle that identifies the session in all subsequent node calls.
The session out parameter is obtained from the Initialize Acquisition Sessionnode or the Initialize Generation Sessionnode.
error out
Error information.
The node produces this output according to standard error behavior.