home *** CD-ROM | disk | FTP | other *** search
/ Go64! / Go64_2004-02_2004_CSW_Side_A.d64 / readme < prev    next >
Encoding:
Text File  |  2004-01-01  |  7.0 KB  |  209 lines
  1.                       cj tRANSFER 128, vERSION r1b
  2.  
  3.  
  4.  
  5. tABLE OF CONTENTS
  6.  
  7. -----------------
  8.  
  9. 1.  cOPYRIGHT, LICENSE AND DISCLAIMER
  10.  
  11. 2.  dELIVERY CONTENTS
  12.  
  13. 3.  sYSTEM SET-UP
  14.  
  15. 4.  bACKGROUND
  16.  
  17. 5.  pURPOSE
  18.  
  19. 6.  uSAGE
  20.  
  21. 7.  pERFORMANCE AND HINTS FOR IMPROVING PERFORMANCE
  22.  
  23. 8.  faq
  24.  
  25. 9.  tO BE CONSIDERED FOR FUTURE DEVELOPMENT (CURRENT LIMITATIONS)
  26.  
  27. 10. cONTACT INFORMATION
  28.  
  29. 11. vERSION HISTORY
  30.  
  31.  
  32.  
  33.  
  34.  
  35. 1. cOPYRIGHT, LICENSE AND DISCLAIMER
  36.  
  37.  
  38.  
  39. cj tRANSFER 128 IS COPYRIGHT (c) BY cHRISTIAN jOHANSSON 2004 AND IS DISTRIBUTED
  40.  
  41. AS FREEWARE.
  42.  
  43.  
  44.  
  45. tHE AUTHOR OF cj tRANSFER 128 IS NOT LIABLE FOR ANY DAMAGE OR DATA LOSS CAUSED
  46.  
  47. BY cj tRANSFER 128.
  48.  
  49.  
  50.  
  51.  
  52.  
  53. 2. dELIVERY CONTENTS
  54.  
  55.  
  56.  
  57. * README.TXT (THIS DOCUMENT)
  58.  
  59.  
  60.  
  61. * CJTRANSFER128.D64, WHICH IS AN ARCHIVE FILE CONTAINING THE FOLLOWING prg
  62.  
  63. FILES:
  64.  
  65.  
  66.  
  67.   - cj xfer 128 r1b (THE EXECUTABLE PROGRAM)
  68.  
  69.  
  70.  
  71.   - cj xfer r1b.asm (pOWER aSSEMBLER SOURCE CODE)
  72.  
  73.  
  74.  
  75.  
  76.  
  77. 3. sYSTEM SET-UP
  78.  
  79.  
  80.  
  81. tHE FOLLOWING SET-UP IS REQUIRED IN ORDER TO USE THE tHE cOMMODORE 128 PROGRAM
  82.  
  83. cj tRANSFER 128:
  84.  
  85.  
  86.  
  87. * cOMMODORE 128 COMPUTER
  88.  
  89.  
  90.  
  91. * a 1541, 1541-ii, 1541 COMPATIBLE, 1570, 1571 OR 1581 DISK DRIVE CONNECTED TO
  92.  
  93. THE cOMMODORE 128
  94.  
  95.  
  96.  
  97. * a uSER pORT rs-232 ADAPTER CONNECTED TO THE uSER pORT OF THE cOMMODORE 128.
  98.  
  99. eXAMPLES OF uSER pORT rs232 ADAPTERS ARE vic-1011a AND hANDIC v24.
  100.  
  101.  
  102.  
  103. * a NULL-MODEM CABLE (CROSSED SERIAL CABLE) CONNECTED BETWEEN THE uSER pORT
  104.  
  105. rs-232 ADAPTER AND THE SERIAL PORT OF ANOTHER COMPUTER (CALLED "REMOTE COMPUTER"
  106.  
  107. IN THE REST OF THIS DOCUMENT).
  108.  
  109.  
  110.  
  111. * a REMOTE COMPUTER (OF ANY TYPE AND WITH ANY OPERATING SYSTEM) RUNNING A
  112.  
  113. TERMINAL PROGRAM WITH A CONNECTION TO A SERIAL PORT. tHE TERMINAL PROGRAM MUST
  114.  
  115. SUPPORT THE SETTING 2400 BITS PER SECOND, NO FLOW CONTROL, NO PARITY, 8 DATA
  116.  
  117. BITS AND 1 STOP BIT. tHE xMODEM TRANSFER PROTOCOL MUST ALSO BE SUPPORTED BY THE
  118.  
  119. TERMINAL PROGRAM.
  120.  
  121.  
  122.  
  123.  
  124.  
  125. 4. bACKGROUND
  126.  
  127.  
  128.  
  129. mOST cOMMODORE 64/128 TRANSFER PROGRAMS ONLY WORK RELIABLY UNDER THE ms-dos
  130.  
  131. OPERATING SYSTEM. cj tRANSFER 128 HAS BEEN IMPLEMENTED IN ORDER TO PROVIDE A
  132.  
  133. MORE GENERAL SOLUTION. tHE ADVANTAGE WITH cj tRANSFER 128 IS THAT THE COMPUTER
  134.  
  135. CONNECTED TO THE cOMMODORE 128 VIA A NULL-MODEM CABLE CAN BE ANY KIND OF
  136.  
  137. COMPUTER WITH ANY OPERATING SYSTEM AS LONG AS IT HAS A SERIAL PORT AND A
  138.  
  139. TERMINAL PROGRAM FULFILLING THE REQUIREMENTS DESCRIBED UNDER 3.
  140.  
  141.  
  142.  
  143.  
  144.  
  145. 5. pURPOSE
  146.  
  147.  
  148.  
  149. tHE PURPOSE OF cj tRANSFER 128 IS TO TRANSFER THE CONTENTS OF A PHYSICAL FLOPPY
  150.  
  151. DISK TO A .D64, .D71 OR .D81 ARCHIVE FILE ON THE REMOTE COMPUTER OR THE
  152.  
  153. OPPOSITE, I.E. TRANSFER THE CONTENTS OF AN ARCHIVE FILE ON THE REMOTE COMPUTER
  154.  
  155. TO A PHYSICAL FLOPPY DISK.
  156.  
  157.  
  158.  
  159. oNLY FULL DISK COPY HAS BEEN IMPLEMENTED. cOPYING INDIVIDUAL FILES IS CURRENTLY
  160.  
  161. NOT SUPPORTED.
  162.  
  163.  
  164.  
  165.  
  166.  
  167. 6. uSAGE
  168.  
  169.  
  170.  
  171. tHE PROGRAM IS PRETTY MUCH SELF-EXPLANATORY. jUST load THE PROGRAM AND run IT ON
  172.  
  173. YOUR cOMMODORE 128. tHEN, ANSWER SOME QUESTIONS AND PERFORM THE ACTIONS THE
  174.  
  175. PROGRAM TELLS YOU TO DO. tHE PROGRAM ALSO TELLS YOU WHEN TO START SENDING OR
  176.  
  177. RECEIVING ON THE REMOTE COMPUTER.
  178.  
  179.  
  180.  
  181. yOU HAVE TO MAKE SURE THAT THE DISK DRIVE FOR THE DEVICE NUMBER YOU CHOOSE AND
  182.  
  183. THE FORMAT OF THE DISK IN THAT DRIVE ARE CONSISTENT WITH THE ARCHIVE FORMAT YOU
  184.  
  185. SELECT. aRCHIVE FILES WITH ADDED ERROR INFO ARE NOT SUPPORTED.
  186.  
  187.  
  188.  
  189.  
  190.  
  191. 7. pERFORMANCE AND HINTS FOR IMPROVING PERFORMANCE
  192.  
  193.  
  194.  
  195. tRANSFER TIMES:
  196.  
  197.  
  198.  
  199. fORMAT           {$7c} tO REMOTE COMPUTER   {$7c} fROM REMOTE COMPUTER {$7c}
  200.  
  201. ----------------------------------------------------------------
  202.  
  203. .D64, 1571 DRIVE {$7c} 16 MIN, 5 SECONDS    {$7c} 15 MIN, 29 SECONDS   {$7c}
  204.  
  205. ----------------------------------------------------------------
  206.  
  207. .D64, 1541 DRIVE {$7c} 22 MIN, 47 SECONDS   {$7c} 17 MIN, 36 SECONDS   {$7c}
  208.  
  209. ----------------------------------------------------------------
  210.  
  211. .D71             {$7c} nOT MEASURED         {$7c} nOT MEASURED         {$7c}
  212.  
  213. ----------------------------------------------------------------
  214.  
  215. .D81             {$7c} nOT MEASURED         {$7c} nOT MEASURED         {$7c}
  216.  
  217. ----------------------------------------------------------------
  218.  
  219.  
  220.  
  221. aS CAN BE SEEN IN THE TABLE ABOVE, USING A 1571 DRIVE (OR A 1570 DRIVE)
  222.  
  223. DECREASES THE TRANSFER TIME COMPARED TO USING A 1541 (OR 1541-ii DRIVE).
  224.  
  225.  
  226.  
  227. tHE xMODEM IMPLEMENTATION IN cj tRANSFER 128 DOES NOT SUPPORT USING crc. oNLY
  228.  
  229. THE ORIGINAL VERSION OF xMODEM WITH AN ADDITIVE CHECKSUM IS SUPPORTED. tHE NEWER
  230.  
  231. VERSION OF xMODEM WITH crc IS BACKWARDS COMPATIBLE WITH THE ORIGINAL VERSION.
  232.  
  233. hOWEVER, A TERMINAL PROGRAM SUPPORTING crc WILL DO A NUMBER OF RETRIES WHEN
  234.  
  235. STARTING TO RECEIVE A FILE BEFORE GOING OVER TO USING CHECKSUM. tHIS CAN
  236.  
  237. TYPICALLY TAKE AROUND 30 SECONDS (NOT INCLUDED IN THE TABLE ABOVE). tHEREFORE,
  238.  
  239. IN ORDER TO DECREASE THE TRANSFER TIME WHEN SENDING FROM THE cOMMODORE 128 TO
  240.  
  241. THE REMOTE COMPUTER, IT IS RECOMMENDED TO USE A TERMINAL PROGRAM THAT DOES NOT
  242.  
  243. SUPPORT xMODEM WITH crc (ONLY xMODEM WITH ADDITIVE CHECKSUM) ON THE REMOTE
  244.  
  245. COMPUTER. uNDER wINDOWS, FOR EXAMPLE tERA tERM pRO (
  246.  
  247. HTTP://HP.VECTOR.CO.JP/AUTHORS/va002416/TERATERM.HTML) CAN BE USED INSTEAD OF
  248.  
  249. hYPERtERMINAL.
  250.  
  251.  
  252.  
  253. cj tRANSFER 128 IS RUNNING IN 2 mhZ MODE DURING TRANSFER. iF YOU ARE USING A 40-
  254.  
  255. COLUMN SCREEN, THE SCREEN WILL BE BLANK SINCE THE 40-COLUMN vic CHIP CANNOT
  256.  
  257. OPERATE UNDER 2 mhZ.
  258.  
  259.  
  260.  
  261.  
  262.  
  263. 8. faq
  264.  
  265.  
  266.  
  267. q: wHERE CAN i BUY A uSER pORT rs-232 ADAPTER?
  268.  
  269.  
  270.  
  271. a: tHESE ARE NOT MANUFACTURED ANYMORE. yOU HAVE TO LOOK AT MARKETS FOR USED
  272.  
  273. cOMMODORE EQUIPMENT, FOR EXAMPLE EbAY, OR BUILD ONE YOURSELF. iF YOU WANT TO
  274.  
  275. BUILD ONE YOURSELF YOU CAN FIND DIAGRAMS FOR EXAMPLE AT HTTP://WWW.PETSCII.COM/
  276.  
  277. .
  278.  
  279.  
  280.  
  281.  
  282.  
  283. 9. tO BE CONSIDERED FOR FUTURE DEVELOPMENT (CURRENT LIMITATIONS)
  284.  
  285.  
  286.  
  287. * rEDUCE THE SIZE OF THE PROGRAM BY MERGING TOGETHER COMMON CODE INTO
  288.  
  289. SUBROUTINES.
  290.  
  291.  
  292.  
  293. * dECREASE TRANSFER TIME. cUSTOM rs-232 ROUTINES COULD BE IMPLEMENTED INSTEAD OF
  294.  
  295. THE kERNAL ROUTINES TO MAKE IT POSSIBLE TO USE BAUD RATES HIGHER THAN 2400 BPS
  296.  
  297. (THIS IS FOR EXAMPLE DONE IN dESTERM) AND/OR DISK TURBO ROUTINES COULD BE
  298.  
  299. IMPLEMENTED.
  300.  
  301.  
  302.  
  303. * sUPPORT xMODEM WITH crc.
  304.  
  305.  
  306.  
  307. * sUPPORT MORE TRANSFER PROTOCOLS THAN xMODEM.
  308.  
  309.  
  310.  
  311. * sUPPORT VARIANTS OF .D64, .D71 AND .D81. wHAT IS MOSTLY LACKING TODAY IS THE
  312.  
  313. SUPPORT FOR ADDED ERROR INFO.
  314.  
  315.  
  316.  
  317. * sUPPORT MORE ARCHIVE FORMATS.
  318.  
  319.  
  320.  
  321. * sUPPORT COPYING INDIVIDUAL FILES IN ADDITION TO WHOLE ARCHIVES.
  322.  
  323.  
  324.  
  325. * aUTO-DETECT THE DRIVE TYPE AND DISK FORMAT FOR A GIVEN DEVICE NUMBER.
  326.  
  327.  
  328.  
  329. * dETECT AND HANDLE ERRORS AT rs-232 TRANSFER.
  330.  
  331.  
  332.  
  333. * dETECT AND HANDLE ERRORS AT DISK TRANSFER.
  334.  
  335.  
  336.  
  337. * iMPLEMENT cOMMODORE 64 VERSION.
  338.  
  339.  
  340.  
  341. * iMPROVE USER INTERFACE. aT THE SAME TIME, REWRITE THE INPUT PART OF THE
  342.  
  343. PROGRAM FROM basic TO ASSEMBLY.
  344.  
  345.  
  346.  
  347.  
  348.  
  349. 10. cONTACT INFORMATION
  350.  
  351.  
  352.  
  353. cOMMENTS AND SUGGESTIONS REGARDING cj tRANSFER 128 ARE WELCOME. tHE E-MAIL
  354.  
  355. ADDRESS TO ME WHO HAS IMPLEMENTED cj tRANSFER 128 (cHRISTIAN jOHANSSON) IS
  356.  
  357. C64(AT)COMHEM.SE.
  358.  
  359.  
  360.  
  361. tHE ADDRESS TO THE OFFICIAL cj tRANSFER 128 PAGE IS
  362.  
  363. HTTP://W1.865.COMHEM.SE/{$7e}U86517142/CJTRANSFER.HTM.
  364.  
  365.  
  366.  
  367. aNY OF THE ADDRESSES ABOVE MAY CHANGE AT ANY TIME SO IT IS NOT CERTAIN THAT THEY
  368.  
  369. ARE VALID WHEN YOU READ THIS.
  370.  
  371.  
  372.  
  373.  
  374.  
  375. 11. vERSION HISTORY
  376.  
  377.  
  378.  
  379. vERSION r1b, fEBRUARY 2004
  380.  
  381. --------------------------
  382.  
  383. * wROTE ALL OF THE TRANSFER ROUTINES IN ASSEMBLY. tHIS GIVES THE FOLLOWING
  384.  
  385. ADVANTAGES:
  386.  
  387.  
  388.  
  389.   - rEDUCED SIZE OF THE EXECUTABLE PROGRAM (FASTER LOAD TIME)
  390.  
  391.  
  392.  
  393.   - dECREASED TRANSFER TIMES
  394.  
  395.  
  396.  
  397. vERSION r1a, jANUARY 2004
  398.  
  399. -------------------------
  400.  
  401. fIRST VERSION.
  402.  
  403.  
  404.  
  405.  
  406.  
  407.  
  408.  
  409.  
  410.  
  411.  
  412.  
  413.  
  414.  
  415.  
  416.  
  417.