find_bd_objs - 2021.1 English

Vivado Design Suite Tcl Command Reference Guide (UG835)

Document ID
UG835
Release Date
2021-06-16
Version
2021.1 English

Find a list of pins, ports or interfaces with a given relationship to the given object.

Syntax

find_bd_objs ‑relation <arg> [‑boundary_type <arg>] [‑thru_hier]
    [‑stop_at_interconnect] [‑stop_at_container] [‑end_type <arg>] [‑quiet]
    [‑verbose] <objects>...

Returns

List of pins, ports or interface objects, "" if failed.

Usage

Name Description
-relation Relation to the input objs: connected_to, addressable_slave, addressing_master. 'connected_to' will find corresponding pins, ports or interfaces that are connected to the given source objects, across hierarchy boundaries.
[-boundary_type] Used when source object is an hierarchical block's pin or interface pin. Valid values are empty string for same level (default), 'lower', or 'all'. If 'lower' boundary, searches from within hierarchy. This option is only valid for relation: connected_to
[-thru_hier] Flag used to ignore boundary of hierarchical blocks. If used used with boundary_type 'lower', flag will only affect the hierarchical blocks within parent hierarchical block.
[-stop_at_interconnect] Flag used to stop at the axi_interconnect's boundary when -thru_hier is used.
[-stop_at_container] Flag used to stop at the container's boundary when -thru_hier is used.
[-end_type] Only to be used with objects that are pins or ports and bus interface pins or ports. For pins/ports - Default is to return the sink objects for a given source object and to return the source object for a given sink object. If 'all' is used for a given sink object, will return both source and other sink objectst that are connected to the source object. For bus interface pins/ports - Default is to return the end connection that is non-monitor interfaces. If 'monitor' is used, will only return the monitor interfaces. If 'all' is used, will return both end connection and monitor interfaces. If 'master', will return master interfaces and if 'slave', will return slave interfaces.This option is only valid for relation: connected_to
[-quiet] Ignore command errors
[-verbose] Suspend message limits during command execution
<objects> One or more source object to start finding from

Categories

IPIntegrator

Description

Find a list of pins, ports or interfaces with a given relationship to the specified objects.

This command returns a list of pins, ports or interface objects if successful, or returns an error if it fails.

Arguments

-relation <arg> - (Required) Specifies the relationship of the objects to find with the objects specified to seed the search. Valid values are:
  • connected_to - Find corresponding pins, ports or interfaces that are connected to the given source objects. The search occurs within the same level of hierarchy as the specified objects. Use the -thru_hier option to search across hierarchical boundaries.
  • addressable_slave - Find pins, ports, or interfaces, that can be addressed as slaves by the specified search objects.
  • addressing_master - Find pins, ports, or interfaces, that address the specified search objects as masters.
-boundary_type [ upper | lower | all ] - (Optional) Used when the specified source objects include a pin or interface pin on a hierarchical module. The default behavior is "upper", which searches for related objects within the same level as the hierarchical module that the pin is found on. If "lower", the search occurs inside the hierarchical module that the pin is on. If "all", then both the level of the hierarchical module, and inside the hierarchical module are searched for related objects.
Note: This option must be used with -relation connected_to.

-thru_hier - (Optional) Ignore the boundary of hierarchical blocks when performing the search for objects. If used used with -boundary_type lower, the search for related objects will start inside the hierarchical module the pin is on, and continue searching downward through the hierarchy.

-stop_at_interconnect - (Optional) Specifies to stop searching at the boundary of the AXI Interconnect IP when -thru_hier is specified. Other hierarchical blocks are searched as usual.

-end_type all - (Optional) This option can be specified for bd_pin and bd_port type <objects>. The default search for related objects returns all of the sink pins attached to a specified source object, and to return the source object for a given sink. When -end_type all is specified for a sink object, the tool will return the source pin or port of the specified sink object, as well as other sink objects that are connected to the source object.
Note: This option must be used with -relation connected_to.
-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.

<objects> - (Required) One or more objects to use to find related objects.

Example

The following example gets pins, ports, and interfaces connected to the specified object, across all levels of the block design hierarchy:

find_bd_objs -relation connected_to -thru_hier \
[get_bd_pins /proc_sys_reset_1/peripheral_aresetn]