PWM 占空比验证:周期/高电平采样比对与 0%/100% 边界用例
更新时间:2026-09-29。PWM(Pulse Width Modulation,脉冲宽度调制)是定时器外设最常见的输出形态,验证它的思路和 计数器边界验证:回绕、重载与极值 一脉相承——都是「把硬件行为换算成数值,再和参考模型比对」。硬件侧的背景知识(输入捕获怎么测脉宽)见 定时器输入捕获与 PWM 原理。这一篇只聚焦测试平台侧:怎么在 scoreboard 里把「占空比对不对」变成一次无歧义的数值比较。
本文要回答的问题
- 为什么 PWM 占空比验证不该用
$realtime量时间,而要采样成时钟计数值? - 参考模型怎么写:周期和高电平各测一次,还是只测一个?
- 容差(tolerance)给多少拍合理,给零会出什么事?
- 0%、100% 占空比和周期突变这些边界用例,各会暴露什么真 bug?
一、测量原则:比计数值,不比仿真时间
新手写 PWM 检查器的第一反应是用 $realtime 记录上升沿/下降沿时刻,相减得到高电平宽度,再除以周期。这条路在 RTL 仿真里是个坑:
- 仿真时间精度受 timescale 影响,跨时钟域、带门控时钟时浮点除法误差不可控;
- DUT 内部的占空比本来就是「多少个系统时钟拍」的整数概念,拿浮点秒数去比对是拿错尺子;
- 一旦换到带 SDF 反标的门级仿真,沿的时刻整体漂移,所有阈值全废。
正确姿势和 DUT 自己的视角对齐:用一个自由运行的计数器,在沿上打时间戳,比对拍数差。这和输入捕获通道干的事一模一样——所以我们在测试平台里实现的就是一个软件版输入捕获。
// 软件输入捕获:对 pwm_out 的沿打拍数时间戳
class pwm_capture;
localparam int MAX_PERIOD = 65536;
int unsigned rise_ts[$]; // 上升沿时间戳队列
int unsigned fall_ts[$]; // 下降沿时间戳队列
task run();
fork
forever @(posedge vip_if.pwm_out) rise_ts.push_back($countones(1)); // 伪码,见下
forever @(negedge vip_if.pwm_out) fall_ts.push_back($countones(1));
join
endtask
endclass上面的 $countones(1) 只是占位;实际做法是用一个 int unsigned free_cnt,在测试平台顶层 always @(posedge clk) free_cnt++,沿到来时把 free_cnt 存进队列。每个周期从队列弹出两个上升沿时间戳相减得周期拍数 P,上升沿到紧随的下降沿相减得高电平拍数 H,占空比 = H / P。整个链路没有一个浮点数,门级仿真下也稳。
二、测量时序:一次看全三个量
把「沿 → 时间戳 → 派生量」的关系画成时序图,能看清参考模型每一步在等什么。

