joey
/
RE6502
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
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.
29 Commits
1 Branch
0 Tags
201 KiB
Rust 94.5%
Assembly 5.1%
Batchfile 0.4%
 
 
 
master
Branches Tags
${ item.name }
Create tag ${ searchTerm }
Create branch ${ searchTerm }
from 'master'
${ noResults }
Go to file
Joey Pollack b5d254f998 Fixed typo 1 year ago
.vscode Refactors InputConsole and OutputConsole into just Console, Adds the assemble.bat script 1 year ago
simple_test_machine Console now truncates input if it's too long (instead of failing to read) 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 Fixed typo 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 at the Simple Test Machine project to see how to use the RE6502 as a component.