Tcl Commands for Cross Probing to Source Files - 2024.2 English

Vivado Design Suite User Guide: System-Level Design Entry (UG895)

Document ID
UG895
Release Date
2024-11-13
Version
2024.2 English

You can use the FILE_NAME and LINE_NUMBER properties on a cell to get information about where the cell is located in the RTL source. You can then open the RTL source in a text editor and navigate to the appropriate line number. Following is the associated Tcl command:

  • Tcl Command: get_cells
    Note: By default, get_cells truncates the returned results in the Tcl Console and log file after the first 500 results. For more information, including how to change the default setting, see the Vivado Design Suite Tcl Command Reference Guide (UG835).
  • Tcl Command Example: The following example shows how to use the get_cells Tcl command in an open design to get a specific instance of a cell, query the properties of that cell object, and report the file and line of interest:
    set cellName dac_spi_i0
    set fileName [get_property FILE_NAME [get_cells $cellName]]
    set lineNum [get_property LINE_NUMBER [get_cells $cellName]]
    puts "Cell: $cellName is instanced in file: $fileName \
    at line number $lineNum"