Download SMASH - Reference manual

Appendix A
___________________________________________________________________________________
Format of the configuration file
At the beginning of the configuration file, general information must be given.
his2test samples all signals with a period introduced with the .PERIOD directive. This is the
strobing period. The .PERIOD directive must appear, it is not optional.
Syntax:
.PERIOD period_value
A default offset may be specified with the .DEFAULT_OFFSET keyword. This is the offset for
the strobing process. The .DEFAULT_OFFSET directive is optional. If no default offset is
specified, the default offset is zero. With a default offset specified, all signals in the .his file are
strobed at times: DEFAULT_OFFSET+n*PERIOD, with n=0,1,2..., unless they have a different
offset assigned, which overides the default (see below).
Syntax:
.DEFAULT_OFFSET def_offset_value
The total number of signals to be converted is introduced with the .SIGNAL_COLUMNS
directive. This directive must be given, it is not optional.
Syntax:
.SIGNAL_COLUMNS number_of_signals
The format of lines in the output file may be parametrized with the optional
.SEQUENCE_FORMAT directive. This directive introduces a string which defines the format of a
line (sequence) in the .tst file. Three tokens may be used in the string description, which are
substituted by their respective values: 'nseq' is the index of the sequence, 'tseq' is the time stamp,
and 'list' is the list of the signal values. Other characters may be given in the format string.
For example:
.SEQUENCE_FORMAT = "Sequence# 'nseq', at time 'tseq', is: < 'list'
>"
will produce this kind of output:
...
Sequence# 2, at time 100, is <111 1101 1001>
Sequence# 3, at time 150, is <011 110x 1101>
...
The default value of the sequence format is:
.SEQUENCE_FORMAT = "'nseq' 'list'"
Once these general parameters are given, the signal description begins. his2test lets you select the
signals you want to extract and convert from the .his file. The input signals must be given within
the .INPUTS section, and the output signals within the .OUTPUTS section. The .INPUTS section
starts with the .INPUTS keyword and is terminated by a .ENDS keyword. The .OUTPUTS section
starts with the .OUTPUTS keyword and is terminated by a .ENDS keyword. The signals in the
.INPUTS section are listed first, then the signals in the .OUTPUTS section.
Note: except for bidirectional signals, signals in .INPUTS section and signals in .OUTPUTS
section are treated identically.
Each signal in its section is introduced with a line which starts with the NAME keyword. It will
correspond to a column in the output file. Additional optional parameters may be specified along
the line. The signal description must fit on a single line in the .cfg file.
Syntax: (although shown on two lines below, this has fo fit on a single line)
461