Dialog: Edit Receive Sequence
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:
•Comment - After receiving the sequence, insert a user-defined comment into the communication window (and log file, if available). Various comment macros are available for creating dynamic comment texts.
•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.
•Checksum - Perform automatic validation of a checksum, including any type of CRC standard such as Modbus, CCITT, CRC32.
Set the Checksum Specification, as well as what should be done with the result:
Detect Checksum OK - the received data must have the same checksum than the calculated value from Docklight.
Checksum Wrong - the opposite. A mismatching checksum constitutes a "sequence match".
Both OK/Wrong - the sequence is always detected. The checksum area will contain all ASCII "1" (HEX 31) for a matching checksum, or ASCII "0" (HEX 30) for a wrong checksum.
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 Options... --> Control Character Shortcuts to define other shortcuts you find useful.