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