FPGA 与数字 IC 设计 / 系统课时
冻结双时钟统计模块接口和时序
冻结双时钟统计模块接口和时序
在编写双时钟流式统计模块前,先把接口、跨域边界、计数规则和输出握手定义成可验证的契约。本课以采样域接收事件、处理域累计事件数量并输出统计快照为例,给出固定参数、SystemVerilog 接口声明和逐项验收条件,避免实现过程中反复修改协议。
学习目标
- 固定两个时钟域的职责、接口信号、数据宽度及复位约束。
- 明确采样接收、跨域传输、统计累计和输出握手的周期行为。
- 将接口契约转换为可执行的协议断言和边界验收用例。
固定模块功能与时钟域边界
本项目实现一个事件统计模块:采样端输入一条带数值的事件,处理端累计事件数量与数值总和,上游发出快照请求后,处理端通过 ready-valid 接口输出一条统计结果。
为使接口和验收具有确定性,采用以下工程规格。表中的频率是本项目仿真与时序约束的目标,不表示 RTL 自动生成时钟。
| 项目 | 冻结规格 |
|---|---|
采样时钟 sample_clk |
100 MHz,周期 10 ns |
处理时钟 proc_clk |
80 MHz,周期 12.5 ns |
事件数据 s_data |
8 位无符号数,0~255 |
| 事件输入握手 | s_valid && s_ready |
| 跨域缓冲 | 深度 16 的异步 FIFO |
事件计数 event_count |
32 位无符号数 |
数值累计 value_sum |
32 位无符号数 |
输出数据 m_data |
64 位,分别存放数量与总和 |
| 输出握手 | m_valid && m_ready |
| 统计溢出 | 32 位自然回绕,模 |
采样域只负责接受事件并将其写入异步 FIFO;处理域从 FIFO 读取事件、更新计数器并生成快照。任何单周期控制信号都不能直接从一个时钟域接到另一个时钟域的状态更新逻辑。

冻结顶层接口与复位约束
采用 SystemVerilog 定义顶层模块接口,后续实现、测试平台和集成模块都以该声明为准。以下是接口定义片段示例,依赖后续实现的异步 FIFO、计数逻辑和输出寄存器,不是可以直接仿真得到统计结果的完整模块。
module dual_clock_stats #(
parameter int unsigned DATA_W = 8,
parameter int unsigned COUNT_W = 32,
parameter int unsigned FIFO_DEPTH = 16
) (
input logic sample_clk,
input logic sample_rst_n,
input logic proc_clk,
input logic proc_rst_n,
input logic s_valid,
output logic s_ready,
input logic [DATA_W-1:0] s_data,
input logic snapshot_req,
output logic m_valid,
input logic m_ready,
output logic [2*COUNT_W-1:0] m_data
);
// 后续在此实现FIFO、统计计数器和快照输出逻辑。
endmodule这份声明默认生成 64 位输出,参数化实现必须另外检查 FIFO_DEPTH 为不小于 2 的二次幂,DATA_W 与 COUNT_W 均大于零。本项目验收配置固定为 8、32、16,不在第一版验收中测试其他参数组合。
接口方向与所有者必须明确:
| 信号 | 所属时钟域 | 契约 |
|---|---|---|
s_valid、s_data |
sample_clk |
上游驱动,等待握手期间保持稳定 |
s_ready |
sample_clk |
FIFO能够安全接受一条事件时为1 |
snapshot_req |
proc_clk |
高电平持续一个周期表示一次快照请求 |
m_valid、m_data |
proc_clk |
模块驱动,背压期间保持不变 |
m_ready |
proc_clk |
下游驱动,表示可以接收统计快照 |
两个低有效复位信号独立输入,允许异步断言,但必须分别在各自时钟域同步释放。复位期间禁止输入接收和输出发送;复位完成且 FIFO 的双侧恢复握手结束之前,s_ready 必须保持为0。
规定事件累计与快照周期行为
事件被采样域接受的条件是采样时钟上升沿同时满足 s_valid=1 与 s_ready=1。不满足该条件时,不得向 FIFO 写入新事件。
处理域从 FIFO 成功取出一条事件时执行以下更新:
event_count增加1。value_sum增加该事件的s_data数值。- 两个寄存器都按32位无符号整数回绕。
快照请求由 snapshot_req 在处理时钟上升沿采样,固定采用请求边沿之前的统计寄存器值。如果同一个处理时钟边沿既消费 FIFO 事件又采样快照请求,该事件不包含在此次快照中,而会计入后续快照。
输出字段固定为:高32位 event_count,低32位 value_sum。例如依次处理数据 10、20、30 后,统计值是数量3、总和60,对应 m_data=64'h00000003_0000003C。
本项目使用单槽快照寄存器,并采用以下明确的控制约束:
- 快照槽为空时,采样到
snapshot_req=1,在该上升沿锁存当前计数值;该沿之后m_valid变为1。 m_valid=1且m_ready=0时,保持输出有效位和64位数据不变。m_valid=1且m_ready=1时,该上升沿完成输出握手;该沿之后清除m_valid。m_valid=1的整个周期内,上游不得发出新的snapshot_req;即使发生,第一版模块也不会缓存该请求。- 输出握手与新快照请求不能在同一个上升沿合并处理;必须等到槽位空闲后的后续上升沿才能接收新请求。
这相当于定义了快照请求的前置条件:请求端必须保证输出槽空闲。由于本版接口没有 snapshot_ready 信号,是否满足条件由上游协议保证,并在验证中用断言检查。

