1irsim-analyzer(3) IRSIM USER'S MANUAL irsim-analyzer(3)
2
6 irsim-analyzer
7
9 analyzer node...
10
12 The analyzer provides a graphical interface to irsim; displaying the
13 state of the nodes (or vectors) node...
14 Every invocation of the analyzer command adds a new set of signals to
16 the display list.
17 The view is split into 3 regions: a trace window, a text window, and a
19 banner. The banner displays the name of the simulation (from the sim
20 file), and the pull-down menu headers. The text window is a 1-line
21 window used to request and display certain information.
22 The trace window displays the following information:
24 left side: names of the signals (nodes/vectors) displayed.
26 top side: On the left and right sides, the time corresponding to the
28 left and right edges of the trace window. In the center,
29 the time of the current cursor position.
30 right side: Values of the signals under the cursor.
32
35 zoom:
36 in Zooms in by a factor of 2 (magnify).
37 out Zooms out by a factor of 2 (reduce).
39 base: Changes the numerical base used to display the value of the
41 selected vector (see below how to select a trace) to one of the
42 following:
43 bin (base 2)
45 oct (base 8)
47 hex (base 16)
49 window:1
51 delta T Allows to determine the difference (in time) between
53 any two edges. First click the mouse (any button)
54 to the right of the first edge, then to the left of
55 the second edge. The time of the two edges as well
56 as their difference will be shown in the text
57 window. As long as the button remains depressed, a
58 line is shown between the two edges. Times are all
59 shown in ns.
60 move to Moves the left edge of the trace window to the
62 specified time. The time is requested in the text
63 window.
64 set width Sets the number of ns. that will be displayed. The
66 time is requested in the text window.
67 name length Since the most important differentiating information
69 in a long signal name is usually at the end, the
70 analyzer will display the last 15 characters of a
71 signal name. This option allows changing the
72 maximum number of characters that will be displayed,
73 which must be in the range [8-256].
74 scroll Usually the analyzer displays simulation activity by
76 scrolling the traces to the left, so the last
77 changes are shown. The scroll feature
78 enables/disables this scrolling, effectively
79 freezing the traces. When scrolling is enabled, a
80 check mark is shown on this menu entry.
81 print: These options control the generation of a PostScript file
83 suitable for obtaining a hardcopy of the trace window.
84 file Requests the filename to hold the PostScript output.
86 Hitting <return> will use the default name (shown in
87 parens). Hitting <ctrl-C> will abort generation of the
88 file. The following menu entries control the aspect of
89 the PostScript file; a check mark in the corresponding
90 menu entry implies that the feature will be included in
91 the output.
92 banner Generate a banner, showing the simulation name and
94 current date.
95 legend Generate (in a separate page) a description of the
97 signals displayed: the complete names of nodes (since
98 the first characters may be stripped), and for vectors
99 the names of the nodes of wich it is composed.
100 times Generate a time ruler at the bottom of the traces.
102 outline Draw an outline around the trace window.
104
106 The analyzer provides various functions depending on where in the
107 window a mouse button is depressed. All buttons have the same meaning,
108 except inside the scrollbar. Pressing a mouse button in the following
109 regions will provide:
110 Signal names:
112 The signal name where the button was depressed will be
113 highlighted and will be moved to the position where the button
114 is released, scrolling the other traces if necessary. If the
115 button is released under the same signal on which it was
116 pressed, that signal will become selected. The selected signal
117 is always underlined, and some information regarding that signal
118 is printed in the text window.
119 If the button is released outside the traces area (above or
121 below) the signal will be removed from the display. It can only
122 be added again by invoking the analyzer command.
123 Left Arrow:
125 The traces are scrolled left by half a page (move back in time).
126 Right Arrow:
128 The traces are scrolled right by half a page (move forward in
129 time).
130 Double Left Arrow:
132 Scrolls traces left by a full page.
133 Double Right Arrow:
135 Scrolls traces right by a full page.
136 Scrollbar:
138 The left button allows to stretch the left side of the window,
139 thereby zooming in/out by an arbitrary amount. The right side
140 of the window remains the same.
141 The right button allows to stretch the right side of the window,
143 thereby zooming in/out by an arbitrary amount. The left side of
144 the window remains the same.
145 The middle button moves the whole view back and forth in time.
147 The magnification factor remains the same.
148 Traces
150 The cursor is moved to the time-step where the mouse is clicked.
151 Some lack of accuracy in selecting the time may become apparent
152 due to screen resolution round off.
153 Holding down the shift key simultaneously with the mouse button
155 will not move the cursor, but rather show the value of the
156 signal at the time-step where the mouse is clicked. The value
157 is printed in the text window using the following format:
158 name @ time:value=value,input=status
160 The value is always shown in binary, regardless of the base
162 selected for that signal. The status is a string showing which
163 nodes where inputs at that time. Nodes that were inputs have an
164 i in their respective position, otherwise an -.
165 Cursor Values:
167 The selected signal value is highlighted and, when the button is
168 released, the value of the signal is expanded in the text
169 window. This is useful for displaying each of the bits that
170 make up a vector. The information printed has the following
171 format:
172 name:value=value input=status
174 where value and status have the same meaning as above.
176 Banner:
178 Clicking on the banner brings the window to the foreground.
179 Box on Banner:
181 Clicking in the little box on the left side of the banner
182 iconizes the analyzer window. To de-iconize the window, simply
183 click any button within the icon.
184 Banner Menus:
186 Pressing a mouse button in one of the banner menus (on the right
187 side) will pull down the corresponding menu.
188
192 The analyzer application uses the appropriate resource specification at
193 startup time to customize the appearance of its window. The format for
194 a resource specification in the .Xdefaults file is:
195 [name.]resource: value
197 For the analyzer, the available names are irsim and analyzer. The
199 available resources are:
200 background Specifies the traces window background color. The
203 default is black.
204 foreground Specifies the text color, or the background of
206 everything else besides the traces window. The default
207 is white.
208 geometry Specifies the default geometry (window size and screen
210 location) of the graphic window. The default Xgeometry
211 is "=1000x300+0+0".
212 reverseVideo Specifies whether the foreground and background colors
214 are to be reversed (on monochrome displays only). The
215 default is off.
216 font Specifies the fixed-width font displayed. The default
218 is 6x13.
219 borderWidth Specifies the width of the border (in pixels). The
221 default is 2.
222 borderColor Specifies the border color when the window is selected.
224 The default is black.
225 highlight Specifies the color used for highlighting. The default
227 is red (color displays only).
228 traceColor Specifies the color in which the traces are drawn. The
230 default is white.
231 bannerBg Specifies the background color for the banner. The
233 default is white.
234 bannerFg Specifies the foreground (text) color for the banner.
236 The default is black.
237
240 irsim(1)
241 irsim-analyzer(3)