home *** CD-ROM | disk | FTP | other *** search
/ Amiga ISO Collection / AmigaUtilCD1.iso / Emulatoren / pdata352.lha / PData / PData.DOC < prev   
Encoding:
Text File  |  1995-02-04  |  10.2 KB  |  226 lines
  1. PDATA DOCUMENTATION
  2. ~~~~~~~~~~~~~~~~~~~
  3.  
  4.    Release version : 3.52 final
  5.    Date            : Saturday, 3rd February 1995
  6.  
  7.    Copyright © 1993-1995 Deadbeat/The Sharks
  8.                (C64 coding, optimized cable schematics, documentation)
  9.  
  10.    Copyright © 1993 Hude
  11.                (Amiga coding)
  12.  
  13.    Please notice that the Amiga executable file is now called "XData"!
  14.    (It's 100% compatible with PData; read FUTURE for more information)
  15.  
  16. 1. OVERVIEW
  17.  
  18.    PData is an utility for transfering both binary and text files between
  19.    the C64/C128 and Amiga. It's about 25 times faster than a null modem
  20.    cable and it even leaves your Amiga's serial port free for other
  21.    applications (The maximum BPS rate in a _standard_ C64 is around 2.4K).
  22.  
  23. 2. DISTRIBUTION AND DISCLAIMER
  24.  
  25.    PData may be freely distributed as long as all files are included
  26.    intact and as long as no more than a nominal fee is charged to cover
  27.    time and copying costs. PData may NOT be used for commercial purposes
  28.    without a written permission from the author(s). The author(s) can't be
  29.    held liable for any damage directly or indirectly caused by the use or
  30.    misuse of this manual and/or the program it describes. PData is provided
  31.    "as-is" and it is a subject to change without notice.
  32.  
  33.    Internet users will most likely find the latest version of PData from
  34.    nic.funet.fi. You could also try to /MSG DEMOBOT for some HELP on IRC.
  35.    Those unprivileged ones (Persons without 'net access) should call any
  36.    of THE SHARKS' boards, and they'll get the latest version.
  37.  
  38.    If you like this program, feel free to send me (Deadbeat) a postcard.
  39.    On the other hand, you could always drop me with some e-mail...
  40.  
  41. 3. REQUIREMENTS
  42.  
  43.    The C64 end of PData will work in every C64/C128. The Amiga end of PData
  44.    will - hopefully - work in every model, but Kickstart v37.175 (v2.04) or
  45.    above is required to utilize all features. A special cable between the
  46.    C64 and Amiga is required. The following things are needed for the cable:
  47.  
  48.         - One card edge connector (C64 user port)
  49.         - One male D-25 connector (Amiga parallel port)
  50.         - Suitable length of flat cable (Width 12 or more)
  51.  
  52.    Additionally, you'll need the following files for your Amiga...
  53.  
  54.         - Devs/Parallel.device
  55.         - L/Port-handler
  56.         - Libs/Asl.library
  57.         - Libs/Locale.library
  58.  
  59. 4. PDATA CABLE SCHEMATICS
  60.  
  61.    C64 user port              Amiga parallel port
  62.  
  63.    Pin      Description       Description      Pin
  64.  
  65.    B        FLAG*             STROBE           1
  66.    C        PB0               DATA 0           2
  67.    D        PB1               DATA 1           3
  68.    E        PB2               DATA 2           4
  69.    F        PB3               DATA 3           5
  70.    H        PB4               DATA 4           6
  71.    J        PB5               DATA 5           7
  72.    K        PB6               DATA 6           8
  73.    L        PB7               DATA 7           9
  74.    8        PC*               ACK*             10
  75.    M        PA2               BUSY             11
  76.    N        GND               GND              17
  77.  
  78. 5. USING PDATA C64
  79.  
  80.    Using PData C64 is fairly easy. You'll first be prompted for your work
  81.    drive. Any device between 8 and 11 will do. Then you can select whether
  82.    to handle your files as binary or text. If you select binary, the files
  83.    will be transfered without any alterations. Selecting text mode will
  84.    cause everything to be translated from PETSCII to ASCII and vice versa.
  85.    The next step is to decide whether to send or receive files. At this
  86.    point, you can press "," to access a SEQ file handler, using which you
  87.    can print out or view sequential files. Assuming that you didn't enter
  88.    the SEQ file handler, you now can press F1 to toggle between normal/zip
  89.    mode. If zip mode is on, PData will add those 1! 2! 3! and 4! prefixes
  90.    in front of each zip disk-packed file automatically and you only need
  91.    to worry about fourteen last characters. If you start receiving a file
  92.    in single mode, you'll be prompted whether to process files as PRG or
  93.    SEQ. If a file exists, you'll be given a chance to regret. You can use
  94.    "$" (CR = $ as Default) to see directory, "@" for DOS commands and "?"
  95.    to see number of free blocks available on disk. Pressing "=" at all
  96.    times (Except in multi-file transfer menu) will take you one step
  97.    "backwards" in the menus. In zip mode, you can individually decide
  98.    which of the files should be overwritten. Pressing F3 will take you
  99.    to multi-file transfer menu. In multi-file transfer menu, press F1 for
  100.    sending files, F3 for receiving files, F5 for directory and F7 for main
  101.    menu. After pressing F1, you can use Y/N to select files. Pressing CR
  102.    (Return) will quit or start transfer, depending if you've got any files
  103.    selected. After pressing F3, you can enter target filenames. Leave one
  104.    blank line and hit CR to start transfer. Multi-file transfer can handle
  105.    255 files both directions. It handles only binary PRG files and never
  106.    overwrites it's target files. At ALL times, pressing restore will clear
  107.    the channel, initialize vectors and restart program. If you're in doubt
  108.    of something, just try it. There's no way the program could crash.
  109.  
  110. 6. USING XDATA AMIGA
  111.  
  112.    xdata (s/r/?) (path/filename)
  113.    (s = send / r = receive / ? = help)
  114.    Example : xdata r dh1:dl/c64_rules.txt
  115.  
  116.    Pressing CTRL+C will - hopefully - abort transfer. Use it in combination
  117.    with RESTORE in the C64 end to gain maximum effect. If you have a
  118.    multifacecard (MFC) in your Amiga, remember you must use the XData.CFG
  119.    in S: directory to re-route PAR: into PIT:. Edit the file so that it
  120.    reads PIT:<CR>. If you're not a hard drive user, I suggest you redirect
  121.    the files into RAM: when receiving something from the C64, if you don't
  122.    have lots of spare time to waste (See missing features).
  123.  
  124. 7. MISCELLANEOUS
  125.  
  126.    Configuring your regular directory tool for PData makes your life much
  127.    easier. Once you've made the first transfer after turning both of your
  128.    computers on, you can ignore the C64's on-screen prompts about setting
  129.    the other end to send/receive mode. This is because once the Amiga's
  130.    port-handler has been "activated", PData can't "lose" anything. When
  131.    transfering PData mainfile (PDATA.C64) to the C64, you MUST use the
  132.    filename "PDATA 3.5-SHARKS". To transfer the file, try a null modem
  133.    cable. Schematics are supplied below. You'll need a RS-232 adapter for
  134.    the C64 and a suitable terminal program for both ends. If, however, you
  135.    should experience problems in doing so, e-mail the official PData
  136.    helpline at this address: kemu@zombie.oulu.fi and beg for help! :)
  137.    (Mysdee/Canus*Patrol just volunteered to help all the people in need!)
  138.  
  139. 8. NULL MODEM CABLE SCHEMATICS
  140.  
  141.    Pin     Description       Description       Pin
  142.  
  143.    2       TXD               RXD               3
  144.    3       RXD               TXD               2
  145.    4       RTS               DCD               8
  146.    6       DSR               DTR               20
  147.    7       GND               GND               7
  148.    8       DCD               RTS               4
  149.    20      DTR               DSR               6
  150.  
  151. 9. BUGS AND MISSING FEATURES
  152.  
  153.    C64 end:   - None known, although there has been some reports about
  154.                 problems with multi-file transfers.
  155.  
  156.    Amiga end: - Sometimes refuses to work if a filename ends with "+".
  157.               - Refuses to work if a filename contains any spaces.
  158.               - Receive buffer missing.
  159.                 ...
  160.  
  161.    PData doesn't send a header containing a filename. This is NOT a bug.
  162.    By the way, did you know that PData can be used to transfer data between
  163.    two C64's or two Amiga's with minor cable modifications? Hardware wizards
  164.    may figure this one out on their own, full cable schematics will be
  165.    released later on for the public.
  166.  
  167. 10. FUTURE
  168.  
  169.    This version of PData is the very final ever. I've finally decided to
  170.    share my views about the future with the public. PDATA IS DEAD. LONG LIVE
  171.    XDATA. After careful consideration and lots of time, I've finally decided
  172.    to make some major changes. The changes are so radical, that I've decided
  173.    to change the name as well. Expect the initial release of XData soon...
  174.    In fact, I've had the C64 end finished for months now, but finding a
  175.    qualified Amiga coder has been the most difficult thing. Hude lost his
  176.    interest towards this project, and he even managed to lose the source
  177.    codes somewhere. Anyways, there'll be lots of new features. The entire
  178.    C64 end has been reprogrammed from scratch. Finally there should be a PC
  179.    version as well. There has been pretty radical ideas for future versions,
  180.    like a TwinExpress with GUI, but much better and more advanced. Data
  181.    transfer rates will be *MUCH* higher, no more typing in hundreds of
  182.    filenames thanks to neat headers - and hopefully we'll finally get rid
  183.    of the ugly ASL file requester!... Reqtools rules... Just wait and see.
  184.    The Amiga executable is indeed already named "XData", but it's exactly
  185.    the same as "PData". I just patched the program a bit to make it look
  186.    better. Besides, I finally wanted to get rid of the "PData" name!
  187.  
  188. 11. CONTACT ADDRESS
  189.  
  190.    Alias:           Deadbeat/The Sharks
  191.  
  192.    Snailmail:       Timo Rönkkö
  193.                     Linjakuja 3
  194.                     FIN-74120 Iisalmi
  195.                     Finland
  196.  
  197.    E-mail:          deadbeat@freenet.hut.fi
  198.  
  199.    Ircnick:         Deadbeat
  200.  
  201.    Feel free to /MSG me in IRC, if you see me around. Please don't
  202.    snailmail me letters begging for cables, I have *NO* time to make any.
  203.    Consider the making of a PData cable as a lamer-protection! ;)
  204.    If you really have to ask me something, try e-mail first (Prefered).
  205.  
  206.    Should you want to trade C64 & Amiga warez - feel free to contact me!
  207.    (Especially if you're into request-trading...)
  208.  
  209.    See me in person next August at Assembly '95 in Helsinki, Finland.
  210.    (Get your demos finished, there *WILL* be competitions for the C64!
  211.    I'll be personally organizing the C64 competitions...)
  212.  
  213. 12. BOARDS
  214.  
  215.    - MASTER & SERVANT
  216.      +49-(0)ASK-FOR-iT / +49-(0)PRi-VATE
  217.      THE SHARKS World Headquarters (C64)
  218.      QUARTEX German Headquarters (Amiga, SNES)
  219.      REBELS German Headquarters (PC)
  220.  
  221.    - DEEP THOUGHT
  222.      +358-(9)77-54311 / +358-(9)77-PRi-VATE
  223.      THE SHARKS European Headquarters (C64)
  224.      DIGITAL European Headquarters (Amiga)
  225.      >>> OFFLINE UNTIL FURTHER NOTICE <<<
  226.