chip8-interpreter-debugger

Table of contents

• General info
• Notes
• Setup
• Usage
• Technical Reference and Contact

General info

A basic CHIP-8 Interpreter CLI with debugger. Interpreter's gui is powered by ncurses. Developed just for fun.

Notes

Keep in mind:

• Sound not implemented.
• Refreshing rate is not stable.
  

I'll fix these issues soon.

Setup

You'll need "libncurses5" and "CMake" to compile project

libncurses installation

Debian/Ubuntu
$ sudo apt-get install libncurses5-dev libncursesw5-dev

CentOS/RHEL/Scientific Linux 6.x/7.x+ and Fedora Linux 21 or older
$ sudo yum install ncurses-devel

Fedora Linux 22.x+
$ sudo dnf install ncurses-devel

After you clone the project:

$ cd chip8-interpreter-debugger
$ mkdir make
$ cd make
$ cmake ../
$ make

Usage

• As Interpreter:

$ ./chip8-interpreter-debugger <rom_directory>

• As Debugger:

$ ./chip8-interpreter-debugger -s <rom_directory>

• As Disassembler:

$ ./chip8-interpreter-debugger -d <rom_directory>

Keypad:
4567
RTYU
FGHJ
CVBN

• To next step on debugger SPACEBAR
  
• To Terminate CTRL + C

Technical Reference and Contact

Technical reference: Cowgod's Chip-8 Technical Reference
Contact: emre6271@gmail.com