21.4.16 sd_create_pin_group

Description

This tcl command creates a group of pins in a SmartDesign component. A pin group is only used to manage the complexity of the SmartDesign canvas. There is no actual netlist functionality related to pin group commands. Pin groups cannot be created for top level ports.

sd_create_pin_group -sd_name {smartdesign component name} \
                    -instance_name {instance name} \
		    [-group_name {group name}] \
		    [-pin_names {pin to be added to the group}]

Arguments

ParameterTypeDescription
sd_namestringSpecifies the name of the SmartDesign component. It is mandatory.
instance_namestringSpecifies the name of the instance on which the pin group is added. It is mandatory.
group_namestringSpecifies the name of the pin group. It is optional. If the group name is not specified, the default name will be 'Group'. If the name 'Group' is already taken, then the group name will be 'Group_<index>' (index is auto-incremented).
pin_nameslist of stringsSpecifies the list of instance pins to be added to the pin group(example below). It is optional.
Return TypeDescription
NoneNone

Error Codes

Error CodeDescription
NoneUnconnected input pin "instace_name":"pin_name".
NoneParameter 'param_name' is not defined. Valid command formatting is 'sd_create_pin_group -sd_name "sd_name" [-group_name "group_name"] -instance_name "instance_name" [-pin_names "[pin_names]+"]'.
NoneRequired parameter 'sd_name' is missing.
NoneRequired parameter 'instance_name' is missing.

Supported Families

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

Example

The following example creates a pin group named "MyGroup" on the "COREAXINTERCONNECT_C0_0" instance in the "TOP" design:

sd_create_pin_group -sd_name {TOP} \
                    -instance_name {COREAXINTERCONNECT_C0_0} \
                    -group_name {MyGroup} \
                    -pin_names {ACLK ARESETN}

The following example creates a group of "FORCE_DISP", "DISP_SEL" and "WA_RSTn" pins in a "TOP" design named "MyGroup" on the "CorePCS_C0_0" instance:

sd_create_pin_group -sd_name {TOP} \
                    -group_name {MyGroup} \
                    -instance_name {CorePCS_C0_0} \
                    -pin_names {"FORCE_DISP" "DISP_SEL" "WA_RSTn"}

See Also

  • sd_add_pins_to_group
  • sd_delete_pin_group
  • sd_rename_pin_group
  • sd_remove_pins_from_group