6502
/
ksim65
mirror of https://github.com/irmen/ksim65.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity
Kotlin 6502/65C02 microprocessor simulator
51 Commits 1 Branch 8 Tags 2.2 MiB
Assembly 76.2%
Kotlin 20%
xBase 3.4%
C 0.4%
Go to file
Irmen de Jong 4601839d26 better breakpoints 2019-09-29 12:40:13 +02:00
.idea Custom c64 key mapping to make typing on a modern keyboard tolerable. Connected Restore key (backslash) to NMI. 2019-09-25 23:23:07 +02:00
gradle/wrapper initial 2019-09-11 02:17:59 +02:00
src better breakpoints 2019-09-29 12:40:13 +02:00
.gitignore virtual machine 2019-09-16 01:17:54 +02:00
.travis.yml trigger 2019-09-13 01:43:58 +02:00
LICENSE fix disassembler address display 2019-09-14 17:25:41 +02:00
README.md added Commodore-64 emulator 2019-09-19 21:29:33 +02:00
build.gradle.kts gradle maven library artifact publishing 2019-09-27 23:27:09 +02:00
c64.png added Commodore-64 emulator 2019-09-19 21:29:33 +02:00
ehbasic.png added Commodore-64 emulator 2019-09-19 21:29:33 +02:00
gradle.properties tweak 2019-09-13 01:20:57 +02:00
gradlew initial 2019-09-11 02:17:59 +02:00
gradlew.bat initial 2019-09-11 02:17:59 +02:00
settings.gradle.kts initial 2019-09-11 02:17:59 +02:00

README.md

saythanks Build Status

KSim65 - Kotlin/JVM 6502/65C02 microprocessor simulator

Written by Irmen de Jong (irmen@razorvine.net)

Software license: MIT, see file LICENSE

6502

This is a Kotlin/JVM library that simulates the 8-bit 6502 and 65C02 microprocessors, which became very popular in the the early 1980's.

Properties of this simulator:

  • Written in Kotlin. It is low-level code, but hopefully still readable :-)
  • Designed to simulate hardware components (bus, cpu, memory, i/o controllers)
  • IRQ and NMI simulation
  • Aims to be clock cycle-precise (not yet 100% correct right now)
  • Aims to implements all 6502 and 65c02 instructions, including the 'illegal' 6502 instructions (not yet done)
  • correct BCD mode for adc/sbc instructions on both cpu types
  • passes several extensive unit test suites that verify instruction and cpu flags behavior
  • maximum simulated performance is a 6502 running at ~100 Mhz (on my machine)

Documentation

Still to be written. For now, use the source ;-)

Virtual machine examples

Three virtual example machines are included. The default one starts with gradle run or run the ksim64vm command. There's another one ehBasicMain that is configured to run the "enhanced 6502 basic" ROM:

ehBasic

Finally there is a fairly functional C64 emulator running the actual roms (not included, but can be easily found elsewhere for example with the Vice emulator):

C64 emulation