setup_pr_configurations - 2024.1 English

Vivado Design Suite Tcl Command Reference Guide (UG835)

Document ID
Release Date
2024.1 English

Creates minimum PR Configurations and Child Impl runs automatically based on the combination of Partition Instances and RMs


setup_pr_configurations [‑partitions <args>] [‑use_netlist] [‑force]
    [‑run <arg>] [‑dfx_mode <arg>] [‑quiet] [‑verbose]


Name Description
[-partitions] List of partition instances and reconfig modules pairs
[-use_netlist] Use netlist for getting instances of partition_defs to creating PR Configurations
[-force] Using force deletes active parent impl run's PR Configuration and it's child runs and PR Configurations, and then creates new PR Configurations and runs
[-run] Parent impl run to which child impl runs and PR Configurations need to be created
[-dfx_mode] dynamic function exchange mode Default: STANDARD
[-quiet] Ignore command errors
[-verbose] Suspend message limits during command execution




Automatically creates the minimum PR configurations and child implementation runs based on the combination of Partition Instances and Reconfigurable Modules.

In the Dynamic Function eXchange (DFX)design flow, the PR configuration lets you specify a reconfigurable module (RM) to assign to a specific instance of a Partition Definition (partitionDef). This flow lets you create unique configurations of the design based on the combination of the core design and one or more RMs. The PR design flow requires the implementation of each PR configuration, resulting in partial bitstreams for the RMs, but complete bitstreams for each integrated configuration. Refer to the Vivado Design Suite User Guide: Dynamic Function eXchange (UG909) for more information.

This command is designed to work automatically to create the needed PR configurations and implementation runs for those configurations.

This command returns nothing if successful, or returns an error if the command fails.


-partitions <arg> - (Optional) Specify a list of partition instances and reconfigurable module pairs to assign to the PR configuration. The argument must be specified as <partitionInstance>:<RM> pairs. This format lets you assign different RMs to multiple instances of a single partitionDef in the design.

-force - (Optional) Delete current PR configurations and configuration runs, and create new PR configurations and runs.

-run <arg> - (Optional) Specify the parent run to use for the implementation run of a PR configuration.

-dfx_mode <arg> - (Optional) Specifies the Dynamic Function eXchange mode. It can either be STANDARD or ABSTRACT SHELL. STANDARD mode takes full design into consideration while implementing the reconfigurable modules but ABSTRACT SHELL mode uses the shell for a single reconfigurable partition to implement a single reconfigurable module. ABSTRACT SHELL mode saves implementation time compared to STANDARD mode. STANDARD mode is the default.

-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.
Note: Any errors encountered on the command-line, while launching the command, will be returned. Only errors occurring inside the command will be trapped.
-verbose - (Optional) Temporarily override any message limits and return all messages from this command.
Note: Message limits can be defined with the set_msg_config command.


The following example automatically creates the necessary PR configurations, and PR config implementation runs, to support the partitionDefs and RMs in the project: