Skip to content

joamag/chip-ahoyto

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

CHIP-Ahoyto πŸͺ

CHIP-8 emulator written in Rust πŸ¦€.

The goal of this project is purely experimental and a learning tool for rust.

The work of this emulator was inspired/started by jc-chip8.

You can check a working version of the emulator at chip-ahoyto.joao.me

Goals

  • Performance 🏎
  • Separation of concerns πŸ––
  • Simplicity πŸ˜€
  • Compatibility πŸͺ›

Features

  • Drag and drop support for ROMs
  • Pallet switching
  • Visual diagnostics
  • Variable CPU frequency
  • Multiple engine implementations (classic and neo)
  • Full compliant with test CHIP-8 ROMs
  • RAM snapshot saving and loading
  • WebAssembly support 🌐

Deployments

Provider Stable URL
Cloudflare True chip-ahoyto.joao.me
Netlify True chip-ahoyto.netlify.app
Cloudflare True chip-ahoyto.joao.me
Cloudflare True chip-ahoyto.pages.dev
Cloudflare True prod.chip-ahoyto.pages.dev
Cloudflare True stable.chip-ahoyto.pages.dev
Cloudflare False master.chip-ahoyto.pages.dev

Crate Features

Name Description
quirks Allows CHIP-8 quirks runtime evaluation, comes at a performance penalty.

Build

Library

cargo build

WASM for Node.js

cargo install wasm-pack
wasm-pack build --release --target=nodejs -- --features wasm

WASM for Web

cargo install wasm-pack
wasm-pack build --release --target=web --out-dir=frontends/web/lib -- --features wasm
cd frontends/web
npm install && npm run build
cd dist && python3 -m http.server

Reason

And... yes this is the real inspiration behind the emulator's name:

Chips Ahoy

Inspiration

Many articles and websites helped me in this quest to build the emulator these are some of them.

Documentation

Articles

License

CHIP-Ahoyto is currently licensed under the Apache License, Version 2.0.

Build Automation

Build Status crates Status npm Status License