Formatted report for PCIe core.
Syntax
report_hw_pcie [‑file <arg>] [‑append] [‑return_string] [‑quiet] [‑verbose]
<hw_pcie>
Usage
Name | Description |
---|---|
[-file]
|
File name (including full path) to output the report results to |
[-append]
|
Append the report results to a file |
[-return_string]
|
Return report results as a string |
[-quiet]
|
Ignore command errors |
[-verbose]
|
Suspend message limits during command execution |
<hw_pcie>
|
Hardware PCIe object |
Categories
Description
Generate a report for the Peripheral Component Interconnect Express (PCIe) debug core object, hw_pcie, defined on the current hardware device.
The customizable LogiCORE IP PCIe core for AMD Versal Adaptive SoCs is designed for evaluating and monitoring the PCIe Link Training and Status State Machine (LTSSM) running on the Gigabit Transceivers (GTs). In the AMD Vivado™ Hardware Manager, Versal PCIe soft cores implemented in the design, are represented as hw_pcie objects. You can use these PCIe debug cores to solve a range of debug and validation problems; from viewing the PCIe link info to the LTSSM state transition diagram.
This command generates a report with general information about the PCIe core, the LTSSM state visitation status and the trace data for the LTSSM transition graph.
Arguments
-file <arg>
- (Optional) Write the report into the specified file.
-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.
-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.
-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.
<hw_pcie>
- (Required) List of HW PCIe objects. If not provided, report is generated for all available PCIe cores.
Examples
The following example generates a report for the PCIe core at index 0
report_hw_pcie [lindex [get_hw_pcies] 0]
The following example generates the report for the hw_pcie objects and outputs them to the text file specified
report_hw_pcie -file C:/data/pcie_report.txt [get_hw_pcies]