********************************************************************************
         apple <-> pc disk and sequential text file transferring program

                     Clay Chang,Taipei,Taiwan,ROC OCT-1994
********************************************************************************

1.Who will need this?
  Those who want to transfer their apple ][ disks to pc in .dsk format and vice
  versa but don't own a serial card

  Those who want to transfer sequential files between apple ][ and pc but don't
  own a serial card.

2.System Requirement
  apple ][+ 48k (and better apple ][s) with 16 pin game I/O,one disk drive
  apple DOS 3.3 boot disk
    48K DOS! ... don't use 64K dos or ProDos
  PC with parallel port

3.Function Description
  This version of program runs under DOS 3.3,not on ProDos
  it uses pc parallel port #1 (PRN or LPT1),auto seek port address

  1.apple ][ disk -> pc .dsk file
    transfer a standard DOS 3.3 RWTS readable disk (5.25") to pc in .dsk form
    you can use the .dsk file with apl2em  only 35 tracks now
    (almost all unprotected 16-sectors disks,include prodos formatted disk)

  2.pc .dsk file -> apple ][ disk
    transfer .dsk file to a formatted apple ][ 5.25" floopy disk
    all things on the floopy will be destoryed
    thus you can play things on real apple ][

  3.apple ][ sequential text file -> pc sequential text file
    transfer sequential text file to pc
    you can transfer docs,programs...etc(even binsciied files)
    all control chars will be eliminated
    CR -> CR-LF

  4.pc sequential text file -> apple ][ sequential text file
    transfer sequential text file to apple
    you can transfer .bsc .exe and .bas to your apple
    may need transfer to ProDos disk by your own if you want to sciibin and
      unshrink it (and EXEC)
    all control chars will be eliminated
    CR-LF -> CR

4.Limitation
  1.must boot with DOS 3.3 on apple side (say, not for ProDos)
  2.not very fast speed(?)
  3.35 track disks only now
  4.unprotected standard-RWTS-able-to-handle disks only now

5.Performance
  on my 286-12 ancient machine, it takes 7 minute to transfer a disk
  (it runs apl2em much slower than real apple ][)
  it WILL run much faster on a better pc,trust me!

6.Operating method
  prevent damaging important data,please use backup disks to work!
  apple side:
    transfer ap2222pc.dsk to an apple ][ disk according to file quickin.doc
    after boot with DOS 3.3, insert ap2222pc.dsk disk and "RUN WORK"
    every once you re-run the program,you must insert the disk contain the files
    (it will BLOAD subroutines each RUN)
  pc side:
    "ap2222pc -<option> <filename>" to work
    where <option> is one of following:
      1  apple -> pc disk transfer
      2  pc -> apple disk transfer
      3  apple -> pc text file transfer
      4  pc -> apple text file transfer
    <filename> could contain drive,path and filename itself
    example: "ap2222pc -1 disk6a.dsk"
             "ap2222pc -2 ap2222pc.dsk"
             "ap2222pc -3 c:/docs/apple.txt"
             "ap2222pc -4 c:/docs/apple.txt"
  NOTICE:please following instructions on both screen to press keys to work

7.Technical data (simple)
  apple game i/o port
    3 one digit input (PB0~2)
    1 strobe output
      (could be used with a flip-flop to get constant voltage signal eg.74LS74)
    4 one digit output (AN0~3)
    4 analgue input (GC0~3)

  pc parallel port
    some multi i/o card permit parallel port bidirection data transmission
    if your port address is $378 , then
    $378 is data out port (usually outout only)
       bit  7  6  5  4  3  2  1  0
       pin  9  8  7  6  5  4  3  2
    $379 is status port (input only)
       bit  7  6  5  4  3  2  1  0
       pin  11 10 12 13 15 x  x  x
    you can use MFT to check your parallel port address

  apple printer card (for parallel printers)
    as long as you grounded pin 2 and 20 (busy and GND)
    every key stroke (or STA $C090) will send data to pin 3,5,7,9,11,13,15,17
    and auto send a strobe signal at pin 1
    busy could be as handshake in (really?)
    and strobe could be as handshake out

8.Using the subroutine
  those codes with source is inside ap2222pc.dsk
  atpdsk.asm located $9200, transfer disks from apple to pc
  ptadsk.asm located $9300, transfer disks from pc to apple
  file.asm   located $300, 2 subroutine for using game i/o input & output
             3 bits once if data is 12345678
             then apple out is 123 456 780  order (pc in)
                  apple in  is 012 345 678  order (pc out)
  $9500~$95FF is buffer for one sector i/o
  $07 stores checksum
  $08 stores data read/write

9.Concepts dealed
  general:parallel data transmission,handshakes i/o,text file structure,checksum
  apple side:game i/o,RWTS,assembly,text file r/w,
  pc side:parallel port i/o,block and sequential file,command line tail
          memory allocate,bios data seeking,dos file handler,F-PC & TCOM

10.No responsibility & about copy rights

   The author will not responsible for any damage or any other consequences
     of using this program,don't find me if any disk ruined.

   This program is virus-free at the time author spread out

   You can freely copy and distribute this archive as long as the content
     isn't changed.you can't sell this program or earn money with this program

11.Thanks to
   the creators of apple ][,DOS 3.3 and ProDos
   the creator of F-PC and TCOM
   all of you using this program

12.future plans
   duo to study works,next reversion time will be summer of 1995
   disk <-> .dsk operation under ProDos
     (use MLI call,.dsk file require interleave)
   sequential text file transfer under ProDos
     (use bload & bsave and more assembly)
   modulize,optional use 4 bit (with strobe) or apple printer card
            pc 2-way parallel port
   read/write disk in nibble form,handle protected disks(how?I dunno yet)

13.files contain in the zip archive
   ap2222pc.seq     source code of ap2222pc.com , must compile with newest TCOM
   ap2222pc.com     pc side program
   ap2222pc.dsk     apple side program in disk image form
                    include assembly codes and sources and basic program
   ap2222pc.doc     this doc
   readme.1st       what you should read 1st
   lineconn.doc     line connection doc
   loader.asm       apple side code to load all program (pc .dsk ->apple disk)
   quickin.doc      quick start instructions

14.Feedback to the author
   You don't have to mail $$ to me,but please e-mail me back about the
   bugs,performance and your feeling about this program

   Clay Chang,
   Dept. Mechanical Engineering, National Central Univ. 320 ChungLi,Taiwan,ROC
   u332302@twncu865.ncu.edu.tw   <--- please e-mail to this place! :)
   u339589@sparc20.ncu.edu.tw
   (before Sep-1995)