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.

Firtool is required to generate Verilog.

Verilator is installation is required to simulate your Verilog designs.

Ubuntu Linux

Install the JVM
```
sudo apt-get install default-jdk
```
Install sbt according to the instructions from sbt download.
Install Firtool

Choose whatever version is being used in continuous integration
```
wget -q -O - https://github.com/llvm/circt/releases/download/firtool-1.38.0/firrtl-bin-ubuntu-20.04.tar.gz | tar -zx
```
This will give you a directory called firtool-1.38.0 containing the firtool binary, add this to your PATH as appropriate.
```
export PATH=$PATH:$PWD/firtool-1.38.0/bin
```
Alternatively, you can install the binary to a standard location by simply moving the binary (if you have root access).
```
mv firtool-1.38.0/bin/firtool /usr/local/bin/
```
Install Verilator. We currently recommend Verilator version v4.226. 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 https://github.com/verilator/verilator
```
3. In the Verilator repository directory, check out a known good version:
```
git pull
git checkout v4.226
```
4. In the Verilator repository directory, build and install:
```
unset VERILATOR_ROOT # For bash, unsetenv for csh
autoconf # Create ./configure script
./configure
make
sudo make install
```

Arch Linux

Install Verilator and SBT
```
pacman -Sy verilator sbt
```
Install firtool

See the instructions for Ubuntu above, the firtool Ubuntu binary is a "many Linux" mostly statically linked binary.

Windows

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

Install Verilator and SBT
```
brew install sbt verilator
```
Install firtool
```
wget -q -O - https://github.com/llvm/circt/releases/download/firtool-1.38.0/firrtl-bin-macos-11.tar.gz | tar -zx
```
This will give you a directory called firtool-1.38.0 containing the firtool binary, add this to your PATH as appropriate.
```
export PATH=$PATH:$PWD/firtool-1.38.0/bin
```
Alternatively, you can install the binary to a standard location by simply moving the binary.
```
mv firtool-1.38.0/bin/firtool /usr/local/bin/
```

3.4 KiB Raw Blame History

Chisel Local Setup

Ubuntu Linux

Arch Linux

Windows

Mac OS X

3.4 KiB

Raw Blame History