make_bd_intf_pins_external - 2023.2 English

Vivado Design Suite Tcl Command Reference Guide (UG835)

Document ID
Release Date
2023.2 English

Create external port for the corresponding interface pins. If a cell is specified, create external interface ports for all unconnected interface pins.


make_bd_intf_pins_external [‑quiet] [‑verbose] <objects>...


Pass if successful in creating at least one interface port.


Name Description
[-quiet] Ignore command errors
[-verbose] Suspend message limits during command execution
<objects> The interface pins/cells to be made external




Create an external interface port in the current block design and connect that to the selected block interface pin. If a bd_cell is specified as the argument, all unconnected block interface pins of that cell will be made external. The created external interface port will have the same properties as the selected block interface pin.

Important: For a group of block interface pins, one external port will be created per block interface pin.

The selected block interface pin, if unconnected, will be connected to a new interface port at the top-most level of the block design.

This command returns TCL_OK if it is successful, or TCL_ERROR if it fails, unless -quiet is specified.


-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) Specify either a list of block interface pin objects returned by get_bd_intf_pins, or block design cell objects returned by get_bd_cells.


The following example will select the specified block interface pin on the bd_cell axi_gpio_0, and connect it to an external interface port:

make_bd_intf_pins_external [get_bd_intf_pins axi_gpio_0/S_AXI] 

The following example will look at all unconnected block interface pins of the bd_cell axi_gpio_0 and individually connect them to external interface ports:

make_bd_intf_pins_external [get_bd_cells axi_gpio_0]