How emh-spec/chip-8 works
This is a no_std CHIP-8 emulator library. A host calls run with a mutable emulator and platform implementation; the loop polls keys, advances CPU instructions and timers, updates sound and display, and paces frames until the emulated program quits. The core owns opcode execution and emulated state, using the display renderer and RNG internally. The excerpts show this main workflow, but the README is empty and no additional product capabilities are documented.
Main entry points: lib.rs Frame loop · core.rs Opcode engine · platform.rs Platform API · display.rs Display renderer
Components 8
Emulation runtime
- Frame loop
src/lib.rs
Virtual machine
- CHIP-8 core
src/chip8/core.rs - Opcode engine
src/chip8/core.rs - Display renderer
src/chip8/display.rs - Xorshift RNG
src/chip8/xorshift32.rs
Host interface
- Platform API
src/chip8/platform.rs - Key events
src/chip8/platform.rs
Other components
- Host application
Connections 9
- Host application → Frame loop: calls
src/lib.rs - Frame loop → Platform API: uses
src/lib.rs - Frame loop → Key events: polls
src/lib.rs - Frame loop → CHIP-8 core: ticks
src/lib.rs - Frame loop → CHIP-8 core: reads state
src/lib.rs - CHIP-8 core → Opcode engine: executes
src/chip8/core.rs - Opcode engine → Display renderer: draws sprites
src/chip8/core.rs - Opcode engine → Xorshift RNG: generates values
src/chip8/core.rs - Frame loop → Platform API: draws and beeps
src/lib.rs