如何在ChiselSim中正确对Bundle类型信号执行poke/peek操作？

问题分析 #

你遇到的两个问题本质都是对ChiselSim的Bundle操作API理解偏差：

• 直接poke Bundle报错：ChiselSim对Bundle的poke要求硬件端口与软件Bundle实例的结构完全匹配，且软件实例的每个字段都必须是明确的Literal值；部分旧版本Chisel可能不支持直接对Bundle调用.poke()方法。
• peek Bundle提示无该方法：FlatInstruction作为硬件Bundle端口本身没有peek方法，peek是用于获取硬件信号数值的顶层API，而非Bundle成员方法。

解决方案 #

1. 正确实现Bundle的poke操作 #

如果直接对端口调用.poke(worklist(i))报错，有两种可行方式：

方式一：使用顶层poke函数（推荐，Chisel 3.4+支持）

直接传入硬件端口和软件Bundle实例：

poke(c.io.in, worklist(i))

方式二：手动遍历字段逐个poke（兼容所有版本）

如果方式一无效，可逐个字段赋值：

val inst = worklist(i)
c.io.in.inst_subclass.poke(inst.inst_subclass)
c.io.in.inst_ptr.poke(inst.inst_ptr)
c.io.in.inst_value.poke(inst.inst_value)
c.io.in.inst_bit_len.poke(inst.inst_bit_len)
c.io.in.inst_change_type.poke(inst.inst_change_type)
// 依次赋值op0、op1相关字段
c.io.in.op0_subclass.poke(inst.op0_subclass)
c.io.in.op0_ptr.poke(inst.op0_ptr)
c.io.in.op0_value.poke(inst.op0_value)
c.io.in.op0_bit_len.poke(inst.op0_bit_len)
c.io.in.op0_change_type.poke(inst.op0_change_type)
c.io.in.op1_subclass.poke(inst.op1_subclass)
c.io.in.op1_ptr.poke(inst.op1_ptr)
c.io.in.op1_value.poke(inst.op1_value)
c.io.in.op1_bit_len.poke(inst.op1_bit_len)
c.io.in.op1_change_type.poke(inst.op1_change_type)
// 最后赋值控制字段
c.io.in.is_valid.poke(inst.is_valid)
c.io.in.is_last.poke(if (i == worklist.length - 1) true.B else inst.is_last)

注意：避免同时使用Bundle整体poke和单个字段poke，后者会覆盖前者的对应字段值。

2. 正确实现Bundle的peek操作 #

要获取整个输出Bundle的数值，需使用顶层peek函数，而非调用Bundle端口的.peek()方法：

if (c.io.out.is_valid.peek().litToBoolean) {
  val resultInst = peek(c.io.out).asInstanceOf[FlatInstruction]
  results = results :+ resultInst
}

或者利用类型推导简化：

if (c.io.out.is_valid.peek().litToBoolean) {
  results = results :+ peek(c.io.out)
}

修正后的完整测试代码片段 #

var worklist : Seq[FlatInstruction] = Seq() // 确保每个元素的字段都已赋值为Literal（如U(0x123), true.B等）
var results : Seq[FlatInstruction] = Seq()
simulate(new AccelSimWrapper) { c =>
  // 复位流程
  c.reset.poke(true)
  c.clock.step(1)
  c.reset.poke(false) // 必须释放复位，否则电路一直处于复位状态

  var i = 0
  var finished = false
  while (!finished)  {
    // 输入指令逻辑
    if (i < worklist.length) {
      poke(c.io.in, worklist(i))
      // 仅当是最后一条指令时覆盖is_last字段
      if (i == worklist.length - 1) {
        c.io.in.is_last.poke(true.B)
      }
      i += 1
    } else {
      // 无更多指令时输入无效信号
      c.io.in.is_valid.poke(false.B)
    }

    // 收集结果逻辑
    if (c.io.out.is_valid.peek().litToBoolean) {
      val result = peek(c.io.out)
      results = results :+ result
      finished = result.is_last.litToBoolean
    }

    c.clock.step(1)
  }
}

额外注意事项 #

• 确保worklist中的FlatInstruction实例每个字段都已用U()、Bool()等构造为Literal值，而非未初始化的硬件节点。
• 复位操作需完整：复位后必须pokefalse释放复位，否则电路无法正常工作。

内容的提问来源于stack exchange，提问作者gillo04