yayacemu/README.md

1.8 KiB

Yet another yet another Chip-8 emulator (yayacemu)

Because one just wasn't enough.

A Chip-8 emulator (interpreter) written in SystemVerilog with I/O simulated with C++ also depends on SDL2.

Note: Code quality is bad at the moment because I just wanted to get graphics working and didn't pay much attention to it. I will fix tomorrow.

Building & Testing

In order to run yayacemu, you must have sdl2, verilator, and make installed.

Once you have the dependencies installed, you can build the emulator with:

make build

You can build start the emulator with:

make run ROM_FILE=[PATH_TO_YOUR_ROM]

Running

If you have a binary, you can run it with the following:

yayacemu [PATH_TO_YOUR_ROM]

Todo

  • Graphics
  • Corax+ Required Instructions
  • Proper Flag Handling
  • Working Input
  • More Instructions
  • Tetris Working Running
  • Pass Quirks Test
  • Add beeper (instead of sound, screen becomes red)
  • Add all Instructions
  • Implement a real (synthesizeable, pseudorandom) random module
  • Code cleanup

Screenshots

Chip 8 Logo Demo IBM Logo Demo CORAX+ Test Demo Flag Test Demo Quirk Test Demo Tetris Demo Beeper Demo