读这张图抓三件事。第一,P(周期)要等第二个上升沿才算得出来,所以任何占空比检查天然有一拍周期的延迟,scoreboard 比对时刻要对齐到「周期完整闭合」之后,不能在高电平结束时就急着判。第二,H 和 P 来自同一根信号的两组沿,共用同一个 free_cnt 基准,绝对相位(103 从哪来)无所谓,差值才有意义——这让检查器对测试启动时刻完全免疫。第三,占空比 40% 是派生量的派生量,误差会沿 H、P 两级累积,这就是下一节容差存在的理由。
工程上另一个常见选择:P 和 H 都要测。只测 H 不测 P 的环境,遇到过周期寄存器配错但高电平恰好也等比缩放的漏网 bug——占空比读数正常,输出频率却错了一倍。两个量独立比对,一个量出错另一个立刻露馅。
三、参考模型与容差:差一拍算不算错
参考模型(predictor)从寄存器写序列推导期望值:周期寄存器 ARR 决定 P_exp = ARR+1,比较寄存器 CCR 决定 H_exp = CCR(具体 +1/-1 惯例按手册对齐)。比对逻辑写成:
function bit check(int unsigned p_act, h_act, p_exp, h_exp);
return (abs_diff(p_act, p_exp) <= TOL_P) &&
(abs_diff(h_act, h_exp) <= TOL_H);
endfunction容差怎么定,看 DUT 的更新机制:
| 更新机制 | 建议 TOL_P / TOL_H | 理由 |
|---|---|---|
| 立即更新(写寄存器当拍生效) | 0 拍 | 无任何异步路径,差一拍就是真 bug |
| 影子寄存器 + 更新事件(UEV 换载) | 0 拍,但比对窗口避开换载周期 | 换载那一周期出现旧值/新值混合是合法的 |
| 跨时钟域同步后生效 | 2-3 拍 | 同步器打两拍,外加相位差一拍 |
| 带预分频(prescaler) | 按预分频比放大 | 计数器走 N 拍才动一格,量化误差放大 N 倍 |
TOL 给零但比对窗口不避开换载周期,是 PWM 验证误报榜第一名:测试随机在任意时刻改写 CCR,恰好命中换载中那个「半新半旧」的周期,检查器报 fail,查半天发现设计行为完全合规。对策有两个,任选其一:要么参考模型预测「本周期用旧值还是新值」(要知道写入时刻相对计数器相位),要么把换载周期标记为 don't check 窗口,下个完整周期再比对。前者严格后者省事,回归规模大了以后多数团队选后者。
四、边界用例:0%、100% 与周期突变
常规随机占空比打不出这几个角的深度,必须定向写:
| 用例 | 期望行为 | 专抓的 bug |
|---|---|---|
| duty = 0%(CCR=0) | 输出恒低,没有沿 | 计数器到 0 仍翻出一个毛刺窄脉冲 |
| duty = 100%(CCR ≥ ARR+1) | 输出恒高,没有沿 | 比较逻辑 >= 写成 > 导致差一拍翻转 |
| 0% ↔ 100% 直接跳变 | 电平干净切换,无中间窄脉冲 | 换载逻辑在极值间切换时丢更新事件 |
| 运行中改周期(ARR 大改小) | 当前周期提前换载或走完旧周期(按手册) | 新周期立即截断导致输出一个超窄脉冲 |
| 最小周期(ARR=0 或 1) | 每个/每两个时钟拍翻转 | 计数器回绕与比较同拍发生时的竞争 |
| 毛刺注入(输入捕获模式下) | 窄于滤波窗的脉冲被滤掉 | 捕获逻辑把毛刺沿当成有效沿记录 |
这张表里前两行特别值得展开。0% 和 100% 的共同特征是没有沿——而整个测量链路是靠沿驱动的!沿不来,capture 队列就是空的,检查器如果在「等沿」上死等,测试会挂死而不是报错。正确做法是 watchdog 式判定:等了 2 倍期望周期还没见到沿,且采样输出电平恒定等于期望值,则判通过;电平不对或等来一个不该有的沿,判失败。这正好复用 计数器边界验证:回绕、重载与极值 里「极值用例必须验证长时间静默」的思路。

这张流程图把「有沿走数值比对、没沿走电平判定」的双路径画清楚了:判定节点是「窗口内是否见到完整周期」,两条出边分别通向两套判据。注意它同时防住了两类相反的错误——0% 用例里冒出一个沿(走左侧路径,比对立刻失败),和 50% 配置下输出却卡死恒低(走右侧路径,电平判定失败)。
最后补一个容易漏的维度:占空比随时间的稳定性。单次比对过了不代表长期稳定,在长跑测试里对每个周期记录 (P, H) 并统计最大/最小值,能抓到偶发的换载毛刺——这类问题 100 次短测不一定撞上一次,建议留一个 nightly 级别的万周期长跑用例兜底。
这一篇在知识体系里的位置
- 上游原理:定时器输入捕获与 PWM 原理 讲清捕获通道与 PWM 发生器的硬件结构,本篇的参考模型就是它的测试平台镜像。
- 同族方法:计数器边界验证:回绕、重载与极值 提供「计数值比对 + 极值定向用例」的通用框架,本篇把它落到 PWM 这一具体外设上。
- 断言配合:对「输出恒高/恒低期间不得有沿」这类属性,可以用 SVA 固化成长期在线的监控,写法见同目录 SVA 系列文章。
总结
PWM 占空比验证的要点是「用 DUT 的尺子量 DUT」:以自由运行计数器在输出沿上打时间戳,把周期 P 与高电平 H 都换算成拍数再和寄存器推导的期望值比对,容差随更新机制定 0-3 拍并避开换载周期;0%/100% 这类「无沿」用例必须切换到「超时 + 电平恒定」的 watchdog 判据,配合运行中改周期、最小周期、长跑稳定性统计,才能把 PWM 输出的数值正确性与波形干净度同时钉死。