Getting Started using Docker (Suggested)

Install Conda (for the first time)

If you don’t have Docker installed yet, follow the instructions here to install on your platform.

Install environment using Docker

Start by cloning mase:

git clone git@github.com:DeepWok/mase.git

Create your own branch to work on:

cd mase
git checkout -b your_branch_name

Launching Docker

If you’re an Imperial College student running MASE on a CAS server (ee-beholder/ee-kraken), you can just run the following commands to use the existing docker container.

make shell

If you do not have access to one of our servers and need access to Vivado/Vitis toolflows, you need to rebuild your docker container from scratch by running the following command:

make shell vhls=$YOUR_VHLS_PATH vhls_version=$YOUR_VHLS_VERSION local=1

The first argument points to your Xilinx tool directory and you should see the following folder under the path:

DocNav  Model_Composer  Vitis  Vitis_HLS  Vivado  xic

The second argument indicates your Xilinx tool version, e.g. 2023.1. The last argument asks to build the docker container locally with the new arguments.