chip8

Yet another Rust/WASM Chip8. Targets SDL2 and/or an HTML5 canvas via WebAssembly.

Usage

To run the native renderer, use make or make native. By default it will run corax89/chip8-test-rom. Use --rom/-r directly with cargo to pass a game name: cargo run --features="sdl" -- -r brix. Game ROMs are compiled in to the library.

To build the WebAssembly frontend, first run make deps. Use make dev and point your browser to localhost:8080 to use the local development build. For sorta-kinda "hot reloading", keep that terminal open, and use make wasm in another terminal to rebuild the Wasm module on change, the dev server will pick it up. To deploy the compiled site to docs/, run make deploy.

The source includes the Chip8 Games Pack as well as the above tester.

Acknowledgements

• This awesome blog post by Laurence Muller.
• The Chip8 Wikipedia article.
• The Binary-coded decimal Wikipedia article.