Annotation of Net2/scsi/readme, revision 1.1.1.2

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

unix.superglobalmegacorp.com

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