|
|
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:
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.