home *** CD-ROM | disk | FTP | other *** search
/ Amiga ISO Collection / AmigaUtilCD1.iso / Disk&HD / 1541.LHA / 1541.doc < prev    next >
Encoding:
Text File  |  1994-06-17  |  6.1 KB  |  128 lines
  1. 1541 Disk Reader (and related utilities)
  2.  
  3. Copyright © 1994 by Dan Babcock. These programs may be freely 
  4. copied and used for non-commercial purposes, including distribution 
  5. via FTP (Aminet) and CDROM (Fish, Aminet).
  6.  
  7. General
  8.  
  9.     The programs are CLI-based and use standard command-line 
  10. parsing (e.g. typing  "program ?" will display the argument template). 
  11. Kickstart 2.04 or above is required (developed under 3.1). You can 
  12. generally abort execution by pressing Control-C.
  13.     This document is rather brief and assumes you have a solid 
  14. understanding of both the Amiga and the 1541. If you need 1541 in
  15. formation I strongly recommend _Inside Commodore DOS_ by Rich
  16. ard Immers and Gerald Neufeld. That book was the sole reference 
  17. used to develop this software.
  18.     If you want to contact me for some reason (such as reporting 
  19. a bug), my email address is d6b@ecl.psu.edu.
  20.     I apologize for the terrible formatting of this text. The ASCII 
  21. export of this version of FinalWriterII (release 1...I need to upgrade) 
  22. really sucks!
  23.  
  24. 1541
  25.  
  26. Command line: 1541 DriveNumber FileName [Retry=RetryNumber] 
  27. [TOP]
  28. DriveNumber: drive number (0-3)
  29. FileName: file name for disk image
  30. [RetryNumber]: number of times to retry a track before giving up 
  31. (default 10)
  32. [TOP]: Read from "other" side of disk. THIS DOES NOT WORK. You 
  33. must physically flip the disk. But since I don't exactly know _why_ 
  34. this option doesn't work, I've left it in for experimentation purposes.
  35.  
  36. Example: 1541 2 ram:dump retry=20
  37.  
  38.     The "1541" program reads a 1541 disk and produces a disk 
  39. image. A "disk image" is simply a block-by-block copy of the disk, 
  40. stores as a file. 1541 disk images are frequently given a ".d64" ex
  41. tension, and referred to as "d64" files. (The term "disk image" is pre
  42. ferred, however).
  43.     "1541", as may already be obvious, reads from an Amiga 
  44. 5.25 inch drive; I use the Commodore A1020, and recommend it to 
  45. you as well. There is a catch, however. A 5.25 inch drive running at 
  46. the standard 300RPM speed can only read 1541 tracks 18-35, that 
  47. is, all but speed zone 1. (I'm not going to explain the 1541 speed 
  48. zones, so if you don't understand, don't worry about it). Luckily, 
  49. though, there is an easy fix: simply slow down the drive. At a some
  50. what slower speed the Amiga is able to read all 4 1541 speed 
  51. zones.
  52.     If you don't know how to use a screwdriver, you may want to 
  53. have an expert technician perform the speed adjustment; otherwise, 
  54. keep reading. Disassemble the drive casing. Examine (carefully!) the 
  55. drive, looking for any turn-able adjustment (potentiometer). In the 
  56. case of my Alps drive, there's a rather large adjustment nicely slot
  57. ted for a screwdriver on the circuit board surrounding the drive mo
  58. tor.
  59.     After you've located the (presumed) speed control, get the 
  60. drive in a position in which you can adjust the speed while the drive 
  61. is connected and functional. Run the "speed" program (see below), 
  62. which continuously prints drive speed information (in RPM) to the 
  63. console. I've found that 280RPM works satisfactorily, so that's what I 
  64. recommend you use, at least as a start. If you have problems read
  65. ing tracks 1-17 at 280RPM you can try reducing the speed slightly 
  66. (but I wouldn't recommend going lower than 270RPM). After you've 
  67. read in a few disks as a test, you can reassemble the case and for
  68. get about it. You should still be able to read IBM and AppleII disks at 
  69. the reduced speed, but I wouldn't recommend writing to them.
  70.     Anyway, once you have adjusted the speed of your drive you 
  71. should be able to read 1541 disks to your heart's content. On my 
  72. A2000 (68040) it takes about 13 seconds to read a disk. (I could 
  73. actually reduce the time to under 10 seconds, but I didn't deem it 
  74. worth the effort). One more thing worth mentioning about "1541" is 
  75. how it deals with errors. When "1541" finds that it can't read a sec
  76. tor, it places a special identifying mark on the sector 
  77. ($00,$FF,"LAZARUS" to be precise). That way programs (like Get
  78. Files, see below) that manipulate the disk image can identify sectors 
  79. that were unable to be read from the physical disk.
  80.  
  81. GetFiles
  82.  
  83. Command line: getfiles DiskImageName [DIR] [EXT]
  84. DiskImageName: file name of disk image (wildcards accepted)
  85. [DIR]: get a directory of the disk image (if not specified a directory 
  86. AND dump is performed)
  87. [EXT]: add file type extensions (e.g. ".PRG") to the dumped files
  88.  
  89. Example: getfiles mydisk
  90.  
  91.     GetFiles is used to extract the files (if any) from a disk image. 
  92. If you specify the DIR option a directory will be printed but the files 
  93. will not be dumped. Wildcards are accepted in the file name, so you 
  94. can easily directory and/or dump many disk images at once. Typi
  95. cally you can use the universal wildcard (#?) because only files with 
  96. the exact size of a 1541 disk image will be considered.
  97.     GetFiles will rename files that contain illegal (for Amiga filena
  98. mes) characters. For a "/", a "\" is substituted; for ":", ";" is substi
  99. tuted; and for non-printable characters "-" is substituted. In addition, 
  100. files containing the special "LAZARUS" signature (see the "1541" 
  101. description above) will be reported as corrupt.
  102.     1541 files of type PRG, SEQ, USR, REL, and DEL in the nor
  103. mal and locked forms are acceptable. Other types are ignored, but 
  104. an informative message is printed. Normally the files are stored "as 
  105. is" (except for illegal character substitution), but you can have the file 
  106. type added as an extension using the EXT option.
  107.     I should note that there is another freely-available program 
  108. that performs the same function as GetFiles: UNd64 by Jess Sos
  109. noski. If you are dissatisfied with GetFiles for some reason, I sug
  110. gest you try UNd64. The only major advantage to using GetFiles is 
  111. that it can detect the "LAZARUS" signature.
  112.  
  113. Speed
  114.  
  115. Command line: speed DriveNumber
  116. DriveNumber: drive number (0-3)
  117.  
  118.     The "speed" program measures the drive speed in RPM 
  119. (revolutions per minute). Normal drive speed is 300RPM. "Speed" 
  120. will continuously print the drive speed to the console (as usual, hit 
  121. Control-C to exit). You must have a disk inserted in the drive or 
  122. "speed" will not function.
  123.     In case you're curious, "speed" works by measuring the time 
  124. between index pulses. A simple index interrupt routine takes a 
  125. time-stamp of the "E clock" (CIA .7Mhz clock).
  126.  
  127.  
  128.