Mirrors/RISCV-VP
7
0
Fork 1
mirror of https://github.com/Minres/RISCV-VP.git synced 2025-12-17 08:51:35 +00:00
Code Issues Packages Projects Releases Wiki Activity

updates README.md, FW, some names and does some cleanup

Browse Source
This commit is contained in:
Eyck Jentzsch
2024-06-30 20:22:19 +02:00
parent 15144ca608
commit c15fd95d4c
16 changed files with 81 additions and 153 deletions
Download Patch File Download Diff File Expand all files Collapse all files

110
README.md
View File

@@ -1,5 +1,6 @@
# TGC-VP
The Scale4Edge ecosystem VP using VP-VIBES peripherals.
# RISCV-VP
A RISC-V VP using VP-VIBES peripherals.
This VP is based in MINRES TGC series cores and uses CoreDSL to generate the concrete ISS
of a particular ISA + extensions. The generator approach makes it very flexible and adaptable.
@@ -8,7 +9,7 @@ provides a comprehensive and consistent solution to develop processor cores.
## Ultra Quick start
Using gitpod you can run the VP in the cloud. Just visit [Gitpod.io](https://www.gitpod.io/#https://github.com/Minres/TGC-VP/tree/develop)
Using gitpod you can run the VP in the cloud. Just visit [Gitpod.io](https://www.gitpod.io/#https://github.com/Minres/RISCV-VP/tree/develop)
and follow the instructions. After the build finished you can run
```
@@ -31,96 +32,29 @@ You will see on console the prints of the hello world firmware at fw/hello-world
[![Open in Gitpod](https://gitpod.io/button/open-in-gitpod.svg)](https://gitpod.io/#https://github.com/Minres/TGC-VP)
## Quick start
## Build instructions for Linux
* you need to have a C++14 capable compiler, make, python, and cmake installed
You need to have a C++17 capable compiler, make or Ninja, Python 3, and CMake installed.
* install conan.io (see also http://docs.conan.io/en/latest/installation.html):
To install conan.io version 2.0 and above (see also http://docs.conan.io/en/latest/installation.html) execute the following:
```
pip3 install --user conan
```
It is advised to use conan version 1.36 or newer. In case of an older version please run
```sh
pip3 install --user --upgrade conan
```
Installing conan for the first time you need to create a profile:
```
conan profile create default --detect
```
* checkout source from git
```sh
git clone --recursive -b develop https://github.com/Minres/TGC-VP.git
```
* start an out-of-source build:
```
cd TGC-VP
mkdir build
cd build
cmake ..
make -j tgc-vp
```
* run the VP with pre-built firmware
```
ctest
```
or
```
src/tgc-vp -f ../fw/hello-world/prebuild/hello.elf
```
To rebuild the firmware you need to install a RISC-V toolchain like https://github.com/riscv/riscv-tools.
# Windows/Visual Studio build
TGC-VP supports VS2019/MSVC 16 and has been tested only with this version
## Prerequisites
You need to have to following installed:
* Visual Studio 2019 (community edition is sufficient) with C/C++ support
* Python 3.6 or newer
* SystemC 2.3.3 and SystemC-CCI 1.0.0. Both should be installed into the same location and the
environment variable SYSTEMC_HOME should point to it
* Conan (https://conan.io/) version 1.36 or newer. If python is installed this can be installed using pip
(see above in [Quick start](#quick-start))
## build step
Create a project at the location of the git workarea. This can be done
```
python3 -m venv .venv
. .venv/bin/activate
pip3 install conan
conan profile new default --detect
```
devenv <path to checkout>
Building the VP is as simple as:
```
cmake -S . -B build/Release --preset Release && cmake --build build/Release -j24
```
The build steps are as described in the VS documentation for CMake based projects.
Building a debug version is analogous:
```
cmake -S . -B build/Debug --preset Debug && cmake --build build/Debug -j24
```
To build some firmware you need to install a RISC-V toolchain like https://github.com/riscv/riscv-tools.