Skip to content

Latest commit

 

History

History
74 lines (64 loc) · 1.61 KB

README.md

File metadata and controls

74 lines (64 loc) · 1.61 KB

rustchip

A CHIP-8 Emulator written in Rust. Based on the tutorial at http://www.multigesture.net/articles/how-to-write-an-emulator-chip-8-interpreter/

Building

First, you'll need to install the SFML and CSFML libraries. If you're using a GNU/Linux distribution that supports PPAs, you can run the following:

apt-add-repository ppa:sonkun/sfml-development
apt-get install libsfml-dev libcsfml-dev

Once you've done that, just run cargo build.

Testing

Tests are found in src/cpu.rs. They can be executed by running cargo test.

Running

Run cargo run <rompath> to start the emulator. The CHIP-8 system uses a hex keypad, with keymappings listed below. You can reset the emulator by pressing ALT+R.

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