Flachmann und Heggelbacher Docklight V2.2, Руководство пользователя

Страница: 25 / 83

25
Docklight V2.2 User Manual 07/2016 Copyright 2016 Flachmann und Heggelbacher GbR
Working with Docklight
· Docklight is ready to run a test as described in the previous use cases, e.g. testing a
serial device or a protocol implementation .
· The serial device (the temperature device in our example) is operating.
Using Receive Sequences with wildcards
A) Preparing the project
Create a new Docklight project and set up all communication parameters.
B) Defining the Receive Sequences used
1.
Create a new Receive Sequence . Enter a Name for the sequence.
2. Enter the fixed part of your expected answer in the Sequence section. For our
example you would enter the following sequence in ASCII mode:
t | e | m | p | e | r | a | t | u | r | e | =
3. Open the popup / context menu using the right mouse button , and choose
Wildcard '?' (matches one character) to insert the first wildcard at the cursor
position. Add two '#' wildcards using the popup menu Wildcard '#' (matches zero
or one character) . The sequence now looks like this:
t | e | m | p | e | r | a | t | u | r | e | = | ? | # | #
4. Enter the fixed tail of our temperature string, which is a letter 'F' and the terminating
<CR> character. You can use the default
control character shortcut Ctrl+Enter to
enter the <CR> / ASCII code 13. The sequence is now:
t | e | m | p | e | r | a | t | u | r | e | = | ? | # | # | F | r
5. Specify an Action to perform after a temperature reading has been detected.
6. Click OK to add the new sequence to the Receive Sequence list.
NOTE: To distinguish the wildcards '?' and '#' from the regular question mark or number
sign characters (decimal code 63 / 35), the wildcards are shown on a different
background color within the sequence editor.
C) Running the test
Start Docklight by choosing Run > Start Communication .
Docklight will now detect any temperature reading and perform the specified action.
Additional notes on '#' wildcards
1. '#' wildcards at the end of a Receive Sequence have no effect. The Receive Sequence
"HelloWorld###" will behave like a Receive Sequence "HelloWorld".
2. A "match inside a match" is not returned: If a Receive Sequence
"Hello#######World" is defined, and the incoming data is "Hello1Hello2World", the
Receive Sequence detected is "Hello1Hello2World", not "HelloWorld"
Receive Sequence comment macros
Macro keywords can be used in the Edit Receive Sequence > 3 - Action > Comment
text box, to create Docklight comment texts with dynamic data, e.g. the actual data
received.
Macro Is Replaced By
%_L Line break