Report QoR Suggestions
report_qor_suggestions 命令是处理 QoR 建议对象时使用的主要命令。 QoR 建议对象会创建命令和属性来改善设计的时序性能（ 欲知详情 ， 请参阅 QoR 建议 ） 。
report_qor_suggestions 命令可执行两项任务 ：
1. 报告 QoR 建议对象
2. 生成新 QoR 建议对象
在综合后的任意阶段都能在设计上运行此命令。
此节中还提供了有关使用 write_qor_suggestions 命令从报告创建 RQS 文件的部分详细信息。
“ QoR Suggestions ”报告
“ QoR Suggestions ” （ QoR 建议 ） 报告拆分为汇总部分和详情部分 ， 汇总部分中每项建议位于顶部 ， 有关建议的详情则位于报告的下半部分。下表显示了所生成报告的示例。
在此报告的“ Suggestion Report ” （ 建议报告 ） 下提供了所有建议的列表。这些建议分为 4 个类别来呈现。这些建议按如下方式成对显示：
• “ GENERATED ” （ 生成的建议 ） 和“ EXISTING ” （ 现有建议 ）：
• “ Generated ”建议是流程当前阶段新生成的建议。
• “ Existing ”建议可能来自流程先前阶段或者通过读入 RQS 文件获得。
• “ APPLIED ” （ 已应用的建议 ） 和“ FAILED TO APPLY ” （ 应用失败的建议 ）：
• “ Applied ”建议是已启用并且已通过 APPLICABLE_FOR 阶段的建议。这些建议已成功应用。
• “ Failed to apply ”建议已启用并且已通过 APPLICABLE_FOR 阶段 ， 但尚未成功应用。请检验现有 log 日志文件， 了解尚未应用这些建议的原因。“ Applied ”建议是已启用并且已通过 APPLICABLE_FOR 阶段的建议。这些建议已成功应用。
报告的下半部分包含有关生成的建议的详细信息。它拆分为以下类别 ， report_qor_suggestions 根据这些类别来分析设计：
• Clocking （ 时钟设置 ）
• Congestion （ 拥塞 ）
• Utilization （ 使用率 ）
• Timing （ 时序 ）
• Netlist （ 网表 ）
• XDC
• Strategy （ 策略 ）
通过观察 GENERATED 建议可知 ， 详情部分应提供充分的信息 ， 以供您推断报告这些建议的原因。可通过“GENERATED ”建议的详情部分进行交叉探测。以下交叉探测方法非常实用 ：
• 选中对象会在其他窗口 （ 例如 ， “ Device ”视图 ） 中高亮这些对象
• 按“ F4 ”可显示选定对象的板级原理图
• 右键单击对象即可生成时序报告
通过观察 EXISTING 建议可知 ， 可能对象已修改且不存在 （ 例如 ， opt_design 可能从网表中移除对象 ） 。因此 ， 选择“EXISTING ”建议时 ，交叉探测有时不可用。对于每项建议 ， 报告中包含额外的列 ， 以提供有关如何使用这些建议的实用信息。下表显示了这些列的详细信息。
生成 QoR 建议报告
在 AMD Vivado ™ IDE 中使用“ Reports ” （ 报告 ） 下拉菜单中的“ Report QoR Suggestions ” （ QoR 建议报告 ） 即可访问 report_qor_suggestions 命令。
Tcl 控制台中的等效命令如下 ：
report_qor_suggestions -name qor_suggestions_1
要更改时序路径限制的默认值 100 ， 请更改“ Number of paths for suggestion analysis ” （ 建议分析的路径数 ） 。这样即可增加建议数量， 但这些建议仍将应用于尚未最优化的时序路径。等效的 Tcl 命令行选项如下 ： -max_paths <N>
要更改生成的 ML 策略数量 ， 请更改“ Maximum Number of Strategies to suggest ” （ 最大策略建议数 ）， 如以下对话框所示。等效的 Tcl 命令行选项如下 ： -max_strategies <N>
要扩展分析以报告不违反阈值条件的建议 ， 请选中“ Report all suggestions ” （ 报告所有建议 ） 。行为如下 ：
• 时序建议 ： 无论是否满足时序 ， 都会提供有关时序路径的建议。
• 使用率建议 ： 提供有关非关键资源的建议。
• 拥塞建议 ： 提供有关在布线后阶段已满足时序的设计的建议。
等效的 Tcl 命令行选项如下 ： -report_all_suggestions
要生成支持性 CSV 文件以显示失败的时序路径及其关联的建议 ， 请选中此复选框并指定目录。 CSV 文件能够大幅简化时序路径的浏览， 较文本报告中的表格更便于管理。此外还会生成第二个文件 ， 其中包含 DONT_TOUCH 报告。等效的 Tcl 命令行选项如下 ：
-csv_output_dir <directory>
