File	Date	Author	Commit
.gitignore	2014-02-19	Sebastian Humenda	[ae0e45] * add ToDo
COPYING	2014-01-19	Sebastian Humenda	[cb6955] - add COPYING with (full) GPL license
Makefile	2014-02-19	Sebastian Humenda	[652247] make Makefile more standards-conform, add unins...
README	2014-02-19	Sebastian Humenda	[a939ca] mention Makefile in README
ToDo	2014-02-19	Sebastian Humenda	[ae0e45] * add ToDo
vcd2txt.pl	2014-02-19	Sebastian Humenda	[6046d5] add timer offset functionality, use -t switch

Read Me

vcd2txt - view value change dumps on a tty
==========================================

Introduction
------------

This program reads value change dumps (*.vcd) that are generated e.g. by a
simulation using GHDL.

The copyright information can be found in the file `COPYING`.


Installation
------------

Just type

$ sudo make install

You can use DESTDIR and PREFIX to alter the default location to /usr/bin.

$ sudo make uninstall

will uninstall the script again.


Usage
-----

The usage is simple:

    ./vcd2txt <file.vcd>

The formatted tables are written directly to the terminal. The following should
be kept in mind when reading the table(s):

- All signal values are in hexadecimal format, except 'U' which stands for
  "undefined".
- Signal names are shortened to 6 characters.
- Time is given in nano-seconds.
- Tabwidth must be 8 characters.
- Every entity becomes a seperate table.

Further Development
-------------------

For problems or suggestions, feel free to contact the developers:

- `mzabeltud@users.sourceforge.net`
- `humenda@users.sourceforge.net`