HIFIVE1-VP/README.md

89 lines
3.0 KiB
Markdown
Raw Normal View History

2017-11-28 03:45:49 +01:00
# DBT-RISE-RISCV
2018-07-28 10:02:28 +02:00
Am instruction set simulator based on DBT-RISE implementing the RISC-V ISA. The project is hosted at https://git.minres.com/DBT-RISE/DBT-RISE-RISCV.
2017-08-27 12:10:38 +02:00
2017-11-28 03:45:49 +01:00
**DBT-RISE-RISCV README**
2017-08-27 12:10:38 +02:00
2017-09-25 21:17:55 +02:00
This is work in progress, so use at your own risk. Goal is to implement an open-source ISS which can easily embedded e.g. into SystemC Virtual Prototypes. It used code generation to allow easy extension and adaptation of the used instruction.
The RISC-V ISS reaches about 30MIPS running on Intel Core i7-2600K.
2017-08-27 12:10:38 +02:00
2017-09-25 21:17:55 +02:00
The implementation is based on LLVM 4.0. Eclipse CDT 4.7 (Oxygen) is recommended as IDE.
2017-08-27 12:10:38 +02:00
2017-11-28 03:46:38 +01:00
DBT-RISE-RISCV uses libGIS (https://github.com/vsergeev/libGIS) as well as ELFIO (http://elfio.sourceforge.net/), both under MIT license
2017-08-27 12:10:38 +02:00
**What's missing**
2017-11-23 14:48:18 +01:00
* F & D standard extensions for 32bit to be implemented
* MACF &D standard extensions for 64bit to be implemented and verified
2017-08-27 12:10:38 +02:00
**Planned features**
* add platform peripherals beyond programmers view to resemble E300 platform
* QSPI
* PWM
2017-09-25 21:17:55 +02:00
* ...
2017-08-27 12:10:38 +02:00
* and more
**Quick start**
2017-10-26 11:41:35 +02:00
* you need to have a decent compiler, make, python, and cmake installed
2017-11-28 03:45:49 +01:00
* install LLVM 4.0 according to http://apt.llvm.org/ (if it is not already provided by your distribution e.g by Ubuntu 17.04)
* install conan.io (see also http://docs.conan.io/en/latest/installation.html):
2017-10-26 11:41:35 +02:00
```
pip install conan
```
* setup conan to use the minres repo:
2017-10-26 11:41:35 +02:00
```
2017-11-23 11:24:25 +01:00
conan remote add minres https://api.bintray.com/conan/minres/conan-repo
conan remote add bincrafters https://api.bintray.com/conan/bincrafters/public-conan
2017-10-26 11:41:35 +02:00
```
2017-08-27 12:10:38 +02:00
* checkout source from git
* start an out-of-source build:
2017-10-26 11:41:35 +02:00
```
2017-09-25 21:17:55 +02:00
cd DBT-RISE-RiscV
2017-08-27 12:10:38 +02:00
mkdir build
cd build
2017-09-25 21:17:55 +02:00
cmake ..
2017-10-26 11:41:35 +02:00
cmake --build .
2017-08-27 12:10:38 +02:00
```
2017-10-26 11:41:35 +02:00
* if you encounter issues when linking wrt. c++11 symbols you might have run into GCC ABI incompatibility introduced from GCC 5.0 onwards. You can fix this by adding '-s compiler.libcxx=libstdc++11' to the conan call or changing compiler.libcxx to
```
compiler.libcxx=libstdc++11
```
2017-11-28 03:45:49 +01:00
in $HOME/.conan/profiles/default
** Detailed Setup steps**
*** prepare Ubuntu 18.04 ***
```
sudo apt-get install -y git python-pip build-essential cmake libloki-dev zlib1g-dev libncurses5-dev \
libboost-dev libboost-program-options-dev libboost-system-dev libboost-thread-dev llvm-dev llvm-doc
pip install --user conan
```
*** prepare Fedora 28 ***
```
#prepare system
dnf install @development-tools gcc-c++ boost-devel zlib-devel loki-lib-devel cmake python2 python3 llvm-devel llvm-static
#install conan
pip3 install --user conan
export PATH=${PATH}:$HOME/.local/bin
```
*** Build the ISS ***
```
# configure conan
conan remote add minres https://api.bintray.com/conan/minres/conan-repo
conan remote add bincrafters https://api.bintray.com/conan/bincrafters/public-conan
conan profile new default --detect
# clone and build DBT-RISE-RISCV
git clone --recursive https://github.com/Minres/DBT-RISE-RISCV.git
cd DBT-RISE-RISCV/
git checkout develop
mkdir build;cd build
MAKE_FLAGS="-j4" cmake ..
make -j4
```