README.md

CHIP-8 Emulator

A simple emulator for the Chip-8 interpreter written from scratch in C. This project is for educational purpose as a learning opportunity for me to get into emulator development.

👾🕹️👾

CHIP-8 Specifications

• 4 KiB memory
• 16 8-bit registers (V registers)
• 16 16-bit stack
• 1 16-bit index register
• 64x32 pixels graphics
• 16-key input keypad
• Delay timer
• Sound timer

Dependencies

• Simple DirectMedia Layer (SDL) 2.0: Graphics and keyboard input
• Ceedling + gcovr: Unit testing

Building + Running

make
./bin/chip8_emu.out <path_to_rom.ch8>

Testing

./run_test.sh

Should run all of the commands needed to run unit tests and generate coverage report.

Additional Resources

• Tobias V. Langhoff's CHIP-8 Emulator Guide
• Austin Morlan's CHIP-8 Emulator Guide (C++)
• Timendus's CHIP-8 Test Suite
• Repository of CHIP-8 ROMs by dmatlack
• CHIP-8 Archive by johnearnest