WebAssembly FPGA Runtime

This is the project repository of the WebAssembly FPGA runtime. It comprises project goals, architectural documentation and general information regarding development and contribution.

Prerequisites

Xilinx Vivado 2019.2
HxS Interface Generation Tool

Workspace setup

This project uses Google's Repo tool to work with multiple repositories.

Install repo tool

Use the following instructions to install the Repo tool.

~$ mkdir ~/bin
~$ PATH=~/bin:$PATH
~$ curl https://storage.googleapis.com/git-repo-downloads/repo > ~/bin/repo
~$ chmod a+x ~/bin/repo

Further information regarding the Repo tool can be found here.

Clone repositories

After having installed the Repo tool, all project related repositories can be synced.

~git$ mkdir webassembly && cd webassembly
~git/webassembly$ repo init -u https://github.com/denisvasilik/wasm-fpga
~git/webassembly$ repo sync

Now, the workspace is ready for development.

Create Vivado projects

This project uses a Xilinx FPGA, therefore Xilinx Vivado is used for bitstream generation. Each IP project contains a Make target named project that is used to establish a Vivado project.

~git/webassembly$ for d in wasm-fpga-*/ ; do cd $d && make project && cd .. ; done

The Vivado project is located in the work directory of each wasm-fpga-* root folder.