The VCD Reader

This document describes the function of the software unit that reads VCD files and stores the value changes in a compressed and accelerated format to the wave database WDB for later processing.

Overview

Introduction
Options

Introduction

In addition of using the GateVision PRO GUI to read VCD files either the stand alone binary vcdcompile or the Tcl command wdb read can be used.

The vcdcompile binary reads the given VCD file and creates a WDB binfile containing the value changes of the input file:

vcdcompile -o binfile.zdb <OPTIONS> <FILE.VCD>

The wdb read Tcl command reads the given VCD file and returns the created in-memory WDB database:

set wdb [wdb read <OPTIONS> <FILE.VCD>]

The Tcl command is available in the Console window of the GateVision PRO GUI .

This document describes the usage of this flow.

Options

Option Parameters Description

Option	Parameters	Description
`-argsFromFile`	`<file>`	Read cmdline arguments from file.
`-breakOnError` \| `-breakOnErr`	`on\|off`	Stop on errors during parsing. (The default value for this option is `off`.)
`-debugFlag`	`<flag>`	Enable a specific debug flag.
`-dontCut`		Don’t cut long filenames in messages.
`-from`	`<time>`	Ignore value changes before time.
`-help` \| `-h`		Print a help text with a short description of each option.
`-info`	`None\|Error\|Warning\|Verbose\|Debug`	Level of verbosity for issued messages. (The default value for this option is `Error`.)
`-logAppend`		Append to logfile.
`-logfile`	`<file>`	Generate log file.
`-noCollapse`		Do not collapse multiple value changes at same t.
`-nogcd`		Compile without gcd for time deltas.
`-nologo`		Print no greeting message.
`-noSkipDupl`		Do not skip identical value changes.
`-nozip`		Compile without zip.
`-o`	`<file>`	Name of binary wave output file.
`-prog`		Print progress information.
`-skipLeadX`		Skip lead 'X' values, if all signal values are equal.
`-suppress`	`<type> <pattern>`	Suppress messages which match pattern.
`-time`		Print CPU time consumption (requires enabled progress updates).
`-to`	`<time>`	Ignore value changes after time.
`-wait_for_license` \| `-waitForLicense`	`<sec>`	Wait 'sec' seconds for a license. If the value is -1 then the started tool will not wait for the next free license. Use a value of 0 to wait forever. (The default value for this option is `-1`.)

-argsFromFile

<file>

Read cmdline arguments from file.

-breakOnError | -breakOnErr

on|off

Stop on errors during parsing.
(The default value for this option is off.)

-debugFlag

<flag>

Enable a specific debug flag.

-dontCut

Don’t cut long filenames in messages.

-from

<time>

Ignore value changes before time.

-help | -h

Print a help text with a short description of each option.

-info

None|Error|Warning|Verbose|Debug

Level of verbosity for issued messages.
(The default value for this option is Error.)

-logAppend

Append to logfile.

-logfile

<file>

Generate log file.

-noCollapse

Do not collapse multiple value changes at same t.

-nogcd

Compile without gcd for time deltas.

-nologo

Print no greeting message.

-noSkipDupl

Do not skip identical value changes.

-nozip

Compile without zip.

-o

<file>

Name of binary wave output file.

-prog

Print progress information.

-skipLeadX

Skip lead 'X' values, if all signal values are equal.

-suppress

<type> <pattern>

Suppress messages which match pattern.

-time

Print CPU time consumption (requires enabled progress updates).

-to

<time>

Ignore value changes after time.

-wait_for_license | -waitForLicense

<sec>

Wait 'sec' seconds for a license. If the value is -1 then the started tool will not wait for the next free license. Use a value of 0 to wait forever.
(The default value for this option is -1.)