chip-8

A simple Rust implementation of a Chip-8 emulator.

It uses EasyCurses, which is built on pancurses, for display, keyboard input, and sound, so any platform that EasyCurses/pancurses run on, this should as well.

Building

cargo build

Running

Usage: chip-8 [options] ROM

Options:
    -d, --debug         display debug info
    -h, --help          display this help message

ROMs

Searching for "chip-8 roms" yields many links to various ROMs that should run on this emulator. I used this test ROM, which exercises the various features of the Chip-8. I also tested with PONG, PONG2, and INVADERS.

Here are two sites with public domain ROMs:

• Zophar's Domain
• dmatlack/chip8

Reference Documents

• Wikipedia: Chip-8
• Cowgod's Chip-8 Technical Reference
• An Easy Programming System, Byte Magazine, December, 1978
• Mastering Chip-8
• How to write a Chip-8 Interpreter
• Writing a CHIP-8 emulator with Rust and WebAssembly
• Introduction to Chip-8

Inspirational Projects

• danirod/chip8
• eejdoowad/Chip8
• JamesGriffin/CHIP-8-Emulator