Annotation of Net2/scsi/readme, revision 1.1.1.1

1.1       root        1:  *
                      2:  * PATCHES MAGIC                LEVEL   PATCH THAT GOT US HERE
                      3:  * --------------------         -----   ----------------------
                      4:  * CURRENT PATCH LEVEL:         1       00098
                      5:  * --------------------         -----   ----------------------
                      6:  *
                      7:  * 16 Feb 93   Julian Elischer         ADDED for SCSI system
                      8: This release consists of the following files 
                      9: (relative to the base of the kernel tree)
                     10: 
                     11: 
                     12: MAKEDEV
                     13: 
                     14: scsi
                     15: scsi/README
                     16: scsi/scsiconf.h
                     17: scsi/scsiconf.c
                     18: scsi/scsi_all.h
                     19: 
                     20: scsi/scsi_disk.h
                     21: scsi/sd.c
                     22: 
                     23: scsi/scsi_tape.h
                     24: scsi/st.c
                     25: 
                     26: sys/chio.h
                     27: scsi/scsi_changer.h
                     28: scsi/ch.c
                     29: 
                     30: sys/cdio.h
                     31: scsi/scsi_cd.h
                     32: scsi/cd.c
                     33: 
                     34: i386/conf/SCSITEST
                     35: i386/isa/aha1542.c
                     36: 
                     37: README.AHA1742
                     38: i386/conf/AHBTEST
                     39: i386/isa/aha1742.c
                     40: 
                     41: i386/conf/UHATEST
                     42: i386/isa/ultra14f.c
                     43: 
                     44: i386/conf/BTTEST
                     45: i386/isa/bt742a.c
                     46: 
                     47: 
                     48: 
                     49: ----------------------------------------------------------------
                     50: This scsi system is designed to allow the re-use of top end drivers
                     51: such as disk and tape drivers, with different scsi adapters.
                     52: 
                     53: As of writing this document, There are top end drivers working for:
                     54: ----------------------------------------------------------------
                     55: generic scsi disk
                     56: generic scsi tape
                     57: cd-rom  (plays music under the xcplayer (?) program)
                     58: AEG Character recognition devices *
                     59: Calera Character recognition devices *
                     60: Kodak IL900 scanner *
                     61: Exabyte tape changer device.
                     62: ----------------------------------------------------------------
                     63: 
                     64: 
                     65: There are also working bottom end drivers for:
                     66: ----------------------------------------------------------------
                     67: adaptec 1542 (and 1742 in 1542 mode)
                     68: bustec 742a
                     69: adaptec 174x 
                     70: Ultrastore 14f                         
                     71: ----------------------------------------------------------------
                     72: 
                     73: 
                     74: Work is proceeding on the following bottom end drivers:
                     75: ----------------------------------------------------------------
                     76: Future Domain (1680)**                 [email protected] & me
                     77: Future Domain (8  bit)****             [email protected]
                     78: WD7000**                               [email protected]
                     79: seagate st01/st02****                  [email protected] ?
                     80: ----------------------------------------------------------------
                     81: * drivers not made public (proprietary.. proof that the concept works though)
                     82: ** driver not yet released but working.
                     83: *** just a dream so far.
                     84: **** some amount more than just a dream so far.
                     85: 
                     86: 
                     87: ################## Using the scsi system ##################
                     88: ------------minor numbers---------------
                     89: This scsi system does not allocate minor numbers to devices depending
                     90: on their SCSI IDs is any way. A devices minor number is dependant
                     91: on the order in which it was found.
                     92: e.g. the first tape found will become st0 (minor number 0)
                     93:        the second found will become st1 (minor number 16)
                     94:        the third will become st2 (minor 32) 
                     95:        etc.
                     96: 
                     97: These devices could be on the same scsi bus or different scsi busses.
                     98: That would not change their minor numbers.
                     99: 
                    100: It is possible to run two different TYPES of scsi adapters at the 
                    101: same time and have st0 on one and st1 on another. (for example)
                    102: 
                    103: There is a scheme supported in which scsi devices can be 'wired in' even
                    104: if they are not present or powered on at probe time. (see scsiconf.c)
                    105: 
                    106: --------------getting started------------
                    107: It should be possible to use the /dev entries for as0 as if they were 
                    108: /dev entries for sd0 and the old as bootblocks should
                    109: continue to work if you are using an adaptec 1542b.
                    110: 
                    111: --------------making devices------------
                    112: A changed version of /dev/MAKEDEV is supplied that
                    113: can be used to make devices sd[01234] and st[01234]
                    114: 
                    115: e.g. 
                    116: cd /dev
                    117: sh MAKEDEV sd0 sd1 sd2 st0 st1 cd0
                    118: 
                    119: 
                    120: The tape devices are as follows:
                    121: rst0   basic raw device, will rewind on close
                    122: nrst0  will not rewind on close
                    123: erst0  will rewind and EJECTon close
                    124: nerst0  will not rewind and WILL eject (some devices may rewind anyhow)
                    125: 
                    126: ------------future enhancements--------------
                    127: Some people have indicated that they would like to have the SCSI ID
                    128: encoded into the minor number in some way, and
                    129: this may be supported at some timein the future, using
                    130: minor numbers greater than 128. (or maybe a different major number)
                    131: 
                    132: I will also be writing (probably) a generic scsi-error
                    133: handling routine that will be table driven, so that the routine can
                    134: be removed from each individual driver. With enough care,
                    135: two similar devices with different error codes (quite common) could run
                    136: the same driver but use different error tables.
                    137: 
                    138: --------------file layout-------------------
                    139: Originally I had all scsi definitions in one file: scsi.h
                    140: I have since moved definitions of commands so that all
                    141: definitions needed for a particular type of device are
                    142: found together in the include file of that name.
                    143: This approximatly follows the layout of their definition 
                    144: in the SCSI-2 spec. 
                    145: As such they are:
                    146: 
                    147: scsi_all.h             general commands for all devices --- CHAPTER 7
                    148: scsi-disk.h            commands relevant to disk        --- CHAPTER 8
                    149: scsi-tape.h            commands for scsi tapes          --- CHAPTER 9
                    150: scsi-cd.h              commands for cd-roms (and audio) --- CHAPTER 13
                    151: scsi-changer.h         commands medium changer devices  --- CHAPTER 16
                    152: 
                    153: ---------ioctl definitions-------------
                    154: User accessable structures (e.g. ioctl definitions) have been
                    155: placed in sys/cdio and sys/chio (based after sys/mtio for
                    156: the ioctls for mag tapes (including st).
                    157: 
                    158: -----------cd-rom-----------------
                    159: The cd rom driver ha been tested by a number of people and
                    160: [email protected] has completed the audio play
                    161: functions.
                    162: He tells me he has some Public Domain package that
                    163: allows an control of the cd player from an Xwindow
                    164: but I don't have it.
                    165: 
                    166: -------------media changer---------------
                    167: Once again courtesy of [email protected].
                    168: I have not tested this but he assures me it's ready for testing.
                    169: If anyone has an exabyte tape changer or similar, 
                    170: contact the author for information regarding the control interface
                    171: and program.
                    172: 
                    173: -----------booting from an AHA-174x---------
                    174: For some reason I have not yet worked out,
                    175: the BIOS-based bootblocks I have posted will not boot
                    176: from the aha1742 in extended mode. (it can't be serious
                    177: because the MACH version works) This is in fact not a 
                    178: problem because the aha1742 driver will force the board into extended
                    179: mode during probe, so it can be left in standard mode during the boot.
                    180: During the next reboot, the bios will place it back in standard mode
                    181: ready for the NEXT boot.
                    182: 

unix.superglobalmegacorp.com

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.