Automatically Generating and Applying Suggestions - 2022.1 English

Vivado Design Suite User Guide: Design Analysis and Closure Techniques (UG906)

Document ID
Release Date
2022.1 English

The automatic QoR suggestion flow generates and applies QoR suggestions for project-based runs. It is the easiest way to generate and apply QoR suggestions on a design that is readily changing. When automatic QoR suggestions are enabled, the standard implementation flow is adjusted as shown in the following figure.

Figure 1. Implementation Flow with Automatic QoR Suggestions

The initial run can be set to take a user-selected RQS file, or it can without an RQS file. If a user RQS file is selected, it remains in place until new suggestions are generated. Any suggestions in the file are written into a <top>_routed.rqs file, removing the requirement to keep the original file.

After the final flow step, whether that is route_design or post-route phys_opt_design, the report_qor_suggestions command is run and new suggestions can be generated if available. If any newly generated suggestions can be applied automatically and have been generated or regenerated at the final stage, they are added to an RQS file along with any suggestions that have been successfully applied in the current run. To examine the suggestions, the report_qor_suggestions report is available in the Reports tab.

When the run is reset, suggestions are copied from the implementation run directory to another location and added to the utils_1 fileset. This location is part of the sources directory by default but can be modified to any other location.

Suggestions can also be applied to the parent synthesis run if one exists. Only one child implementation run can supply synthesis suggestions. If more than one child implementation run is selected, the latest one is used.

The following Tcl properties are used in this flow:

Table 1. Auto QoR Suggestion Flow Run Properties
Property Values Description
RQS_FILES RQS file name Allows you to input user RQS file.
Enable the automatic RQS flow.
AUTO_RQS.DIRECTORY <directory> Allows the specification of an alternative directory to copy the RQS file back to.
AUTO_RQS.SUGGESTION_RUN Implementation run name that generates the RQS file Applied to the synthesis parent run.

An example of the use of these properties in Tcl is shown in the following code snippet:

set_property AUTO_RQS 1 [get_runs impl_1]
set_property RQS_FILES C:/temp/test.rqs [get_runs impl_1]
set_property AUTO_RQS.DIRECTORY C:/project_name/sources/rqs/impl_1 [get_runs impl_1]
set_property AUTO_RQS.SUGGESTION_RUN impl_1 [get_runs synth_1]