Packages

  • package root

    This is the documentation for Chisel.

    This is the documentation for Chisel.

    Package structure

    The chisel3 package presents the public API of Chisel. It contains the concrete core types UInt, SInt, Bool, Clock, and Reg, the abstract types Bits, Aggregate, and Data, and the aggregate types Bundle and Vec.

    The Chisel package is a compatibility layer that attempts to provide chisel2 compatibility in chisel3.

    Utility objects and methods are found in the util package.

    The testers package defines the basic interface for chisel testers.

    Definition Classes
    root
  • package chiseltest

    ChiselTest Compatibility Layer for Chisel 7

    ChiselTest Compatibility Layer for Chisel 7

    This package provides a drop-in replacement for the ChiselTest library that was removed in Chisel 7. It preserves the familiar ChiselTest API while delegating to Chisel 7's ChiselSim underneath.

    Usage:

    import chiseltest._
    import org.scalatest.flatspec.AnyFlatSpec
    
    class MyTest extends AnyFlatSpec with ChiselScalatestTester {
      it should "work" in {
        test(new MyModule) { dut =>
          dut.io.in.poke(42.U)
          dut.clock.step()
          dut.io.out.expect(42.U)
        }
      }
    }

    Key Components: - testableData, testableUInt, testableBoolExt: Implicit conversions for poke/peek/expect - testableClock: Clock stepping and control - DecoupledIOOps: Utilities for Decoupled interface testing - ChiselScalatestTester: ScalaTest integration trait

    See README.md for detailed documentation.

    Definition Classes
    root
  • package formal

    Formal compatibility API placeholders.

    Formal compatibility API placeholders.

    Formal verification is currently unsupported in this compatibility layer. Any usage should fail at compile time to avoid vacuously passing tests.

    Definition Classes
    chiseltest
  • ChiselScalatestTester
  • DecoupledDriver
  • DecoupledIOOps
  • ForkHandle
  • VerilatorBackendAnnotation
  • WriteVcdAnnotation
  • testableBoolExt
  • testableClock
  • testableData
  • testableReset
  • testableUInt
t

chiseltest

ChiselScalatestTester

trait ChiselScalatestTester extends AnyRef

ChiselTest-compatible API that delegates to ChiselSim (Chisel 7)

This trait provides the ChiselTest API that users are familiar with from Chisel 6, but internally uses ChiselSim from Chisel 7 to perform the actual testing.

VCD GENERATION SUPPORT: This compatibility layer supports VCD generation when WriteVcdAnnotation is used. VCD files are generated in: build/chiselsim/<timestamp>/workdir-verilator/trace.vcd

AUTOMATIC RESET FEATURE: By default, this trait automatically resets the module before running tests, mimicking ChiselTest's behavior from Chisel 6.

To disable auto-reset or customize the reset duration:

class MyTest extends AnyFlatSpec with ChiselScalatestTester {
  override def autoResetEnabled: Boolean = false  // Disable auto-reset
  override def resetCycles: Int = 5               // Or change duration
}

Example usage with VCD:

import chiseltest._
import org.scalatest.flatspec.AnyFlatSpec

class MyModuleSpec extends AnyFlatSpec with ChiselScalatestTester {
  behavior of "MyModule"

  it should "generate waveforms" in {
    test(new MyModule).withAnnotations(Seq(WriteVcdAnnotation)) { dut =>
      dut.io.in.poke(42.U)
      dut.clock.step()
      dut.io.out.expect(42.U)
    }
    // VCD file: build/chiselsim/<timestamp>/workdir-verilator/trace.vcd
  }
}
Source
ChiselScalatestTester.scala
Linear Supertypes
AnyRef, Any
Type Hierarchy
Ordering
  1. Alphabetic
  2. By Inheritance
Inherited
  1. ChiselScalatestTester
  2. AnyRef
  3. Any
Implicitly
  1. by any2stringadd
  2. by StringFormat
  3. by Ensuring
  4. by ArrowAssoc
  1. Hide All
  2. Show All
Visibility
  1. Public
  2. Protected

Type Members

  1. class TestBuilder[T <: Module] extends AnyRef

    Builder class to support .withAnnotations() chaining

  2. class TestRunner[T <: Module] extends AnyRef

    Runner class that executes the test with VCD support

