virtual sequence:UVM 多 agent 激励协调与 start 层次详解
更新时间:2026-10-01。前面 UVM sequence/driver/scoreboard 讲了单条 sequence 怎么把 item 送进 driver,UVM sequence 仲裁 讲了多条 sequence 抢同一个 sequencer 时谁来定先后。这一篇再往上一层:当一个 SoC 环境里有五个、十个 agent,每个 agent 都有自己的 sequencer,测试场景需要「先配寄存器、再等中断、然后多路并发打流量」时,谁来当这个总指挥?答案就是 virtual sequence——一篇把它的组织模式、start 的层次、p_sequencer 与 m_sequencer 的语义、以及调试中最折磨人的挂死问题讲透。
本文要回答的问题
- virtual sequence 解决什么问题,为什么不能让普通 sequence 直接干这个活?
- virtual sequencer 里的子 sequencer 句柄怎么拿到,config_db 和手动 connect 两种路子差在哪?
p_sequencer和m_sequencer到底谁是「我在哪跑」、谁是「我是什么类型」,用错会怎样?start()传 null sequencer、传 virtual sequencer、在子 sequence 里再 start,三种层次的语义分别是什么?- virtual sequence 挂死(仿真不前进也不报错)最常见的五个原因是什么,按什么顺序排查最快?
一、为什么需要 virtual sequence:多 agent 场景的总指挥
单 agent 环境里,sequence 的世界很简单:一个 sequence 跑在一个 sequencer 上,往 driver 里喂 item,场景切换就是换一条 sequence。可一旦环境长成 SoC 级——APB agent 管寄存器、两个 AXI master agent 管数据通路、一个 interrupt agent 管中断注入、再来一个 clock/reset agent 管时钟复位——「测试场景」这个概念就不再属于任何一个 agent 了。「先通过 APB 把 DMA 描述符写好,再等中断 agent 报完成,同时两个 AXI 口打背景流量」这种剧本,天然横跨四个 sequencer。
让某一条普通 sequence 兼任指挥行不行?不行,原因有三。其一,普通 sequence 绑定在特定 item 类型上,它自己就是要产 APB item 或 AXI item 的,让它去协调别的协议等于类型错配。其二,它跑在某个具体 sequencer 上,想给别的 sequencer 发 sequence 就得跨层次抓句柄,层次关系一重构代码全碎。其三,也是最实际的:这种剧本要在几十个 testcase 里复用,必须是一个独立的、可参数化的类——virtual sequence 派生出「上电初始化剧本」「DMA 全双工压测剧本」「错误注入恢复剧本」,testcase 只需选剧本、传参数,不再关心背后调度了几个 agent。这也是 UVM 分层激励思想的顶点:item 层管一拍数据长什么样,sequence 层管一条通路上打什么,virtual sequence 层管整个系统什么时候做什么。

