🕹️ Chip8 Emulator

This is a Chip8 emulator written in Rust, capable of running most Chip8 games.

🚀 Usage

Prerequisites

To run the emulator, ensure you have the following installed on your system:

1. Rust: Follow the installation instructions from the official Rust website.

2. SDL2 Library: . On Ubuntu, you can install it by running:

   sudo apt-get install libsdl2-dev

Running the Emulator

Once the prerequisites are installed, follow these steps:

1. Clone this repository:

   git clone https://github.com/Juannbel/chip8-emulator.git
   cd chip8-emulator

2. Run the emulator with the following command:

   cargo run --release <path_to_rom>

   Replace <path_to_rom> with the path to the Chip8 ROM you want to run. Sample ROMs are available in the roms directory within the project.

Controls

Chip8 Keypad	Emulator keyboard Mapping
1 2 3 C 4 5 6 D 7 8 9 E A 0 B F	1 2 3 4 Q W E R A S D F Z X C V

→. IPF += 1 (instructions per frame) ←. IPF -= 1 ↑. RATE += 1 ↓. RATE -= 1

References

• Cowgod's Chip-8 Technical Reference v1.0: This was the primary resource used to implement the emulator. You can access it here.
• Chip8 Test Suite: Test ROMs used to verify emulator functionality were sourced from the Chip8 Test Suite repository.