=========================================================================== FS1541 v1.0 =========================================================================== (C) Copyright 1996-1997 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 reads and writes 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. In order to process 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 --------------------------------------------------------------------------- There are two versions of 1541-handler, one for plain 68000 machines and one optimized for the 68030 processor (which will also work fine on an 68020). Copy the respective file to "L:1541-handler". Then 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 works okay as long as the BAM is not corrupt. Unfortunately, this version does not feature a disk validator, but I will add that. You need the multidisk.device 2.0 to be able to write and format disks (with fmsdisk.device it's no problem, of course). There are four so-called "virtual" files, which don't appear in the directory and serve special purposes: $ Contains an ANSIfied directory as it would be given by a C64/1541 with LOAD "$",8 and LIST. $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! You can also write to this file and modify the disk directly in a file monitor. After modifying I suggest you issue a 'diskchange' command. $opt If you access this file in any way, e.g. by means of type or delete, the directory is optimized: All (invisible and visible) DEL entries are thrown out. You must know that files are not deleted completely with "delete", but rather set to DEL instead. This operation discards those directory entries. Disk.info Provides a disk icon for Workbench. The last file can be overridden, i.e. you can create a real file called `Disk.info' on the disk which will be visible then. If you delete it, the virtual file will become active again. When formatting disks, the system is told the disk consists of one big cylinder. This is due to the variable track layout on a 1541 disk! --------------------------------------------------------------------------- >>> HISTORY --------------------------------------------------------------------------- v1.0 (20-Jan-96) - You can rename files and disks now! - Writing many small files is faster, since the BAM update is done only once: one second after the last access, just like the ROM FileSystem does it. - Removed bug in ACTION_PARENT v0.7 (15-Dec-96) - Block allocation assumed a wrong BAM structure, now fixed. - Virtual file '$opt' - Formatting - Everything works fine with the new multidisk.device 2.0! v0.6 (08-Dec-96) - You can write files now! - Virtual file '$' - Some small bugs fixed v0.5 (24-Nov-96) - First public release A detailed list of changes can be found in file "ChangeLog". Thanks must go to John Selck (Graham/Oxyron) for his numerous hints and tips to the structure of 1541 disks. My documents contained many errors! Without him this FileSystem wouldn't be so stable. --------------------------------------------------------------------------- >>> FUTURE --------------------------------------------------------------------------- - Virtual file $val, which can be used to validate disks. - ACTION_SET_FILE_SIZE - ACTION_EXAMINE_FH --------------------------------------------------------------------------- >>> WHAT ABOUT THE SOURCE CODE? --------------------------------------------------------------------------- FS1541 was entirely written using GCC 2.7.2.1 from the ADE as found on ftp.ninemoons.com or the Geek Gadgets 1 CD. 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 (available from Vesalia Germany), 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!