make_bd_pins_external - 2024.1 English

Vivado Design Suite Tcl Command Reference Guide (UG835)

Document ID
Release Date
2024.1 English

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


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


Pass if successful in creating at least one port.


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




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

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

The selected block pin, if unconnected, will be connected to a new port at the topmost 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 pin objects returned by get_bd_pins, or block design cell objects returned by get_bd_cells.


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

make_bd_pins_external [get_bd_pins axi_gpio_0/s_axi_aclk] 

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

make_bd_pins_external [get_bd_cells axi_gpio_0]