1 stable release
1.0.0 | Jan 15, 2023 |
---|
#202 in Emulators
12KB
286 lines
chipmunk
A CHIP-8 interpreter written in Rust.
This was a project I built live during many of my programming streams, which you can find here
Demo
Roms
Usage
To model the keyboard of the time, the following keys are mapped like so
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|
+-+-+-+-+ +-+-+-+-+
Run a ROM
chipmunk run roms/pong.rom
Run a ROM in Debug Mode
Roms can be ran in debug mode, where the program will wait for F
(mapped to V
) to be pressed before moving on the next instruction.
chipmunk run --debug roms/pong.rom
Disassemble a rom
chipmunk dis roms/pong.rom
Dependencies
~18MB
~384K SLoC