Gentoo Archives: gentoo-commits

From: "Rafael Martins (rafaelmartins)" <rafaelmartins@g.o>
To: gentoo-commits@l.g.o
Subject: [gentoo-commits] gentoo commit in xml/htdocs/proj/en/science/electronics/tests: gtkwave.png index.xml
Date: Sun, 28 Nov 2010 19:00:54
Message-Id: 20101128190045.B07E520054@flycatcher.gentoo.org
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>