Automatically Generating and Applying Suggestions - 2025.2 English - UG906

Vivado Design Suite User Guide: Design Analysis and Closure Techniques (UG906)
Document ID
UG906
Release Date
2025-12-10
Version
2025.2 English

The automatic QoR suggestion flow generates and applies QoR suggestions for project-based runs. It is the simplest method for designs that change frequently. When enabled, the standard implementation flow is adjusted as shown in the following figure.

Figure 1. Implementation Flow with Automatic QoR Suggestions

You can start with either:

  • A user-selected RQS file (remains in place until replaced by newly generated suggestions)
    • Any suggestions in the file are written into a <top>_routed.rqs file, removing the requirement to keep the original file.
  • No RQS file, allowing the tool to generate one automatically

The report_qor_suggestions command runs after:

  • opt_design
  • place_design
  • Either route_design or post-route phys_opt_design (if enabled)

To examine the suggestions, open the report_qor_suggestions report in the Reports tab at each point where the command runs.

Most suggestions are written to the RQS file at the end of the run so they can be applied in the next run. Suggestions included are:

  • New suggestions with AUTO_RQS_FLOW==1
  • Older suggestions with APPLIED==1

RQS_CLOCK-1 and RQS_CLOCK-26 suggestions can be generated at opt_design and applied in the same run.

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 changed.

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

To examine the suggestions, the report_qor_suggestions report is available in the Reports tab for each of the points where the command is run.

The following properties are used on the first class run object:

Table 1. Auto QoR Suggestion Flow Run Properties
Property Values Description
RQS_FILES RQS file name Allows input of a custom RQS file.
AUTO_RQS
1
On
0
Off
 Enables the automatic RQS flow.
AUTO_RQS.DIRECTORY <directory> Specifies an alternative location to copy the RQS file.
AUTO_RQS.SUGGESTION_RUN Implementation run name that generates the RQS file Generates the RQS file for the parent synthesis 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]