add_wave_marker - 2024.1 English

Vivado Design Suite Tcl Command Reference Guide (UG835)

Document ID
Release Date
2024.1 English

Create a new wave marker


add_wave_marker [‑into <arg>] [‑name <arg>] [‑quiet] [‑verbose] [<time>]


The new created marker.


Name Description
[-into] the wave configuration in which to create the marker
[-name] sets the name of the new marker to the specified string
[-quiet] Ignore command errors
[-verbose] Suspend message limits during command execution
[<time>] the numerical portion of the new marker's time Default: 0
[<unit>] the time unit portion of the new marker's time. Allowed values are fs, ps, ns, us, ms, and s.




Creates a wave marker at the specified time and of the specified name in the current waveform configuration.

This command returns nothing.

Note: This command can only be used when running a simulation.


-into <wcfg> - (Optional) Specifies the WCFG object into which the new wave marker is inserted. If -into is not specified, the wave marker is added to the current wave configuration.

-name <arg> - (Optional) Creates a marker with the specified name. The default name is new_marker.

<time> - (Optional) Is the simulation runtime within the waveform at which to set the marker. The default is time 0.

<unit> - (Optional) Is the time unit. Allowable units are s, ms, μs, ns, and ps. The default is the time unit used in the specified waveform configuration.

-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.
Note: Any errors encountered on the command-line, while launching the command, will be returned. Only errors occurring inside the command will be trapped.
-verbose - (Optional) Temporarily override any message limits and return all messages from this command.
Note: Message limits can be defined with the set_msg_config command.


Add a marker to the existing waveform configuration at 500 ns.

add_wave_marker 500 ns