home *** CD-ROM | disk | FTP | other *** search
/ Amiga ISO Collection / AmigaUtilCD1.iso / Disk&HD / LSD-LOS.LHA / TrackLoader.Docs < prev    next >
Encoding:
Text File  |  1980-01-15  |  4.3 KB  |  116 lines
  1.  
  2.      TrackLoader  -  System-Free Sector Loader V1.1- By Phil!94 26/4/94.
  3.      ------------------------------------------------------------------
  4.  
  5.  Wanna contact me? I'm at: 43 Fairholme Rd,  
  6.                            Hodge Hill,
  7.                            Birmingham,
  8.                            B36 8HN.
  9.                            England.
  10. DESCRIPTION
  11. -----------
  12.  
  13. This piece of code is a cut down version of MultiDiskTrackLoader and
  14. enables you to load data from dos blocks from a disk in one drive only.
  15.  
  16. You can set the label DRIVE to any drive number IE: 00 - 03 but this
  17. is only for test purposes - If you want to access more than one drive
  18. use the MULTIDISK version.
  19.  
  20. LOADING A FILE:
  21. ---------------
  22.  
  23. Before loading for the 1st time ONLY, you MUST call "INIT_DISK".
  24. You will never need to call it again.
  25.  
  26. To load, you should preset the registers A6,D6 and D7 as shown:
  27.  
  28. Move.w #xxxx,D7     - The start block of the read ($0-$6df)
  29. Move.l #xxxxxxxx,D6 - The number of bytes you wish to load.
  30. move.l #xxxxxxxx,A6 - The load address in RAM.
  31.  
  32. BSR/JSR: "BLOCK_LOAD" (All Registers are preserved-except D7)
  33.  
  34.  D7 - Returns as 00 upon a successful load. Else it will be:
  35.  
  36.  01 = No speed signal from motor
  37.  02 = No DMA transfer - time out
  38.  03 = Disk removed from drive
  39.  04 = Can't find that disk block   (disk corrupt)
  40.  05 = Wrong track marker ID        ('')
  41.  06 = Checksum error on disk block ('')
  42.  07 = Block number out of range    (>$6df)
  43.  
  44. If error report occurs, its up to you to display an appropiate message
  45. (or disk requester in the case of error $03).. You can then if you want
  46. jump straight back to your 'set-registers and call load' bit of code as
  47. the program switches off the drive, and waits 1 second before exit.IE: It
  48. does things properly NOT leaving the motor running for example! Actual
  49. MFM (disk corrupt) errors are only returned after the program has tried
  50. to re-read the dodgey track 12 times! - during which time it will have
  51. reset the disk head etc in case its an alignment problem.
  52.  
  53. IMPORTANT:-
  54. -----------
  55.  
  56. To shut down the drive after youve finished loading for a while - call 
  57. "MOTOR_OFF"!!!
  58.  
  59. I did not make this automatic as it would have meant stopping and restarting
  60. the motor needlessly and wasting time waiting for the motor to reach the
  61. right speed between each load. The motor will only be left running (ready
  62. for next load) if there has not been any error report! The code will always
  63. sense if the motor needs to be restarted and will perform this task.
  64.  
  65. The code contains an MFM buffer - if you select a short load from near the
  66. same place as the previous load, the drive may not actually start as the
  67. data will be fetched from the buffer.
  68.  
  69. GENERAL INFO
  70. ------------
  71.  
  72. The loader contains thorough error checking and should not lock up.
  73. You can even eject a disk whilst loading and it will return an error as
  74. normal! I've tested it on A500-A1200 with no problems - Timing is made
  75. using CIAB timer b so CPU speed will make NO difference. It doesnt generate
  76. any interrupts, lock out any interupts or use the blitter. The code is
  77. obviously not designed to multitask - you'd use TRACKDISK_DEVICE for
  78. system friendly loading! -So make sure you knock out the system IRQs when
  79. testing. You can run your own interrupts whilst loading takes place
  80. (EG:copper,VBL etc - but be careful if using the cia's!)
  81.  
  82. The example call on the source returns to dos after completion, this is
  83. only for test purposes.. DO NOT attempts any normal dos disk activity cus
  84. the Amiga will not realize that the heads have been shifted etc and it
  85. probably will corrupt your disk(s).. Also the example calls have a large
  86. load buffer for testing (128k) so dont be put off by the executable file
  87. size!
  88.  
  89. Abrieviated info also contained at the start of the source code together
  90. with an example load call. For multidisk/multidrive loading see the docs
  91. for "MultiDiskTrackLoader".
  92.  
  93. -----------------------------------------------------------------------------
  94.  
  95. QUICK EXAMPLE OF USE:
  96.  
  97.     move.w #$4000,$dff09a    ;Disable Irqs
  98.  
  99. GO    move.w #$370,d7        ;start at block $370
  100.     move.l #$12345,d6        ;bytes to load
  101.     move.l #$c0000,a6        ;some address
  102.  
  103.     jsr BLOCK_LOAD
  104.  
  105.     tst.w d7            ;how did it go?
  106.     beq.s LOAD_OK
  107.                   
  108.     bsr SHOW_ERROR_REPORT    ;your routine
  109.     
  110. LOAD_OK    bsr MOTOR_OFF
  111.     move.w #$c000,$dff09a
  112.     rts
  113.  
  114. -------------------------------------------------------------------------------
  115.  
  116.