The repository comprises all the open-source hardware involved in the overlay, together with the automated flow to generate wrapper interfaces for application-specific hardware accelerators and system components.
The overlay generator should be cloned at first:
[email protected]:gbellocchi/arov.git
Set HERO_OV_HW_EXPORT to the root of AROV (e.g. /home/user-name/workspace_user/arov).
Set VSIM_PATH to the vsim of AROV (e.g. /home/user-name/workspace_user/arov/vsim).
To pull the required Git submodules, run:
git submodule update --init --recursive
The repository is the following:
ov_cfg/- Collection of generated source files to customize accelerator-rich system.deps/- SystemVerilog dependencies. Basically, the overlay IPs (RISC-V core, DMA, memory, etc.).genov/- Tool employed to generate the accelerator wrappers and system-level components.test/- SystemVerilog testbench to simulate the behavior of the target accelerator-rich system.vsim/- Scripts to set up and run simulations.fpga/- FPGA build flow and associated scripts.
Version control is currently managed in a hybrid way:
- The RTL dependencies are flattened in the genov Git repository, meaning that once a RTL component is added, this does not behave as a submodules, but is added to the file tree with a
git add. This has the advantage to make modifications possible with no need to modify the remote repository. The latter operation can be realized once the modifications are finally stable. - The information about the RTL tree dependencies is propagated to tools, such as vivado and QuestaSim, with the employment of Bender. The latter is used to generate configuration scripts that feed the target tool with the proper source file listings and compilation scripts.
- Additional tools, such as
GenOvfigure as Git submodules from the perspective of AROV.
A step-by-step guide is included under genov/README.md. Following it, It is possible to set up GenOv and generate an exemplary system instance.
This solution is for users who have a HERO repository installed. A test application could be run in simulation as follows.
-
Set the following environment variable to the top directory of your HERO ecosystem:
export HERO_HOME_DIR=<your_path> (typically something like $HOME/workspace_user/hero). -
Be sure to source the proper environment to compile the software tests:
source $HERO_HOME_DIR/env/esim.sh. -
Move to the directory of your test application (for example
$HERO_HOME_DIR/openmp-examples/helloworld). It does not have to be necessarily an heterogeneous application, as tests will only run on the accelerator-rich system (no host included). -
Build the application in standalone mode with
make only=pulp clean all. -
Go back to the AROV root.
-
Launch the simulation.
To run verification tests on QuestaSim, you can run the command make vsim.
Additionally, add the following arguments:
-
APP_PATH: This is to specify the path to the test application that has been just built. For example, you can run the command:
make vsim APP_PATH=${HERO_OV_HOME_DIR}/helloworld. -
GUI: The script runs by default a QuestaSim GUI. To run the simulation in console-only mode set the variable
GUIto 0 when launching the simulation command. For example:make vsim GUI=0
Note that Bender creates a TCL file named compile.tcl to inform QuestaSim about the structure of the RTL dependency tree associated with the target system under-test.
After this, the application binary is retrieved and partitioned according to the L2 and L1 bank structure. At this point, the simulation starts: the testbench will load memories with the partitioned binary and cores will be activated to execute the test application.
- "A RISC-V-based FPGA Overlay to Simplify Embedded Accelerator Deployment" - G. Bellocchi et al. (2021)
Gianluca Bellocchi
- E-mail: [email protected]