report_values - 2023.1 English

Vivado Design Suite Tcl Command Reference Guide (UG835)

Document ID
UG835
Release Date
2023-05-16
Version
2023.1 English

Print current simulated value of given HDL objects (variable, signal, wire, or reg)

Syntax

report_values [‑radix <arg>] [‑print_type] [‑quiet] [‑verbose]
    [<hdl_objects>...]

Returns

Print name and value of HDL objects on the console in textual format.

Usage

Name Description
[-radix] The radix specifies the radix to use for printing the values of the hdl_objects. Allowed values are: default, dec, bin, oct, hex, unsigned, ascii, smag.
[-print_type] Print type information for the object.
[-quiet] Ignore command errors
[-verbose] Suspend message limits during command execution
[<hdl_objects>] The hdl_objects to report. Default is report_objects [get_objects *]

Categories

Description

Report the values of the specified HDL objects at the current simulation run time.

HDL objects include HDL signals, variables, or constants as defined in the Verilog or VHDL test bench and source files. An HDL signal includes Verilog wire or reg entities, and VHDL signals. Examples of HDL variables include Verilog real, realtime, time, and event.

HDL constants include Verilog parameters and localparams, and VHDL generic and constants. The HDL scope, or scope, is defined by a declarative region in the HDL code such as a module, function, task, process, or begin-end blocks in Verilog. VHDL scopes include entity/architecture definitions, block, function, procedure, and process blocks.

Arguments

-radix <arg> - (Optional) Specifies the radix to use when returning the value of the specified objects. Allowed values are: default, dec, bin, oct, hex, unsigned, ascii, or smag.

Note: The radix dec indicates a signed decimal. Specify the radix unsigned when dealing with unsigned data.
-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.

<hdl_objects> - (Required) Specifies one or more HDL objects to return the values of. The object can be specified by name, or can be returned as an object from the get_objects command.

Examples

The following example reports the value of all objects at the current time:

report_values [get_objects]

This example shows the difference between the bin, dec, and unsigned radix on the value returned from the specified bus:

report_values -radix bin /test/bench_VStatus_pad_0_i[7:0]
  Declared: {/test/bench_VStatus_pad_0_i[7:0]} Verilog 10100101
report_values -radix unsigned /test/bench_VStatus_pad_0_i[7:0]
  Declared: {/test/bench_VStatus_pad_0_i[7:0]} Verilog 165
report_values -radix dec /test/bench_VStatus_pad_0_i[7:0]
  Declared: {/test/bench_VStatus_pad_0_i[7:0]} Verilog -91