CHIP-8 is an interpreted programming language, developed by Joseph Weisbecker. It was initially used on the COSMAC VIP and Telmac 1800 8-bit microcomputers in the mid-1970s. CHIP-8 programs are run on a CHIP-8 virtual machine.

Read more at: https://en.wikipedia.org/wiki/CHIP-8

In order to download any dependencies, building and running the emulator you need to have cabal and ghc installed. On windows you can download Haskell Platform, which comes bundled with GHC and Cabal among other utilities.

Start by cloning the repository with:

git clone https://github.com/joelsiks/chip8-haskell

There are a couple of rom files already present in the repository in the roms/ folder which you can use when running the emulator.

You might want to download any dependencies if they are not already installed. Use:

cabal update

To build and run the emulator, use:

cabal run

When starting the emulator the program will look for a folder named roms. It will then ask you what rom located in the roms folder you want to run.

When the emulator window pops up, you start it by clicking on the window.

The 16 available keyboard input keys for the emulator are the following:

After launching a ROM it might not be immediately clear what input the program expects (if anything). The input combinations for some of the most common ROMs that are played on the CHIP-8 can be seen in the table below.

If you want to exit the program at any time, press the escape key (ESC).

Joel Sikström, Casper Norrbin, Jakob Wallén

Project work for the course Program Design and Data Structures (20 ECTS).