CHIP8 Emulator

A CHIP8 emulator written in rust.

Building

cargo build

If you're running linux, you may need to install libwayland-dev

This emulator reads binary files written with chip8 operations. A program might look something like this:

hexdump testbin/xy_neq_neq.chip8
0000000 0560 0661 1090 0170
0000008

The testbin folder has several examples of chip8 programs for each instruction.

To run a program, use the load operation followed by the file you wish to load:

chip_8_emulator load myChip8Prog.chip8

An optional arg can be used to set the color for the pixels, purple, green, blue, or red, the default is purple.

chip_8_emulator load myChip8Prog.chip8 blue

The CHIP8 keyboard:

Is mapped to:

cargo test

row	op	op	Description
0x200	A2	06	Set our address register to begin reading at location 206
0x202	D0	05	Draw at (0,0), 5 bytes starting from the location in memory specified by the address register
0x204	00	00	Halt
0x206	FF	C3	The bytes that will be drawn
0x208	FF	C3
0x210	00

Note that programs loaded into memory begin at location 0x200, this is the default in some CHIP8 machines, though not all of them

each pixel cooresponds to a set bit

// ******** 0xFF 0b1111_1111
// **    ** 0xC3 0b1100_0011
// ******** 0xFF 0b1111_1111
// **    ** 0xC3 0b1100_0011
// **    ** 0xC3 0b1100_0011

cargo build
./target/debug/chip_8_emulator load examples/draw_a.chip8

Debugging allows you to wait for enter, esc, or delete to be pressed before the next operation is executed.

cargo build
./target/debug/chip_8_emulator debug examples/a_plus_a.chip8