perfect6502, a MOS 6502 CPU emulator that performs a simulation of the original NMOS 6502 netlist
Go to file
Michael Steil 268d16647c fixed measure.c to work with new API 2020-06-13 19:18:57 +02:00
apple1basic cleanup: moved cbmbasic and apple1basic demos into subdirectories 2020-06-04 19:32:59 +02:00
cbmbasic cleanup: moved cbmbasic and apple1basic demos into subdirectories 2020-06-04 19:32:59 +02:00
.gitignore added object files to .gitignore 2014-11-28 07:56:51 +01:00
LICENSE Create LICENSE 2020-06-04 19:47:38 +02:00
Makefile fixed measure.c to work with new API 2020-06-13 19:18:57 +02:00
Makefile.apple1basic cleanup: moved cbmbasic and apple1basic demos into subdirectories 2020-06-04 19:32:59 +02:00
Makefile.measure fixed measure.c to work with new API 2020-06-13 19:18:57 +02:00
README.md cleanup: moved cbmbasic and apple1basic demos into subdirectories 2020-06-04 19:32:59 +02:00
compare.c cleanup 2010-10-05 16:18:28 +00:00
measure.c fixed measure.c to work with new API 2020-06-13 19:18:57 +02:00
netlist_6502.h moved nodes names into netlist_6502.h 2014-12-01 16:42:48 +01:00
netlist_sim.c cleanup: moved cbmbasic and apple1basic demos into subdirectories 2020-06-04 19:32:59 +02:00
netlist_sim.h Add destroyChip. 2019-09-08 15:06:26 +02:00
perfect6502.c fixed measure.c to work with new API 2020-06-13 19:18:57 +02:00
perfect6502.h Add destroyChip. 2019-09-08 15:06:26 +02:00
types.h split code into generic netlist simulation and 6502-specific code 2014-12-01 13:53:46 +01:00

README.md

perfect6502

perfect6502 is a MOS 6502 CPU emulator that performs a simulation of the original NMOS 6502 netlist that was extracted by the visual6502.org project.

Consequently, perfect6502 is

  • perfect: It is not a reimplementation of the 6502, but a simulation of the original transistors. Its complete behavior, its internal state and its outputs are half-cycle exact.
  • slow: Even though perfect6502 is highly optimized C code, achieves only 1/30 of the speed of a 1 MHz 6502 on a high-end CPU of 2020.

perfect6502 is useful for

  • understanding and reverse engineering the 6502
  • debugging 6502 emulators by running them side by side with perfect6502

Usage

As a demonstration and as a performance/regression test, perfect6502 is hooked up to Commodore BASIC (cbmbasic).

You can compile the project with

$ make

and run it with

$ cbmbasic/cbmbasic

You should get the following output:

	**** COMMODORE 64 BASIC V2 ****

 64K RAM SYSTEM  38911 BASIC BYTES FREE

READY.

Benchmarking

You can use the UNIX time tool to measure the performance of the emulator. Run time cbmbasic/cbmbasic and press Ctrl+C once it has reached READY. the "user" time is the effective time that was required to reach character input. On a 1 MHz 6502, this takes 0.05 sec.

Credits

perfect6502 is is written by Michael Steil and derived from the JavaScript visual6502 implementation by Greg James, Brian Silverman and Barry Silverman.

Contributing

Further performance optimizations are gladly accepted.