3 unstable releases

new 0.2.2 May 25, 2024
0.2.0 May 13, 2024
0.1.2 May 13, 2024
0.1.1 May 13, 2024

#214 in Embedded development

Download history 399/week @ 2024-05-13 203/week @ 2024-05-20

602 downloads per month

MIT license

81KB
3K SLoC

lib6502 CPU emulation library

What is this?

It's an experimental 6502 emulation library written in Rust.

Why is this?

Because I thought it would be fun, I was also inspired by Ben Eater's excellent 6502 video series. Originally I had wanted to create a breadboard computer, but realized that I didn't have the extra cash for things like logic analyzers or oscilloscopes. Besides, emulating in software gives me flexibility to create whatever hardware I want!

Project Status

  • 100% legal opcode implementation
  • Illegal opcode support
  • 100% test coverage
  • Example implementation
  • Cycle-accurate instructions
    • Instruction-level accuracy
    • Cycle-level accuracy

Building

I don't know why you would want to build just this, but:

cargo build

Testing

cargo test

Running

Coming soon.

NesDev CPU wiki - Fantastic resource for 6502 information, specifically the NES version of the 6502.

mass:werk 6502 tools - A fully functional 6502 CPU emulator, assembler, and disassembler, as well as a great resource for 6502 instruction set internals

Dependencies

~110KB