UNIDISK 3.5 Apple II co-processor in Merlin Assembler
Go to file
Riccardo a549adee54
Merge branch 'master' into Actions-test
2020-10-04 15:19:17 +02:00
.github Create Build.yml 2020-10-04 14:53:12 +02:00
AppleII Add compile files 2020-06-03 19:53:16 +02:00
Images Update README.md 2020-06-01 15:24:49 +02:00
src Merge branch 'master' into Actions-test 2020-10-04 15:19:17 +02:00
LICENSE Create LICENSE 2015-02-14 15:34:03 +01:00
README.md Update README.md 2020-06-01 15:24:49 +02:00

README.md

Apple II UniDisk 3.5 drive project

The project is based on the knowing of internal structure of UniDisk 3.5 drive, it uses same HW of Apple II machines. It is a smart device built by controlled drive board powered by

65c02 mp @2.0 Hz with 2KB RAM and 8KB ROM plus 527 byte of I/O peripheral registers, all addressing by memory mapped method.

The UniDisk 3.5 drives can use directly by Apple //c with 3.5 ROM (ROM version 0) or by Apple IIe or an II Plus using special interface controller card aka "LIRON card".

(C) 1985 Apple Computer, Inc.

The firmware was written by Michael Askins.

The Liron design team was:

  • Josef Friedman, manager
  • Cheng Lin, hardware
  • Michael Askins, software
  • Cecilia Arboleya, tech support
  • Cameron Birse, tech support

The Protocol Converter (PC) is a set of assembly-lenguage routines built in 3.5 ROM or in Liron controller used to support smart external I/O devices (aka SmartPort), like UniDisk 3.5.

The Protocol Converter Bus (CBus) consists of hardware and software components that permit and ontrol communications between the Apple II and intelligent I/O devices (s. a. UniDisk 3.5's) connected o its external disk port.

  • The software part of the Protocol Converter Bus includes Protocol Converter and the CBus communication protocol;
  • The hardware component of the CBus is a daisy chain made up of the following:
    • The Apple II disk port
    • One or more Intelligent I/O devices (UniDisk drive)
    • One Disk II (optional). If included, the Disk II must be the terminal member of the daisy chain and remains dormant when a bus resident is addressed.

The target of project allows to use UniDisk 3.5 drive resource to process data in-line or off-line the Apple II like a "co-processor".

The project evolved steps by steps:

  1. Simply command and read information of UniDisk (DIB Device Information Block) using Protocol Converter STATUS Call;

  2. Using Protocol Converter CONTROL Call to simply Eject disk;

  3. Using Protocol Converter CONTROL Call (Set Dowload, Download, Run) to Download and Run a special 65c02 subroutine, and using STATUS Call to read the informations. This complex sistem allow to Dumping all UniDisk memory;

  4. Use the seme mechanism of step (3) to download a simply routine to making integer operation at one or two Byte and read the relative results;

  5. Due to UniDisk, less the I/O Disk routine in its ROM, is a bare metal, i decide to implement the Floating Point routine by using WOZ original routine, but I was need to write the converter program from WOZ routine to Applesoft routine. This allow me to execute FP operations;

  6. Use the UniDisk FP operations to execute Graphics calculations.

This project required a great deal of effort due to use only the real Apple IIc machine to coding in 'Merlin' Assembler and 'Applesoft' Basic and then execute the code, because no Apple II simulator is able to emulate UniDisk 3.5 Drive, at now.

The PC/MAC next to the Apple II machine, connected by serial port, allows you to use different special software to compile, manage disks image and then send to Apple II. A custom all-in-one modern IDE also can be creating to automate all this process.

This project allows this target:

  • Scan, identify, command and dump memory of UniDisk 3.5
  • Allow to use UniDisk 3.5 like an Apple II "co-processor"

UniDisk

More information and demonstration videos on: AppleII personal web page