Add new waves
Syntax
add_wave [‑into <args>] [‑at_wave <args>] [‑after_wave <args>]
[‑before_wave <args>] [‑reverse] [‑radix <arg>] [‑color <arg>]
[‑name <arg>] [‑recursive] [‑r] [‑regexp] [‑nocase] [‑quiet] [‑verbose]
<items>...
Returns
The new waves.
Usage
Name | Description |
---|---|
[-into]
|
the wave configuration, group, or virtual bus into which the new wave object(s) will be inserted. |
[-at_wave]
|
inserts the new wave object(s) into the specified wave object, or after the specified wave object if not a group or virtual bus |
[-after_wave]
|
inserts the new wave objects(s) after the specified wave object |
[-before_wave]
|
inserts the new wave objects(s) before the specified wave object |
[-reverse]
|
reverses the displayed bit order of the new wave objects(s) |
[-radix]
|
sets the displayed radix of the new wave object(s) to the specified radix. Allowed values are: default, dec, bin, oct, hex, unsigned, ascii, smag |
[-color]
|
sets the displayed color of the new wave object(s) to the specified color, which can be a standard color name or a string of the form #RRGGBB |
[-name]
|
sets the displayed name of the single new wave object to the specified string |
[-recursive]
|
if the design object is a scope, this option specifies that wave objects for all design objects under that scope should be created |
[-r]
|
if the design object is a scope, this option specifies that wave objects for all design objects under that scope should be created |
[-regexp]
|
interprets <items> using regular expressions |
[-nocase]
|
only when regexp is used, performs a case insensitive match |
[-quiet]
|
Ignore command errors |
[-verbose]
|
Suspend message limits during command execution |
<items>
|
the design objects from which to create wave objects |
Categories
Description
The add_wave
command creates one or more new design-based wave objects.
This command returns the name of the newly-created wave object(s).
item
, which is an HDL object (signal) within the simulation
project. In the AMD Vivado™ Design Suite interface, the object would display in the Objects
Window.Arguments
-into <wcfgGroupVbusObj>
- (Optional) Specifies the wave configuration, group, or virtual bus into which the new wave object(s) are inserted. If <wcfgGroupVbusObj>
is a string instead of an object, it is treated as the name of a group in the current WCFG. If no such group is found, the tool searches the names of the virtual buses of the current WCFG. If still not found, the tool searches the names of all WCFG objects. If no -into
object is specified, the current wave configuration is assumed.
-at_wave <waveObj>
- (Optional) Adds a wave object at a specified wave object. If <waveObj>
is a string, it is treated as the display name of a wave object.
-after_wave <waveObj>
- (Optional) Adds a wave object after a specified wave object. If <waveObj>
is a string, it is treated as the display name of a wave object.
-before_wave <waveObj>
- (Optional) Adds a wave object before a specified wave object. If <waveObj> is a string, it is treated as the display name of a wave object.
-reverse
- (Optional) Sets the IS_REVERSED
property of the new wave object(s) to true
.
-radix <arg>
- (Optional) Sets the radix property of the new wave object(s) to radix. Allowed values are: default
, dec
, bin
, oct
, hex
, unsigned
, ascii
, or smag
.
-color <arg>
- (Optional) Sets the color property of the new wave object(s) to color, which is either a pre-defined color name or a color specified by a six-digit RGB format (#RRGGBB).
-name <arg>
- (Optional) Sets the DISPLAY_NAME
property of the new wave object to the specified name. It is an error for there to be more than one new wave object being created.
-recursive
| -r
- (Optional) If <items> specifies a scope, this option specifies that all sub-scopes of that scope should also be added.
-regexp
- (Optional) Specifies that <items>
are written as
regular expressions. The regular expression commands are always anchored to the
start of the search string. You can add ".*
" to the beginning of
the search string to widen the search. See http://perldoc.perl.org/perlre.html for help with regular expression syntax.
-quiet
- (Optional) Execute the command quietly, returning no messages from the command. The command also returns TCL_OK regardless of any errors encountered during execution.
-verbose
- (Optional) Temporarily override any message limits and return all messages from this command.
set_msg_config
command.
<items
- (Required) Add waves for the specified HDL objects in the current simulation.
Examples
The following example defines a wave group, defines a color for that group, and adds all signals that begin with the letter 's', and has at least one character following it followed by 0 or more characters, to the wave window in the wave group:
set groupColor YELLOW
set AXIS_ID [add_wave_group "Streaming Data"]
add_wave -into $AXIS_ID -color $groupColor -regexp s.*
Add the dout_tvalid
signal from the
rsb_design_testbench
to the existing simulation waveform
configuration:
add_wave dout_tvalid /rsb_design_testbench/dout_tvalid