INSTALL.md

Running the console

Preparation

First, install the Git submodule where I'm keeping my libraries:

git submodule update --init

I'm using the following software:

• Icarus Verilog

• IceStorm toolchain

• TinyFPGA BX software (pip install --user tinyprog)

• GTKWave (for make sim target)

• tortilla8 (for compiling CHIP-8 ROMs from assembly language):

    pip3 install --user 'git+https://github.com/aanunez/tortilla8.git'
    sudo apt install python3-tk
  

See also setup instructions for my FPGA tutorial.

Uploading project to board

To flash the project, connect the board and run:

make flash-chip8

This will also compile and run the default "game", which is counter (asm/counter.c8asm). To use a different one (e.g. tetris), run:

make flash-chip8 GAME=tetris

The Makefile searches for games in the games directory.

Running tests

To run a single test-bench:

make run V=cpu_tb.v

To run all tests:

make test