Skip to content
Branch: master
Find file Copy path
Find file Copy path
2 contributors

Users who have contributed to this file

@ucbjrl @chick
73 lines (57 sloc) 2.65 KB

Chisel Local Setup

Instructions for setting up your environment to run Chisel locally.

For a minimal setup, you only need to install SBT (the Scala Build Tool), which will automatically fetch the appropriate version of Scala and Chisel based on on your project configuration.

Verilator is optional, only if you need to run the Chisel3 regression suite, or simulate your Verilog designs. Note that both PeekPokeTester and testers2 both support using treadle (a FIRRTL simulator written in Scala) as the simulation engine, which requires no additional installation steps.

Ubuntu Linux

  1. Install Java

    sudo apt-get install default-jdk	
  2. Install sbt, which isn't available by default in the system package manager:

    echo "deb /" | sudo tee -a /etc/apt/sources.list.d/sbt.list	
    sudo apt-key adv --keyserver hkp:// --recv 642AC823	
    sudo apt-get update	
    sudo apt-get install sbt	
  3. Install Verilator. We currently recommend Verilator version 4.016. Follow these instructions to compile it from source.

    1. Install prerequisites (if not installed already):

      sudo apt-get install git make autoconf g++ flex bison	
    2. Clone the Verilator repository:

      git clone	
    3. In the Verilator repository directory, check out a known good version:

      git pull	
      git checkout verilator_4_016	
    4. In the Verilator repository directory, build and install:

      unset VERILATOR_ROOT # For bash, unsetenv for csh	
      autoconf # Create ./configure script	
      sudo make install	

Arch Linux

  1. Install Verilator and SBT
    yaourt -S sbt verilator


  1. Download and install sbt for Windows.

Verilator does not appear to have native Windows support. However, Verilator works in WSL or in other Linux-compatible environments like Cygwin.

There are no issues with generating Verilog from Chisel, which can be pushed to FPGA or ASIC tools.

Mac OS X

  1. Install Verilator and SBT
    brew install sbt verilator
You can’t perform that action at this time.