home *** CD-ROM | disk | FTP | other *** search
/ Amiga ISO Collection / AmigaUtilCD1.iso / Disk&HD / LSD-LOS.LHA / MultiDiskTrackLoader.Docs < prev    next >
Encoding:
Text File  |  1980-01-15  |  5.4 KB  |  138 lines
  1.  
  2.            MultiDiskTrackLoader V1.1- System-Free Dos Block Loader! 
  3.            -------------------------------------------------------
  4.  
  5.                          By Phil!94/LSD 26/4/94.
  6.  
  7.  Wanna contact me? I'm at: 43 Fairholme Rd,  
  8.                            Hodge Hill,
  9.                            Birmingham,
  10.                            B36 8HN.
  11.                            England.
  12.  
  13. DESCRIPTION
  14. -----------
  15.  
  16. This piece of code enables you to load bytes off dos tracks directly from
  17. disks in a multi-disk / multidrive environment without using the ROM system
  18. software. You can load from any of 127 disks and all drives df0-df4
  19. (as available) will be checked for the disk you require OR you can access
  20. a drive directly - Full error checking is provided.
  21.  
  22. LOADING:
  23. --------
  24.  
  25. You MUST call "INIT_DISK" before loading any data for the 1st ever time!
  26. This initializes the drives and variables - you never need to call this
  27. routine again, not even after 'MOTOR_OFF'.
  28.  
  29.  To LOAD, First set the registers A6, D5, D6 and D7 as shown:-
  30.  
  31.  Move.L #Destination Address,A6
  32.  Moveq  #Disk / Drive Number to load from,D5 (See below)
  33.  Move.l #Bytes to load,D6
  34.  Move.w #Starting Block ($0-$6df),D7
  35.  
  36. There are 2 ways of setting D5, If you want to load from a named DISK
  37. then just set D5 with Moveq #disk,D4.. BUT if you want to directly access
  38. a drive Make sure the high word of D5 is -1 and the low word is the drive
  39. number. EG:- Move.l #$ffff000x,d5.. Where x is the drive 0 - 3.
  40.  
  41. Then call: "BLOCK_LOAD" - All registers preserved except D7.
  42.  
  43.  D7 returns as 00 is load OK. Else one of the following errors:
  44.  
  45.  01 = No speed signal from motor   (disk ejected whilst loading)
  46.  02 = No DMA transfer time out     (no sync / ''            '' )
  47.  03 = Disk removed from drive      (whilst loading)
  48.  04 = Can't find that disk block   (disk corrupt)
  49.  05 = Wrong track marker ID        ('')
  50.  06 = Checksum error on disk block ('')
  51.  07 = Block number req'd too big   (you've (in)directly asked for >$6df)
  52.  08 = Disk requester               (Disk specifified in D5 isnt inserted)
  53.  09 = No disk in that drive        (Direct drive access failed)
  54.  0A = That drive is not connected  (''                      '')
  55.  
  56. 'NAMING' DISKS
  57. --------------
  58.  
  59. This system does not use the names on the root block $370 as for normal
  60. file type loading as you dont really want a pointless root block stuck 
  61. right in the middle of your data tracks. So disks are identified by the
  62. 2 words at $8 & $a on the boot block. The first should be $5052 (ascii "PR")
  63. to identify disks that are to work with this loader. The next word should
  64. be $00xx where xx is the disk number from $00 to $7f.. This system does not
  65. appear to stop the Amiga booting the disks!
  66.  
  67. DISK REQUESTS
  68. -------------
  69.  
  70. If error report occurs, its up to you to display an appropiate message
  71. (or disk requester in the case of error $08).. You can then if you want
  72. jump straight back to your 'set-registers and call load' bit of code as
  73. the program switches off the drive, and waits 1 second before exit.IE: It
  74. does things properly NOT leaving the motor running for example! Actual
  75. MFM (disk corrupt) errors are only returned after the program has tried
  76. to re-read the dodgey track 12 times! - during which time it will have
  77. reset the disk head etc in case of alignment problems.
  78.  
  79. IMPORTANT!
  80. ----------
  81.  
  82. To shut down the drive after youve finished loading for a while - call 
  83. "MOTOR_OFF" - I did not make this automatic as it would have meant stopping
  84. and restarting the motor needlessly and wasting time waiting for the motor
  85. to reach the right speed between loads. The motor will only be left running
  86. (ready for the next load) if there was no error return! The code will always
  87. sense if the motor needs to be restarted and will perform this task.
  88.  
  89. GENERAL INFO
  90. ------------
  91.  
  92. The loader contains thorough error checking and should not lock up.
  93. You can even eject a disk whilst loading and it will return an error as
  94. normal! I've tested it on A500-A1200 with no problems - Timing is made
  95. using CIAB timer b so CPU speed will make NO difference. It doesnt generate
  96. any interrupts, lock out any interupts or use the blitter. The code is
  97. obviously not designed to multitask - you'd use TRACKDISK_DEVICE for
  98. system friendly loading! -So make sure you knock out the system IRQs when
  99. testing. You can run your own interrupts whilst loading takes place
  100. (EG:copper,VBL etc - but be careful if using the cia's!)
  101.  
  102. The example call on the source returns to dos after completion, this is
  103. only for test purposes.. DO NOT attempts any further normal dos disk activity
  104. cus the Amiga will not realize that the heads have been shifted etc and it
  105. probably will corrupt your disk(s).. Also the example calls have a large
  106. load buffer for testing (128k) so dont be put off by the executable file
  107. size!
  108.  
  109. Abrieviated info also contained at the start of the source code together
  110. with an example load call. For simple 1 drive loading see the source and
  111. docs for "TrackLoader".
  112.  
  113. -----------------------------------------------------------------------------
  114.  
  115. QUICK EXAMPLE OF USE:
  116.  
  117.     move.w #$4000,$dff09a    ;Disable Irqs
  118.  
  119.     JSR INIT_DISK
  120.  
  121. GO    move.w #$1,d5        ;load from disk named 1
  122.     move.l #$12345,d6        ;bytes to load
  123.     move.w #$370,d7        ;start at block $370
  124.     move.l #$c0000,a6        ;load address
  125.     jsr BLOCK_LOAD
  126.     tst.w d7            ;how did it go?
  127.     beq.s LOAD_OK
  128.  
  129.      bsr SHOW_ERROR_REPORT    ;your routine
  130.     
  131. LOAD_FINE    bsr MOTOR_OFF
  132.     
  133.     move.w #$c000,$dff09a
  134.     rts
  135.  
  136. -----------------------------------------------------------------------------
  137.  
  138.