https://github.com/willdunklin/questionable-chip-8
My own implementation of CHIP-8 emulator & assembler (originally done in an afternoon)
https://github.com/willdunklin/questionable-chip-8
Last synced: 2 months ago
JSON representation
My own implementation of CHIP-8 emulator & assembler (originally done in an afternoon)
- Host: GitHub
- URL: https://github.com/willdunklin/questionable-chip-8
- Owner: willdunklin
- Created: 2024-02-01T05:48:17.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2024-02-07T06:19:28.000Z (over 2 years ago)
- Last Synced: 2025-03-05T01:45:03.311Z (over 1 year ago)
- Language: C
- Homepage:
- Size: 29.3 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Questionable (C)HIP-8
## Quick Start
```bash
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
```bash
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:
```asm
mov v0 2
jmp0 198
add v0 60
```
See more in [assembly.md](./assembly.md).
## Resources
- [Cowgod's Chip-8 Technical Reference](http://devernay.free.fr/hacks/chip8/C8TECH10.HTM)
- [CHIP-8 Wikipedia](https://en.wikipedia.org/wiki/CHIP-8)
- [Instruction Set Reference](https://johnearnest.github.io/Octo/docs/chip8ref.pdf)
- [CMake Docs](https://cmake.org/cmake/help/latest/index.html)
- [CMake Download](https://cmake.org/download/)