@database "Floppy.guide"
@node Main "Contents"


                      @{fg shine}@{b}Floppy.device 4.3@{ub}@{fg shadow}

                        @{i}BETA release@{ui}



                      @{"Copyright      " link "Copyright"}
                      @{"Introduction   " link "Introduction"}
                      @{"Requirements   " link "Requirements"}
                      @{"Installation   " link "Installation"}
                      @{"Hints And Tips " link "Hints And Tips"}
                      @{"Programing Info" link "Programing Info"}
@endnode

@Node "Copyright"

 @{fg fill}Copyright:@{fg shadow}
 Floppy.device © 1994-98 Orhan Dagistanli.
 All rights reserved.

 @{fg fill}Warranty:@{fg shadow}
 This software is provided "as-is" and subject to change
 without notice; no warranties are made. All use is at your
 own risk. No liability or responsibility is assumed.

 @{fg fill}Freeware:@{fg shadow}
 This archive may be freely redistributed but may not be altered
 in any way and cannot be used for commercial purposes without
 the written permission of the author.


 Email: prohst03@vm.ege.edu.tr (OR)
@endnode

@Node "Introduction"

                       @{fg fill}Introduction@{fg shadow}

 Floppy.device is a replacement for trackdisk.device.

 @{u}Features@{uu}

 - Trackdisk compatible.
 - Faster than trackdisk.
 - Disk size is 1120KB or 2240KB.
@endnode

@Node "Requirements"

 @{fg fill}Requirements:@{fg shadow}
 Kickstart 3.0, M68020


 @{fg fill}Tested at these systems:@{fg shadow}
 A1200


@endnode

@Node "Installation"

                        @{fg fill}Installation@{fg shadow}

 Execute the install script from WorkBench. Script just
 installs for unit 0. For others you should copy FS0 file
 and change the unit numbers in the files.

 If you selected 'FS0:' in the install, double click the FS0
 icon in the Sys:Devs/DosDrivers to mount the drive or enter
 the command:

 @{i}Mount FS0:@{ui}


                    @{fg fill}MultiFileSystem Users@{fg shadow}

 After reboot, you can enter the following commands to format
 a disk from floppy.device:

 (if disk is already formatted from floppy.device)
 @{i}Format drive DF0: name x <quick> <noicons> @{ui}

 (safe method to any disk formatting from floppy.device)
 @{i}Format drive DF0: name x <quick> <noicons> fs=DOS\5@{ui}

 From cli, you should not use
 OFS/FFS/INTL/NOINTL/DIRCACHE/NODIRCACHE
 options because MFS will change the filesystem to DOS\0.

 From WorkBench, you must select filesystem DOS\5 and
 FFS/DIRCACHE options.
@endnode

@Node "Hints and tips"

                       @{fg fill}Hints And Tips@{fg shadow}

- @{i}'Avail flush'@{ui} command removes the device from memory
  if it is closed.
@endnode

@Node "Programing info"

                       @{fg fill}Programing Info@{fg shadow}
                 
- AbortIO() function returns IOERR_NOCMD.
- ETD_XXX, TD_RAWREAD, TD_RAWWRITE commands are not supported.
- DiskChange interrupt works for all devices.
- A private FastFileSystem structure will be patched for
  removable flag.
- TD_REMOVE command is supported but should not be used.
- You must call TD_GETGEOMETRY whenever disk inserted.
- Do not forget to update before TD_MOTOR-off command.
- TD_FORMAT command additionally updates & clears buffers
  but not verifies.
- CMD_UPDATE and CMD_WRITE commands verify the written track.
- Sector checksum & track number will be checked in read op.
- No drive clicks.
- Retry count is one (for read/write/update operations).
- There are two track buffers (lower and upper sides of
  current cylinder).
- Normally track buffers are not affected by disk changes,
  but when density is changed (dd to hd or hd to dd) buffers
  will be cleared.
- FastFileSystem will call CMD_UPDATE and CMD_CLEAR commands
  whenever disk inserted or removed (if it is mounted).
  When removed and buffers were not updated disk-light will
  blink and buffers will be cleared.
@endnode