Closes the wave config
Syntax
close_wave_config [‑force] [‑quiet] [‑verbose] [<wcfgobj>]
Usage
Name | Description |
---|---|
[-force]
|
Forces the closing of the wave configuration, even if changes would be lost. Default behavior is to reject the closing with an error if changes would be lost. |
[-quiet]
|
Ignore command errors |
[-verbose]
|
Suspend message limits during command execution |
[<wcfgobj>]
|
Closes and destroys the specified wave configuration object, or the current wave configuration if none specified Default: NULL |
Categories
Description
Close the current, or specified wave configuration.
In the Vivado® simulator GUI, you can work with a waveform to analyze your design and debug your code. A wave configuration object displays with top-level HDL objects, and can be further populated using commands like add_wave
and add_wave_divider
. A new wave configuration object can be created in the current simulation with the create_wave_config
command.
Any changes made to a wave configuration object can be saved to a Wave Config file with the save_wave_config
command. You can open a saved Wave Config file with the open_wave_config
command.
Arguments
-force
- (Optional) Forces the closing of the Wave Config file, even if changes would be lost. The default behavior is to return an error if unsaved changes would be lost.
-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.<wcfgobj> - (Optional) Specify a Wave Config object to close. The default is to close the current Wave Config file as returned by the current_wave_config
command.
get_wave_configs
command.Examples
The following example closes all Wave Config files associated with the current simulation:
close_wave_config [get_wave_configs]