You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
Joey Pollack d27cd2c3e4 Cleans up some files and adds the README files 1 year ago
.vscode Refactors InputConsole and OutputConsole into just Console, Adds the assemble.bat script 1 year ago
simple_test_machine Cleans up some files and adds the README files 1 year ago
src Fix a bug with the branch instructions not being able to move backward (offsets were unsigned) 2 years ago
todo Adds updated license and readme files 1 year ago
.gitignore Preparing to add the InputConsole 1 year ago
Cargo.lock Adds the simple test virtual machine and a few hard-coded test programs 2 years ago
Cargo.toml Adds the simple test virtual machine and a few hard-coded test programs 2 years ago
LICENSE Adds updated license and readme files 1 year ago
README.md Cleans up some files and adds the README files 1 year ago

README.md

RE6502

RE6502 is an emulator for the 6502 cpu written in rust. The project comes with a very basic virtual machine for testing (it just has simple I/O functionality) as well as some test programs (find these in simple_test_machine/programs). The test programs can be built with the win2c64 (or lin2c64, or mac2c64) assembler which can be found here: https://www.aartbik.com/retro.php. Theoretically any 6502 assembler should work but win2c64 is the one I've been using for testing.

Building

The emulator doesn't really do anything on it's own but you can build it with the normal cargo build or cargo run if you run this program it will just do some simple internal tests. There are also unit tests you can run with cargo test. To make better use of the emulator you'll need to use it as a component of a larger emulator/vm. Take a look a the Simple Test Machine project to see how to use the RE6502 as a component.