This is my attempt to study the Rust programming language and have fun at the same time. The goal is to present in the least obfuscated way how the Commodore 64 works and what's happening behind the scenes once you start a program. Emulation is cycle based and fairly accurate at this point.
The emulator has a built-in visual debugger which lets you view the contents of each memory page in RAM, Color RAM, VIC registers, CIA registers and SID registers. The VIC window is a ICU64-style raster debugger where each pixel represents one VIC cycle and any events occuring at that time.
Requires Rust 1.5.0 or higher to compile and run.
cargo build cargo run --release
You can pass a .prg file as a command line parameter to load it into memory once the emulator boots (just type RUN to start the program):
cargo run --release prgs/colors.prg
To run with double-sized window:
cargo run --release x2 prgs/colors.prg
To run with double-sized window and debug windows enabled:
cargo run --release x2 debugger prgs/colors.prg
ESC - Run/Stop END - Restore TAB - Control LCTRL - C= ` - <- - - + INS - & HOME - CLR/Home BSPACE - INST/DEL [ - @ ] - * DEL - ^ ; - : ' - ; \ - = F11 - start asm output to console (very slow!) F12 - reset C64 RCTRL - joystick fire button NUMLOCK - toggle between joystick ports 1 and 2 (default: port 2) In debugger window: PGUP/PGDWN - flip currently displayed memory page HOME/END - switch currently displayed memory banks between RAM, Color RAM, VIC, CIA and SID
This is an on-off WIP project, so update frequency may vary.
The following documents and websites have been used to create this emulator: