Configure Multi-Sample Pattern Match Start Trigger
- Updated2023-02-17
- 3 minute(s) read
Configure Multi-Sample Pattern Match Start 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 node. 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 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 array
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
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 |
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.