kpy3 / chip8-emulator

Chip-8 emulator written in Rust

Chip8 Emulator

This is another Chip8 realisation written on Rust for education purposes (in both creating simple virtual machines and rust). It uses pixels for video, which I found ideally suitable for this project.

Build

This project requires stable rust installed, to build use

$ cargo build

Run

To run emulator use

$ cargo run -- <path to ROM file>

Play

Use following control keys for play:

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|
  +-+-+-+-+                +-+-+-+-+

One can download Chip8 ROMs pack here.

Test

This realisation tested against two test ROMs:

1. Chip8 test ROM
2. BC_Test (explanation)

NOTE: There is at last one not documented error code in BC_Test with code E 34, in my case it pointed to wrong implementation of Fx55 and/or Fx65 operation codes.

TODO

• Fix some minor bugs
• Add audio
• Add tests for Chip-8
• Cleanup code

Useful Resources

• Chip 8 Technical Reference
• Building a CHIP-8 emulator [C++]
• Mastering CHIP-8
• Emulation Basics: Write your own Chip 8 Emulator/Interpreter
• Chip8 web site
• David Winter's CHIP-8 emulation page
• EMUBook