README.md

Questionable (C)HIP-8

Quick Start

cmake -B ./build -G Ninja  # -G Ninja is optional but recommended
cmake --build ./build && ./build/chip8

# to try assembler run the following binary (after building of course)
./build/chip8asm ./test/foo.asm ./test/bar.bin

Build, Assbemble and Run

clear; cmake --build ./build && ./build/chip8asm test/foo.asm test/bar.bin > /dev/null && ./build/chip8 test/bar.bin

Assembly Info

I've added a simple assembler (but don't try to push it very far). It ignores spaces, blank lines and nothing else. The basic syntax is as follows:

mov  v0 2
jmp0 198
add  v0 60

See more in assembly.md.

Resources

• Cowgod's Chip-8 Technical Reference
• CHIP-8 Wikipedia
• Instruction Set Reference
• CMake Docs
• CMake Download