Calculate device configuration time (ms)
Syntax
calc_config_time [‑verbose] [‑max] [‑min] [‑typical] [‑por_used]
[‑por_ramp <arg>] [‑clk_freq <arg>] [‑bitstream_size <arg>] [‑quiet]Returns
Report
Usage
| Name | Description |
|---|---|
[-verbose]
|
Print out calculation parameters |
[-max]
|
Calculate Maximum Configuration Time |
[-min]
|
Calculate Minimum Configuration Time |
[-typical]
|
Calculate Typical Configuration Time |
[-por_used]
|
(Deprecated) Specify if Power On Reset (POR) is used by using a non-zero por_ramp |
[-por_ramp]
|
Specify a Power On Reset (POR) ramp rate as 1 ms to 50 ms Default: 0 ms |
[-clk_freq]
|
Specify a clock frequency for Slave mode, or for Master mode if using external master clock (MHz) Default: 0 MHz |
[-bitstream_size]
|
Specify a bitstream size to override the default Default: 0 |
[-quiet]
|
Ignore command errors |
Description
Estimates the time in milliseconds (ms) to configure an AMD device for the current design. Some applications require that the AMD device is configured and operational within a short time. This command lets you estimate the configuration time for the device and design in question. The configuration time includes the device initialization time plus the configuration time. Configuration time depends on the size of the device and speed of the configuration logic. For more information on the configuration time refer to UltraFast Design Methodology Guide for the Vivado™ Design Suite (UG949), the UltraScale Architecture Configuration User Guide (UG570), or the 7 Series FPGAs Configuration User Guide (UG470).
Follow these steps to ensure that this command properly:
- define Device Configuration mode
- open the design in the system memory
Some of the settings that calculate the configuration time are stored as properties on the
current design, for example, BITSTREAM.CONFIG.CONFIGRATE or
BITSTREAM.CONFIG.EXTMASTERCCLK_EN properties. In some master
modes, the FPGA provides the configuration clock to control configuration, with the
nominal configuration clock frequency specified by
BITSTREAM.CONFIG.CONFIGRATE. The property is defined either in
the Edit Device Properties dialog box of the AMD Vivado™
Design Suite, or by using set_property to directly set the value of
the specified property.
For a slave configuration mode or for configuration modes using an external master clock, the
required clock frequency is specified by the -clk_freq option.
For boot time estimation, refer to the following support articles:
- Zynq devices: https://support.xilinx.com/s/article/67475
- Versal adaptive SoC devices: https://support.xilinx.com/s/article/76300
This command does not support DFX (partial bitstreams) in the native mode. However,
you can obtain the bitstream size value from the
write_bitstream command and apply to the
-bitstream_size option. This solution works only when the
external configuration mode is same.
Arguments
-verbose - (Optional) Temporarily override any message limits and return all messages from this command.
set_msg_config command.
-max - (Optional) Reports the maximum configuration time as estimated by the command.
-min - (Optional) Reports the minimum configuration time as estimated by the command.
-typical - (Optional, default) Reports the typical configuration time as estimated by the command.
-por_ramp <arg> - (Optional) Specify the power-on reset (POR) ramp rate as a value from 1 millisecond (ms) to 50 ms. The default is 0. You can reduce the power on reset time (Tpor) by controlling the ramp rate on the system. For specifications on the Tpor ramp options, see the FPGA configuration switching characteristics in the data sheet of the specific device in use.
-clk_freq <arg> - (Optional) Specify a clock frequency in MHz for Slave mode, or when using an external master clock. The default is 0.
-bitstream_size <arg> - (Optional) Specify a bitstream size in bits. Default is the design bitstream size.
-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.
Example
The following example returns the maximum calculated configuration time for the current target part based on the specified external clock frequency:
calc_config_time -max -clk_freq 50