Convert specified IP to or from core container format.
Syntax
convert_ips [‑force] [‑to_core_container] [‑from_core_container] [‑quiet]
[‑verbose] <objects>
Usage
Name | Description |
---|---|
[-force]
|
Force conversion even if the IP is locked. |
[-to_core_container]
|
Convert IP to core container format. |
[-from_core_container]
|
Convert IP to non core container format. |
[-quiet]
|
Ignore command errors |
[-verbose]
|
Suspend message limits during command execution |
<objects>
|
Input objects for the IP. May IP or source file objects |
Categories
Description
This command converts existing IP into core container format, or reverts core container IP into the expanded non-core container format.
The core container format for IP is a compressed zip file that reduces the file structure in the design, and increases tool performance.
By default, the Vivado® tool adds IP from the Xilinx® IP catalog into a design using the core container format. However, the convert_ips
command lets you convert IP in existing designs to take advantage of the core container format. In addition, the convert_ips
command also lets you revert the compressed core container format into the expanded non-core container format.
-to_core_container
or -from_core_container
options are specified then the convert_ips
command will convert the IP from its current format into the opposite form. Any core container IP will be converted to non-core container format, and any non-core container IP will be converted to core container format.IP that is user-managed, cannot be converted from its current format. IP that is locked requires the use of the -force
option to convert. Refer to the Vivado Design Suite User Guide: Designing with IP (UG896) for more information on editing IP and the IS_LOCKED and IS_MANAGED properties.
This command returns a transcript of its actions, or returns an error if it fails.
Arguments
-force
- (Optional) Force the conversion of IP that are currently locked (IS_LOCKED).
-to_core_container
- (Optional) Convert existing expanded form IP into the core container format. Any IP specified that are already in core container format will simply be ignored.
-from_core_container
- (Optional) Convert IP currently in the core container format into the expanded form of the non-core container format. Any IP specified that are already in non-core container format will simply be ignored.
-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.
<objects>
- (Required) Specify the IP objects or IP files to convert. IP files can be specified using the get_files
command, or IP objects can be specified with get_ips
.
Examples
The following example converts all IP in the current project into core container format:
convert_ips -to_core_container [get_ips]
The following example converts the specified IP file to core container format:
convert_ips -to_core_container \
[get_files C:/Data/wave1/wave1.srcs/sources_1/ip/char_fifo/char_fifo.xci]
The following example toggles the current format of all IP in the design, switching from core container to non-core container, and from non-core container to core container:
convert_ips [get_ips]