带参 property:SVA 断言参数化复用写法、默认实参与端口映射的完整指南
更新时间:2026-10-02。验证工程师写 SVA(SystemVerilog Assertions,SystemVerilog 断言)时,最初的痛苦是「不会写」,写顺之后的痛苦变成「写太多」——同一个「valid 拉起期间 payload 必须稳定」的检查,AXI 读通道抄一遍、写通道抄一遍、自定义流接口再抄一遍,除了信号名一模一样。带参 property 就是消灭这种复制粘贴的语言机制:把协议规则写成带形式参数的 property 或 sequence,信号、延时、位宽都作为参数传入,一处定义、处处例化。本站的 SVA 断言完整指南 讲了断言语法全景,SVA checker 库复用 站在工程组织角度讲断言库怎么建,这一篇是两者之间承上启下的一篇:聚焦带参 property 这一个语言特性本身——形参怎么声明、默认实参怎么给、端口方向语义有什么坑、sequence 与 property 之间参数怎么互传。把这些细节吃透,你写的断言库才不是「看着能复用、一用就报错」的样子货。
本文要回答的问题
- 带参 property 和带参 sequence 的形参列表怎么写,与 module 参数有什么本质区别?
- 形参有没有方向(input/output/inout)?「untyped 形参」到底是什么语义?
- 默认实参什么时候能省略实参,省略规则与 Verilog 函数参数的省略规则有何不同?
- 参数化断言实例化时按名连接和按位置连接怎么选,信号宽度不匹配会发生什么?
- 怎么把带参 property 组织成可维护的断言库,局部变量与参数怎么搭配使用?
一、为什么需要带参 property:从复制粘贴到一处定义
先看不参数化的世界有多疼。典型 SoC 有十几种接口:AXI4、APB、AHB、自定义流接口,握手细节各不相同,但大量检查是「同构」的:valid 拉高期间 data 稳定、握手完成前地址不得撤销、响应限时返回。不参数化的话,每个接口的断言文件里都有一坨结构相同、只有信号名不同的 property。某次评审发现「stable 检查应加 disable iff 复位」这条改进,你要改几十处,漏改一处就是定时炸弹——两个接口对同一条规则做了不同检查,没人知道哪个对。
带参 property 把这类同构检查收敛成一份定义:规则的「形状」(时序逻辑)写在模板里,「内容」(具体信号)在例化点以实参填入。这和软件函数抽象同思想,但 SVA 参数化更灵活:实参不只是数值,还可以是信号表达式、甚至时序表达式。SVA AXI4 读通道检查 和 SVA AXI4 写通道检查 里大量检查项,本质都是同一个「握手稳定性」模板喂了不同信号。

