You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Krzysztof Kondrak 3e9d295faf Host images directly on the repository. 1 month ago
images Host images directly on the repository. 1 month ago
prgs renamed tests to prgs 4 years ago
res added draw_multi(); reintroduced font.bmp for later debugging purposes 4 years ago
rom added rom 5 years ago
src Merge branch 'master' into crt 2 years ago
.gitignore Redox support 2 years ago
.travis.yml Added missing deps to travis.yml 3 years ago
Cargo.lock Update Cargo.lock 2 years ago
Cargo.toml Merge branch 'master' into crt 2 years ago
LICENSE Update LICENSE 4 years ago
Makefile removed comment from Makefile 4 years ago
README.md Host images directly on the repository. 1 month ago
appveyor.yml [CI] fixing appveyor 4 years ago

README.md

Build Status Build status

Rust64 - a C64 emulator written in Rust

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.

Major dependencies

Requires Rust 1.5.0 or higher to compile and run.

Youtube demo #1:

Screenshot

Youtube demo #2:

Screenshot

Screenshot:

Screenshot

Build instructions

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

C64 and special key mappings

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

TODO

  • serial bus/disk drives (d64, t64, tap)
  • implement remaining undocumented ops
  • switch from SDL2 to cpal for audio once it supports OSX
  • improve SID emulation

Known Issues

  • missing serial bus may cause some very specific programs to perform incorrectly or get stuck in infinite loops
  • elaborate programs that require very precise timing are not running correctly yet

This is an on-off WIP project, so update frequency may vary.

Resources

The following documents and websites have been used to create this emulator:

Special thanks