Handout Materials

We provide handout materials for the tutorial. It includes environment setup instructions and the reading materials for the frameworks to be introduced in the tutorial.

If you have any questions, especially about environment setup, please contact Youwei Xiao (shallwe@pku.edu.cn). We will try our best to help you.

Environment Setup

We provide two setup methods for the involved frameworks: Docker and local installation. We recommend using Docker to try out the frameworks.

Docker

Easiest way: use the built Docker image.

We provide a built Docker image for the tutorial. You can pull it from Docker Hub:

docker pull uvxiao/ahs-tutorial:aspdac2025

Then, you can run the following command to start the container:

docker run -it --rm uvxiao/ahs-tutorial:aspdac2025

The frameworks are installed inside the /root/repos directory.

Building Docker Image from Source

We also provide a repository for building the Docker image from source. Please refer to the ahs-docker repository for details. Here are some takeaways instructions:

git clone git@github.com:pku-liang/ahs-docker.git
cd ahs-docker
# clone the framework collection
git clone git@github.com:pku-liang/ahs-tutorial.git repos --recursive
# make the run.sh executable
chmod +x run.sh
# pull the ubuntu images
./run.sh pull
# build the base Docker image
./run.sh build -i ahs-docker
# run a container with the frameworks mounted
./run.sh run -i ahs-docker -c ahs-docker -v mount.json
docker attach ahs-docker
# then inside the container:
cd /root/repos
chmod +x ./install.sh
./install.sh

The produced Docker image should be the same as the uvxiao/ahs-tutorial:aspdac2025 image.

Local Installation

We also provide a local installation script for the tutorial. Some prerequisites, including but not limited to Ninja, gperf, zip, are required, please refer to Dockerfile as a reference.

Then, you can run the following commands to install the frameworks:

git clone git@github.com:arch-of-shadow/ahs-tutorial.git
cd ahs-tutorial
git submodule update --init
chmod 777 install.sh
./install.sh

Reading Materials

For every framework to be introduced in the tutorial, we provide its open-source repository link and related reading materials like publications, documentation, etc.

Framework	Repository	Materials
POPA	pku-liang/popa	FPGA’24 Paper(Lasa), FCCM’23 Paper
Hector	pku-liang/Hector	ICCAD’22 Paper
Hestia	pku-liang/hestia	MICRO’24 Paper
Cement	pku-liang/Cement	FPGA’24 Paper, Crates.io Package, Documentation
OriGen	pku-liang/OriGen	ICCAD’24 Paper, Hugging Face
Khronos (ksim)	pku-liang/ksim	MICRO’23 Paper

Feel free to have a glance at the materials to get a sense of our works! We’ll assist you to use them step-by-step in the tutorial.