TGC-VP/README.md

2.4 KiB

TGC-VP

The Scale4Edge ecosystem 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. Since the CoreDSL description is used to generate RTL as well as verification artifacts it 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 and follow the instructions. After the build finished you can run

build/src/tgc-vp -f fw/hello-world/prebuilt/hello.elf

or use ctest:

cd build
ctest

You will see on console the prints of the hello world firmware at fw/hello-world/hello.c

Open in Gitpod

Quick start

  • you need to have a C++14 capable compiler, make, python, and cmake installed

  • install conan.io (see also http://docs.conan.io/en/latest/installation.html):

    pip3 install --user 'conan<2.0'
    

    Installing conan for the first time you need to create a profile:

    conan profile create default --detect
    
  • checkout source from git

    git clone --recursive -b develop https://github.com/Minres/TGC-VP.git 
    
  • start an out-of-source build:

    cd TGC-VP
    cmake -S . -B build
    cmake --build build -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
  • Conan (https://conan.io/) version 1.36 or newer. If python is installed this can be installed using pip (see above in Quick start)

build step

Create a project at the location of the git workarea. This can be done

devenv <path to checkout>

The build steps are as described in the VS documentation for CMake based projects.