Compute utilization of device and display report
Syntax
report_utilization [‑file <arg>] [‑append] [‑pblocks <args>]
[‑evaluate_pblock] [‑exclude_child_pblocks] [‑exclude_non_assigned]
[‑cells <args>] [‑return_string] [‑slr] [‑packthru] [‑name <arg>]
[‑no_primitives] [‑omit_locs] [‑hierarchical] [‑spreadsheet_file <arg>]
[‑spreadsheet_table <arg>] [‑spreadsheet_depth <arg>]
[‑hierarchical_depth <arg>] [‑hierarchical_percentages] [‑quiet]
[‑verbose]Returns
Report
Usage
| Name | Description |
|---|---|
[-file]
|
Filename to output results to. (send output to console if -file is not used) |
[-append]
|
Append the results to file, don't overwrite the results file |
[-pblocks]
|
Report utilization of given pblock |
[-evaluate_pblock]
|
Report utilization with demand as specified cells and supply as specified pblock area |
[-exclude_child_pblocks]
|
Report utilization with out child pblocks |
[-exclude_non_assigned]
|
Pblock utilization with out Non-assigned Cells |
[-cells]
|
Report utilization of given list of cells |
[-return_string]
|
Return report as string |
[-slr]
|
SLR wise utilization of resources |
[-packthru]
|
Reports LUTs used exclusively as pack-thru |
[-name]
|
Output the results to GUI panel with this name |
[-no_primitives]
|
Removes "Primitives Section" from report_utilization o/p. |
[-omit_locs]
|
Removes "Loced" column from report_utilization o/p. |
[-hierarchical]
|
Generates text-based hierarchical report. |
[-spreadsheet_file]
|
Specify file for exporting utilization tables as spreadsheets. This feature is available only in GUI mode. |
[-spreadsheet_table]
|
Choose a particular utilization table to export as spreadsheet file. Default value : Hierarchy |
[-spreadsheet_depth]
|
Specifies the depth level for spreadsheet. Default value : 8 Default: 8 |
[-hierarchical_depth]
|
Specifies the depth level for textual hierarchical report Default: 0 |
[-hierarchical_percentages]
|
Report percentages in textual hierarchical report |
[-quiet]
|
Ignore command errors |
[-verbose]
|
Suspend message limits during command execution |
Categories
Description
Report resource usage on the target part by the current synthesized or implemented design. The report is returned to the standard output, unless the -file, -return_string, or -name arguments are specified.
This command returns the requested information, or returns an error if it fails.
Arguments
-file <arg> - (Optional) Write the report into the specified file. The specified file will be overwritten if one already exists, unless -append is also specified.
-append - (Optional) Append the output of the command to the specified file rather than overwriting it.
-append option can only be used with the -file option.-pblocks <arg> - (Optional) Report the resources utilized by one or more Pblocks in the design.
-pblocks can not be used with the -name option.
-evaluate_pblock <arg> - (Optional) Performs a what-if analysis on the specified -pblocks and the specified -cells. This option reports the utilization of the Pblocks as if they were populated by the specified cells. Percentages of utilization represent the ratio of the assigned cells to the available resources. This option requires both -pblocks and -cells to be specified.
-exclude_child_pblocks - (Optional) Report utilization of the specified -pblocks excluding any nested Pblocks. This has the effect of reducing the utilization of the region as it does not account for cells that are assigned to a Pblock through a nested Pblock.
-exclude_non_assigned - (Optional) Exclude non-assigned cells from the Utilization report when the -pblocks option is specified. This has the effect of decreasing the utilization of the Pblock region as it does not account for cells that are utilized, but are not assigned to the specified Pblocks.
-cells <arg> - (Optional) Report the resources utilized by one or more hierarchical cells in the current design.
-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.
-file option.
-slr - (Optional) Reports the utilization for each separate SLR in devices having SLRs.
-packthru - (Optional) Reports LUTs used for route through purposes. This appears in the utilization report as "LUTs used exclusively as route-thrus".
-name <arg> - (Optional) Specifies the name of the results to output to the GUI.
-no_primitives - (Optional) Remove the Primitives section from the report. The Primitives section reports the number and type of logic primitives used on the device.
-omit_locs - (Optional) Omit the Fixed column from the report. The Fixed column reports the quantity of logic elements that the user has fixed, or manually placed onto the device.
-hierarchical - (Optional) Reports the utilization of the device broken down according to the hierarchy of the design.
-hierarchical_depth <arg> - (Optional) Specifies the depth of the hierarchy to report when reporting utilization according to the hierarchy. The default depth is 0, which means that -hierarchical will report full design hierarchy.
-hierarchical_percentages - (Optional) Specifies that utilization data in the hierarchical report be reported as percentages.
-spreadsheet_file <arg> - (Optional) Export utilization tables to the specified XLSX format spreadsheet. The ability to export a spreadsheet file is only available when the -name option is also specified and the report is generated in the GUI.
-spreadsheet_table <arg> - (Optional) Specify a utilization table to export to the spreadsheet file. The default is to export the Hierarchy table for the whole design. This option requires the use of -spreadsheet_file. The table name is displayed in the Report Utilization window when a specific table is selected from the tree view. Some example table names are:
- "Hierarchy"
- "Slice Logic Distribution"
- "Slice Logic Distribution - LUT as Memory"
- "Slice Logic Distribution - LUT as Memory - LUT as Distributed RAM"
- "Slice Logic Distribution - LUT as Memory - LUT as Shift Register"
- "Slice Logic Distribution - LUT as Logic"
- "Slice Logic - F8 Muxes"
- "Slice Logic - Slice Registers"
- "Slice Logic - Slice Registers - Registers as AND/OR"
- "Memory - Block RAM Tile"
- "Memory - Block RAM Tile - RAMB18"
- "DSP - DSPs"
- "Clocking - BUFGCTRL"
- "Specific Feature - BSCANE2"
- "Primitives"
-spreadsheet_depth <arg> - (Optional) Specifies the hierarchical depth, starting from the top-level of the design, to export to the spreadsheet file. The default value is 8. This options requires the use of -spreadsheet_file.
-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.Examples
report_utilization -pblocks [get_pblocks] -file C:/Data/pblocks_util.txt report_utilization -name utilization_1 -spreadsheet_file util_table.xlsx \
-spreadsheet_table "Clocking - BUFGCTRL" foreach x [get_pblocks] {
puts "Reporting Pblock: $x ----------------------------------"
report_utilization -append -file C:/Data/pblocks_util.txt -pblocks $x
}