上图是参数化的收益全景:真正的收益不是「少打字」,而是「协议规则的改进能原子地传播到所有使用点」——断言库里修一个 bug,所有接口的检查行为一起变对。
二、形参声明语法:类型、方向与 untyped 语义
带参 property 的声明形式是在 property 关键字后紧跟一个括号形参列表,sequence 同理:
property stable_during_valid(sig, valid, clk);
@(posedge clk) disable iff (!rst_n)
valid |=> $stable(sig);
endproperty形参可以带类型,也可以不带。不带类型的形参是 untyped(无类型)形参,语义是「例化点文本级代入」——实参是什么表达式,模板里就出现什么表达式,宽度、符号性都不在定义点检查。这是 SVA 参数化和软件泛型最不一样的地方:untyped 更像宏展开,实参可以是完整表达式(比如 mst.req[i].data & mask),带类型参数里这说不通。
带类型形参则像变量声明:property p(logic [31:0] sig, logic valid);。好处是定义点就能做宽度检查、不匹配时编译器报错;代价是实参须能隐式转换到该类型,表达式会被求值截断。经验法则:跨项目复用的模板用 untyped,项目内部固定宽度的模板可带类型换编译期检查。
形参还可以声明方向——input、inout、output——但方向语义与 module 端口完全不同,是 SVA 里最反直觉的坑之一。对 property 而言,input 形参取实参的采样值,inout 传引用,output 允许把局部变量的值「带出」到实参——但 output 实践中几乎只在 sequence 里与局部变量搭配用(把匹配中间结果暴露给外层)。九成情况不需要写方向,默认 untyped 代入就是对的;明确写 input 的主要动机是某些形式工具对采样语义处理更严格。
| 形参写法 | 代入语义 | 定义点类型检查 | 实参可否为表达式 | 适用场景 |
|---|---|---|---|---|
| untyped(默认) | 文本级代入 | 无 | 可以 | 跨项目复用模板 |
| 带类型 | 求值后转换 | 有 | 会被求值截断 | 固定宽度项目内模板 |
| input 方向 | 采样值代入 | 取决于类型 | 可以 | 形式工具严格采样 |
| inout/output | 引用/回传 | 有 | 必须是左值 | sequence 局部变量回传 |
这张表把四种写法的选择逻辑钉死了:需要传表达式或宽度不定——untyped;想要编译期宽度保护——带类型;要和局部变量玩回传——output/inout。拿不准就 untyped,坑最少。
三、默认实参:省略规则与常见用法
形参可以带默认实参(default actual argument),例化时对应的实参可以省略——但省略的写法有讲究:
property ack_within(req, ack, max_wait = 8, clk = clk);
@(posedge clk) disable iff (!rst_n)
req |-> ##[1:max_wait] ack;
endproperty
// 例化:后两个参数都取默认值
assert property (ack_within(start, done));
// 例化:只覆盖 max_wait,clk 用默认值——用逗号占位
assert property (ack_within(start, done, 16));
// 例化:跳过 max_wait 只覆盖 clk——必须用按名连接
assert property (ack_within(start, done, .clk(sys_clk)));关键规则两条:其一,默认值只能「从右往左」连续省略——想省中间的参数又想给后面的参数传值,按位置连接做不到,必须切到按名连接(.形参名(实参))。其二,按位置连接时想显式表达「这个参数用默认值」,不是留空逗号(那是语法错误),而是直接按名连接或调整形参顺序——把最常覆盖的参数放前面、最少覆盖的放后面,是形参排序的基本原则。
默认实参的典型场景三类。一是时钟与复位:模板里 clk、rst_n 几乎总是同一个全局信号,给了默认值例化点就不用每次写——注意默认值里的信号在定义点作用域解析,断言库编译进 package 再 bind 到不同模块时该名字必须在使用点可见,否则宁可不给默认值。二是超时常数:如上面的 max_wait,默认值给协议上限,特殊场景覆盖。三是开关量:property p(sig, en_check = 1'b1),例化时可整个关掉某条子检查,用于灰度启用新检查项。

上图是形参列表的设计规则:按「例化时被覆盖的概率」从高到低排。排对了,九成例化按位置连接一行写完;排错了,每个例化点都被迫按名连接,使用体验直线下降——而体验直接决定团队愿不愿意复用你的断言库。
四、sequence 参数与 property 互传:把时序本身参数化
带参 sequence 的价值比带参 property 更高一层:它允许把「触发条件」和「后续时序」都做成参数。一个典型模式是「通用响应检查器」:
sequence req_then_ack(req, ack, min_gap = 1, max_gap = 8);
req ##[min_gap:max_gap] ack;
endsequence
property axi_read_resp;
@(posedge clk) disable iff (!rst_n)
ar_valid && ar_ready |-> req_then_ack(1'b1, r_valid && r_ready, 1, 16);
endproperty这里 req_then_ack 把「两个事件之间的窗口」抽象成 sequence,property 里只关心把哪个事件接到哪个端口。更进一步,sequence 的形参本身可以是另一个 sequence——实参位置传 a ##2 b 这样的时序表达式,模板把它当成整体事件用。这是搭协议检查器库的核心手法:协议状态机骨架写成 sequence 模板,状态转移条件作为实参传入。
带参 property 调用带参 sequence 时参数链式传递:property 的形参可直接作为实参传给 sequence,也可先加工(如 |-> seq_tmpl(sig & mask))。链式传递有个采样时机的坑:「参数传的是表达式,不是数值快照」。需要快照时(请求时刻的地址要在响应窗口内比对),须用局部变量在 sequence 开头捕获——这属于 SVA 多时钟与局部变量 的深水区,只提醒一句:跨拍比对必须走局部变量,靠参数传值做不到。
五、工程落地:参数化断言库的组织方式
单个带参 property 会写了,库怎么组织还有一层学问。推荐三层结构:底层「协议无关原语」(stable、window、eventually 这类纯时序模板,全 untyped、全默认值),中层「协议模板」(AXI 握手规则、APB 相位规则),顶层「bind 外壳」(例化模板并 bind 到 DUT,实参填层次路径信号)。三层独立演进:协议升级改中层,DUT 改名只改 bind 文件,原语层几乎不动。bind 细节见 SVA bind 断言模块:bind 解决「断言与 DUT 解耦」,参数化解决「断言与接口解耦」,两个解耦叠加,断言库才真正成为跨项目资产。
落地三条纪律。第一,每个模板配「自我实例化」smoke 测试:用 toy DUT 例化每个模板,确认默认值、按名连接、untyped 代入按预期工作——模板的 bug 会在所有使用点同时爆炸,必须最早暴露。第二,实参宽度不匹配用 lint 规则拦住:untyped 不做宽度检查,32 位实参喂 64 位模板会静默截断。第三,形式工具对复杂参数化(sequence 套 sequence、局部变量穿参数)支持度参差,上 FPV 前先用小用例验证,仿真能跑不代表形式能证,详见 形式验证基础 与 FPV 约束方法论。
这一篇在知识体系里的位置
本篇在 chip-design/verification 目录的 SVA 语言特性线上。向上承接 SVA 断言完整指南 的语法全景与 SVA assertion 实践 的入门写法,把「会写单条断言」推进到「会写可复用的断言模板」。横向与多篇算子级深文互补:时序窗口相关见 SVA sequence 重复算子,匹配与触发语义见 SVA ended 与 matched 触发,复位窗口见 SVA disable iff 复位处理。向下,参数化模板是 SVA checker 库复用 的地基,具体协议实例落在 SVA AXI4 读通道检查、SVA AXI4 写通道检查 与 SVA APB 相位检查。
总结
带参 property 的本质是把协议规则的「形状」与「内容」分离:形参列表按覆盖概率从高到低排序、少覆盖的参数给默认值、省略只能从右往左(中间省略必须按名连接);untyped 形参做文本级代入、能传任意表达式但不做宽度检查,带类型形参换编译期保护;sequence 参数化还能把时序骨架本身抽象出来,配合 bind 的三层组织(原语、协议模板、bind 外壳),断言库才真正从「复制粘贴的集合」升级为「一处修改、处处生效」的验证资产。