FPGA 与数字 IC 设计 / 系统课时

配置同步器工程属性

配置同步器工程属性

本课解决“RTL 看起来是两级同步器,但综合和实现未必按同步器处理”的工程问题。你将以 AMD Vivado 为例,为同步链添加工具可识别的 ASYNC_REG 属性,并从综合网表、实现结果和 CDC 报告三处完成可执行验证。

学习目标

  • 能解释同步器寄存器为什么需要专门的工程属性
  • 能用 SystemVerilog 正确标注两级同步寄存器
  • 能在 Vivado 综合与实现结果中查询属性,并用 report_cdc 复核跨域结构

为什么仅有两级 RTL 还不够

两级寄存器只表达了逻辑结构,综合、优化和布局仍由实现工具决定。同步器要求第一级直接采样异步输入,第二级只采样第一级输出,并希望工具保留这条同步链、识别其 CDC 意图并在实现时合理处理寄存器位置。

Vivado 的 ASYNC_REG=TRUE 用来声明寄存器属于同步链。该属性会随综合网表向后传递,并影响综合、布局布线和相关分析;它不会消除亚稳态,也不能把错误的 CDC 架构变安全。属性名和行为属于具体工具链,迁移到其他 FPGA 或 ASIC 流程时必须重新核对。

同步器工程属性从 RTL 到综合、实现和 CDC 复核的验证链路

用 ASYNC_REG 标注同步寄存器

下面选择 Vivado 作为具体平台。ASYNC_REG 应标在同步链的各级同步寄存器上,而不是只标第一级,也不应无差别加到普通控制寄存器。以下模块可直接作为 Vivado 工程的综合输入。

systemverilog
module bit_sync_with_attr (
    input  logic clk_b,
    input  logic rst_b_n,
    input  logic async_in,
    output logic sync_out
);
    (* ASYNC_REG = "TRUE" *) logic sync_ff1;
    (* ASYNC_REG = "TRUE" *) logic sync_ff2;

    always_ff @(posedge clk_b or negedge rst_b_n) begin
        if (!rst_b_n) begin
            sync_ff1 <= 1'b0;
            sync_ff2 <= 1'b0;
        end else begin
            // 第一级接收异步输入,第二级只接收第一级输出。
            sync_ff1 <= async_in;
            sync_ff2 <= sync_ff1;
        end
    end

    assign sync_out = sync_ff2;
endmodule

预期结果

text
RTL 功能仍是两级同步器;综合后两个目标寄存器应保留 ASYNC_REG=TRUE。

业务逻辑不要读取 sync_ff1。第一级正是可能进入亚稳态的寄存器,正常使用点应从第二级 sync_ff2 之后开始。异步复位的释放本身仍属于复位域问题,本属性不会替代复位释放策略。

在综合结果中确认属性真的生效

先以本课模块作为最小工程顶层运行 Synthesis。综合完成后,在 Vivado Tcl Console 执行下面的真实命令。这里不仅“查看报告”,还对带 ASYNC_REG 的网表单元数量做显式检查;若属性没有进入综合网表,脚本会直接报错。

tcl
open_run synth_1

set sync_regs [get_cells -hier -filter {ASYNC_REG == TRUE}]
puts "ASYNC_REG_COUNT=[llength $sync_regs]"

if {[llength $sync_regs] != 2} {
    error "Expected 2 ASYNC_REG cells, got [llength $sync_regs]"
}

foreach reg $sync_regs {
    puts "[get_property NAME $reg] ASYNC_REG=[get_property ASYNC_REG $reg]"
}

预期输出

text
ASYNC_REG_COUNT=2
<CELL_1> ASYNC_REG=TRUE
<CELL_2> ASYNC_REG=TRUE

<CELL_1>、<CELL_2> 的综合网表名称会随层级和综合命名变化,实际值可能不同,但最小工程中应对应 sync_ff1 与 sync_ff2。如果查询结果为空或数量不是 2,应检查属性拼写、属性作用对象、源文件是否参与综合,以及当前打开的是否确实是 synth_1 结果。

在实现结果和 CDC 报告中复核

完成 Implementation 后再次打开实现结果,检查属性是否仍存在,并打印寄存器实际放置位置。随后在已经接入真实源时钟和目标时钟约束的完整设计中运行 report_cdc -details,生成结构化 CDC 报告。

tcl
close_design
open_run impl_1

set sync_regs [get_cells -hier -filter {ASYNC_REG == TRUE}]
foreach reg $sync_regs {
    puts "[get_property NAME $reg] ASYNC_REG=[get_property ASYNC_REG $reg] LOC=[get_property LOC $reg]"
}

report_cdc -details -file cdc_impl.rpt

预期结果

text
<CELL_1> ASYNC_REG=TRUE LOC=<LOC_1>
<CELL_2> ASYNC_REG=TRUE LOC=<LOC_2>
cdc_impl.rpt 已生成

<LOC_1>、<LOC_2> 由器件和布局决定,实际值可能不同。这里的验收重点不是固定坐标,而是实现后的同步寄存器仍带 ASYNC_REG=TRUE。report_cdc 分析的是已定义时钟之间的跨域结构;若最小测试只有目标时钟和无来源时钟约束的顶层异步输入,它不一定形成可报告的时钟域对,因此属性查询与 CDC 拓扑复核必须分别完成。

属性不能替代正确的 CDC 结构

ASYNC_REG 适合帮助工具保存、放置和识别同步链,但不会提供多比特原子性、脉冲保持或握手语义。单比特慢变化控制信号可以使用两级或多级同步器;多比特总线、窄脉冲、握手事件和连续数据流仍应选择与数据语义匹配的跨域结构。

工程验收应形成闭环:RTL 中同步链结构正确,综合后能查询到目标寄存器的 ASYNC_REG=TRUE,实现后属性仍存在,最后在完整双时钟设计中用 report_cdc -details 复核 CDC 拓扑。这样才能证明属性确实作用到了实现对象,而不是只停留在 RTL 文本里。

按自己的节奏,确认真正理解。

目录与阅读设置

记录一个想法

配置同步器工程属性

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通