diff --git a/README.md b/README.md index 05db1fc..d46ae2e 100644 --- a/README.md +++ b/README.md @@ -1,2 +1,58 @@ -# TK2000_floppicator +# The FLOPPICATOR +## DISCLAIMER + +Any use of this project is **under your own responsibility**. +By using this project You will agree that I cannot be held responsible if it will destroy any of your devices, damage your computer, burn down your house or whatever. + +## Introduction + + +I recently built myself a Microdigital TK2000 clone [I recently built for myself](https://github.com/hkzlab/TK2000_Build_Notes). +This clone is almost-but-not-really Apple II compatible, and most low level software (like floppy duplicators) fail to work correctly (or at all). + +The only original TK2000 software I have available to handle copying from one floppy to another, is meant for the original TK2000 disk interface, which +supported only a single drive. This poses a problem when I want to copy something from my FloppyEMU to a real floppy. + +I could setup a greaseweazle, but... sometimes I'm lazy. + +So I developed a simple copier that takes all the sector data from the disk in the primary drive and copies it to the secondary. + +Note that this supports DOS 3.3 sector structure only, and **the destination disk must be formatted beforehand**. + +### Support + +If you wish to support me in building new hardware and software for old machines, [throw a few euros in my direction via Ko-Fi](https://ko-fi.com/hkzlab) ☕! + +### Current state + +It works. It will copy the content of a DOS 3.3 based disk from the primary drive to the secondary, 7 tracks at a time, and then verify what was written via CRC8. + +It's a bit slow (takes roughly 6 minutes including data verification), but You're not going to run a disk mastering business with this, right? + +## How to play + +Start with a floppy containing the FLOPPICATOR. Once you get to the initial screen, remove the FLOPPICATOR disk, put in what you want to copy, then insert the destination in the secondary drive. + +Then push a button. + +Then wait. + +Once it finishes, you can repeat the procedure as many times as you want. + +### Floppy version + +Just put your floppy in the first drive and power on the TK2000. It will autoboot. + +## How to build + +You need the following: + +- GNU Make (I used the one provides by [MSYS2](https://www.msys2.org/)) +- [Calypsi 6502 toolchain](https://www.calypsi.cc/) (tested with 5.10) +- [AppleCommander](https://github.com/AppleCommander/AppleCommander), "ac" command line version (tested with 1.9.0) +- [dsk2woz](https://github.com/TomHarte/dsk2woz) + +## The future + +What future?