Manage the IP instance Synthesis cache. Lists out the IP Cache entries if no options are specified.
Syntax
config_ip_cache [‑use_cache_location <arg>] [‑use_project_cache]
[‑disable_cache] [‑clear_output_repo] [‑clear_local_cache]
[‑cache_has_match] [‑cache_was_used] [‑get_id]
[‑get_entry_location <arg>] [‑disk_usage_output_repo]
[‑import_from_project] [‑zip_cache <arg>] [‑remove] [‑purge]
[‑vlnv <arg>] [‑old_swvers] [‑unused] [‑swver <arg>]
[‑num_days_old <arg>] [‑num_days_unused <arg>] [‑obs_synth_crc]
[‑report] [‑rptfile <arg>] [‑csvfile <arg>] [‑dir <arg>] [‑quiet]
[‑verbose] [<ip>]
Usage
Name | Description |
---|---|
[-use_cache_location]
|
Set current project properties to use the specified cache location |
[-use_project_cache]
|
Set current project properties to use the default project IP cache location |
[-disable_cache]
|
Disable cache use. |
[-clear_output_repo]
|
Delete from disk and in memory all cache entries that exist in the current project's designated cache (local or remote). |
[-clear_local_cache]
|
Delete from disk and in memory all local cache entries for this project. |
[-cache_has_match]
|
Returns the cache-ID of the cache entry that would work for this IP instance; else ''. |
[-cache_was_used]
|
Returns '1' if the cache was used to obtain the IP's current synthesis results; else '0'. |
[-get_id]
|
Calculate and return IP cache ID string for specified <ip> |
[-get_entry_location]
|
Return directory where this cache-ID entry is located. |
[-disk_usage_output_repo]
|
Return total disk usage in MB for all cache entries in the current project's ip_output_repo. |
[-import_from_project]
|
Import existing synthesized IP from the project into the cache. |
[-zip_cache]
|
Zip up all cache entries used by IP instances in the current project and write to the given zipfilename. |
[-remove]
|
Remove the corresponding cache entry for the specified IP instance or specified cachedInst; return cache ID string if successful, otherwise blank. |
[-purge]
|
Delete all cache entries that match the specified type(s): -vlnv, -obs_swvers, -obs_synth_crc, and/or -swver. Returns the number of entries deleted. |
[-vlnv]
|
Used with -purge, specifies the VLNV of the IP the cache entries were created from. May use a wildcard ('*') in one or more fields in the VLNV. |
[-old_swvers]
|
Used with -purge to delete cache entries created with old Vivado SW Versions. |
[-unused]
|
Used with -purge to delete cache entries that have never been used. |
[-swver]
|
Used with -purge to delete any cache entries created from this specific Vivado SW Version (i.e., '2017.1'). |
[-num_days_old]
|
Used with -purge to delete any cache entries that are this number of days old or older. |
[-num_days_unused]
|
Used with -purge to delete any cache entries that have not been used for this number of days or longer. |
[-obs_synth_crc]
|
Used with -purge to delete cache entries whose component synth checksum is not the same as the IP Catalog's current component synthesis checksum. |
[-report]
|
Report cache statistics for the specified IP or cache object, or for the current cache location if none specified. If -rptfile is specified, write statistics to that file. If -dir is specified, write statistics for cache entries found under that directory. |
[-rptfile]
|
Used with -report, specifies the text file to write the cache statistics to. |
[-csvfile]
|
Used with -report, specifies the csv file to write the cache statistics to, in csv format. |
[-dir]
|
Used eith -report, specifies the directory to report cache entry statistics for. |
[-quiet]
|
Ignore command errors |
[-verbose]
|
Suspend message limits during command execution |
[<ip>]
|
IP instance object, IP file, or IP name pattern |
Description
This command lets you manage the Vivado® Design Suite out-of-context (OOC) IP cache. The Vivado Design Suite caches the synthesis results for customized OOC IP in a cache repository, so multiple IP that use the same customization profile can share OOC synthesis results to decrease run time. The cached synthesis results can be reused in a single project from the project cache, or across multiple projects using a remote cache location.
You can specify a location for the cached IP synthesis results either within the current project, or at an external location. The location of the IP cache is defined by the IP_OUTPUT_REPO property on a project, with the value of a string defining a valid file system directory. You can set this property using the config_ip_cache
command with either the -use_cache_location
or the -use_project_cache
options. The default IP synthesis cache location is in the current project folders.
The use of the IP synthesis cache is controlled by the IP_CACHE_PERMISSIONS project property that can be set with the set_property
command. The current values are:
- disabled - Do not use the IP synthesis cache.
- read - Use the IP synthesis cache to read OOC synthesis results from and apply as appropriate in the current project.
- write - Use the IP synthesis cache to write OOC synthesis results into, but do not use them to read IP into the current project.
- read write - Use the IP synthesis cache for both writing results to, and using those results in the current project. This is the default setting.
By default, without any of the arguments specified below, the config_ip_cache
command returns a list of entries in the IP synthesis cache, or returns an error if it fails.
Arguments
-use_cache_location <arg>
- (Optional) Specify a directory pathname to use as the IP cache repository for the current project. For example, "config_ip_cache -use_cache_location /mydata/global_cache
".
-use_project_cache
- (Optional) This is the default location for the cached IP synthesis results. This option enables the current project to use the default IP cache location inside the local project directory. You can use this option to restore the default. For example, "config_ip_cache -use_project_cache
".
-disable_cache
- (Optional) Disable the IP synthesis cache. This has the effect of setting the IP_CACHE_PERMISSIONS property to "disabled". For example, "config_ip_cache -disable_cache
".
-clear_output_repo
- (Optional) This clears the IP synthesis cache of all existing cached results, whether the cache is local to the project or a remote directory that is shared across multiple projects. For example, "config_ip_cache -clear_output_repo
".
-clear_local_cache
- (Optional) This clears the IP synthesis cache of all existing cached results, but only if using the local project cache. For example, "config_ip_cache -clear_local_cache
".
-cache_has_match
- (Optional) Returns the cache-ID of the cached entry that would work for the specified IP instance. For example, "config_ip_cache -cache_has_match [get_ips my_ip_0]
".
-cache_was_used
- (Optional) Returns '1' if the cache was used to obtain the specified IP's current synthesis results; else '0'. For example, "config_ip_cache -cache_was_used [get_ips my_ip_0]
".
-get_id
- (Optional) Calculates and returns the cache-ID string for the specified IP instance. The cache-ID is unique to each cache entry, generated based on the IP instance configuration and current Vivado version and settings. For example, "config_ip_cache -get_id [get_ips my_ip_0]
".
-disk_usage_output_repo
- (Optional) Returns the total disk usage in MB for all cache entries in the current project's IP Cache repository. For example, "config_ip_cache -disk_usage_output_repo
".
-import_from_project
- (Optional) Populates the current IP cache with synthesis results from the current design. This can be used to populate an IP cache with the synthesis results of an existing project to be reused by other projects or design iterations. For example, config_ip_cache -import_from_project
.
-zip_cache <file_name>
- (Optional) Zips up all cache entries used by the IP instances in the current project and writes to the specified <file_name>
. The cache entries could be found in the Cache repository, or in any of the loaded user repositories. If any IP instance in the project does not have a cache entry found, then the return string holds a message that lists those IP instances. For example, "config_ip_cache -zip_cache /mydata/projCache.zip
".
-remove
- (Optional) Removes the corresponding cache entry for the specified IP instance or specified cache object. Returns cache-ID string if successful, otherwise blank. For example, "config_ip_cache -remove [get_ips my_ip_0]
".
-purge
- (Optional) Deletes all cache entries that match the specified type(s): -vlnv
, -old_swvers
, -unused
, -num_days_old
, -num_days_unused
, -obs_synth_crc
, and/or -swver
. Returns the number of entries deleted. More than one specified type can be used in a single -purge
command. The specific types of entries to purge are provided by the following options:
-
-vlnv <arg>
- (Optional) Used with -purge, specifies the VLNV of the IP the cache entries were created from. Entries created from IPs with the specified VLNV will be deleted. May use a wildcard ('*') in one or more fields in the VLNV. For example, "config_ip_cache -purge -vlnv xilinx.com:ip:axi_gpio:*"
.Tip: The VLNV is the IPDEF property on an individual IP instance. -
-swver <arg>
- (Optional) Used with-purge
, deletes cache entries created by the specified software version. The software version can be specified as<version>.<revision>
, for example2017.2
. For example,config_ip_cache -purge -swver 2017.2
. -
-old_swvers
- (Optional) Used with-purge
, deletes cache entries created by an older software version than the one currently in use. For example, "config_ip_cache -purge -old_swvers
". -
-unused
- (Optional) Used with -purge, deletes cache entries that have never been used. For example, "config_ip_cache -purge -unused
". -
-num_days_old <arg>
- (Optional) Used with -purge, deletes any cache entries older than the specified number of days. For example, to delete cache entries that were created 10 days or longer ago, type "config_ip_cache -purge -num_days_old 10
". -
-num_days_unused <arg>
- (Optional) Used with -purge, deletes cache entries that have not been used for the specified number of days or longer. For example, to delete cached entries that have not been used for 10 days or longer, type "config_ip_cache -purge -num_days_unused 10
". -
-obs_synth_crc
- (Optional) Used with -purge, deletes cache entries that were generated with the component's synthesis checksum that is different from the checksum found in the current IP catalog's component. This is only relevant if the component has been modified since the cache entry was generated. For example, "config_ip_cache -purge -obs_synth_crc
".
-report
- (Optional) Reports cache statistics for the specified IP or cache object, or for the current cache location if none specified. Use -rptfile
to have the report written to a text file, or -csvfile
for a csv format file. Use -dir
to report statistics for cache entries found under that directory. Cache statistics include the VLNV of the IP used to create the cached synthesis results, the number of times the cache entry was used, the date of the last time it was used, and the synthesis runtime when the entry was created. For example, to write the current cache's statistics to the return string, type config_ip_cache -report
. To write the statistics for the cache entry that would work for the specified IP instance, to the return string, type "config_ip_cache -report [get_ips my_ip_0]
".
-rptfile <arg>
- (Optional) Used with the -report
option to direct the report output to the specified file name. For example, to write statistics for the current cache to a text file, type "config_ip_cache -report /mydata/cacheStats/proj1_stats.txt
".
-csvfile <arg>
- (Optional) Used with the -report option to direct the report output in CSV format to the specified CSV file name. For example, to write statistics for a specific IP instance's matching cache entry in CSV format to a file, type "config_ip_cache -report -csvfile /mydata/mystats/proj1_stats.csv [get_ips my_ip_0]
".
-dir <arg>
- (Optional) Used with the -report
option to specify a directory (that has cache entries under it) to get the statistics for the cache entries found there. Use this to get statistics from a directory other than the current cache setting. For example, to get statistics for all the cache entries found under the specified directory to a text file, type "config_ip_cache -report -dir /mytests/mycache -rptfile /myresults/mycacheStats.txt
".
-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.Examples
join [config_ip_cache] \n
config_ip_cache -use_cache_location C:/Data/ip