将协议约束变成可检查的断言
接口冻结后,先编写边界不变式,再进行完整数据通路实现。下面的 SVA 是验证绑定片段示例,依赖已经例化的 dual_clock_stats 实例及其实际端口连接。假定两个复位信号可被测试平台单独控制,且 FIFO 恢复完成前不会开放 s_ready。
// 采样域:上游受到背压时必须保持事件及有效标志。
a_s_input_hold: assert property (
@(posedge sample_clk)
disable iff (!sample_rst_n || !proc_rst_n)
s_valid && !s_ready |=> s_valid && $stable(s_data)
);
// 处理域:输出受背压时有效位和数据必须保持。
a_m_output_hold: assert property (
@(posedge proc_clk)
disable iff (!sample_rst_n || !proc_rst_n)
m_valid && !m_ready |=> m_valid && $stable(m_data)
);
// 处理域:复位释放后的输出不得包含未知值。
a_m_output_known: assert property (
@(posedge proc_clk)
disable iff (!sample_rst_n || !proc_rst_n)
m_valid |-> !$isunknown(m_data)
);
// 请求协议:已有待发送快照时不允许重复请求。
a_snapshot_request: assert property (
@(posedge proc_clk)
disable iff (!sample_rst_n || !proc_rst_n)
m_valid |-> !snapshot_req
);这些断言分别验证输入稳定、输出稳定、有效数据确定性和快照请求限制。a_s_input_hold 与 a_snapshot_request 检查的是外部驱动遵守协议,a_m_output_hold 与 a_m_output_known 检查的是模块输出行为,测试报告应区分责任归属。
这组断言还不能证明跨域 FIFO 没有丢数或乱序。完整验证需要另建参考队列:每次输入握手入队,每次处理域内部 FIFO 消费出队,将消费数据按顺序累计;每次快照请求锁存参考统计值,输出握手时逐位比较64位结果。
固定验收场景和完成标准
测试平台应分别产生 10 ns 与 12.5 ns 的时钟,使用独立复位,并在处理域生成单周期快照请求。下面给出第一版必须通过的功能验收表。
| 场景 | 输入与操作 | 预期结果 |
|---|---|---|
| 基础累计 | 已消费10、20、30,之后请求快照 | 数量3,总和60 |
| 零值事件 | 连续消费4条数值0的事件 | 数量4,总和0 |
| FIFO满背压 | 暂停处理域读取,持续提交事件 | FIFO满时 s_ready=0,上游必须保持待发送数据 |
| 输出背压 | m_valid=1,连续3个处理周期令 m_ready=0 |
数据与有效位连续保持 |
| 同拍边界 | 请求沿同时消费一条事件 | 当前快照不包含该条事件 |
| 计数回绕 | 通过受控测试预置数量为 32'hFFFFFFFF,再消费1条事件 |
数量回绕至0 |
| 单侧复位 | 模块繁忙时只拉低一个复位输入 | 整个会话清零并进入双侧恢复,禁止旧数据继续输出 |
预置计数器属于验证环境的白盒操作,不是公开模块接口,必须在测试报告中单独标明。复位测试还应覆盖 FIFO 非空、输出背压和双侧错峰释放,确认旧会话数据不会混入新会话。
为了验证异步 FIFO 的时钟边界,测试不能只运行两个固定相位的时钟。至少增加采样时钟初始相位偏移 0 ns、2 ns、5 ns 三种情况,并分别覆盖 FIFO 从空到非空、从未满到满、以及复位重新建立的过程。
最终验收要求:所有合法事件恰好消费一次、消费顺序与输入握手顺序一致、合法快照的64位结果与参考模型完全一致、ready-valid 断言零失败、复位恢复期间零非法握手。所有合法事务完成后,参考模型队列必须为空。
接口一旦冻结,后续实现可以替换 FIFO 存储结构或优化内部流水线,但不能擅自更改采样归属、快照同拍规则、背压保持条件和输出字段排列。若这些契约需要修改,应同步更新接口版本、断言、参考模型和验收用例。