Skip to content
Arduino library for driving the Z80 retro-shield.
C++
Branch: master
Clone or download
Latest commit eced4c8 Aug 8, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
_media Mention installation via the Arduino IDE Aug 3, 2019
examples Updated output-text Aug 8, 2019
src Updated the call-back function setters. Aug 1, 2019
LICENSE.md Added license Aug 2, 2019
README.md
keywords.txt Fixed syntax-highlighting for our library Jul 31, 2019
library.properties v0.1.0 Aug 1, 2019

README.md

Z80RetroShield

The RetroShield is an addon/shield for the Arduino Mega which allows your arduino to drive, control, and interact with a real processor.

This library is designed to work with the Z80-based retroshield, allowing you to experiment and build projects which use a Z80.

Motivation

The retroshield project contains some sample code, however that sample code mixes the actual Z80-usage with some unrelated things, (button-scanning, LCD display, SPI-RAM access etc), which makes it harder to use as a standalone "thing".

This repository aims to make the Z80 retroshield easier to deal with, by abstracting the CPU-driving into a single standalone class, and packaging it as a library for the Arduino IDE. This should allow you to use it in your arduino-sketch along with whatever else you wish to do.

Installation

If you wish to install the library manually you can clone this repository beneath your arduino libraries folder, or download a release there.

The simpler way to install is via the Arduino library manager, enter "z80" into the search box and you'll find the library. Click "install" to install, then restart your IDE and open the examples:

Screenshot

Usage

The examples included within this library should be sufficient to demonstrate how to use the class, but in brief you:

  • Instantiate an instance of the Z80RetroShield object.
  • Configure a small number of callbacks
    • Which are fired to read/write RAM and handle I/O.
  • Call Tick() to allow the Z80 processor to execute.

Examples

You can view the examples by exploring the repository, and the examples should be visible via the Arduino-IDE interface:

  • ram-test.ino
    • Tests a simple program for reading/writing to RAM.
  • hello.ino
    • A simple example which writes a message to the serial-console.
  • speed_test.ino
    • Shows how many ticks/cycles we execute a second.
    • This shows the overhead of using the driver.
  • uc.ino
    • Read from serial-console, and output the input in upper-case.

Links

Now some Z80 links

Steve

You can’t perform that action at this time.