diff options
Diffstat (limited to 'sys/scsi/README')
| -rw-r--r-- | sys/scsi/README | 209 |
1 files changed, 209 insertions, 0 deletions
diff --git a/sys/scsi/README b/sys/scsi/README new file mode 100644 index 000000000000..646ed8f56694 --- /dev/null +++ b/sys/scsi/README @@ -0,0 +1,209 @@ +This release consists of the following files +(relative to the base of the kernel tree) + + +MAKEDEV + +scsi +scsi/README +scsi/scsiconf.h +scsi/scsiconf.c +scsi/scsi_all.h + +scsi/scsi_disk.h +scsi/sd.c + +sys/mtio.h (modified) +scsi/scsi_tape.h +scsi/st.c + +sys/sgio.h +scsi/scsi_generic.h +scsi/sg.c /* port not complete */ + +sys/chio.h +scsi/scsi_changer.h +scsi/ch.c + +sys/cdio.h +scsi/scsi_cd.h +scsi/cd.c + +i386/conf/SCSITEST +i386/isa/aha1542.c + +i386/conf/AHBTEST +i386/isa/aha1742.c + +i386/conf/UHATEST +i386/isa/ultra14f.c + +i386/conf/BTTEST +i386/isa/bt742a.c + + + +---------------------------------------------------------------- +This scsi system is designed to allow the re-use of top end drivers +such as disk and tape drivers, with different scsi adapters. + +As of writing this document, There are top end drivers working for: +---------------------------------------------------------------- +generic scsi disk +generic scsi tape +cd-rom (plays music under the xcplayer (?) program) +AEG Character recognition devices * +Calera Character recognition devices * +Kodak IL900 scanner * +Exabyte tape changer device. +GENERIC SCSI DEVICES (user generated scsi commands) (port not complete) +---------------------------------------------------------------- + + +There are also working bottom end drivers for: +---------------------------------------------------------------- +adaptec 1542 (and 1742 in 1542 mode) +bustec 742a (apparently works for VESA version) +adaptec 174x +Ultrastore 14f (works for 34f (VESA version)) +---------------------------------------------------------------- + + +Work is proceeding on the following bottom end drivers: +---------------------------------------------------------------- +Future Domain (1680)** hosler@tfs.com & me +Future Domain (8 bit)**** rpr@oce.nl +WD7000** terry@icarus.weber.edu +seagate st01/st02**** overby@aspen.cray.com ? +---------------------------------------------------------------- +* drivers not made public (proprietary.. proof that the concept works though) +** driver not yet released but working. +*** just a dream so far. +**** some amount more than just a dream so far. + + +################## Using the scsi system ################## +------------minor numbers--------------- +This scsi system does not allocate minor numbers to devices depending +on their SCSI IDs is any way. A devices minor number is dependant +on the order in which it was found. +e.g. the first tape found will become st0 (minor number 0) + the second found will become st1 (minor number 16) + the third will become st2 (minor 32) + etc. + +These devices could be on the same scsi bus or different scsi busses. +That would not change their minor numbers. + +THE EXCEPTION TO THIS IS IN THE GENERIC SCSI DRIVER. in which case +the following mapping applies: + +BB LLL TTT B= scsi bus number, T = target number, L = LUN. +(yes I know it's strange but it's SGI compatible) + +It is possible to run two different TYPES of scsi adapters at the +same time and have st0 on one and st1 on another. (for example) + +There is a scheme supported in which scsi devices can be 'wired in' even +if they are not present or powered on at probe time. (see scsiconf.c) + +--------------getting started------------ +It should be possible to use the /dev entries for as0 as if they were +/dev entries for sd0 and the old as bootblocks should +continue to work if you are using an adaptec 1542b. + +--------------making devices------------ +A changed version of /dev/MAKEDEV is supplied that +can be used to make devices sd[01234] and st[01234] + +e.g. +cd /dev +sh MAKEDEV sd0 sd1 sd2 st0 st1 cd0 + + +The tape devices are as follows: +rst0 basic raw device, will rewind on close +nrst0 will not rewind on close +erst0 will rewind and EJECTon close +nerst0 will not rewind and WILL eject (some devices may rewind anyhow) + +------------future enhancements-------------- +Some people have indicated that they would like to have the SCSI ID +encoded into the minor number in some way, and +this may be supported at some timein the future, using +minor numbers greater than 128. (or maybe a different major number) + + +I will also be writing (probably) a generic scsi-error +handling routine that will be table driven, so that the routine can +be removed from each individual driver. With enough care, +two similar devices with different error codes (quite common) could run +the same driver but use different error tables. + +--------------file layout------------------- +Originally I had all scsi definitions in one file: scsi.h +I have since moved definitions of commands so that all +definitions needed for a particular type of device are +found together in the include file of that name. +This approximatly follows the layout of their definition +in the SCSI-2 spec. +As such they are: + +scsi_all.h general commands for all devices --- CHAPTER 7 +scsi-disk.h commands relevant to disk --- CHAPTER 8 +scsi-tape.h commands for scsi tapes --- CHAPTER 9 +scsi-cd.h commands for cd-roms (and audio) --- CHAPTER 13 +scsi-changer.h commands medium changer devices --- CHAPTER 16 + +---------ioctl definitions------------- +User accessable structures (e.g. ioctl definitions) have been +placed in sys/cdio, sys/sgio and sys/chio (based after sys/mtio for +the ioctls for mag tapes (including st). + +-----------cd-rom----------------- +The cd rom driver ha been tested by a number of people and +grefen@wilbur.zdv.uni-mainz.de has completed the audio play +functions. +(xcdplayer was available from the 'from_ref' directory on agate) + +At this time it is possible audio play is broken on cdroms and I will +be unable to fix it until I get one to test. + +-------------media changer--------------- +Once again courtesy of grefen@wilbur.zdv.uni-mainz.de. +I have not tested this but he assures me it's ready for testing. +If anyone has an exabyte tape changer or similar, +contact the author for information regarding the control interface +and program. + +WARNING: This has not been tested for a LONG TIME! + +-----------booting from an AHA-174x--------- +For some reason I have not yet worked out, +the BIOS-based bootblocks I have posted will not boot +from the aha1742 in extended mode. (it can't be serious +because the MACH version works) This is in fact not a +problem because the aha1742 driver will force the board into extended +mode during probe, so it can be left in standard mode during the boot. +During the next reboot, the bios will place it back in standard mode +ready for the NEXT boot. + +[Update: This has apparently been fixed in the newest NetBSD/FreeBSD +releases ] + + + +---------recent changes----------- +Removed all bitfields from machine independent sections to make +it possible for them to be used on big-endian architectures. + +Removed scsi specific timeouts in favour of system timeout handling. + +Many structures (getting more all the time) now dynamically allocated. + +Addition of code in the tape driver to recognise models of drive that +have particular problems so they can be handled specially. + +many bug-fixes and cleanups. + +$Id: README,v 1.7 1993/10/16 17:21:04 rgrimes Exp $ |