CHIP-8

In my quest to build a GBA emulator in rust, I started with a CHIP-8 interpreter in rust

Running locally

Make sure you have the latest version of rust installed

Mac OS

• Install Homebrew
• Install sdl2 with homebrow: brew install sdl2
• Add this export LIBRARY_PATH="$LIBRARY_PATH:$(brew --prefix)/lib" to your .zshrc file if you use zsh or your .bashrc file if you use bash
• In root directory of this project do cargo run and point it at the chip8 rom file you would like to run. Ex. cargo run /ROM_ADDRESS

Linux

• Install sdl2 with: sudo apt update && sudo apt install -y libsdl2
• Add this export LIBRARY_PATH="$LIBRARY_PATH:$(brew --prefix)/lib" to your .zshrc file if you use zsh or your .bashrc file if you use bash
• In root directory of this project do cargo run and point it at the chip8 rom file you would like to run. Ex. cargo run /ROM_ADDRESS

WASM

• Make sure you have wasm-pack installed. If not use cargo install wasm-pack
• cd into the wasm directory of this project
• Run: wasm-pack build --target web
• Run: mv pkg/wasm_bg.wasm ../web
• Run: mv pkg/wasm.js ../web
• cd to the main project directory and then start a web server of your choice

Sources

• Cowgod's Chip-8 Technical Reference
• CHIP‐8 Technical Reference
• Chip8 Book
• Guide to making a CHIP-8 emulator
• How to write an emulator (CHIP-8 interpreter)