Skip to content

nicoan/chip8emu

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

34 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Chip 8 Emulator

Preview

The objective of this project is to get some understanding in how emulators work and use it as an opportunity to learn and play a little with Rust lang.

Build

Dependencies

  • libsdl2-gfx-dev

Building

Debug: cargo build

Release: cargo build --release

Run

cargo run -- [OPTIONS] --game <FILE>

Options

  • -g, --game <FILE>: Path to the game
  • -r, --renderer <terminal | sdl>: Render method to use. Default is SDL.
  • -h, --help: Prints help information
  • -V, --version: Prints version information

NOTE: You need to be root in order to run the terminal front end, root privileges are needed to detect KEY_UP and KEY_DOWN events in a terminal environment

Play

The emulator has the following keymappings

 Chip8 Keypad                PC 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|
   +-+-+-+-+                  +-+-+-+-+

To exit emulator, press 'o' key.

Resources

About

CHIP-8 Emulator written in Rust.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages