README.md

CHEAP-8

Simple CHIP-8 emulator, assembler and disassembler written in Java.

Building

In order to build project make sure you have installed:

• JAVA JDK
• ANT

Simply run ant while in project directory

Emulator

Running

The compiled file is in binary directory, so simply run java -jar binary/CHEAP-8.jar [-h] [display help] [-s] [scale factor]" [-t] [CPU time delay between commands] [-d] [display type] Path_to_rom Arguments in [] brackets are optional

Keyboard

Themes

Currently there are 4 supported themes

Black-white

PowerShell

Radar

Inverted

Assembler

Running

java -jar binary/CHEAP-8.jar --asm [-o output file] Path_to_rom

List of commands

For list of supported commands and help with syntax see CHIP-8 Technical Reference
For comments in assembly files use #

Disassembler

Runing

java -jar binary/CHEAP-8.jar --dasm [-o output file] Path_to_rom

Suggestions

If you want to build your own emulator I suggest you also check out:
CHIP-8 Wikipedia page
CHIP-8 Technical Reference
craigthomas' emulator

License

MIT License © Mario Perić