Chit8 is a toy emulator / interpreter for the CHIP8 virtual machine written in
the Rust programming language.
Currently it only sports a very basic disassembler and a semi-complete CPU emulation without display and real keyboard.
This project has served as my introduction to the Rust language and tooling. As such, the code quality may vary.
- Rust Programming Language Nightly version preferred, but any newish should work.
Clone the repository and run cargo build [--release] to retrieve dependencies and build the emulator (optionally in release mode). Run chit8.exe <path-to-rom> to execute the emulator.
Alternatively use cargo run <path-to-rom> to run the emulator.
Use cargo test to run the test suite. Currently only the CPU opcodes are covered by tests.
Use cargo doc to generate documentation.
- sprocketnes by Patrick Walton for inspiration and coding tips
- Cowgod's Chip-8 Technical Reference v1.0
- Mastering CHIP-8 by Matthew Mikolay for more technical reference on implementing the emulator