home *** CD-ROM | disk | FTP | other *** search
/ CBM Funet Archive / cbm-funet-archive-2003.iso / cbm / crossplatform / transfer / Amiga / pdata352.lha / PData / PData.DOC < prev   
Encoding:
Text File  |  1995-08-25  |  9.7 KB  |  207 lines
  1.                             pdata documentation
  2.                             -------------------
  3.  
  4.    rELEASE VERSION : 3.52 FINAL
  5.    dATE            : sATURDAY, 3RD fEBRUARY 1995
  6.                      (tHIS TEXTFILE WAS LAST MODIFIED ON 25TH aUGUST 1995)
  7.  
  8.    cOPYRIGHT {SHIFT-POUND} 1993-1995 dEADBEAT/tHE sHARKS
  9.                (c64 CODING, OPTIMIZED CABLE SCHEMATICS, DOCUMENTATION)
  10.  
  11.    cOPYRIGHT {SHIFT-POUND} 1993 hUDE
  12.                (aMIGA CODING)
  13.  
  14.    pLEASE NOTICE THAT THE aMIGA EXECUTABLE FILE IS NOW CALLED "xdATA"!
  15.    (iT'S 100% COMPATIBLE WITH pdATA; READ future FOR MORE INFORMATION)
  16.  
  17. 1. overview
  18.  
  19.    pdATA IS AN UTILITY FOR TRANSFERING BOTH BINARY AND TEXT FILES BETWEEN
  20.    THE c64/c128 AND aMIGA. iT'S ABOUT 25 TIMES FASTER THAN A NULL MODEM
  21.    CABLE AND IT EVEN LEAVES YOUR aMIGA'S SERIAL PORT FREE FOR OTHER
  22.    APPLICATIONS (tHE MAXIMUM bps RATE IN A _STANDARD_ c64 IS AROUND 2.4k).
  23.  
  24. 2. distribution and disclaimer
  25.  
  26.    pdATA MAY BE FREELY DISTRIBUTED AS LONG AS ALL FILES ARE INCLUDED
  27.    INTACT AND AS LONG AS NO MORE THAN A NOMINAL FEE IS CHARGED TO COVER
  28.    TIME AND COPYING COSTS. pdATA MAY not BE USED FOR COMMERCIAL PURPOSES
  29.    WITHOUT A WRITTEN PERMISSION FROM THE AUTHOR(S). tHE AUTHOR(S) CAN'T BE
  30.    HELD LIABLE FOR ANY DAMAGE DIRECTLY OR INDIRECTLY CAUSED BY THE USE OR
  31.    MISUSE OF THIS MANUAL AND/OR THE PROGRAM IT DESCRIBES. pdATA IS PROVIDED
  32.    "AS-IS" AND IT IS A SUBJECT TO CHANGE WITHOUT NOTICE.
  33.  
  34.    iNTERNET USERS WILL MOST LIKELY FIND THE LATEST VERSION OF pdATA FROM
  35.    NIC.FUNET.FI. yOU COULD ALSO TRY TO /MSG sharkbite FOR SOME help ON irc.
  36.    tHOSE UNPRIVILEGED ONES (pERSONS WITHOUT 'NET ACCESS) SHOULD CALL ANY
  37.    OF the sharks BOARDS, AND THEY'LL GET THE LATEST VERSION.
  38.  
  39.    iF YOU LIKE THIS PROGRAM, FEEL FREE TO SEND ME (dEADBEAT) A POSTCARD.
  40.    oN THE OTHER HAND, YOU COULD ALWAYS DROP ME WITH SOME E-MAIL...
  41.  
  42. 3. requirements
  43.  
  44.    tHE c64 END OF pdATA WILL WORK IN EVERY c64/c128. tHE aMIGA END OF pdATA
  45.    WILL - HOPEFULLY - WORK IN EVERY MODEL, BUT kICKSTART V37.175 (V2.04) OR
  46.    ABOVE IS REQUIRED TO UTILIZE ALL FEATURES. a SPECIAL CABLE BETWEEN THE
  47.    c64 AND aMIGA IS REQUIRED. tHE FOLLOWING THINGS ARE NEEDED FOR THE CABLE:
  48.  
  49.         - oNE CARD EDGE CONNECTOR (c64 USER PORT)
  50.         - oNE MALE d-25 CONNECTOR (aMIGA PARALLEL PORT)
  51.         - sUITABLE LENGTH OF FLAT CABLE (wIDTH 12 OR MORE)
  52.  
  53.    aDDITIONALLY, YOU'LL NEED THE FOLLOWING FILES FOR YOUR aMIGA...
  54.  
  55.         - dEVS/pARALLEL.DEVICE
  56.         - l/pORT-HANDLER
  57.         - lIBS/aSL.LIBRARY
  58.         - lIBS/lOCALE.LIBRARY
  59.  
  60. 4. pdata cable schematics
  61.  
  62.    c64 USER PORT              aMIGA PARALLEL PORT
  63.  
  64.    pIN      dESCRIPTION       dESCRIPTION      pIN
  65.  
  66.    b        flag*             strobe           1
  67.    c        pb0               data 0           2
  68.    d        pb1               data 1           3
  69.    e        pb2               data 2           4
  70.    f        pb3               data 3           5
  71.    h        pb4               data 4           6
  72.    j        pb5               data 5           7
  73.    k        pb6               data 6           8
  74.    l        pb7               data 7           9
  75.    8        pc*               ack*             10
  76.    m        pa2               busy             11
  77.    n        gnd               gnd              17
  78.  
  79. 5. using pdata c64
  80.  
  81.    uSING pdATA c64 IS FAIRLY EASY. yOU'LL FIRST BE PROMPTED FOR YOUR WORK
  82.    DRIVE. aNY DEVICE BETWEEN 8 AND 11 WILL DO. tHEN YOU CAN SELECT WHETHER
  83.    TO HANDLE YOUR FILES AS BINARY OR TEXT. iF YOU SELECT BINARY, THE FILES
  84.    WILL BE TRANSFERED WITHOUT ANY ALTERATIONS. sELECTING TEXT MODE WILL
  85.    CAUSE EVERYTHING TO BE TRANSLATED FROM petscii TO ascii AND VICE VERSA.
  86.    tHE NEXT STEP IS TO DECIDE WHETHER TO SEND OR RECEIVE FILES. aT THIS
  87.    POINT, YOU CAN PRESS "," TO ACCESS A seq FILE HANDLER, USING WHICH YOU
  88.    CAN PRINT OUT OR VIEW SEQUENTIAL FILES. aSSUMING THAT YOU DIDN'T ENTER
  89.    THE seq FILE HANDLER, YOU NOW CAN PRESS f1 TO TOGGLE BETWEEN NORMAL/ZIP
  90.    MODE. iF ZIP MODE IS ON, pdATA WILL ADD THOSE 1! 2! 3! AND 4! PREFIXES
  91.    IN FRONT OF EACH ZIP DISK-PACKED FILE AUTOMATICALLY AND YOU ONLY NEED
  92.    TO WORRY ABOUT FOURTEEN LAST CHARACTERS. iF YOU START RECEIVING A FILE
  93.    IN SINGLE MODE, YOU'LL BE PROMPTED WHETHER TO PROCESS FILES AS prg OR
  94.    seq. iF A FILE EXISTS, YOU'LL BE GIVEN A CHANCE TO REGRET. yOU CAN USE
  95.    "$" (cr = $ AS dEFAULT) TO SEE DIRECTORY, "@" FOR dos COMMANDS AND "?"
  96.    TO SEE NUMBER OF FREE BLOCKS AVAILABLE ON DISK. pRESSING "=" AT ALL
  97.    TIMES (eXCEPT IN MULTI-FILE TRANSFER MENU) WILL TAKE YOU ONE STEP
  98.    "BACKWARDS" IN THE MENUS. iN ZIP MODE, YOU CAN INDIVIDUALLY DECIDE
  99.    WHICH OF THE FILES SHOULD BE OVERWRITTEN. pRESSING f3 WILL TAKE YOU
  100.    TO MULTI-FILE TRANSFER MENU. iN MULTI-FILE TRANSFER MENU, PRESS f1 FOR
  101.    SENDING FILES, f3 FOR RECEIVING FILES, f5 FOR DIRECTORY AND f7 FOR MAIN
  102.    MENU. aFTER PRESSING f1, YOU CAN USE y/n TO SELECT FILES. pRESSING cr
  103.    (rETURN) WILL QUIT OR START TRANSFER, DEPENDING IF YOU'VE GOT ANY FILES
  104.    SELECTED. aFTER PRESSING f3, YOU CAN ENTER TARGET FILENAMES. lEAVE ONE
  105.    BLANK LINE AND HIT cr TO START TRANSFER. mULTI-FILE TRANSFER CAN HANDLE
  106.    255 FILES BOTH DIRECTIONS. iT HANDLES ONLY BINARY prg FILES AND NEVER
  107.    OVERWRITES IT'S TARGET FILES. aT all TIMES, PRESSING RESTORE WILL CLEAR
  108.    THE CHANNEL, INITIALIZE VECTORS AND RESTART PROGRAM. iF YOU'RE IN DOUBT
  109.    OF SOMETHING, JUST TRY IT. tHERE'S NO WAY THE PROGRAM COULD CRASH.
  110.  
  111. 6. using xdata amiga
  112.  
  113.    XDATA (S/R/?) (PATH/FILENAME)
  114.    (S = SEND / R = RECEIVE / ? = HELP)
  115.    eXAMPLE : XDATA R DH1:DL/C64_RULES.TXT
  116.  
  117.    pRESSING ctrl+c WILL - HOPEFULLY - ABORT TRANSFER. uSE IT IN COMBINATION
  118.    WITH restore IN THE c64 END TO GAIN MAXIMUM EFFECT. iF YOU HAVE A
  119.    MULTIFACECARD (mfc) IN YOUR aMIGA, REMEMBER YOU MUST USE THE xdATA.cfg
  120.    IN s: DIRECTORY TO RE-ROUTE par: INTO pit:. eDIT THE FILE SO THAT IT
  121.    READS pit:<cr>. iF YOU'RE NOT A HARD DRIVE USER, i SUGGEST YOU REDIRECT
  122.    THE FILES INTO ram: WHEN RECEIVING SOMETHING FROM THE c64, IF YOU DON'T
  123.    HAVE LOTS OF SPARE TIME TO WASTE (sEE MISSING FEATURES).
  124.  
  125. 7. miscellaneous
  126.  
  127.    cONFIGURING YOUR REGULAR DIRECTORY TOOL FOR pdATA MAKES YOUR LIFE MUCH
  128.    EASIER. oNCE YOU'VE MADE THE FIRST TRANSFER AFTER TURNING BOTH OF YOUR
  129.    COMPUTERS ON, YOU CAN IGNORE THE c64'S ON-SCREEN PROMPTS ABOUT SETTING
  130.    THE OTHER END TO SEND/RECEIVE MODE. tHIS IS BECAUSE ONCE THE aMIGA'S
  131.    PORT-HANDLER HAS BEEN "ACTIVATED", pdATA CAN'T "LOSE" ANYTHING. wHEN
  132.    TRANSFERING pdATA MAINFILE (pdata.c64) TO THE c64, YOU must USE THE
  133.    FILENAME "pdata 3.5-sharks". tO TRANSFER THE FILE, TRY A NULL MODEM
  134.    CABLE. sCHEMATICS ARE SUPPLIED BELOW. yOU'LL NEED A rs-232 ADAPTER FOR
  135.    THE c64 AND A SUITABLE TERMINAL PROGRAM FOR BOTH ENDS. iF, HOWEVER, YOU
  136.    SHOULD EXPERIENCE PROBLEMS IN DOING SO, E-MAIL THE OFFICIAL pdATA
  137.    HELPLINE AT THIS ADDRESS: MYSTI@STEKT.OULU.FI AND BEG FOR HELP! :)
  138.    (mYSDEE/tHE sHARKS JUST VOLUNTEERED TO HELP ALL THE PEOPLE IN NEED!)
  139.  
  140. 8. null modem cable schematics
  141.  
  142.    pIN     dESCRIPTION       dESCRIPTION       pIN
  143.  
  144.    2       txd               rxd               3
  145.    3       rxd               txd               2
  146.    4       rts               dcd               8
  147.    6       dsr               dtr               20
  148.    7       gnd               gnd               7
  149.    8       dcd               rts               4
  150.    20      dtr               dsr               6
  151.  
  152. 9. bugs and missing features
  153.  
  154.    c64 END:   - nONE KNOWN, ALTHOUGH THERE HAS BEEN SOME REPORTS ABOUT
  155.                 PROBLEMS WITH MULTI-FILE TRANSFERS.
  156.  
  157.    aMIGA END: - sOMETIMES REFUSES TO WORK IF A FILENAME ENDS WITH "+".
  158.               - rEFUSES TO WORK IF A FILENAME CONTAINS ANY SPACES.
  159.               - rECEIVE BUFFER MISSING.
  160.                 ...
  161.  
  162.    pdATA DOESN'T SEND A HEADER CONTAINING A FILENAME. tHIS IS not A BUG.
  163.    bY THE WAY, DID YOU KNOW THAT pdATA CAN BE USED TO TRANSFER DATA BETWEEN
  164.    TWO c64'S OR TWO aMIGA'S WITH MINOR CABLE MODIFICATIONS? hARDWARE WIZARDS
  165.    MAY FIGURE THIS ONE OUT ON THEIR OWN, FULL CABLE SCHEMATICS WILL BE
  166.    RELEASED LATER ON FOR THE PUBLIC.
  167.  
  168. 10. future
  169.  
  170.    tHIS VERSION OF pdATA IS THE VERY FINAL EVER. i'VE FINALLY DECIDED TO
  171.    SHARE MY VIEWS ABOUT THE FUTURE WITH THE PUBLIC. pdata is dead. long live
  172.    xdata. aFTER CAREFUL CONSIDERATION AND LOTS OF TIME, i'VE FINALLY DECIDED
  173.    TO MAKE SOME MAJOR CHANGES. tHE CHANGES ARE SO RADICAL, THAT i'VE DECIDED
  174.    TO CHANGE THE NAME AS WELL. eXPECT THE INITIAL RELEASE OF xdATA SOON...
  175.    iN FACT, i'VE HAD THE c64 END FINISHED FOR MONTHS NOW, BUT FINDING A
  176.    QUALIFIED aMIGA CODER HAS BEEN THE MOST DIFFICULT THING. hUDE LOST HIS
  177.    INTEREST TOWARDS THIS PROJECT, AND HE EVEN MANAGED TO LOSE THE SOURCE
  178.    CODES SOMEWHERE. aNYWAYS, THERE'LL BE LOTS OF NEW FEATURES. tHE ENTIRE
  179.    c64 END HAS BEEN REPROGRAMMED FROM SCRATCH. fINALLY THERE SHOULD BE A pc
  180.    VERSION AS WELL. tHERE HAS BEEN PRETTY RADICAL IDEAS FOR FUTURE VERSIONS,
  181.    LIKE A tWINeXPRESS WITH gui, BUT MUCH BETTER AND MORE ADVANCED. dATA
  182.    TRANSFER RATES WILL BE *much* HIGHER, NO MORE TYPING IN HUNDREDS OF
  183.    FILENAMES THANKS TO NEAT HEADERS - AND HOPEFULLY WE'LL FINALLY GET RID
  184.    OF THE UGLY asl FILE REQUESTER!... rEQTOOLS RULES... jUST WAIT AND SEE.
  185.    tHE aMIGA EXECUTABLE IS INDEED ALREADY NAMED "xdATA", BUT IT'S EXACTLY
  186.    THE SAME AS "pdATA". i JUST PATCHED THE PROGRAM A BIT TO MAKE IT LOOK
  187.    BETTER. bESIDES, i FINALLY WANTED TO GET RID OF THE "pdATA" NAME!
  188.  
  189. 11. getting in touch with me...
  190.  
  191.    aLIAS:           dEADBEAT/tHE sHARKS
  192.  
  193.    sNAILMAIL:       tIMO r{$f6}NKK{$f6}
  194.                     lINJAKUJA 3
  195.                     fin-74120 iISALMI
  196.                     fINLAND
  197.  
  198.    e-MAIL:          DEADBEAT@FREENET.HUT.FI
  199.  
  200.    ircNICK:         dEADBEAT 
  201.                     (i'M USUALLY ON CHANNELS #c-64 AND #aMIGASCNE)
  202.  
  203.    fEEL FREE TO /MSG ME ON irc, IF YOU SEE ME AROUND. pLEASE DON'T
  204.    SNAILMAIL ME LETTERS BEGGING FOR CABLES, i HAVE _no_ TIME TO MAKE ANY.
  205.    cONSIDER THE MAKING OF A pdATA CABLE AS A LAMER-PROTECTION! ;)
  206.    iF YOU REALLY HAVE TO ASK ME SOMETHING, TRY E-MAIL FIRST (pREFERED).
  207.