3. Vivado时序分析工具入门：report_timing_summary、report_timing、report_clock_interaction的使用方法

在TLM适配器的时序收敛优化工作中，Vivado提供的三大时序报告工具是定位问题、分析路径、验证优化效果的核心手段。本章将系统讲解report_timing_summary、report_timing和report_clock_interaction三个命令的功能定位、适用场景及关键参数，帮助你在TLM适配器设计中快速建立时序分析能力。

3.1 三大报告的功能定位与对比

三个报告工具分别服务于时序分析的三个层次：全局概览、单路径诊断、时钟域交互检查。下表从多个维度对比其核心差异：

3.2 report_timing_summary：全局时序状态总览

该命令是时序分析的起点，提供设计整体的时序裕量统计。在TLM适配器项目中，每次综合或实现后都应首先运行此报告。

3.2.1 常用命令与参数

# 基础用法（实现后）
report_timing_summary -file timing_summary.rpt

# 带详细路径输出
report_timing_summary -delay_type min_max -report_unconstrained -file timing_summary_detailed.rpt

# 按时钟域分组
report_timing_summary -group_by clock_domain -file timing_summary_by_clock.rpt

3.2.2 关键输出解读

报告的核心输出包含以下关键指标：

• WNS（Worst Negative Slack）：最差建立时间裕量，负值表示违例。TLM适配器中常见于跨时钟域路径。
• TNS（Total Negative Slack）：所有违例路径的裕量总和，反映违例严重程度。
• WHS（Worst Hold Slack）：最差保持时间裕量，负值表示保持违例。
• THS（Total Hold Slack）：所有保持违例路径的裕量总和。
• Total Negative Slack（Setup）：建立时间违例总裕量。

3.3 report_timing：单路径深度分析

当report_timing_summary显示存在违例时，使用report_timing对具体路径进行逐级延迟分析，定位瓶颈。

3.3.1 常用命令与参数

# 查看最差建立时间路径
report_timing -max_paths 1 -nworst 1 -setup -file worst_setup_path.rpt

# 查看指定时钟域的最差路径
report_timing -clock clk_tlm -max_paths 5 -setup -file tlm_clock_paths.rpt

# 查看保持时间违例路径
report_timing -delay_type hold -max_paths 10 -file hold_paths.rpt

# 从指定起点到终点的路径
report_timing -from [get_pins tlm_adapter/inst/ff_a/C] -to [get_pins tlm_adapter/inst/ff_b/D] -file specific_path.rpt

3.3.2 路径延迟分解结构

报告输出的每条路径包含以下延迟分段：

3.4 report_clock_interaction：时钟域交互检查

TLM适配器通常涉及多个时钟域（如AXI时钟、TLM时钟、用户逻辑时钟），跨时钟域路径的时序约束是否正确直接影响设计功能。report_clock_interaction提供时钟域间的路径统计和约束状态。

3.4.1 常用命令与参数

# 基础用法
report_clock_interaction -file clock_interaction.rpt

# 包含未约束路径
report_clock_interaction -include_unconstrained -file clock_interaction_full.rpt

# 按交互类型分组
report_clock_interaction -group_by interaction_type -file clock_interaction_grouped.rpt

3.4.2 交互矩阵解读

报告输出一个时钟域交互矩阵，每个单元格表示两个时钟域之间的路径数量和约束状态：

3.5 三大报告在TLM适配器中的协同使用流程

下图展示了在TLM适配器时序收敛过程中，三个报告工具的协同工作流程：

3.6 实战案例：TLM适配器违例路径分析

假设在TLM适配器设计中，report_timing_summary显示WNS = -0.35ns，违例路径位于clk_tlm域。使用report_timing进行深度分析：

report_timing -clock clk_tlm -max_paths 3 -setup -file tlm_worst_paths.rpt

报告输出关键片段：

Slack: -0.350ns (violation)
  Source: tlm_adapter/axi_to_tlm/state_machine/current_state_reg[2]/C
          (rising edge-triggered cell FDRE clocked by clk_tlm)
  Destination: tlm_adapter/axi_to_tlm/data_mux/out_reg[7]/D
               (rising edge-triggered cell FDRE clocked by clk_tlm)
  Path Group: clk_tlm
  Path Type: Setup (Max at Slow Process Corner)

  Delay Type                Delay(ns)     Cumulative(ns)
  ------------------------------------------------------
  Clock Path Skew           0.012         0.012
  Clock Network Delay       0.845         0.857
  Data Path Delay           4.893         5.750
    Logic Delay             2.340
    Net Delay               2.553
  ------------------------------------------------------
  Required Time                           5.400
  Arrival Time                            5.750
  ------------------------------------------------------
  Slack                                   -0.350

3.7 常用参数速查表

以下表格汇总了三个报告工具在TLM适配器设计中最常用的参数组合：