1 |
rafaelmartins 10/11/28 19:00:45 |
2 |
|
3 |
Added: gtkwave.png index.xml |
4 |
Log: |
5 |
Added "Test benches" page, with gtkwave tests. |
6 |
|
7 |
Revision Changes Path |
8 |
1.1 xml/htdocs/proj/en/science/electronics/tests/gtkwave.png |
9 |
|
10 |
<<Binary file>> |
11 |
|
12 |
|
13 |
1.1 xml/htdocs/proj/en/science/electronics/tests/index.xml |
14 |
|
15 |
file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/proj/en/science/electronics/tests/index.xml?rev=1.1&view=markup |
16 |
plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/proj/en/science/electronics/tests/index.xml?rev=1.1&content-type=text/plain |
17 |
|
18 |
Index: index.xml |
19 |
=================================================================== |
20 |
<?xml version="1.0" encoding="UTF-8"?> |
21 |
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd"> |
22 |
<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/proj/en/science/electronics/tests/index.xml,v 1.1 2010/11/28 19:00:45 rafaelmartins Exp $ --> |
23 |
|
24 |
<guide link="index.xml" lang="en"> |
25 |
<title>Test benches</title> |
26 |
|
27 |
<author title="Author"> |
28 |
<mail link="calchan@g.o">Denis Dupeyron</mail> |
29 |
</author> |
30 |
|
31 |
<author title="Author"> |
32 |
<mail link="rafaelmartins@g.o">Rafael G. Martins</mail> |
33 |
</author> |
34 |
|
35 |
<abstract>Test benches for all software maintained by the Electronics subproject</abstract> |
36 |
|
37 |
<!-- The content of this document is licensed under the CC-BY-SA license --> |
38 |
<!-- See http://creativecommons.org/licenses/by-sa/2.5 --> |
39 |
<license/> |
40 |
|
41 |
<version>1.0</version> |
42 |
<date>2010-11-28</date> |
43 |
|
44 |
<chapter> |
45 |
<title>Help wanted</title> |
46 |
<section> |
47 |
<body> |
48 |
<p> |
49 |
Help us create test benches for the tools we maintain. See |
50 |
<uri link="../todo.xml#doc_chap1">the 'Test benches' entry in our TODO list</uri>. |
51 |
</p> |
52 |
<p> |
53 |
Instructions on how to test our packages and verify they work properly should get |
54 |
listed below. Developers, please remember that a non-specialist must be able to |
55 |
execute your test bench. List packages alphabetically, and store any required |
56 |
additional material in a bz2 tarball in the same directory as this guide. |
57 |
</p> |
58 |
</body> |
59 |
</section> |
60 |
</chapter> |
61 |
|
62 |
<chapter> |
63 |
<title>Test benches</title> |
64 |
<section> |
65 |
<title>sci-electronics/gtkwave</title> |
66 |
<body> |
67 |
<p> |
68 |
An example is available in the source tarball. You can install its files by emerging |
69 |
GTKWave with USE=examples, which is what we are going to assume in the following |
70 |
instructions. You should replace ${PF} with the corresponding number of the version |
71 |
(with the revision) you want to test. |
72 |
</p> |
73 |
<pre caption="run the GTKWave example"> |
74 |
$ <i>cp -R /usr/share/doc/gtkwave-${PF}/examples .</i> |
75 |
$ <i>cd examples</i> |
76 |
$ <i>vzt2vcd des.vzt > des.vcd</i> |
77 |
VZTLOAD | 1432 facilities |
78 |
VZTLOAD | Total value bits: 22921 |
79 |
VZTLOAD | Read 1 block header OK |
80 |
VZTLOAD | [0] start time |
81 |
VZTLOAD | [704] end time |
82 |
VZTLOAD | |
83 |
VZTLOAD | block [0] processing 0 / 704 |
84 |
$ <i>gtkwave des.vcd</i> |
85 |
</pre> |
86 |
<figure link="gtkwave.png" short="GTKWave" caption="an example GTKWave window"/> |
87 |
<p> |
88 |
In the SST window (left side, towards the top) navigate down the hierarchy of signals, |
89 |
then drag and drop a few signals from the 'Signals' window below the SST window, to the |
90 |
other 'Signals' window just right of SST. Play with signals a bit, zoom in, zoom out, etc... |
91 |
</p> |
92 |
</body> |
93 |
</section> |
94 |
</chapter> |
95 |
|
96 |
</guide> |