home *** CD-ROM | disk | FTP | other *** search
/ Amiga ISO Collection / AmigaUtilCD1.iso / Disk&HD / LSD-LOS.LHA / FileLoader.Docs < prev    next >
Encoding:
Text File  |  1980-01-15  |  5.0 KB  |  126 lines
  1.  
  2.           No System File 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.  
  11. This Routine allows you to load AmigaDos standard binary files without
  12. using the ROM system software at all. You give the location of the
  13. filename and where in ram you want the file loaded and the code does the
  14. rest! In this 1 drive version all loads are taken to come from the drive
  15. specified in the label 'DRIVE'. This label is provided for test purposes
  16. more or less. If you want to properly access multiple drives use the 
  17. multidisk version of this routine. Full error return codes are given upon
  18. return from load.
  19.  
  20. The code will let you load files from within subdirectories by simply
  21. adhering to the standard amiga syntax in file names. Eg:to load the file
  22. "Turkey" in directory "FOWL", the filename should be:"FOWL/TURKEY,($00)"
  23. However dont use any fancy wildcards in the filenames etc. Upper/lower
  24. case characters are treated as the same character.
  25.  
  26. LOADING A FILE
  27. --------------
  28.  
  29. Before loading for the 1st time ONLY,you MUST call "INIT_DISK"
  30. You never need to call it again.
  31.  
  32. To load a file just set A5,A6 AND D7 as shown:-
  33.  
  34. SET A5 = Load address. This will return as last byte address of file+1 if
  35.          load succesful - make even aligned for 68000 compatibility.
  36.  
  37. SET A6 = Location of zero-terminated filename ascii string.
  38.  
  39. SET D7 = Mode of Operation :
  40.  
  41.          00 = Normal load.
  42.          01 = Search, and return file length (if found) in A5 only.
  43.                             
  44. Then JSR / BSR 'FILE_LOAD' - All registers are saved except A5 as explained
  45. above and D7 which returns 00 if load successful or one of these reports:-
  46.  
  47.  01 = No speed signal from motor      (ejected disk whilst loading?)
  48.  02 = No DMA transfer - time out      (bad disk / ''           ''  )
  49.  03 = No Disk in drive.               
  50.  04 = Can't find that disk block      (disk corrupt)
  51.  05 = Wrong track marker ID           ('')
  52.  06 = Checksum error on disk block    ('')
  53.  07 = Block number out of range       ('')
  54.  08 = Not a file specifed             (thats a directory!)
  55.  09 = File not found.                 (obvious!)
  56.  
  57. If error report occurs, its up to you to display an appropiate message
  58. (or disk requester in the case of error $03).. You can then if you want
  59. jump straight back to your 'set-registers and call load' bit of code as
  60. the program switches off the drive, and waits 1 second before exit.IE: It
  61. does things properly NOT leaving the motor running for example! Actual
  62. MFM (disk corrupt) errors are only returned after the program has tried
  63. to re-read the dodgey track 12 times! - during which time it will have
  64. reset the disk head etc in case its an alignment problem.
  65.  
  66. IMPORTANT:-
  67. -----------
  68.  
  69. After you've finished loading a batch of files (or just one) you should shut
  70. down the drive. Call "MOTOR_OFF" 
  71.  
  72. I did not make this automatic as it would have meant stopping and restarting
  73. the motor needlessly and wasting time waiting for the motor to reach the
  74. right speed between each file. The motor will only be left running (ready
  75. for next file) if there has not been any error report! The code will always
  76. sense if the motor needs to be restarted and will perform this task.
  77.  
  78. GENERAL INFO
  79. ------------
  80.  
  81. The loader contains thorough error checking and should not lock up.
  82. You can even eject a disk whilst loading and it will return an error as
  83. normal! I've tested it on A500-A1200 with no problems - Timing is made
  84. using CIAB timer b so CPU speed will make NO difference - It doesnt
  85. generate any interrupts, lock out any interrupts or use the blitter!
  86. The code is obviously not designed to multitask so make sure you knock
  87. out the system IRQs when testing. You can run your own interrupts whilst
  88. loading takes place (EG: copper, VBL etc-but be careful if any of your
  89. code uses the cia's!)
  90.  
  91. The example call on the source returns to dos after completion, this is
  92. only for test purposes.. DO NOT attempts any normal dos disk activity cus
  93. the Amiga will not realize that the heads have been shifted etc and it
  94. probably will corrupt your disk(s).. Also the example calls have a large
  95. load buffer for testing (128k) so dont be put off by the executable file
  96. size!
  97.  
  98. Abrieviated info also contained at the start of the source code together
  99. with an example load call. For multidisk / multidrive  disk loading see
  100. the the source and docs for "MultiDiskFileLoader".
  101.  
  102. -----------------------------------------------------------------------------
  103.  
  104. QUICK EXAMPLE OF USE:
  105.  
  106.     move.w #$4000,$dff09a    ;Disable Irqs
  107.     
  108.     moveq #0,d7        ;actual load please
  109. GO    move.l #$c0000,a5        ;load address
  110.     move.l #filname,a6        ;file name address
  111.  
  112.     jsr LOAD_FILE
  113.     tst.w d7            ;how did it go?
  114.     beq.s LOAD_OK
  115.  
  116.      bsr SHOW_REPORT        ;YOUR ROUTINE!  
  117.     
  118. LOAD_OK    jsr MOTOR_OFF
  119.     move.w #$c000,$dff09a
  120.     rts
  121.  
  122. Filename dc.b "Vegetables/Cabbage",$0
  123.  
  124. -------------------------------------------------------------------------------
  125.  
  126.