README.md

chip8-emulator

An implementation of the CHIP-8 interpreter

Usage

cargo run --release <path/to/rom>

I've added somes games in the roms folder to try out. For example, to play the classic game Breakout:

cargo run --release roms/breakout.ch8

Keyboard Input

CHIP-8 has a 16-key keypad, denoted in hex (0-F). The keypad is mapped to the keyboard as follows:

Chip-8 Keypad	Keyboard Mappings
1 2 3 C 4 5 6 D 5 6 7 E A 0 B F	1 2 3 4 Q W E R A S D F Z X C V

For example, to play breakout.ch8, the controls are 4 and 6 to move the paddle left and right (Q and E respectively on the keyboard).

References

• Cowgod's Chip-8 reference
• How to write an emulator