#chip8 #sdl2 #emulator #chipmunk

app chipmunk-sdl2

CHIP8 Emulator built in Rust

1 stable release

1.0.0 Jan 15, 2023

#202 in Emulators

MIT license

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

kripod/chip8-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