Skip to content
This repository has been archived by the owner on Nov 25, 2022. It is now read-only.

Latest commit

 

History

History
40 lines (29 loc) · 1.05 KB

README.md

File metadata and controls

40 lines (29 loc) · 1.05 KB
Raw

Containerised VHDL implementation of Conway's Game of Life

Project for Embedded Systems course

Arguments:

  • VHDL
    • Multiple entities
    • Unit test testbenches
    • Interactive testbench
  • Object oriented programming
    • Python (backend API and tests)
    • TypeScript
    • Code generation
  • UNIX shell
    • Interaction with a process through piped stdin and stdout
    • Makefile
    • Dockerfiles with shell commands
  • DevOps
    • Containerisation
    • Unit tests
    • Git

How to use

Start an instance of the entire system by using Docker Compose:

docker-compose up

It might take a few minutes to start the system.

Once both the containers are started, navigate to localhost in your browser.

The backend might be really slow to start on Apple Silicon machines due to an additional emulation layer, making the frontend unresponsive for a while. The backend (GHDL) container is x86-only.

The interactive documentation for the REST API is available at localhost:8000/redoc.