report_pr_configuration_analysis - 2023.1 English

Vivado Design Suite Tcl Command Reference Guide (UG835)

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

Report reconfigurable partition analysis across multiple configurations

Syntax

report_pr_configuration_analysis [‑complexity] [‑clocking] [‑timing]
    [‑cells <args>] [‑dcps <args>] [‑rent] [‑nworst <arg>] [‑file <arg>]
    [‑quiet] [‑verbose]

Usage

Name Description
[-complexity] Run complexity analysis
[-clocking] Run clocking analysis
[-timing] Run boundary net timing analysis
[-cells] List of reconfigurable cell names
[-dcps] List of design checkpoints for each reconfigurable cell. The order of dcps must match that of the -cells option.
[-rent] Compute Rents component as part of complexity analysis. Runtime intensive for large designs.
[-nworst] Specifies the N worst boundary paths. Default: 10
[-file] Filename to output results to. (send output to console if -file is not used)
[-quiet] Ignore command errors
[-verbose] Suspend message limits during command execution

Categories

Report

Description

Important: You must first define the project as a Partial Reconfiguration (PR) project by setting the PR_FLOW property on the project to TRUE, or by using the Tools > Enable Partial Reconfiguration command.

Report reconfigurable partition analysis across multiple configurations as defined by create_pr_configuration. This report compares each Reconfigurable Module that you select to give you input on your PR design. It examines resource usage, floorplanning, clocking, and timing metrics to help you manage the overall PR design. For more information on this command refer to the Vivado Design Suite User Guide: Dynamic Function eXchange (UG909).

When this analysis is done, each RM is examined based on information in the checkpoints provided. While post-synthesis checkpoints can be supplied, the most complete information is not available until after opt_design when all the linking and expansion has been done.

Arguments

-complexity - (Optional) Perform complexity analysis of the design and report the Rent Exponent, Average Fanout, and Primitive Histogram.

Tip: The -complexity option can be specified with -cells to control the analysis of the design or cells.

-clocking - (Optional) This option focuses the report on clock usage and loads for each RM, helping you plan the overall clocking distribution of the design.

-timing - (Optional) This option focuses the report on boundary interface timing details, allowing you analyze bottlenecks in and out of RMs.

-cells <args> - (Option) Generate the report on the specified list of reconfigurable cells. The details of the report will be based on the specified cells rather than the whole design, or current_instance.

-dcps <args> - (Optional) List of design checkpoints (DCP) for each reconfigurable cell.

Important: The order of DCP files specified must match the order of the -cells option.

-rent - (Optional) Adds Rent metrics to the complexity analysis. This is runtime intensive for large designs, which is why it is not included in complexity analysis by default.

-nworst <arg> - (Optional) Reports the N worst boundary paths. The default is 10.

-file <arg> - (Optional) Write the analysis results into the specified file instead of to the Tcl console. The specified file will be overwritten if one already exists.

Note: If the path is not specified as part of the file name, the file will be written into the current working directory, or the directory from which the tool was launched.
-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 performs complexity analysis of the design:

report_pr_configuration_analysis -complexity