Dialog: Edit Receive Sequence

Top  Previous  Next

This dialog is used to define new Receive Sequences and edit existing ones (See also Editing and Managing Sequences).

 

Index

The index of the sequence displayed below. The first sequence has index 0 (zero).

 

1 - Name

Unique name for this sequence (e.g. "Ping received"). This name is for referencing the sequence. It is not the sequence received through the serial port. See "2 - Sequence" below.

 

2 - Sequence

The character sequence which should be detected by Docklight within the incoming serial data.

 

3 - Action

The action(s) performed when Docklight detects the sequence defined above.

 

You may choose from the following actions:

Answer - After receiving the sequence, transmit one of the Send Sequences. Only Send Sequences that do not contain wildcards can be used as an automatic answer.
Comment - After receiving the sequence, insert a user-defined comment into the communication window (and log file, if available).
Trigger - Trigger a snapshot when the sequence is detected. This is an advanced feature described in the section Catching a specific sequence...
Stop - Stop communications and end the test run.

 

Wildcards

Wildcards can be used to test for sequences that have a variable part with changing values (e.g. measurement or status values). See section Checking for sequences with random characters for details and examples.

 

Control Character Shortcuts

Using keyboard shortcuts is a great help when editing a sequence that contains both printing characters (letters A-z, digits 0-9, ...) and non-printing control characters (ASCII code 0 to 31). Predefined shortcuts are:

Ctrl+Enter for carriage return / <CR> / decimal code 13

Ctrl+Shift+Enter for line feed / <LF> / decimal code 10

 

Use WRENCH Options... --> Control Character Shortcuts to define other shortcuts you find useful.