Skip to content

cornell-zhang/heterocl

Repository files navigation

Note: HeteroCL is superseded by Allo, a new programming language for composable accelerator design [PLDI'24]. For the latest updates, please visit our new repository.

GitHub license CircleCI

HeteroCL: A Multi-Paradigm Programming Infrastructure for Software-Defined Reconfigurable Computing

Website | Installation | Tutorials | Documentation

Introduction

With the pursuit of improving compute performance under strict power constraints, there is an increasing need for deploying applications to heterogeneous hardware architectures with accelerators, such as GPUs and FPGAs. However, although these heterogeneous computing platforms are becoming widely available, they are very difficult to program especially with FPGAs. As a result, the use of such platforms has been limited to a small subset of programmers with specialized hardware knowledge.

To tackle this challenge, we introduce HeteroCL, a programming infrastructure comprised of a Python-based domain-specific language (DSL) and a compilation flow. The HeteroCL DSL provides a clean programming abstraction that decouples algorithm specification from hardware customizations including compute and data customizations. HeteroCL can further capture the interdependence among these different customization techniques, allowing programmers to explore various performance/area/accuracy trade-offs in a systematic and productive manner.

Language Overview

flow

Current Compilation Flow

flow

Install MLIR-based HeteroCL

To install the HeteroCL-MLIR dialect, please make sure you have installed the tools below:

  • gcc >= 5.4
  • cmake >= 3.19
  • python >= 3.7

The following script shows the complete process of building the HeteroCL-MLIR dialect and connecting it with the HeteroCL frontend. It may take about 10 minutes to install the LLVM package depending on the internet connection and the hardware resource of your machine. If you are a HeteroCL developer, please refer to the guide in the HCL-MLIR repository and build the dialect with the Python binding from source.

git clone https://github.com/cornell-zhang/heterocl.git heterocl-mlir
cd heterocl-mlir
git submodule update --init --recursive
pip install . -v
# export LLVM path
export LLVM_BUILD_DIR=$(pwd)/hcl-dialect/externals/llvm-project/build
export PATH=${LLVM_BUILD_DIR}/bin:${PATH}

To verify HeteroCL is installed correctly, you can run the following test.

python3 -m pytest tests

Related Publications

Related Work

Contributing to HeteroCL

Coding Style (Python)

We follow official Python coding style and use NumPy docstring style. We use Black and PyLint to format Python code.

Coding Style (C and C++)

We follow Google coding style. Please refer to the hcl-dialect repository for more details.