blob: 27e07960958feff181c7fc3e0d5917f5cb3f0174 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
|
# 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)](http://www.scala-sbt.org), which will automatically fetch the appropriate version of Scala and Chisel based on on your project configuration.
[Verilator](https://www.veripool.org/wiki/verilator) is optional, only if you need to run the Chisel3 regression suite, or simulate your Verilog designs.
Note that both [PeekPokeTester](https://github.com/freechipsproject/chisel-testers) and [testers2](https://github.com/ucb-bar/chisel-testers2) both support using [treadle](https://github.com/freechipsproject/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
```
1. Install sbt according to the instructions from [sbt download](https://www.scala-sbt.org/download.html).
1. 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 http://git.veripool.org/git/verilator
```
3. In the Verilator repository directory, check out a known good version:
```
git pull
git checkout v4.016
```
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
1. Install Verilator and SBT
```
yaourt -S sbt verilator
```
## Windows
1. [Download and install sbt for Windows](https://www.scala-sbt.org/download.html).
Verilator does not appear to have native Windows support.
However, Verilator works in [WSL](https://docs.microsoft.com/en-us/windows/wsl/install-win10) 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
```
|