Value Members

  1. final def !=(arg0: Any): Boolean
    Definition Classes
    AnyRef → Any
  2. final def ##: Int
    Definition Classes
    AnyRef → Any
  3. def +(other: String): String
    Implicit
    This member is added by an implicit conversion from ChiselScalatestTester toany2stringadd[ChiselScalatestTester] performed by method any2stringadd in scala.Predef.
    Definition Classes
    any2stringadd
  4. def ->[B](y: B): (ChiselScalatestTester, B)
    Implicit
    This member is added by an implicit conversion from ChiselScalatestTester toArrowAssoc[ChiselScalatestTester] performed by method ArrowAssoc in scala.Predef.
    Definition Classes
    ArrowAssoc
    Annotations
    @inline()
  5. final def ==(arg0: Any): Boolean
    Definition Classes
    AnyRef → Any
  6. final def asInstanceOf[T0]: T0
    Definition Classes
    Any
  7. def autoResetEnabled: Boolean

    Enable automatic reset before each test.

    Enable automatic reset before each test. Override this to disable auto-reset if needed.

  8. def clone(): AnyRef
    Attributes
    protected[lang]
    Definition Classes
    AnyRef
    Annotations
    @throws(classOf[java.lang.CloneNotSupportedException]) @native()
  9. def ensuring(cond: (ChiselScalatestTester) => Boolean, msg: => Any): ChiselScalatestTester
    Implicit
    This member is added by an implicit conversion from ChiselScalatestTester toEnsuring[ChiselScalatestTester] performed by method Ensuring in scala.Predef.
    Definition Classes
    Ensuring
  10. def ensuring(cond: (ChiselScalatestTester) => Boolean): ChiselScalatestTester
    Implicit
    This member is added by an implicit conversion from ChiselScalatestTester toEnsuring[ChiselScalatestTester] performed by method Ensuring in scala.Predef.
    Definition Classes
    Ensuring
  11. def ensuring(cond: Boolean, msg: => Any): ChiselScalatestTester
    Implicit
    This member is added by an implicit conversion from ChiselScalatestTester toEnsuring[ChiselScalatestTester] performed by method Ensuring in scala.Predef.
    Definition Classes
    Ensuring
  12. def ensuring(cond: Boolean): ChiselScalatestTester
    Implicit
    This member is added by an implicit conversion from ChiselScalatestTester toEnsuring[ChiselScalatestTester] performed by method Ensuring in scala.Predef.
    Definition Classes
    Ensuring
  13. final def eq(arg0: AnyRef): Boolean
    Definition Classes
    AnyRef
  14. def equals(arg0: AnyRef): Boolean
    Definition Classes
    AnyRef → Any
  15. def finalize(): Unit
    Attributes
    protected[lang]
    Definition Classes
    AnyRef
    Annotations
    @throws(classOf[java.lang.Throwable])
  16. final def getClass(): Class[_ <: AnyRef]
    Definition Classes
    AnyRef → Any
    Annotations
    @native()
  17. def hashCode(): Int
    Definition Classes
    AnyRef → Any
    Annotations
    @native()
  18. final def isInstanceOf[T0]: Boolean
    Definition Classes
    Any
  19. final def ne(arg0: AnyRef): Boolean
    Definition Classes
    AnyRef
  20. final def notify(): Unit
    Definition Classes
    AnyRef
    Annotations
    @native()
  21. final def notifyAll(): Unit
    Definition Classes
    AnyRef
    Annotations
    @native()
  22. def resetCycles: Int

    Number of clock cycles to assert reset.

    Number of clock cycles to assert reset. Override this to change reset duration.

  23. final def synchronized[T0](arg0: => T0): T0
    Definition Classes
    AnyRef
  24. def test[T <: Module](dutGen: => T): TestBuilder[T]

    Test a module with the given stimulus

    Test a module with the given stimulus

    This method provides the ChiselTest interface.

    T

    The type of module being tested

    dutGen

    A generator function that creates the device under test

  25. def toString(): String
    Definition Classes
    AnyRef → Any
  26. final def wait(): Unit
    Definition Classes
    AnyRef
    Annotations
    @throws(classOf[java.lang.InterruptedException])
  27. final def wait(arg0: Long, arg1: Int): Unit
    Definition Classes
    AnyRef
    Annotations
    @throws(classOf[java.lang.InterruptedException])
  28. final def wait(arg0: Long): Unit
    Definition Classes
    AnyRef
    Annotations
    @throws(classOf[java.lang.InterruptedException]) @native()

Deprecated Value Members

  1. def formatted(fmtstr: String): String
    Implicit
    This member is added by an implicit conversion from ChiselScalatestTester toStringFormat[ChiselScalatestTester] performed by method StringFormat in scala.Predef.
    Definition Classes
    StringFormat
    Annotations
    @deprecated @inline()
    Deprecated

    (Since version 2.12.16) Use formatString.format(value) instead of value.formatted(formatString), or use the f"" string interpolator. In Java 15 and later, formatted resolves to the new method in String which has reversed parameters.

  2. def [B](y: B): (ChiselScalatestTester, B)
    Implicit
    This member is added by an implicit conversion from ChiselScalatestTester toArrowAssoc[ChiselScalatestTester] performed by method ArrowAssoc in scala.Predef.
    Definition Classes
    ArrowAssoc
    Annotations
    @deprecated
    Deprecated

    (Since version 2.13.0) Use -> instead. If you still wish to display it as one character, consider using a font with programming ligatures such as Fira Code.

Inherited from AnyRef

Inherited from Any

Inherited by implicit conversion any2stringadd fromChiselScalatestTester to any2stringadd[ChiselScalatestTester]

Inherited by implicit conversion StringFormat fromChiselScalatestTester to StringFormat[ChiselScalatestTester]

Inherited by implicit conversion Ensuring fromChiselScalatestTester to Ensuring[ChiselScalatestTester]

Inherited by implicit conversion ArrowAssoc fromChiselScalatestTester to ArrowAssoc[ChiselScalatestTester]

Ungrouped