report_noc_qos - report_noc_qos - 2026.1 English

report_noc_qos - report_noc_qos - 2026.1 English - UG835

Vivado Design Suite Tcl Command Reference Guide (UG835)

Document ID

UG835

Release Date

2026-06-23

Version

2026.1 English

Report NOC.

Syntax

report_noc [‑append] [‑file <arg>] [‑json <arg>] [‑return_string] [‑quiet]
    [‑verbose]

Usage

Name	Description
`[-append]`	Append the results to file, don't overwrite the results file
`[-file]`	Filename to output results to. (send output to console if -file is not used) Values: A filename with alphanumeric characters.
`[-json]`	Specifies the output json file name
`[-return_string]`	Return report output as string
`[-quiet]`	Ignore command errors
`[-verbose]`	Suspend message limits during command execution

Description

Generates a Network-on-Chip (NoC) report for the current design. The report provides detailed information on NoC logical paths including Quality of Service metrics, shared physical channels, routing groups, address mappings, apertures, and DFX boundary path ownership.

Arguments

-append - (Optional) Append the output of the command to the specified file rather than overwriting it.

Note: The -append option can only be used with the -file option.

-file <arg> - (Optional) Write the analysis results into the specified file. The specified file is overwritten if one already exists unless -append is also specified.

-json <arg> - (Optional) Write the analysis results into the specified JSON formatted file. The specified file is overwritten only if one already exists.

-return_string - (Optional) Directs the output to a Tcl string rather than to the standard output. The Tcl string can be captured by a variable definition and parsed or otherwise processed.

Note: This argument cannot be used with the -file option.

-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.

Examples

The following example generates a report in the console:

report_noc

The following example generates a report to the file:

report_noc -file noc_analysis.rpt

The following example generates a report to a JSON file:

report_noc -json noc_analysis.json