Skip to content

Disassembles CHIP-8 programs into pseudo-assembly

License

Notifications You must be signed in to change notification settings

ericwoude/CHIP-8-disassembler

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

18 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Main Status Latest Release License

CHIP-8 disassembler

This tool aims to disassemble CHIP-8 programs into pseudo-assembly. It can be useful for debugging when writing a CHIP-8 emulator or for exploring CHIP-8 programs.

Setup

  • To install, simply clone this project and run make. This will output the program called disassembler
  • You can find a list of CHIP-8 programs at Zophar's domain

Usage

You can use this tool using the following command: ./disassembler file, where file is the path to your CHIP-8 program. It might be a good idea to use this program in conjunction with less or grep.

Example

./disassembler programs/HIDDEN
0200 12 1D   JP   21D
0202 48 49   SNE  V8  #49
0204 44 44   SNE  V4  #44
0206 45 4E   SNE  V5  #4E
0208 21 20   CALL 120
020A 31 2E   SE   V1  #2E
020C 30 20   SE   V0  #20
020E 42 79   SNE  V2  #79
0210 20 44   CALL 044
0212 61 76   LD   V1  #76
.
.
.
0550 01 FF   SYS  1FF

Status

The project is finished. I have no further plans to implement instructions for the Super Chip-48.

Inspiration

This tool is highly inspired by the following sources