21.4.29 sd_duplicate_instance

Description

This tcl command creates a new instance in a SmartDesign with the same module/component as the original instance.

Note: This command is not required to build a SmartDesign component. This command maps to an interactive user action in the SmartDesign Canvas and will not be present in the exported SmartDesign component Tcl description.

sd_duplicate_instance 
            -sd_name {smartdesign component name} \
            -instance_name {instance name} \
            [-duplicate_instance_name {duplicate instance name}]

Arguments


Parameter	Type	Description
sd_name	string	Specifies the name of the SmartDesign component. It is mandatory.
instance_name	string	Specifies the name of the instance to be duplicated. It is mandatory.
duplicate_instance_name	string	Specifies the name of the duplicate instance. It is optional. If value is not specified the default name is provided.


Return Type	Description
None	None

Error Codes


Error Code	Description
None	Parameter 'instance_name' has illegal value.
None	Required parameter 'instance_name' is missing.
None	Parameter 'sd_name' has illegal value.
None	Required parameter 'sd_name' is missing.
None	Parameter 'param_name' is not defined. Valid command formatting is 'sd_duplicate_instance -sd_name "sd_name" -instance_name "instance_name" [-duplicate_instance_name "duplicate_instance_name"]'.

Supported Families


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

Example

This example duplicates "PF_CCC_C0_0" instance.

Note: Will create instance named PF_CCC_C0_1.

sd_duplicate_instance -sd_name {top} -instance_name {PF_CCC_C0_0}

This example dupicates {PF_CCC_C0_0} instance with {abc_1} name.

sd_duplicate_instance -sd_name {top} \ 
                      -instance_name {PF_CCC_C0_0} \
                      -duplicate_instance_name {abc_1}