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.
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
convert_ips -to_core_container [get_ips]convert_ips -to_core_container \
[get_files C:/Data/wave1/wave1.srcs/sources_1/ip/char_fifo/char_fifo.xci]convert_ips [get_ips]