home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format CD 17 / amigaformatcd17.iso / -in_the_mag- / emulation / otherstuff / fs1541 / fs1541.doc < prev    next >
Text File  |  1997-07-01  |  8KB  |  200 lines
  1.  
  2. ===========================================================================
  3.                                 FS1541 v1.2
  4. ===========================================================================
  5.  
  6.                 (C) Copyright 1996-1997 by Michael Krause.
  7.                        This production is FreeWare!
  8.  
  9. ===========================================================================
  10.  
  11.  
  12. ---------------------------------------------------------------------------
  13. >>> INTRODUCTION
  14. ---------------------------------------------------------------------------
  15.  
  16. Forget all those nasty tools to read files from 1541 disks:
  17.  
  18. FS1541 is a full-blown AmigaDOS file system, which reads and writes the CBM
  19. 1541  disk  format.   The  CBM 1541 floppy drive has been the standard disk
  20. drive  for the C64 computer series, and many people still have disks flying
  21. around.   In  order  to  process  disks  directly, you need the >Catweasel<
  22. floppy  disk  controller  and a 5.25 inch drive, without it you have to get
  23. "fmsdisk.device" from Aminet or somewhere, which lets you operate on ".d64"
  24. disk image files.
  25.  
  26. You can gather more information about Catweasel:
  27. - from the author himself, Jens Schönfeld <sysop@nostlgic.tng.oche.de>
  28. - from http://www.rat.de/apd/CATWEASL.HTM
  29.  
  30.  
  31. ---------------------------------------------------------------------------
  32. >>> INSTALLATION
  33. ---------------------------------------------------------------------------
  34.  
  35. There  are  two  versions of 1541-handler, one for plain 68000 machines and
  36. one  optimized  for  the  68030  processor (which will also work fine on an
  37. 68020).   Copy  the  respective  file  to  "L:1541-handler".   Then add the
  38. following lines to "DEVS:MountList":
  39.  
  40. CBM0:
  41.         Handler = L:1541-handler
  42.         Stacksize = 4096
  43.         Priority = 10
  44.         GlobVec  = -1
  45.         Mount = 1
  46.         Startup = "DEVICE multidisk.device UNIT 1"
  47. #
  48.  
  49. Explanation of options:
  50.  
  51.         D=DEVICE/A      Name of a trackdisk.device compatible device.
  52.                         Supported and tested are "multidisk.device" and
  53.                         "fmsdisk.device".
  54.  
  55.         U=UNIT/N/A      Exec device unit. 0 or 1 for "multidisk.device",
  56.                         see docs for "fmsdisk.device".
  57.  
  58.         F=FLAGS/N       Exec device flags. Defaults to 16 for multidisk.
  59.  
  60.         NS=NOAUTOSCAN/S Don't read complete disk after insertion.
  61.  
  62.         I=INTERLEAVE/N  Sector interleave when writing data. Defaults to 4.
  63.  
  64.         ICON/K          Followed by the complete pathname of an alternative
  65.                         file used as Disk.info. There are two icons in this
  66.                         archive, the ugly one painted by me is included in
  67.                         the executable as the default icon.
  68.  
  69.  
  70. ---------------------------------------------------------------------------
  71. >>> USAGE
  72. ---------------------------------------------------------------------------
  73.  
  74. Issue  the  command  `mount  cbm0:', and insert disks.  Write support works
  75. okay  as  long as the BAM is not corrupt.  Unfortunately, this version does
  76. not  feature  a  disk  validator,  but  I  will  add  that.   You  need the
  77. multidisk.device   2.0   to  be  able  to  write  and  format  disks  (with
  78. fmsdisk.device it's no problem, of course).
  79.  
  80. There  are  four  so-called  "virtual"  files,  which  don't  appear in the
  81. directory and serve special purposes:
  82.  
  83.         $               Contains an ANSIfied directory as it would be given
  84.                         by a C64/1541 with LOAD "$",8 and LIST.
  85.  
  86.         $d64            Access the .d64 file corresponding to the current
  87.                         disk. E.g. you can use `copy cbm0:$d64 ram:dsk.d64'
  88.                         to create .d64 images of your disks very easily!
  89.                         You can also write to this file and modify the disk
  90.                         directly in a file monitor. After modifying I
  91.                         suggest you issue a 'diskchange' command.
  92.  
  93.         $opt            If you access this file in any way, e.g. by means
  94.                         of type or delete, the directory is optimized: All
  95.                         (invisible and visible) DEL entries are thrown out.
  96.                         You must know that files are not deleted completely
  97.                         with "delete", but rather set to DEL instead.
  98.                         This operation discards those directory entries.
  99.  
  100.         Disk.info       Provides a disk icon for Workbench. See `ICON'
  101.                         startup option.
  102.  
  103. The  last  file  can be overridden, i.e.  you can create a real file called
  104. `Disk.info'  on the disk which will be visible then.  If you delete it, the
  105. virtual file will become active again.
  106.  
  107. When  formatting  disks,  the  system  is told the disk consists of one big
  108. cylinder.  This is due to the variable track layout on a 1541 disk!
  109.  
  110.  
  111. ---------------------------------------------------------------------------
  112. >>> HISTORY
  113. ---------------------------------------------------------------------------
  114.  
  115. v1.2 (29-May-97)
  116. - Fixed possible crash when mounting the device from DEVS:DOSDrivers,
  117.   before the Workbench is started.
  118. - Included disk icon from Thomas Broß and the ICON startup option.
  119.  
  120. v1.1 (19-Feb-97)
  121. - Bug fixed in handling of unformatted disks.
  122. - German translation of TFM
  123.  
  124. v1.0 (20-Jan-97)
  125. - You can rename files and disks now!
  126. - Writing many small files is faster, since the BAM update is done only
  127.   once: one second after the last access, just like the ROM FileSystem
  128.   does it.
  129. - Removed bug in ACTION_PARENT
  130.  
  131. v0.7 (15-Dec-96)
  132. - Block allocation assumed a wrong BAM structure, now fixed.
  133. - Virtual file '$opt'
  134. - Formatting
  135. - Everything works fine with the new multidisk.device 2.0!
  136.  
  137. v0.6 (08-Dec-96)
  138. - You can write files now!
  139. - Virtual file '$'
  140. - Some small bugs fixed
  141.  
  142. v0.5 (24-Nov-96)
  143. - First public release
  144.  
  145. A detailed list of changes can be found in file "ChangeLog".
  146.  
  147.  
  148. Thanks  must  go  to  John Selck (Graham/Oxyron) for his numerous hints and
  149. tips  to  the structure of 1541 disks.  My documents contained many errors!
  150. Without him this FileSystem wouldn't be so stable.
  151.  
  152.  
  153. ---------------------------------------------------------------------------
  154. >>> FUTURE
  155. ---------------------------------------------------------------------------
  156.  
  157. - Virtual file $val, which can be used to validate disks.
  158. - ACTION_SET_FILE_SIZE
  159. - Linux port (as soon as I've figured out how the kernel works...)
  160.  
  161.  
  162. ---------------------------------------------------------------------------
  163. >>> WHAT ABOUT THE SOURCE CODE?
  164. ---------------------------------------------------------------------------
  165.  
  166. FS1541  was  entirely  written  using  GCC 2.7.2.1 from the ADE as found on
  167. ftp.ninemoons.com or the Geek Gadgets 1 CD.  The source code is IMHO a good
  168. example of how AmigaDOS handlers work.
  169.  
  170.  
  171. ---------------------------------------------------------------------------
  172. >>> WHERE TO FIND THE AUTHOR:
  173. ---------------------------------------------------------------------------
  174.  
  175. Michael Krause
  176. Mannesallee 24
  177. 21107 Hamburg
  178.  
  179. rawstyle@ms.demo.org
  180.  
  181. http://ms.demo.org/
  182.  
  183.  
  184. ---------------------------------------------------------------------------
  185. >>> LEGAL MUSH!
  186. ---------------------------------------------------------------------------
  187.  
  188. This  program  is  FreeWare,  which  means that it may be spread as long as
  189. nothing  is charged for it.  It may not be enclosed in commercial packages.
  190. The  one  and  only  exception to this rule is the great >Catweasel< floppy
  191. disk  controller (available from Vesalia Germany), which includes this file
  192. system.   The  controller  lets you use standard PC disk drives to read and
  193. write  PC and Amiga DD/HD disks at a much higher speed than provided by the
  194. Amiga  custom  chips.   When  used with a 5.25 inch disk drive, you can use
  195. this file system to process 1541 disks directly.
  196.  
  197. Neither  the  author  nor  any  other  individual, besides perhaps the user
  198. himself,  can  be  held  reliable  for  damages caused by (mis-)use of this
  199. software!
  200.