Make copies of the objects and add the copies to the given hierarchical cell.
Syntax
copy_bd_objs [‑prefix <arg>] [‑from_design <arg>] [‑quiet] [‑verbose]
<parent_cell> <objects>...
Returns
0, "" if failed.
Usage
Name | Description |
---|---|
[-prefix]
|
Prefix name to add to cells |
[-from_design]
|
The design to own the original objects |
[-quiet]
|
Ignore command errors |
[-verbose]
|
Suspend message limits during command execution |
<parent_cell>
|
Parent cell |
<objects>
|
The objects to copy |
Categories
Description
Use this command to copy IP integrator objects from one open subsystem design to a second subsystem design. The selected objects can be copied into the top-level of the current subsystem design, or into an existing hierarchical module.
Because get_bd_cells
, and other commands like it, operate on the current subsystem design, you must store the objects to be copied in a Tcl variable, as shown in the example below. Set the current subsystem design to the source design, select the group of objects to be copied, and store them in a Tcl variable. Then change the current_bd_design
to the target design, and copy the selected objects. In this case, the -from_design
option must be used.
You can also use this command to copy objects from one level of hierarchy in the current subsystem design to another. In this case, the -from_design
argument does not need to be specified.
This command returns 0 if successful, and returns an error if it failed.
Arguments
-prefix <arg>
- (Optional) A prefix name to apply to any cells that are copied into the hierarchical module.
-from_design <arg>
- (Optional) The name of the IP integrator subsystem design where the specified objects are located. The design must be open in IP integrator. If -from_design
is not specified, the objects are located in the current design, as determined by the current_bd_design
command.
-quiet
- (Optional) Execute the command quietly, returning no messages from the command. The command also returns TCL_OK regardless of any errors encountered during execution.
-verbose
- (Optional) Temporarily override any message limits and return all messages from this command.
set_msg_config
command.
<parent_cell>
- (Required) The name of the hierarchical module to copy the specified objects into. You can specify "/" for the top-level of the current subsystem design.
<objects>
- (Required) The list of cells and nets specified by the get_bd_cells
and get_bd_nets
commands, to copy into the specified <parent_cell>
.
Example
The following example sets the current subsystem design, selects a group of objects, and stores them in a Tcl variable. The current subsystem design is then changed, and the selected objects are copied into the top-level of the current design:
current_bd_design myDesign
myDesign
set copyObjs [get_bd_cells {vidOut_1 bridge_1}]
/vidOut_1 /bridge_1
current_bd_design design_1
design_1
copy_bd_objs -from_design myDesign / $copyObjs
0
get_bd_cells
command only returns cells from the current subsystem design, the Tcl variable is used to store those objects prior to switching to the target design with current_bd_design
.