home *** CD-ROM | disk | FTP | other *** search
/ Amiga Elysian Archive / AmigaElysianArchive.iso / emulate / d64.lha / d64.doc < prev    next >
Text File  |  1993-02-25  |  4KB  |  122 lines
  1.  
  2.  
  3.    D64 - A program to convert C64 programs from datasette to amiga
  4.          file format for use with TheA64Package etc.
  5.  
  6.  
  7.    This program is public domain software!
  8.    You can do with it what You want!
  9.  
  10.    The archive contains the following files:
  11.  
  12.    d64            ;the programm itself
  13.    d64.c          ;the C-Source
  14.    d64.dok        ;German documentation
  15.    d64.doc        ;this documentation file
  16.    Sample1.8svx   ;digitized sample of a C64 datasette program
  17.    Sample2.8svx   ;the same in valid format for D64
  18.    Bild1.ilbm     ;Illustration 1
  19.    Bild2.ilbm     ;Illustration 2
  20.  
  21.  
  22.  
  23.  
  24.  
  25. Program description:
  26. --------------------
  27.  
  28. This program converts C64 programs from tape (TURBO TAPE 64).
  29. To use them from C64 emulators like "TheA64Package" when you
  30. have no C64 with datasette and floppy, digitize the file you
  31. want to convert with a sound digitizer and a program like
  32. Audiomaster with maximal sample rate (more than 40 kHz).
  33. Then zoom to the start (Audiomaster shows a length of 599 Bytes)
  34. an cut the tape noise at the start so that you can hear the
  35. sync signal clearly. It doesn't matter if you cut 1/3 of the
  36. sync signal, but the sound sample must start directly with the
  37. sync signal; that means that you can see waves that are repeating
  38. seven little and one bigger waves. It is not important if it starts
  39. with a bigger wave or one of the lower waves, but you *must* be
  40. able to differ series of 7 lower and one higher wave.
  41. If you have cutted the start of the sample as described, save the
  42. sample, which can now (hopefully) be the input of D64.
  43.  
  44.  
  45. Format of a TURBO TAPE 64 file:
  46. -------------------------------
  47.  
  48. 1. Synchronisation:
  49.    - 5 x (246 x byte value 2)
  50.    - Countdownbytes 9,8,7,6,5,4,3,2,1
  51. 2. Header:
  52.    - Secondary address 1
  53.    - Low- and Highbyte of the start address
  54.    - Low- and Highbyte of the end address
  55.    - Fillbyte (0)
  56.    - Filename
  57.    - the rest of the 193 header bytes are spaces
  58. 3. Synchonisation:
  59.    - 2 x (246 x byte value 2)
  60.    - Countdownbytes 9,8,7,6,5,4,3,2,1
  61.    - Null-Byte
  62. 4. Data
  63. 5. Checksum: EXOR of all data bytes (255 times)
  64.  
  65.  
  66. If you don't like to cut the start of the sample to get it in
  67. the right format for D64, start sampling at the time you hear
  68. the sound of the first sync signal instead of the tape noise
  69. and your sample is cutted. Check it by zooming and looking at
  70. the first 599 (Audiomaster) bytes.
  71.  
  72. Now start D64 with the following syntax:
  73.  
  74. D64 <sample> <c64 file>
  75.  
  76. If you get the output "Prüfsumme OK!" (checksum OK), then your
  77. sample file was successfully converted.
  78. The message "Prüfsummenfehler" (checksum error) could have two
  79. reasons:
  80. - one or more bytes have been swapped
  81. - one or more bytes are to much or are missing
  82. In the first case, you might have luck and the program works
  83. (imagine a program with a wrong graphic byte - that would not
  84. cause more problems than a slightly wrong graphic output, but a
  85. wrong byte in the code...), but in the second case your whole
  86. program had been shifted by one bit - that's not very good...!
  87. When you get the message "Wellenlängeninkonsistenz" (that means
  88. that the length of one or more waves is not correct) you may be
  89. able to fix it because you get the byte number and can have a
  90. look at the wave at this byte - sometimes one wave is drifting
  91. away so that it is completely over or under the middle line
  92. (zero line) - and you can manually correct the wave.
  93.  
  94.  
  95. Here is an example of the use of D64:
  96.  
  97. d64 Sample2.8svx RAM:clock
  98.  
  99. gives the following output:
  100.  
  101. SEARCHING FOR DH2:TMP/SAMPLE2
  102. LOADING
  103. -->Header:
  104.    - Sekundäradresse: 1
  105.    - Startadresse LO: 1
  106.    - Startadresse HI: 8
  107.    - Endadresse   LO: 54
  108.    - Endadresse   HI: 11
  109.    - Dateiname      : THE BIG CLOCK                           
  110. -->Prüfsumme OK!
  111. SAVING
  112. READY.
  113.  
  114.  
  115. In the archive you will find two files Sample1.8svx and Sample2.8svx
  116. with the C64 program "Big Clock" as a digitized example file from
  117. datasette. Sample1 contains tape noise and would cause an error.
  118. Sample2 has been cutted and starts with the sync signal. The files
  119. should look like in Picture 2 (file "Bild2.ilbm"). Picture 1 shows
  120. the datasette file format as it has been described below.
  121.  
  122.