上图是 virtual sequence 的标准站位:它自己一个 item 都不生产,只负责「在正确的时刻、把正确的子 sequence、start 到正确的子 sequencer 上」。virtual sequencer 也不是真正的 sequencer——它不参与仲裁、不连 driver,只是一个装着各子 sequencer 句柄的容器,存在的意义是让 virtual sequence 有一个类型化的、随环境层次一起例化的「接线板」。关于单个 agent 内部 sequence 到 driver 的完整 item 流,见 UVM driver 与 sequence item 流,本篇不再展开。
二、virtual sequencer 的组织:句柄从哪来
virtual sequencer 的骨架极其朴素,就是一排句柄:
class soc_virtual_sequencer extends uvm_sequencer;
`uvm_component_utils(soc_virtual_sequencer)
apb_sequencer apb_sqr;
axi_sequencer axi0_sqr;
axi_sequencer axi1_sqr;
irq_sequencer irq_sqr;
function new(string name, uvm_component parent);
super.new(name, parent);
endfunction
endclass关键问题是:这些句柄怎么赋值?工程上有两条路子。
路子一:env 的 connect_phase 手动连接。 最直白,也是最推荐的做法——env 在例化完各 agent 和 virtual sequencer 之后,显式地把句柄指过去:
function void soc_env::connect_phase(uvm_phase phase);
super.connect_phase(phase);
vsqr.apb_sqr = apb_agt.sequencer;
vsqr.axi0_sqr = axi0_agt.sequencer;
vsqr.axi1_sqr = axi1_agt.sequencer;
vsqr.irq_sqr = irq_agt.sequencer;
endfunction好处是依赖关系全部摊在明面上:哪个 agent 改名、哪个 agent 在 passive 模式下没有 sequencer,编译期和 elaboration 期立刻暴露,不会拖到仿真跑起来才出一个 null handle 的玄学报错。agent 主被动模式对 sequencer 例化的影响,见 UVM agent 主被动模式。
路子二:config_db 逐句柄下发。 每个 agent 或 env 把自己的 sequencer 用 uvm_config_db#(uvm_sequencer)::set 挂出去,virtual sequencer 在 build_phase 逐个 get。这条路在 agent 数量多、环境可裁剪(某些 agent 可选例化)时有用,但代价是字符串路径拼错不报错、只报 get 失败,且类型信息被 uvm_sequencer 基类抹平,拿到手还要 $cast。团队协作规范里通常只在大规模可配置环境顶层用它,普通 SoC env 用路子一足够。
下表把两种路子摆在一起:
| 维度 | connect_phase 手动连接 | config_db 下发 |
|---|---|---|
| 错误暴露时机 | 编译/elaboration 期 | 仿真 build_phase 运行期 |
| 可读性 | 依赖全在 env 一个文件里 | 散落在各 agent 的 set/get |
| 可选 agent 适配 | 需 if 判断,略啰嗦 | 天然适配(get 失败即缺省) |
| 类型安全 | 直接赋值,类型明确 | 需 $cast 下行转换 |
| 推荐场景 | 固定拓扑 SoC env | 高度可配置/可裁剪平台 |
句柄齐了,virtual sequence 才能通过 p_sequencer 摸到它们——这就引出下一节那对最常被混淆的概念。
补一个命名与复用上的实战经验:子 sequencer 句柄的命名要和 agent 实例名严格一致(axi0_sqr 对应 axi0_agt),不要在 virtual sequencer 里另起一套「业务名」(比如 dma_sqr)。环境垂直复用时,上层 env 往往把下层 block env 的 virtual sequencer 句柄再聚合一层(SoC 级的 vsqr 里装的是各 block vsqr,而不是直接装 agent sequencer),形成「virtual sequencer 套 virtual sequencer」的两层结构。这种分层下,SoC 级 virtual sequence 通过 p_sequencer.dma_vsqr.apb_sqr 这样的链式访问触达最底层——链条虽然长,但每一层都是 env 结构的真实投影,重构 block env 时只需要改一处 connect。关于 block 到 SoC 的垂直复用差异,block/subsystem/SoC 验证差异 有更系统的讨论。
三、p_sequencer vs m_sequencer:一个指类型,一个指运行位
几乎所有 UVM 教材都会提这两个句柄,但用错引发的编译报错依然排进新手问题前三。先把语义钉死:
m_sequencer:基类uvm_sequence_base里的成员,类型是uvm_sequencer_base。它记录「这条 sequence 当前正跑在哪个 sequencer 上」——是 start() 时由 UVM 自动赋值的运行态事实。它是基类类型,意味着你没法直接通过它摸到apb_sqr这种子类成员。p_sequencer:宏`uvm_declare_p_sequencer(VSQR_TYPE)在 sequence 内部声明的类型化句柄。它本质上就是同一个 sequencer 指针,但被$cast成了你声明的具体类型,于是p_sequencer.apb_sqr这种访问才合法。
class soc_init_vseq extends uvm_sequence;
`uvm_object_utils(soc_init_vseq)
`uvm_declare_p_sequencer(soc_virtual_sequencer)
task body();
apb_write_seq cfg = apb_write_seq::type_id::create("cfg");
cfg.addr = 32'h40; cfg.data = 32'h1;
cfg.start(p_sequencer.apb_sqr); // 经 p_sequencer 拿子 sequencer
endtask
endclass三个使用纪律。第一,`uvm_declare_p_sequencer 里的类型必须和 sequence 实际 start 上去的 sequencer 类型匹配——宏内部是动态 $cast,不匹配时 p_sequencer 是 null,运行时第一次访问就崩,报错信息还不指向根因。第二,不要为了省事去 $cast(m_sequencer, ...) 自己造类型化句柄,那就是 p_sequencer 宏在做的事,重复造一遍只会多一份出错面。第三,普通 sequence(跑在真实 agent sequencer 上的那种)通常不需要 declare_p_sequencer,它不碰兄弟 sequencer;只有 virtual sequence 才必须声明。

上图把两者的关系画清楚了:它们指向同一个对象,差别只是「看它的类型镜头」。m_sequencer 回答「我在哪跑」,p_sequencer 回答「我能通过你摸到什么」。一个常见的连锁错误是:把 virtual sequence start 到了普通 agent sequencer 上(下一节会讲为什么有人这么干),结果 $cast 失败 p_sequencer 为 null——这同时也是第五节挂死清单里的一条。
还有一个围绕 p_sequencer 的争论值得表态:有团队认为 virtual sequence 不应该通过 p_sequencer 摸子 sequencer,而应该由 test 在 start 之前把各子 sequencer 句柄直接 set 进 sequence 的成员变量,sequence 对 sequencer 拓扑完全无感知。这条路在「同一条 virtual sequence 要复用到拓扑不同的两个环境」时确实更灵活——sequence 只依赖自己声明的句柄字段,不依赖 virtual sequencer 的内部结构。代价是每个 test 都要写一段初始化胶水,且句柄来源从「编译期可检查的层次路径」退化为「运行期赋值」,漏赋一个就是 null。两种风格没有绝对优劣,但一个环境内部必须统一:一半 sequence 走 p_sequencer、一半走外部注入,新人改场景时一定改错地方。
四、start 的层次:null sequencer、virtual sequencer 与子 sequence 的接力
start() 一个参数,三种写法,语义完全不同,这是 virtual sequence 最核心的一节。
写法一:virtual sequence start 在 virtual sequencer 上(主流)。
// test 或 run_phase 中
soc_init_vseq vseq = soc_init_vseq::type_id::create("vseq");
vseq.start(env.vsqr);这是标准姿势:sequencer 真实存在、p_sequencer 可 $cast 成功,phase objection 的传递也走 virtual sequencer 这条线(配合 UVM phase objection 结束控制 里讲的 raise/drop 机制)。
写法二:virtual sequence start(null)。
vseq.start(null); // 或 test 里直接 vseq.start(env.vsqr) 的等价偷懒版virtual sequence 反正不产 item,不需要 sequencer 的仲裁服务,所以传 null 在 UVM 语义上完全合法——IEEE 1800.2 明确允许。但两个代价要掂量:m_sequencer 为 null,p_sequencer 的 $cast 同样失败(null cast 成任何类型还是 null),所以 sequence 内部必须改用别的方式拿子 sequencer——典型做法是 pre_body 里从 config_db 抓一个 env 句柄或 sequencer 句柄表。很多 VIP 的「无 sequencer 场景生成器」用这条路,灵活但把句柄管理的责任甩回给了你自己。
写法三:子 sequence 的接力 start。 virtual sequence 的 body 里,每条子 sequence 必须显式 start 到对应子 sequencer 上,三种等效写法:
task body();
apb_write_seq cfg = apb_write_seq::type_id::create("cfg");
axi_traffic_seq bg0 = axi_traffic_seq::type_id::create("bg0");
axi_traffic_seq bg1 = axi_traffic_seq::type_id::create("bg1");
// 顺序段:先配置
cfg.start(p_sequencer.apb_sqr);
// 并发段:两路 AXI 背景流量
fork
bg0.start(p_sequencer.axi0_sqr);
bg1.start(p_sequencer.axi1_sqr);
join
endtask`uvm_do_on(cfg, p_sequencer.apb_sqr) 宏等价于 create + randomize + start,逻辑相同。这里最容易踩的坑是:子 sequence 的 start 缺省参数是「父 sequence 的 m_sequencer」。在 virtual sequence 里 `uvm_do(cfg) 不写 on 目标,子 sequence 就会被 start 到 virtual sequencer 上——而 virtual sequencer 没连 driver,item 永远等不到 get_next_item,直接挂死。这是线上事故率最高的一条,下一节还会回来。

这张时序图对应上面代码的完整接力过程:test 只 start 一次 virtual sequence,之后所有的 start 接力都发生在 virtual sequence 的 body 内部。顺序段与并发段用 fork/join 表达,调度灵活性全在 body 这个 task 里——这正是 virtual sequence 作为「剧本语言」的价值:改场景不用动 env 结构。关于多 sequence 并发落在同一个 sequencer 上时的仲裁策略(SEQ_ARB_FIFO 等),见 UVM sequence 仲裁;需要独占某条通路时的 lock/grab 语义见 UVM sequencer lock 与 grab。
fork/join 的粒度选择也有讲究。三种常见变体:join 等全部分支(背景流量场景),join_any 等第一条返回就继续(「等中断或超时,谁先到听谁的」),join_none 放火就走(测试全程持续的噪声流量)。join_none 最危险:分支在 virtual sequence 的 body 结束后仍在跑,此时 virtual sequence 的 objection 已 drop,如果没人替它 raise,phase 会在分支还活着的时候就结束测试——表现为「流量打到一半测试正常 PASS」。正确姿势是 join_none 分支配合独立的 objection 管理,或者干脆把这类全程流量挪到 test 层单独 start。另外 fork/join 块内直接 start 子 sequence 时,注意每个分支的 sequence 实例必须各自 create——同一个句柄在两个分支里 start,第二个 start 会等第一个结束,并发变串行,这类问题在 SystemVerilog fork/join 进程控制 里有更细的分析。
五、挂死排查:virtual sequence 五大经典死法
virtual sequence 出问题的典型症状是「仿真时间不走、日志停在某一行、不报错」—— objection 被举着、某个 start 永远不回来。按出现频率排,五大死法和排查顺序如下。
死法一:子 sequence start 到了 virtual sequencer 上。 就是上一节说的 `uvm_do 忘了写 _on 目标。特征是日志里子 sequence 已经 starting,但 driver 侧再无任何 item 活动。排查:在子 sequence 的 pre_body 打 `uvm_info 打印 m_sequencer.get_full_name(),看到名字是 vsqr 就实锤了。修复:显式 start(p_sequencer.xxx_sqr)。
死法二:p_sequencer 为 null。 原因要么 `uvm_declare_p_sequencer 的类型声明错(比如声明成 env 类型而不是 virtual sequencer 类型),要么 sequence 被 start 到了不匹配的 sequencer 上(含 start(null) 后忘了换句柄来源)。特征是访问 p_sequencer.apb_sqr 时仿真器报 null object dereference,或直接静默卡住。排查:body 第一行加 if (p_sequencer == null) uvm_fatal(...)`——所有 virtual sequence 都值得把这句写成模板标配,把运行期玄学变成秒级定位。
死法三:子 sequencer 句柄没连上。 env 的 connect_phase 里漏了一行 vsqr.irq_sqr = ...,或 agent 被切成 passive 模式后 sequencer 根本没例化。virtual sequence start 子 sequence 到 null sequencer,UVM 会报 FATAL 还是挂死取决于版本和写法——用 start(null_handle) 多数版本直接 FATAL,反而是好事;怕的是句柄指向了一个存在但没连 driver 的 sequencer。排查:connect_phase 末尾遍历打印 vsqr 各句柄是否为 null。
死法四:objection 只升不降。 virtual sequence 自己在 pre_body 里 raise 了 objection,body 里某条子 sequence 挂死(回到死法一),导致 post_body 的 drop 永远执行不到。或者更隐蔽的:子 sequence 内部 raise 了它所在 sequencer 的 objection,但挂死前没 drop。特征是仿真日志里 drain time 之后 phase 一直不跳转。排查:加 +UVM_OBJECTION_TRACE,看哪个 objection 计数归不了零,顺藤摸瓜到具体 sequence。objection 机制的完整讨论见 UVM phase objection 结束控制,配合 UVM heartbeat 看门狗 可以把「挂死」变成「超时违例」,回归里不再干等。
死法五:fork/join 里一条分支永不返回。 比如 wait_irq_seq 等一个永不来的中断(中断 agent 没配 enable,或 DUT 根本没拉 irq 线)。join 等所有分支,一条卡住全体卡住。排查:给等待类子 sequence 统一加超时 forks off 或 timeout fork,回归环境绝不允许无界等待。

上面这张决策流程就是推荐的排查顺序:先确认是不是最常见的「start 错位」,再查句柄,再查 objection,最后查并发等待。经验上 80% 的挂死在前两步就能定位。把这张流程贴在团队 wiki 上,新人第一次遇到挂死时平均定位时间能从半天缩到十分钟。
预防比排查更值钱,三条团队规范能把前五类死法中的四类消灭在编码期。第一,virtual sequence 模板里 body 第一行固定写 p_sequencer 的 null 检查加 `uvm_fatal,把运行期玄学变成启动即报。第二,团队内禁用裸 `uvm_do——凡是子 sequence 一律 `uvm_do_on 或显式 start,从语法层面堵死「落回 virtual sequencer」这条路。第三,所有等待类子 sequence(等中断、等状态位)的接口里强制带 timeout 参数,virtual sequence 调用时必须传值,回归环境不允许任何无界等待存在。这三条写进 lint 检查或代码评审清单,比事后调波形划算得多。
这一篇在知识体系里的位置
本篇是 UVM sequence 系列的协调层篇章,上接单点机制、下接环境集成。前置阅读:UVM sequence/driver/scoreboard(单 agent 的 item 流底座)、UVM env/top/test 结构(virtual sequencer 在 env 里的例化位置)、UVM driver 与 sequence item 流(子 sequence start 之后下游发生什么)。横向关联:UVM sequence 仲裁(多 sequence 落同一 sequencer 时的优先级)、UVM sequencer lock 与 grab(virtual sequence 想独占某条通路时)、UVM phase objection 结束控制(挂死死法四的机制底座)、UVM heartbeat 看门狗(把挂死变违例)。后续可接 AMBA AXI UVM 环境,看真实多 agent 环境里 virtual sequence 剧本的完整形态。
总结
virtual sequence 的本质是一个「不产 item 的剧本类」:它 start 在只当接线板的 virtual sequencer 上,靠 `uvm_declare_p_sequencer 拿到类型化的 p_sequencer、进而摸到各子 sequencer,再在 body 里把子 sequence 逐条 start 到正确目标上;挂死排查记住顺序——先看子 sequence 是不是 start 错位到了 virtual sequencer,再查 p_sequencer 与子 sequencer 句柄是否为 null,再用 objection trace 查只升不降,最后查 fork/join 里的无界等待。