21.4.20 sd_cut_paste
(Ask a Question)Description
This Tcl cuts and pastes ports and instances from one SmartDesign to another one.
Important: 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 'Export Component Description(Tcl)' but will
present in Libero Project 'Export Script File'. You must specify at least one valid
instance or
port.
sd_cut_paste -sd_name {SmartDesign component name} \
-source_sd_name {source SmartDesign name} \
[-instance_names {instance names}] \
[-port_names {port names}]Arguments
| Parameter | Type | Description |
|---|---|---|
| sd_name | string | Name of the SmartDesign where the copied data need to be pasted. This parameter is mandatory. |
| source_sd_name | list of strings | Name of the SmartDesign from where object needs to be cut. This parameter is mandatory. |
| instance_names | list of strings | Names of the instances from "source_SmartDesign_name" SmartDesign that need to be cut to "SmartDesign_component_name". |
| port_names | list of strings | Names of the ports from "source_SmartDesign_name" SmartDesign that need to be cut to "SmartDesign_component_name". This parameter is optional. |
| Return Type | Description |
|---|---|
| None | None |
Error Codes
| Error Code | Description |
|---|---|
| None | Required parameter 'sd_name' is missing. |
| None | Parameter 'sd_name' has illegal value. |
| None | Required parameter 'source_sd_name' is missing. |
| None | The paste command failed for port 'port_name' in SmartDesign 'sd`'. The port could not be found in the source SmartDesign. |
| None | Parameter 'port_names' has illegal value. |
| None | The paste command failed for instance 'instance_name' in SmartDesign 'sd'. The instance could not be found in the source SmartDesign. |
| None | Parameter 'instance_names' has illegal value. |
| None | The paste command failed. You must specify at least one valid instance or port. |
| None | Parameter 'source_sd_name' has illegal value. |
| None | Parameter 'param_name' is not defined. Valid command formatting is 'sd_cut_paste -sd_name "sd_name" -source_sd_name "source_sd_name" [-instance_names "[instance_names]+"] [-port_names "[port_names]+"]'. |
Supported Families
| Supported Families |
|---|
| PolarFire® |
| PolarFire SoC |
| RTG4™ |
| SmartFusion® 2 |
| IGLOO® 2 |
Example
The following example cuts "AND2_0" instance, "A", "B", "Y" ports from "sd1" and pastes into "sd2":
sd_cut_paste -sd_name {sd2} -source_sd_name {sd1} -instance_names {"AND2_0"} -port_names {"A" "B" "Y"}The following example cuts "NAND2_0" instance from "sd1" and pastes in "sd2":
sd_cut_paste -sd_name {sd2} -source_sd_name {sd1} -instance_names {"NAND2_0"}The following example cuts only "A", "B", "Y" ports from "sd1" and pastes in "sd2":
sd_cut_paste -sd_name {sd2} -source_sd_name {sd1} -port_names {"A" "B" "Y"}
See Also
- sd_copy_paste