home *** CD-ROM | disk | FTP | other *** search
/ World of A1200 / World_Of_A1200.iso / programs / disk / misc / pfs / tools / diskspare2.2 / doc < prev    next >
Text File  |  1995-02-27  |  13KB  |  335 lines
  1.                  DiskSpareDevice 2.2
  2.  
  3.                 written and (c) 1992-1994
  4.                   by Klaus Deppisch
  5.                  All rights reserved
  6.  
  7.  What is diskspare.device:
  8.  
  9.     It is a completion or replacement of the trackdisk.device,
  10.     which lets you format your disks with 960 kB or 984 kB, or if
  11.     you've got a (trackdisk-compatible!) HD-Drive with 1920 kB
  12.     or 1968 kB !!!
  13.     
  14.  How could this be:
  15.     
  16.     I've changed the track-construction a little bit. In detail I
  17.     left out the (unused) sector-headers and read/write some 
  18.     bytes more than the trackdisk.device.
  19.     The result: I can read/write 12 sectors/track (HD: 24)!
  20.     
  21.     By the way, ALL the drives I tested were able to read/write
  22.     more than 12 sectors (at least 12.4 sectors but unfortunately
  23.     no 25 sectors in HD-Mode).
  24.     -> There should be no problems.
  25.     
  26.     The device is able to read/write 12*160*512 = 983040 Bytes.
  27.     Or (new for v1.6) 12*164*512 = 1007616 Bytes (984K)
  28.     Or (new for v2.0) 24*160*512 = 1966080 Bytes (1920K)
  29.     or          24*164*512 = 2015232 Bytes (1968K)
  30.  
  31.     The HD-Mode is compatible to my 'highdensity.device' which
  32.     is now dead.
  33.     
  34.     The device can be used now with the ProfFilesystem of Michiel Pelt.
  35.     Please don NOT use the version 2.0 of the device. The motor of the 
  36.     drive stays on all the time AND version 2.0 may cause read/write
  37.     errors. There are Mountfiles (for WB 2.1/3.0 only) in the DD and HD 
  38.     drawer called PS0 and PS1. (Names (PSx) are from Brett Simcock)
  39.  
  40.     When you mount the device you can use it like any other disk
  41.     or partition. That means you can access it with your favourite
  42.     dir-util, format, diskcopy  or whatever you want to do with it.
  43.  
  44.  What do you need:
  45.  
  46.     - Kickstart 2.0 or higher    (NO WAY to get it run < KS 2.0 !)
  47.     - diskspare.device             (here it is)
  48.     - mountlist-entry        (included)
  49.     - a floppy-drive        (you should have one)
  50.     - an Amiga            (hmm..)
  51.     
  52.  What to do:
  53.  
  54.     - read this doc-file (the WHOLE crap !!!)
  55.     - copy the file 'diskspare.device' into your DEVS: directory.
  56.     - append the file 'Mountlist' to your Mountlist (to be found
  57.       in your DEVS: directory).
  58.     - insert the lines 'mount DS0:' and 'addbuffers DS0: >NIL:'
  59.       (or DS1-3) into your 'User-Startup' (can be found in S:)
  60.     - OR if you're using WB 2.1/3.0 copy the File(s) DS0-DS3 into
  61.       your DEVS:DosDrivers directory.    
  62.     - OR use the included install sripts (new for v2.0).
  63.     - reboot your Amiga
  64.     
  65.     The line 'addbuffers DSX: >NIL:' is necessary to make the
  66.     device 'visible'. It's better to use this than to modify
  67.     the mountlist with 'Mount = 1' because then you'll get a
  68.     'no disk'-requester when mounting. (only for WB2.0) 
  69.     For Workbench 2.1 and above you can use the 'Mount = 1'.
  70.     
  71.     NOTE:
  72.     If you don't use the 'addbuffers' or 'mount = 1' the device 
  73.     won't be mounted correctly until you access it. That will
  74.     cause some programs to crash !! That's another oddity of the
  75.     workbench! See 'LoadWB' below.
  76.     
  77.     For a quick test simply doubleclick the QuickTest Icon. 
  78.     Please note: You won't get a Disk Icon for unformatted Disk on 
  79.     the Workbench (the same for all devices you mount after LoadWB).
  80.     So you need the Shell to format the disk the first time. 
  81.     (format drive DS0: name Test)
  82.  
  83.  Examples:
  84.      
  85.  1.    You've got two drives and want to use 'DF1' as 'DS1'.
  86.      You've copied the file 'diskspare.device' and appended 'Mountlist'
  87.      to your Mountlist (do *** NOT *** simply COPY it to devs: or your
  88.      personal Mountlist will be LOST !!!). 
  89.     
  90.     To test whether it works (or not) open a Shellwindow and type 
  91.     'mount DS1: <return>' then 'dir DS1: <return>'. You should 
  92.     see a requester now 'No disk present in device DS1', cancel it.
  93.     Insert a blank (or empty) disk into your drive and type:
  94.     'format drive DS1: name test noicons<return>'.
  95.     The disk should be formatted like any other disk. After format 
  96.     type 'info <return>' you should find a line like this:
  97.     'DS1:      983K      1966      2   0%   0  Read/Write test'
  98.     this means that everything works fine and you're able 
  99.     to use this disk like any other disk.
  100.     
  101.  2.    If you've only got one drive and want to use it as 'DS0'.
  102.      You've copied the file 'diskspare.device' and appended 'Mountlist'
  103.      to your Mountlist (do *** NOT *** simply COPY it to devs: or your
  104.      personal Mountlist will be LOST !!!). 
  105.     
  106.     Follow the test-procedure as above.
  107.     After 'info' you should see a line like this:
  108.     'DS0:    983K    1966     2   0%   0  Read/Write test'.
  109.  
  110.  3.    You're the proud owner of an Amiga 4000 and want to use your
  111.      internal 'DF0:' as DS0:. You only have to copy the file
  112.      'diskspare.device' to DEVS: and the Mountlist-File from the
  113.      'HD'-Drawer (!) into your 'Devs:DOSDrivers' Drawer.
  114.  
  115.  
  116.  What problems could arise ?
  117.     
  118.     - If you modify the icons for WB 2.1/3.0, check if they 
  119.       have the right unit-number (use information from the
  120.       icons-menu). (There needn't be a number in the icon.
  121.       I forgot to remove it in the first release...)
  122.     - Mount returns an error: 'Entry not found' -> check if you 
  123.       really appended the mountlist and typed the right name
  124.     - dir returns an error: 'device or directory not mounted' ->
  125.       did you copy the device to devs: or did you try to access
  126.       an invalid drive (if you've got df0: and df1: you can't
  127.       mount ds2:. It's logical, or what !!!)
  128.     - format returns: 'no disk inserted' -> you must wait a
  129.       few seconds after inserting a disk (trackdisk must access
  130.       the disk first)
  131.     - format returns: 'format failed try another disk' -> do so
  132.     - format returns always the above -> it looks like you've
  133.       got a drive that doesn't work -> try another drive or 
  134.       curse me and delete all 'diskspare-files'.
  135.  
  136.  
  137.  NOTES:
  138.  
  139.        -This is NO easy using program! That means, You should know
  140.     what you're doing.
  141.     If you don't know how to use the Shell and how to edit a mountlist
  142.     and user-startup read the manual that came with your machine!
  143.     Or ask a friend to help you.
  144.     Or use the included install scripts.    
  145.     
  146.        -If you mount the device after 'LoadWB' there will be no Icons
  147.     for unformatted disks or during format,diskcopy etc. that say 
  148.     'DSX:BAD' or 'DSX:BUSY'. 
  149.     This isn't a bug of my device but an oddity of the Workbench.
  150.     (It's the same if you mount RAD: or any other device AFTER
  151.     'LoadWB').
  152.     
  153.        -If you use the device for 984K disks NOTE that it IS a HACK! 
  154.     Normally you CAN'T read/write Cyl. 80/81 via trackdisk.device.
  155.     It's only possible due to a PATCH of a PRIVATE device.structure!
  156.     I tried to make it as safe as possible and it works fine with
  157.     KS2.0/KS3.0 but there's NO GUARANTEE that it will work with 
  158.     future releases. (Until I fix it).
  159.     
  160.        -The Autoswitch DD<->HD is only possible due to a PATCH of a PRIVATE
  161.     structure in the FFS. The second nasty hack! (I hope the last one)
  162.     It's necessary because the FFS allows only the trackdisk.device 
  163.     to change the capacity during operation. If the devicename isn't 
  164.     'trackdisk.device' it NEVER calls GETGEOMETRY.
  165.     p.s. Works fine with KS2.0/KS3.0
  166.     
  167.        -It might be possible that there are drives which can't
  168.     read/write up to Cyl.81 (I've never seen one).
  169.  
  170.        -It's currently impossible to mount two drives on the same unit.
  171.         With the FastFilesystem only. If you use another filesystem, which
  172.         uses AddChangeInt instead of Remove (e.g. ProfFileSystem) you may
  173.         mount more than two drives.    
  174.  
  175.  Bonus:
  176.  
  177.     If you use diskspare.device you won't have any problems with
  178.     bootblock-viruses because they try to write single sectors via
  179.     trackdisk.device. Trackdisk can't read the track so it can't
  180.     write single sectors!
  181.     If there should be a virus which is able to write itself to
  182.     the first blocks of a diskspare-disk then this will be it's
  183.     last activity because the device can't be made resident ->
  184.     you can't boot from this disk -> the virus won't be executed!
  185.  Note:
  186.     The Install command checks for trackdisk.- and carddisk.device.
  187.     So you can't install ANY other disks. 
  188.  
  189.  
  190.  Some details:
  191.  
  192.  1.    Safety:
  193.      I've tested the device since Dec. 1992 on different Amigas
  194.      (A500-A4000) and I've copied (nearly) all my disks to diskspare-
  195.      format. I use the cheapest No-Name-Disks and there weren't any
  196.      problems (yet).
  197.      All updates and enchantments made, concerning the 
  198.      device-routines and not the track-construction.
  199.      
  200.      The only problem could be the floppy-drive. There're so many
  201.      different types (I've got 6 drives of 4 different manufacturers)
  202.      that it might be possible that one of them doesn't work.
  203.      
  204.  2.    Speed:
  205.     Diskspare.device is about 5%-15% faster than the trackdisk.device
  206.     (68000 5%, 68020 10%, 68030 15%)
  207.     example:    (A2000 with A2630/25MHz/2Meg)
  208.             kB    sec        speed
  209.     
  210.     format        984    81    ->    12.1 kB/s
  211.             880    83    ->    10.6 kB/s                    
  212.          
  213.  4.    Mountlist:
  214.  
  215.     Flags:
  216.  
  217.     Bit 0:    (1)    0 = Diskchange works only on DSX: (X = 0-3)
  218.                 (you have to do a diskchange for DFX by 
  219.                 hand e.g. 'diskchange df0').
  220.                     1 = Diskchange works on DSX: AND DFX:.        
  221.                 (like CrossDOS).
  222.     Bit 1:    (2)    0 = use only Cyl. 0 to 79 (like trackdisk does)
  223.             1 = allow the device to use also Cyl. 80 and 81
  224.                 You must ALSO change HighCyl to 81 or
  225.                 nothing will happen.
  226.     Bit 2:    (4)    0 = no HD mode allowed
  227.             1 = enables the device to use HD-Disks too.
  228.                 (works LOGICALLY only with HD-Drives!)
  229.     Bit 3:  (8)    0 = use any mem for the trackbuffer
  230.             1 = use mem from $600000 to $A00000 (4M) If the
  231.                 allocation failed, any mem will be used. This 
  232.                 may be useful for A2630 or A3/4000 owners who
  233.                 have got a 16Bit Ramcard.
  234.     
  235.     ALL other values are reserved.
  236.     
  237.     These flags may be different for each drive.
  238.  
  239.     For changing the flags you have to add the values in brackets behind 
  240.     the bitnumbers. e.g. You wish to use bit 1 + 2 (HD with 82 Cyls). So
  241.     you need to add 2 + 4 = 6 = value for the flags.
  242.  
  243.     You may change BlockSize, BlocksPerTrack and Sectors/Block but
  244.     note that a file of even 1 (ONE) Byte length needs 2 blocks
  245.     (FileHeaderBlock & DataBlock). -> if you use big blocks you
  246.     waste A LOT OF disk-space!
  247.     If the HD-Flag is set, you can't change the values for Sectors,
  248.     BlockSize, BlocksPerTrack... They will be overwritten the first
  249.     time a disk is inserted!
  250.     
  251.     BE CAREFUL:
  252.     The entry 'Reserved' MUST BE '2' !!! It cost me a lot of time 
  253.     and nerves because I set it to '0' to get 1K more capacity.
  254.     The only thing I got was curious error-messages! That's 
  255.     obviously a bug in the fastfilesystem.
  256.     
  257.     If you want to waste a lot of speed and capacity you may set
  258.     the 'Buffers < 25' and 'DosType = 0x444f5300'. A good value
  259.     for Buffers is 50 (also for DFx:).
  260.  
  261.  5.    HD-Mode:
  262.     With Bit 2 (Flags in Mountlist) set, the device is enabled to 
  263.     use HD-Drives. It works a little bit differently from the 
  264.     trackdisk.device. Trackdisk allocates and frees the memory 
  265.     for the dmabuffers according to the disk capacity. I don't 
  266.     do so, because if the chipmem is very fragmented or simply 
  267.     not enough of it left, it could be possible that the allocation 
  268.     failed -> No HD-mode possible. So I allocate the buffers when 
  269.     opening the device and keep them until close. -> Make sure the 
  270.     FIRST 'OpenDevice' to a HD-Floppy is made with Bit 2 SET or 
  271.     the HD-Mode won't work!
  272.  
  273.  6.    Copying normal disks to diskspare format:
  274.      You may wish to copy some data from normal (837K) disks to
  275.      diskspare disks (984K) to get some free disks. (You need 8
  276.      d.s. disks for 9 normal disks).     
  277.      The fastest possibility is to mount a RAD: which has the same
  278.      size as a diskspare disk. I've included a sample mountfile
  279.      for 984K (called RDD) and for 1968K (called RHD).
  280.      Now you can copy the files from your normal disks to the RAD
  281.      (RDD or RHD) and then 'diskcopy' it to DSX.
  282.  
  283.  VERSIONS:
  284.     1.6    first public release
  285.         using 'highdensity.device' for HD mode
  286.     
  287.     2.0    now includes HD mode 
  288.     
  289.     2.1    better errorchecking:
  290.         - checks now both for trackdisk and ms-dos format before
  291.           a track is reread !
  292.         - the device does now more retries before an error is
  293.           returned. Do NOT use this to use Disks which can hardly
  294.           be formatted. Such Disks are RUBBISH !!!
  295.         some bugfixes
  296.         
  297.     Because of a misunderstanding with a friend, there was a misrelease
  298.     of the version 2.1. If you find a file 'DiskSpII.lha' please delete
  299.     it immediately! The device itself is (nearly) ok, but the docs don't 
  300.     fit to it.
  301.         
  302.     2.2    some bugfixes again 
  303.         
  304.     
  305.  IMPORTANT:
  306.     The device is FreeWare. You may use it with your own 
  307.     projects until this doc.file and the Mountlist.files are
  308.     distributed with it. You may also use it for commercial 
  309.     programs if you say CLEARLY that this device is FREEWARE!
  310.     You MUSTN'T modify the device itself or this doc.file or
  311.     the MountList.files. Only exception is a translation of 
  312.     this file. If you need a modified/enchanted version 
  313.     please contact me.
  314.  
  315.     This disk-format MUSTN'T be used for stupid NDOS-Games !!!
  316.  
  317.  MOST IMPORTANT:
  318.     You use the above described software at your OWN RISK.
  319.     
  320.     Under NO CIRCUMSTANCES will the author be liable for any
  321.     direct or indirect damage or data loss resulting from 
  322.     the use or misuse of this software or the documents.
  323.     
  324.     All rights are reserved by the author.
  325.     Suggestions and (detailed) bug-reports are welcome.
  326.  
  327.  Author:
  328.     Klaus Deppisch
  329.     Beckenwengert 3
  330.     97246 Eibelstadt 
  331.         Germany
  332.     
  333.     Phone: 09303 1579
  334.                      
  335.