home *** CD-ROM | disk | FTP | other *** search
/ No Fragments Archive 12: Textmags & Docs / nf_archive_12.iso / MAGS / SOURCES / ATARI_SRC.ZIP / atari source / AHDI / TESTSPAR / README.DOC < prev    next >
Encoding:
Text File  |  2001-02-09  |  4.1 KB  |  111 lines
  1. AHDI README.DOC (July 21 1992 - ml.)
  2. ===============
  3.  
  4. AHDI is the hard disk driver for the Atari 680x0-line of computers.
  5. It now supports the ACSI, the SCSI and the IDE interfaces.
  6.  
  7. The hardware dependent code of AHDI is also used by programs like
  8. HDX, FHDX and TSTDRIVE.  Those programs will need all the .H files,
  9. and all the .S files except DRIVER.S and INSTALL.S
  10.  
  11. To build the driver, just run "make" with the MAKEFILE in this
  12. directory.
  13.  
  14. Refer to AHDI 3.00 Release Notes for a detail explanation of the 
  15. patchable variables, the extended GEMDOS partition and the big
  16. GEMDOS partition.
  17.  
  18. The main difference between version 5.00 and version 6.00 is the
  19. support of Sparrow SCSI.  The new files are SPSCSI.H and SPSCSI.S.
  20.  
  21.  
  22. The driver code consists of :
  23.  
  24. ACSI.H        BLITTER.H    DEFS.H        ERROR.H    IDE.H
  25. MACROS.H    MFP.H    SCSI.H        SPSCSI.H    SYSVAR.H
  26.  
  27. DEFS.H        - Most of the conditional assembly and global equates 
  28.           are here.
  29.  
  30.           When compiling for programs like HDX and FHDX, set 
  31.           the "DRIVER" conditional assembly flag to 0.  This
  32.           will include routines (e.g. format) which are not
  33.           needed in the resident driver.
  34.  
  35. 68030.S        - Macros to access the cache registers when running on 
  36.           the 68030.
  37.  
  38. ACSI.S        - Set up the ACSI DMA channel to send commands, to send
  39.           and to receive data.  The clean up code is also used by 
  40.           the Sparrow SCSI code since Sparrow SCSI uses the same 
  41.           channel.
  42.  
  43.           When the standard _rcvacsi() and _wrtacsi() routines 
  44.           (e.g. the format routine) are not used to do the I/O, 
  45.           remember to set and clear "flock" appropiately.  If 
  46.           not, the floppy activities may interfere with the hard
  47.           disk activities.
  48.  
  49. CMDBLK.S    - Stuff the command block for all SCSI and ACSI commands.
  50.  
  51. COOKIE.S    - Allan Pratt's getcookie() code.
  52.  
  53. DOIT.S        - Decide which interface (SCSI, ACSI, or Sparrow SCSI) to
  54.           use for a command, and send it on its way.
  55.  
  56. DRIVER.S    - Most changes made to the driver are documented at the
  57.           beginning of this file.
  58.  
  59.           This file contains the hardware independent file-system 
  60.           level code, all the global variables, and the entry 
  61.           points for the BIOS.
  62.  
  63.           This file MUST be the FIRST file when linking, because
  64.           it contains the patchable variables which locations are
  65.           published.
  66.  
  67. IDE.S        - Set up the IDE channel to do either programmed or
  68.           BLiTTER I/O.
  69.  
  70.           DON'T do BLiTTER I/O on the STBOOK!  To do BLiTTER I/O
  71.           on the Sparrow, the "badcombo" flag initialized in the
  72.           file DRIVER.S needs to be set to 0.
  73.  
  74. INSTALL.S   - This file contains the code to look for devices and 
  75.           initialize the globals.
  76.  
  77.           This file MUST be the LAST file when linking, because
  78.           the Mshrink() or Pterm() done at the end of the driver
  79.           uses a label in this file to calculate how much of the
  80.           driver to keep.
  81.  
  82. SCSI.S        - Set up the TT SCSI channel for either programmed or 
  83.           DMA I/O.
  84.  
  85.           The Falcon 040 SCSI should be able to use most of the
  86.           TT SCSI code.  There are a couple of fixes that I know
  87.           of now.  First, there is no need to use the residue 
  88.           register anymore, the hardware will flush the FIFO.  
  89.           I think the register will stay for compatibility.
  90.           Second, the TT SCSI now bus errors if you try to DMA
  91.           to the end of memory.  That should be fixed in the
  92.           Falcon 040 SCSI.  For the most up-to-date information
  93.           about these issues, contact John Hoenig.
  94.  
  95. SPSCSI.S    - Set up the Sparrow SCSI channel for either programmed 
  96.           or DMA I/O.
  97.  
  98.           Sparrow SCSI is accessed by talking through the ACSI
  99.           DMA chip.  Refer to the macros in SPSCSI.H to access
  100.           the SCSI registers.
  101.  
  102.           When the standard _rcvspscsi() and _wrtspscsi() routines 
  103.           (e.g. the format routine) are not used to do the I/O, 
  104.           remember to set and clear "flock" appropiately.  If 
  105.           not, the floppy activities may interfere with the hard
  106.           disk activities.
  107.  
  108.  
  109. Refer to the comments in the source files for a detail explanation of
  110. the different functions.
  111.