Chip8 emulator, assembler, disassembler, with simplistic curses debugging interface.

Chipp8 has been tested with python3.8.

Install the requirements with:

pip install -r requirements.txt

To assemble the simple demo program:

chippy8 asm demo/23.asm demo_23.c8

To run it:

chippy8 emulator demo_23.c8

To run it in debug mode:

chippy emulator -d demo_23.c8

chippy8 asm PROGRAM.asm BINARY

Assembles PROGRAM.asm into the Chip8 binary file BINARY

chippy8 disasm BINARY OUT.asm

Disassembles BINARY, writting the assembly code into OUT.asm

chippy8 emulator BINARY

Execute BINARY using on the chip8 emulator.

Optional flags:

• -d: run in debug mode, displaying current registry values, and program execution flow. SPACE key will stop execution. n key will execute instructions step by step.
• -b: add a breakpoint at the start of the program. Use the n key for step by step execution. Ignored if not in debug mode (-d).
• -f FREQ: specify (approximate) CPU frequency. Defaults to 60Hz