leonardxiang/bsg_f1

Bespoke Silicon Group AWS EC2 F1 Infrastructure, Example Projects, and Scripts

BSG Manycore F1 Design (Bladerunner)

This repository contains the Amazon AWS F1 software and interface logic for the Bespoke Silicon Group Manycore on AWS F1.

Contents

This repository contains the following folders:

• build: Vivado scripts for building FPGA Design Checkpoint Files to upload to AWS-F1
• hardware: HDL sources, ROM scripts, and package files
• libraries: C/C++ driver and CUDA-lite Runtime library sources
• regression: C/C++ Regression tests for co-simuation and AWS F1 Execution
• testbenches: Testbench makefiles for C/C++ Co-Simulation
• scripts: Scripts used to upload Amazon FPGA images (AFIs) and configure Amazon Machine Images (AMIs).
• machines: Customized Makefile.machine.include file for different designs.

This repository contains the following files:

• Makefile: Contains targets for Co-Simulation, Bitstream Generation, F1 Regression
• Makefile.machine.include: Defines the Manycore configuration for co-simulation and bitstream compilation
• README.md: This file
• cadenv.mk: A makefile fragment for deducing the CAD tool environment
• environment.mk: A makefile fragment for deducing the build environment.
• hdk.mk: A makefile fragment for deducing the AWS-FPGA HDK build environment.

Dependencies

To simulate/co-simulate/build these projects you must have the following tools.

1. Vivado 2019.1
2. A clone of aws-fpga (v1.4.11)
3. Synopsys VCS (We use O-2018.09-SP2, but others would work)

This repository depends on the following repositories:

1. BSG Manycore
2. BaseJump STL
3. AWS FPGA

Quick-Start

The simplest way to use this project is to clone it's meta-project: BSG Bladerunner.

BSG Bladerunner tracks BSG F1 (this repository), BSG Manycore, and BaseJump STL repositories as submodules and maintains a monotonic versionining scheme. BSG Bladerunner also contains cosimulation instructions.

Customized Design Configurations

Makefile.machine.include contains the default design for the testbenches but the machines directory contains other designs. To use one of these other designs, just copy the Makefile.machine.include to this directory.

cp machines/<design_name>/Makefile.machine.include .