arduino6502
arduino6502 copied to clipboard
Retrochallenge 2017/04 Arduino 6502 simulator
Arduino6502
This is my Retrochallenge 2017/04 entry, a software only 6502 microprocessor system emulator for Arduino platforms.
Installation
Assuming you have compatible hardware (see below). Installation and setup instructions are
- Check out this repository and open
arduino6502.ino
in the Arduino IDE. - Upload the sketch to your Arduino.
That's it. Read on for usage instructions.
Usage
This simulator runs over the Arduino serial port at 9600 baud. You will need to use a terminal emulator to access the simulator. Once you've made a serial connection the simulator will restart and issue the prompt
\
Which is the sign that you are in the Woz monitor.
The sketch includes ROM images for AppleSoft Lite and Krusader symbolic assembler.
To run AppleSoft BASIC, enter
E000R
And you will be dropped into the BASIC prompt
>
Remember that the Apple 1 was an upper case only machine, so you should enter all letters in upper case.
Krusader is available at, $F000
.
F000R
Linux instructions
I recommend screen(1)
as the terminal emulator, sample usage:
screen /dev/tty.ACM0 9600
To exit the screen, press Ctrl-a k
.
OS X instructions
I recommend screen(1)
as the terminal emulator, sample usage:
screen /dev/tty.usbmodem1421 9600
To exit the screen, press Ctrl-a k
.
note: the exact device name may be different on your system.
Windows instructions
TODO: Tera Term or PuTTY I guess. Anyone want to send a PR for Windows users.
Supported hardware
Currently only the Arduino Mega 2560 is supported. Support for Arduino Uno boards is planned,
Speed
On 8 bit Atmel platforms the performance is roughly 1/4 of the speed of a real 1Mhz 6502 system.
License
This project is licensed under a BSD "simplified" 2 clause licence.
Portions of this project (common.hpp
, cpu.hpp
, cpu.cpp
) are copywrite Andrea Orru, see LICENSE.LaiNES.
This project contains ROM images from Vince Briel's Replica 1 project, including Applesoft lite BASIC and the original Woz monitor.