Download Tektronix Logic Analyzer Family Version 4.2 Software User Manual

Transcript
Appendix B: TLA Symbol File Format
TSF Headers
A TSF header identifies the file format version to potential file readers. It
specifies whether the file contains pattern or range symbols, the radix used to
specify symbol values, and an optional offset amount to be added to each symbol
value (for range symbol files).
The TSF Header is a file directive, which means that the following information
begins with the special character combination of a number sign character
followed immediately by a plus sign (#+). This is not a comment line. The
special character sequence is used to mark instructions to the file reader; these
instructions are called file directives.
The following examples show sample file headers for a pattern symbol file and a
range symbol file. The first two lines are comments included for readability; they
are not required as part of the file header.
#
TSF Format
# ===============
#+ Version 2.1.0
Type
=======
PATTERN
Display Radix
=============
HEX
File Radix
==========
HEX
#
TSF Format
Type
Display Radix File Radix
# =============== ===== ============= ==========
#+ Version 2.1.0
RANGE
HEX
HEX
Offset
========
00000000
The File Format Version number contains three fields. The first two fields are the
format major and minor version numbers. The logic analyzer will only read TSF
files where the major and minor version number of the file is less than or equal
to that of the TLA TSF symbol file reader. The third field is used to denote
minor format changes, which do not impact the file reader.
The File Format Version number is followed by a key word, PATTERN or
RANGE, which signifies the type of symbols to be found in the file. TSF files
can contain either type of symbols, but no single file can contain both. The
header specifies the type for all symbols in the file.
The Display Radix field sets the default radix that will be used to display the
numeric symbol value. For range symbol files this field must be one of the key
words: HEX, DEC, OCT, or BIN. For pattern symbol files, only the key words:
HEX, OCT, or BIN are allowed.
The File Radix field specifies the radix used by the symbol values in this file.
Like the Display Radix field, the File Radix field must be one of the key words:
HEX, DEC, OCT, or BIN for range symbol files, or HEX, OCT, or BIN for
pattern symbol files.
B- 2
Tektronix Logic Analyzer Family User Manual, Version 4.2 Software