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

ParameterTypeDescription

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 TypeDescription
NoneNone

Error Codes

Error CodeDescription

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}

See Also

  • sd_disconnect_instance