Adds signals to the timing diagram that were specified by calling btim_dumpfile. This will dump the specified signals to the timing diagram during simulation. Once a dump signal has been added using this command, it can not be removed (Note that command btim_DeleteDumpSignal is associated with the btim_AddCorbaDumpSignal and not this command).

Syntax:

$btim_AddDumpSignal(levels?, [signal | scope]+)

Output:

Displays an error in the log window if the signals/scopes do not exist.

Arguments:

integer levels;

Optional. Specifies number of levels to traverse down for scope parameters. Defaults to 1. To dump all levels below the scopes, set to 0.

char* signal_or_scope;

If signal name, dumps the signal. If scope, dumps signals in that scope (and potentially sub-scopes, depending on levels passed).

Description

Adds signals to the timing diagram that was specified by calling btim_dumpfile. If  btim_dumpfile was not previously called, the signals will be dumped to a file called dump.btim. The specified signals will be dumped to the timing diagram during simulation. Examples:

To dump all signals in scope top.mymodule (levels defaults to 1):

$btim_AddDumpSignal(top.mymodule);

To dump all signals in top.mymodule and all signals in modules directly or indirectly instantiated in top.mymodule, we set levels to 0:

$btim_AddDumpSignal(0,top.mymodule);

To dump all signals in scope top.mymodule and signals top.A and top.B:

$btim_AddDumpSignal(top.mymodule, top.A, top.B);

To dump all signals with names that match a pattern, place double quotes around the signal name pattern and use regular expressions for scope and signal name, using \\. as scope delimiter. For instance, to dump all signals whose name starts with sig and that belong to a submodule of top module whose name starts with mymodule:

$btim_AddDumpSignal(“top\\.mymodule.*\\.sig.*”);

Related Functions:

btim_dumpfile