24
Docklight V2.2 User Manual 07/2016 Copyright 2016 Flachmann und Heggelbacher GbR
Working with Docklight
Testing a serial device or a protocol implementation
Logging the test
Click on the
Start Logging
button on the main toolbar.
A dialog window will open for choosing
For each representation (ASCII, HEX, ...), a separate log file may be created. Choose at
least one representation. Log files will have a ".txt" or ".htm" file extension. Docklight
additionally adds the representation type to the file name to distinguish the different log
files. E.g. if the user specifies "Test1" as the base log file name, the plain text ASCII file
will be named "Test1_asc.txt", whereas an HTML HEX log file will be named
"Test1_hex.htm".
Confirm your log file settings and start logging by clicking the
OK
button.
To stop logging and close the log file(s), click the
Stop Logging
button on the main
toolbar. Unless the log file(s) have been closed, it is not possible to view their entire
contents.
5.6
Checking for Sequences With Random Characters (Receive
Sequence Wildcards)
Many serial devices support a set of commands to transmit measurement data and
other related information. In common text-based protocols the response from the serial
device consists of a fixed part (e.g. "temperature="), and a variable part, which is the
actual value (e.g "65F"). To detect all these responses correctly in the serial data
stream, you can define Receive Sequences containing
Take, for example, the following situation: A serial device measures the temperature and
periodically sends the actual reading. Docklight shows the following output:
07/30/2012 10:20:08.022 [RX] -
temperature=82F
<CR>
07/30/2012 10:22:10.558 [RX] -
temperature=85F
<CR>
07/30/2012 10:24:12.087 [RX] -
temperature=93F
<CR>
07/30/2012 10:26:14.891 [RX] -
temperature=102F
<CR>
...
Defining an individual Receive Sequence for every temperature value possible would not
be a practical option. Instead you would define one Receive Sequence using wildcards.
For example:
t | e | m | p | e | r | a | t | u | r | e | = | ? | # | # | F | r
("r" is the terminating <CR> Carriage Return character)
This ReceiveSequence would trigger on any of the temperature strings listed above. It
allows a 1-3 digit value for the temperature (i.e. from "0" to "999"). The following step-by-
step example describes how to define the above sequence. See also the
at the end of this section for some extra information on '#' wildcards.
NOTE: See
Calculating and Validating Checksums
on how to receive and validate
checksum data, e.g. CRCs. There are no wildcards required for checksum areas,
instead use some default character values, e.g. "00 00" in HEX representation.
Preconditions
Содержание Docklight V2.2
Страница 1: ...Docklight V2 2 User Manual 07 2016 Copyright 2016 Flachmann und Heggelbacher GbR...
Страница 5: ...Copyright...
Страница 7: ...Introduction...
Страница 11: ...User Interface...
Страница 14: ...Features and Functions...
Страница 17: ...Working with Docklight...
Страница 28: ...Working with Docklight Advanced...
Страница 41: ...Examples and Tutorials...
Страница 46: ...Reference...
Страница 62: ...Support...
Страница 64: ...Appendix...
Страница 76: ...76 Docklight V2 2 User Manual 07 2016 Copyright 2016 Flachmann und Heggelbacher GbR Appendix...
Страница 77: ...Glossary Terms Used...