blob: 5f5e6f4f4e26848f209aa6cf889404f7a83a6902 (
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
66
67
68
69
70
71
72
|
# 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](http://www.scala-sbt.org/release/docs/Installing-sbt-on-Linux.html),
which isn't available by default in the system package manager:
```
echo "deb https://dl.bintray.com/sbt/debian /" | sudo tee -a /etc/apt/sources.list.d/sbt.list
sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv 642AC823
sudo apt-get update
sudo apt-get install sbt
```
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
```
|
