Skip to content
Provides various testers for chisel users
Scala C++ Other
Branch: master
Clone or download
Latest commit c23bb10 Sep 24, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github Add CODEOWNERS file Dec 7, 2018
project Bump sbt to 1.3.2 (#261) Sep 23, 2019
src Support migration of dontTouch, RawModule, MultiIOModule from experim… Sep 11, 2019
.gitignore Fix double elaboration of DUT when using the interpreter (#154) Jun 8, 2017
CommonBuild.sc Add mill support. (#202) Jul 6, 2018
Makefile
README.md Removed redundant text in doc (#248) Aug 20, 2019
build.sbt Bump dependency versions (#254) Sep 5, 2019
build.sc Bump dependency versions (#254) Sep 5, 2019

README.md

Chisel Testers

This a layer of test harnesses for Chisel

Chisel is an open-source hardware construction language developed at UC Berkeley that supports advanced hardware design using highly parameterized generators and layered domain-specific hardware languages.

Visit the community website for more information.

The Chisel Tutorials provide many examples of how to use these harnesses

The Available Harnesses

There are currently three harnesses available. All make it easy to construct a circuit, implemented as chisel Module, named the device under test (or DUT) by specifying what goes into the module's inputs and what is expected to come out of the module's outputs. The types of IO ports used by the circuit determines which tester to use.

PeekPokeTester

Tests the DUT by poking values into its inputs and testing values of its outputs. PeekPokeTester is the most flexible tester, peeks and pokes are done in a software based model. Peeking can be done at any time, and the value returned can be tested and used to take different branches during the text execution. The PeekPokeTester supports two separate backends.

  1. The Firrtl Interpreter: a lightweight scala based low firrtl execution engine, with rapid spinup but slower overall speed.
  2. A verilator backend: which builds a c++ compiled circuit emulation. Faster execution, but with a longer spinup.

This is in contrast to the following hardware oriented testers, in which a testing circuit is built that drives the circuit, or device under test (DUT) from value vectors for each input. Testing the outputs each cycle against a separate set of value vectors for each output.

For a longer description, see the Using the PeekPokeTester.

SteppedHWIOTester

Tests the DUT by poking values into its inputs and testing values of its outputs. Tests are executed in a fixed order and at a fixed cycle

For a long description see the Using the Hardware IO Testers

OrderedDecoupledHWIOTester

Tests a DUT that uses decoupled flow control for its inputs and outputs. Tests values are applied in order mediated by the ready/valid controls. The implementer does not have to manage this flow control.

You can’t perform that action at this time.