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>
)
