21.4.10 sd_connect_pin_to_port

Description

This Tcl command connects a SmartDesign instance pin to a new top level port. This command is equivalent to the 'Promote to Top Level' GUI action on an instance pin.

Note: This command is not required to build a SmartDesign component. It maps to an interactive user action in the SmartDesign Canvas and will not be present in the exported SmartDesign component Tcl description.
sd_connect_pin_to_port -sd_name {smartdesign component name} \
                       -pin_name {pin name} \
                       [-port_name {port name}]

Arguments

ParameterTypeDescription
sd_namestringSpecifies the name of the SmartDesign component. It is mandatory.
pin_namestringSpecifies the name of the instance level pin that needs to be connected to a top level port. It is mandatory.
port_namestringSpecifies the name of the new top level port that the instance pin will be connected to. It is optional. If the port name is not specified, the new port takes the name of the instance pin. If the port name as defined by these rules already exists, the tool automatically creates a new port with name <port_name>_<index> (index is an automatically generated integer starting at 0 such that the port name is unique in the SmartDesign).
Return TypeDescription
NoneNone

Error Codes

Error CodeDescription
NonePin 'instance_name:pin_name' does not exist.
NoneRequired parameter 'sd_name' is missing.
NoneYou must specify a pin name.
NoneCannot promote pin 'pin_name' on 'instance_name' to top because it is already connected to a top level port.
NoneParameter 'param_name' is not defined. Valid command formatting is 'sd_connect_pin_to_port -sd_name "sd_name" [-pin_name "pin_name"] [-port_name "port_name"]'.

Supported Families

Supported Families
PolarFire®
PolarFire SoC
RTG4™
SmartFusion® 2
IGLOO® 2

Example

  • The following command connects "D" input pin of "DFN1_0" instance to "D" input port which was created with the name of port_name and automatically generated index(unique):

    sd_connect_pin_to_port -sd_name {top} -pin_name {DFN1_0:D}

  • The following command connects "DFN1_0" instance "Q" output pin to "Q_OUT" port:

    sd_connect_pin_to_port -sd_name {top} \
                       -pin_name {DFN1_0:Q} \
                       -port_name {Q_OUT}

See Also

  • sd_connect_pin