
===========================================================================
                                FS1541 v0.5
===========================================================================

                   (C) Copyright 1996 by Michael Krause.
                       This production is FreeWare!

===========================================================================


---------------------------------------------------------------------------
>>> INTRODUCTION
---------------------------------------------------------------------------

Forget all those nasty tools to read files off 1541 disks:

FS1541  is  a full-blown AmigaDOS file system, which processes the CBM 1541
disk  format.   The  CBM 1541 floppy drive has been the standard disk drive
for  the  C64  computer  series,  and  many  people still have disks flying
around.   For  processing  disks  directly, you need the >Catweasel< floppy
disk  controller  and  a  5.25  inch  drive,  without  it  you  have to get
"fmsdisk.device" from Aminet or somewhere, which lets you operate on ".d64"
disk image files.


---------------------------------------------------------------------------
>>> INSTALLATION
---------------------------------------------------------------------------

Copy "1541-handler" to L:.  Add the following lines to "DEVS:MountList":

CBM0:
        Handler = L:1541-handler
        Stacksize = 4096
        Priority = 10
        GlobVec  = -1
        Mount = 1
        Startup = "DEVICE multidisk.device UNIT 1"
#

Explanation of options:

        D=DEVICE/A      Name of a trackdisk.device compatible device.
                        Supported and tested are "multidisk.device" and
                        "fmsdisk.device".

        U=UNIT/N/A      Exec device unit. 0 or 1 for "multidisk.device",
                        see docs for "fmsdisk.device".

        F=FLAGS/N       Exec device flags. Defaults to 16.

        NS=NOAUTOSCAN/S Don't read complete disk after insertion.

        I=INTERLEAVE/N  Sector interleave when writing data. Defaults to 4.


---------------------------------------------------------------------------
>>> USAGE
---------------------------------------------------------------------------

Issue  the  command  `mount  cbm0:',  and  insert  disks.  Write support is
currently  very rudimentary (if not non-existent), don't rely on it working
correctly!   There are two so-called "virtual" files, which don't appear in
the directory and serve special purposes:

        $d64            Access the .d64 file corresponding to the current
                        disk. E.g. you can use `copy cbm0:$d64 ram:dsk.d64'
                        to create .d64 images of your disks very easily!

        Disk.info       Provides a disk icon for Workbench.


---------------------------------------------------------------------------
>>> HISTORY
---------------------------------------------------------------------------

See accompanying file "ChangeLog".


---------------------------------------------------------------------------
>>> FUTURE
---------------------------------------------------------------------------

There is still a lot to do, most important are complete write support and a
virtual file "$" which contains the disk's directory as displayed by a C64,
and some other goodies.  I'll be back!


---------------------------------------------------------------------------
>>> WHAT ABOUT THE SOURCE CODE?
---------------------------------------------------------------------------

FS1541  was  entirely  written  using  GCC  2.7.2  from the ADE as found on
ftp.ninemoons.com.   The  source  code  is  a  good example of how AmigaDOS
handlers work.


---------------------------------------------------------------------------
>>> WHERE TO FIND THE AUTHOR:
---------------------------------------------------------------------------

Michael Krause
Mannesallee 24
21107 Hamburg

rawstyle@blackbox.dame.de
ii7349@fh-wedel.de

http://www.szczecin.pl/~rawstyle/


---------------------------------------------------------------------------
>>> LEGAL MUSH!
---------------------------------------------------------------------------

This  program  is  FreeWare,  which  means that it may be spread as long as
nothing  is charged for it.  It may not be enclosed in commercial packages.
The  one  and  only  exception to this rule is the great >Catweasel< floppy
disk  controller, which includes this file system.  The controller lets you
use standard PC disk drives to read and write PC and Amiga DD/HD disks at a
much  higher speed than provided by the Amiga custom chips.  When used with
a  5.25 inch disk drive, you can use this file system to process 1541 disks
directly.

Neither  the  author  nor  any  other  individual, besides perhaps the user
himself,  can  be  held  reliable  for  damages caused by (mis-)use of this
software!
