Announcing ADT 1.10... a fast, easy way to convert Apple II disks to apl2em images, and back. [From the README file] Apple Disk Transfer 1.10 by Paul Guertin guertinp@iro.umontreal.ca May 13, 1994 Apple II <==> MS-DOS Apple Disk Transfer (ADT for short) is a set of two programs to transfer a standard 16-sector Apple II disk to a 140k file on an MS-DOS computer, and back. ADT is freeware. What's new in version 1.10: 1. ADT now uses a simple compression scheme (differential run length encoding) that will speed up the transfer of many disks. 2. 16-bit CRC error detection for each sector. 3. ADT now tries 5 times to get a good read instead of giving up at the first error. This may help transferring old, flaky disks. 4. The transfer speed is now always 19200 bps. --------------------------------------------------------------------------- Apple Disk Transfer 1.00 by Paul Guertin guertinp@iro.umontreal.ca September 26, 1993 Apple II <==> MS-DOS Apple Disk Transfer (ADT for short) is a set of two programs to transfer a standard 16-sector Apple II disk to a 140k file on an IBM compatible, and back. ADT is freeware. * * * Contents of ADT100.ZIP archive: readme.txt -- This file. APPLE II FILES: adt.asm -- Source code for adt (Merlin assembler). adt.dmp -- Object code for adt (Monitor dump format). MS-DOS FILES: adt.exe -- MS-DOS executable. adt.c -- Source code for adt.exe (Turbo C 2.0). comm.c -- Freeware serial port routines for Turbo C. comm.h -- Header file for above. * * * Recompilation / reassembly: On the PC: to compile ADT with Turbo C, use: "TCC ADT.C COMM.C". Recompilation is required only if you modify the program. On the Apple II: adt.asm doesn't use any esoteric pseudo-opcodes and should be easy to port to other assemblers. * * * Installing: First, connect the PC and the Apple II with a null-modem cable. Then set the DIP switches on the Super Serial Card for the baud rate you want (19200 unless your PC is so slow it can't cope with it -- I have a 25 MHz 386 and it works fine at 19200). See the end of this file for null-modem and DIP switch tables. To install ADT on the PC: there's nothing special to do, since you've already unzipped ADT100.ZIP. The executable file is ADT.EXE. To install ADT on the Apple II: Boot a DOS 3.3 with some free space, and from BASIC type IN#x, where x is the slot your serial card is in. Then, on the PC, start a comm program and ASCII-upload (not Xmodem or any other protocol but a straight text upload) the file "adt.dmp" to the Apple. The program will enter itself in the Monitor and save itself to disk under the name "ADT". Here are some tips to get this to work: 1. Use a slow transfer speed, like 300 baud. 2. If you get a beep at every line, your comm program is probably sending CRLFs to your Apple, which only likes CRs. Turn the "Strip linefeeds on output" option off on your comm. program. 3. If you see total garbage on the Apple II screen, first be sure that the SSC and the comm program agree on the transfer speed. If they do, your comm program is probably doing something funny with the high bit (aka bit 7) of each character. Turn off the "Strip high bit on output" option. If nothing seems to work, you can always type in the hex dump by hand. * * * How to use ADT: Start ADT.EXE on the PC and ADT on the Apple II, and answer the setup questions. ADT operation is entirely controlled from the Apple keyboard, so you can transfer many disks without having to go back and forth between the two computers. NOTE: even though ADT runs under DOS 3.3, it will also transfer ProDOS disks as well as Pascal disks, because they are all in 16-sector format. It will not transfer DOS 3.2 disks or protected disks. ADT is simple and (IMHO) user-friendly. The following explanations should be enough to use it correctly. Send: ADT will ask for an MS-DOS filename and then start reading the disk in slot 6 drive 1 and transmit it to the PC, which will store it in that file. ADT will not overwrite an existing file. All files are stored in the current directory and are 140k in length. The MS-DOS file format is: T0S0B0 T0S0B1 ... T0S0BFF T0S1B0 ... ... T22SFBFF which is the format used by the apl2em emulator by Randy Spurlock. Receive: ADT will ask for a filename. It will then receive that file from the PC and write it to the disk in slot 6 drive 1. THE DISK IN SLOT 6 DRIVE 1 MUST BE FORMATTED WITH DOS 3.3 beforehand. Before transmitting, ADT ensures that the file exists and is 140k in length. (I didn't add signature bytes because I wanted to stay compatible with the apl2em format.) Quit: This quits ADT, returning to DOS 3.3. To quit the program on the PC, press the Escape key on the PC's keyboard. Notes: -- In the track/sector map on the Apple II, "." means the sector was read or written correctly, and "*" indicates an error. ADT does not stop on errors, making it possible to transfer damaged disks. -- When the Apple II says "MS-DOS ERROR", the PC will tell you a little more about the error: disk full, no such file, etc. * * * ADT is based on the program SENDDISK by Rich Williamson (glitch@eskimo.com). In fact, version 0.01 of ADT was a patch to SENDDISK to make it transfer files from the PC to the Apple. I wish to acknowledge Mr. Williamson's contribution to ADT. * * * The following is taken from the SENDDISK readme file, and may help you configure your hardware. > Super Serial card DIP settings: (19200 baud) > SW1-1 off SW2-1 on > 1-2 off 2-2 on > 1-3 off 2-3 off > 1-4 off 2-4 on > 1-5 on 2-5 off > 1-6 on 2-6 off > 1-7 on 2-7 off > > Put the TERMINAL/MODEM jumper pointing up at 'MODEM' > > Serial cable wiring > PC (DB-9) Apple (DB-25) > > 2 - 2 > 3 - 3 > 4 - 8 > 5 - 7 * * * I welcome comments, bug reports, suggestions for future versions, etc. Send fan mail to guertinp@iro.umontreal.ca.