GTKWave 3.3 Wave Analyzer User's Guide GTKWave 3.3 Wave Analyzer User's Guide 1 GTKWave 3.3 Wave Analyzer User's Guide 2 User's Guide GTKWave GTKWave 3.3 Wave Analyzer User's Guide 3 Updated Nov 14, 2020. This manual supports GTKWave 3.3.108 and higher versions. Copyright (c) 1998-2020 BSI Portions of GTKWave are Copyright (c) 1999-2020 Udi Finkelstein. Context support is Copyright (c) 2007-2020 Kermin Elliott Fleming. Trace group support is Copyright (c) 2009-2020 Donald Baltus. GHW and additional GUI support is Copyright (c) 2005-2020 Tristan Gingold. Analog support is Copyright (c) 2005-2020 Thomas Sailer. External DnD support is Copyright (c) 2008-2020 Concept Engineering GmbH. FastLZ is Copyright (c) 2005-2020 Ariya Hidyat. LZ4 is Copyright (c) 2011-2020 Yann Collet. GTKWave is free software. See http://www.gnu.org for more information on the GNU GPL General Public License version 2. There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. The information in this document is subject to change without notice. GTKWave 3.3 Wave Analyzer User's Guide 4 Contents Using This Manual.................................................................9 Printing Conventions.....................................................................................9 Compiling and Installing GTKWave.......................................11 Unix and Linux Operating Systems...............................................................11 Microsoft Windows Operating Systems........................................................13 Apple Macintosh Operating Systems............................................................14 Introduction...........................................................................15 GTKWave Overview.......................................................................................15 Why Use GTKWave?......................................................................................16 What Is GTKWave?........................................................................................18 GTKWave User Interface........................................................19 GTKWave.......................................................................................................19 Main Window ............................................................................................19 Toolbutton Interface..................................................................................23 Signal Subwindow.....................................................................................24 Wave Subwindow.......................................................................................26 Navigation and Status Panel.....................................................................27 Menu Bar...................................................................................................28 TwinWave......................................................................................................29 RTLBrowse....................................................................................................30 Ergonomic Extras..........................................................................................33 Scroll Wheels.............................................................................................33 The Primary Marker..................................................................................33 Interactive VCD.........................................................................................33 GTKWave Menu Functions.....................................................35 File.................................................................................................................35 Edit................................................................................................................37 Search...........................................................................................................42 Time...............................................................................................................44 GTKWave 3.3 Wave Analyzer User's Guide 5 Markers.........................................................................................................46 View...............................................................................................................47 Help...............................................................................................................50 Quick Start.............................................................................51 Sample Design...............................................................................................51 Launching GTKWave.....................................................................................52 Displaying Waveforms...................................................................................54 Signal Search............................................................................................54 Hierarchy Search......................................................................................55 Tree Search...............................................................................................55 Signal Save Files.......................................................................................56 Pattern Search...........................................................................................56 Alias Files and Attaching External Disassemblers........................................57 Debugging the Source Code.........................................................................62 Appendix A: Command Line Options Reference....................63 gtkwave.........................................................................................................63 fst2vcd...........................................................................................................68 vcd2fst...........................................................................................................69 evcd2vcd........................................................................................................70 twinwave.......................................................................................................71 lxt2miner.......................................................................................................72 lxt2vcd...........................................................................................................73 rtlbrowse.......................................................................................................73 vcd2lxt...........................................................................................................74 vcd2lxt2.........................................................................................................75 vcd2vzt..........................................................................................................77 vzt2vcd..........................................................................................................78 vztminer.........................................................................................................79 shmidcat........................................................................................................80 fstminer.........................................................................................................81 xml2stems.....................................................................................................82 Appendix B: .gtkwaverc Variable Reference..........................85 Appendix C: VCD Recoding....................................................97 VList Recoding Strategy................................................................................97 Time Encoding...............................................................................................98 Single-bit Encoding.......................................................................................98 Multi-bit Encoding.........................................................................................99 Reals and String Encoding............................................................................100 Final Notes on VCD Recoding.......................................................................100 GTKWave 3.3 Wave Analyzer User's Guide 6 Appendix D: LXT File Format.................................................103 LXT Framing..................................................................................................103 LXT Section Pointers.....................................................................................103 LXT Section Definitions.................................................................................106 The lxt_write API...........................................................................................114 Appendix E: Tcl Commands....................................................117 Appendix F: Implementation of FST......................................137 Index......................................................................................147 Illustration Index...........................................................................................147 Alphabetical Index.........................................................................................147 GTKWave 3.3 Wave Analyzer User's Guide 7 GTKWave 3.3 Wave Analyzer User's Guide 8 Using This Manual Printing Conventions Text printed in the font courier reflects messages that will be seen on screen at a command prompt or as