chip8

README

CHIP8 Emulator

My first attempt at emulation. This Go project aims to emulate a fully working CHIP8 system complete with graphics, a working CPU, memory, sound, and keyboard input.

Everything works as far as I have tested, except for audio.

Usage

Usage: chip8 [--scaling SCALING] [--fps FPS] [--cpuspeed CPUSPEED] ROMPATH

Positional arguments:
  ROMPATH                Path to CHIP8 ROM file.

Options:
  --scaling SCALING, -s SCALING
                         Pixel scaling. Adjusts size of display. [default: 15]
  --fps FPS, -f FPS      FPS to run display at. [default: 60]
  --cpuspeed CPUSPEED, -c CPUSPEED
                         Speed of CPU relative to FPS. [default: 10]
  --help, -h             display this help and exit
  --version              display version and exit

Controls

Keys

---

1	2	3	4
Q	W	E	R
A	S	D	F
Z	X	C	V

map to

1	2	3	C
4	5	6	D
7	8	9	E
A	0	B	F

respectively

---

Screenshots

Brick	Connect 4	Pong

Rock Paper Scissors	Space Invaders	Tetris

TODO (in no particular order):

• Add more invasive features (e.g. Soft reset, Hard reset, memory manipulation, etc.)
• Implement VIP/Super chip8
• Implement audio (needs a better understanding of goroutines and channels)

Credits

• Thanks to CowGod a.k.a. Thomas P. Greene for their extremely helpful chip8 documentation!

  Link to Docs

• Thanks to @Skosulor for their chip8 testing ROM that helped me identify a mistake in the chip8 docs.

  Link to Testing ROM

• Thanks to @corax for their chip8 testing ROM that helped me identify an error in my stack and instruction pointer.

  Link to Testing ROM

• Thanks to @kripod for his collection of chip8 ROMs. Most of the non-testing ROMs are from here.

  Link to Collection