1.\" $NetBSD: si.4,v 1.8 2002/02/13 08:17:46 ross Exp $ 2.\" 3.\" written from a reading of config files and driver source code 4.\" Erik E. Fair <fair@netbsd.org> 5.Dd May 7, 1998 6.Dt SI 4 7.Os 8.Sh NAME 9.Nm si , 10.Nm sw 11.Nd NCR 5380 SCSI bus host adaptor driver 12.Sh SYNOPSIS 13.Ss sun3 14.Cd "si0 at obio0 addr 0x140000 ipl 2" 15.Ss sun3 and sun3x 16.Cd "si0 at vme2 addr 0x200000 ipl 2 vect 0x40" 17.Cd "si1 at vme2 addr 0x204000 ipl 2 vect 0x41" 18.Ss sun3/E 19.Cd "sebuf0 at vme2 addr 0x300000 ipl 2 vect 0x74 # and 0x75" 20.Cd "sebuf1 at vme2 addr 0x340000 ipl 2 vect 0x76 # and 0x77" 21.Cd "si* at sebuf?" 22.Ss sun4 and sun2 23.Cd "si0 at vme0 addr 0x200000 pri 2 vec 0x40" 24.Ss sun4/100 25.Cd "sw0 at obio0 addr 0x0a000000 level 3" 26.Sh DESCRIPTION 27The 28.Nm 29and 30.Nm sw 31.Qq Tn SCSI Weird 32drivers provide support for the 33.Tn NCR 345380 35.Tn SCSI 36Bus Controller (SBC) chip found on various Sun Microsystems 37.Tn CPU 38motherboards (obio), and on the 39.Qq Sun-3 VME SCSI 40.Pq Sun part # 501-1236 41board used in systems with 42.Tn VME 43bus. 44.Ss sun3 and sun3x 45The 46.Tn sun3 47and 48.Tn sun3x 49version of this driver can be configured with a 50.Em flags 51directive in the 52.Xr config 8 53file. 54The values are bits in a bitfield, and are interpreted as follows: 55.Pp 56.Bl -tag -offset indent -compact -width 0x000ff 57.It 0x000ff 58Set bit (1\*[Lt]\*[Lt]target) to disable 59.Tn SCSI 60disconnect/reselect 61.It 0x0ff00 62Set bit (1\*[Lt]\*[Lt](target+8)) to disable 63.Tn SCSI 64parity checking 65.It 0x10000 66Set this bit to disable 67.Tn DMA 68interrupts (poll) 69.It 0x20000 70Set this bit to disable 71.Tn DMA 72entirely (use PIO) 73.El 74.Pp 75For example: 76.Qq flags 0x1000f 77would disable 78.Tn DMA 79interrupts, and disable disconnect/reselect for targets 0-3. 80The 81.Qq target 82is the 83.Tn SCSI 84ID number of a particular device on a particular 85.Tn SCSI 86bus. 87.Ss sun4 88The 89.Tn sun4 90version of this driver can also be configured with a 91.Em flags 92directive in the 93.Xr config 8 94file. 95The values are bits in a bitfield, and are interpreted as follows: 96.Pp 97.Bl -tag -offset indent -compact -width 0x01 98.It 0x01 99Use 100.Tn DMA 101.Pq may be polled 102.It 0x02 103Use 104.Tn DMA 105completion interrupts 106.It 0x04 107Allow 108.Tn SCSI 109disconnect/reselect 110.El 111.Pp 112For example: 113.Qq flags 0x07 114would enable 115.Tn DMA , 116interrupts, and reselect. 117By default, 118.Tn DMA 119is enabled in the 120.Tn sun4 121driver. 122.Sh SEE ALSO 123.Xr cd 4 , 124.Xr ch 4 , 125.Xr intro 4 , 126.Xr scsi 4 , 127.Xr sd 4 , 128.Xr st 4 129.Sh AUTHORS 130David Jones, 131.br 132Gordon Ross 133.Aq gwr@netbsd.org , 134.br 135Adam Glass 136.Aq glass@netbsd.org , 137.br 138Jason R. Thorpe 139.Aq thorpej@netbsd.org . 140.Sh BUGS 141The 142.Tn VME 143variant has a bit to enable or disable the 144.Tn DMA 145engine, but that bit also gates the interrupt line from the 146.Tn NCR5380 147.Pq !! . 148Therefore, in order to get any interrupt from the 149.Tn NCR5380 , 150(i.e. for reselect) one must clear the 151.Tn DMA 152engine transfer count and then enable 153.Tn DMA . 154This has the further complication that you CAN NOT touch the 155.Tn NCR5380 156while the 157.Tn DMA 158enable bit is set, so we have to turn 159.Tn DMA 160back off before we even look at the 161.Tn NCR5380 . 162.Pp 163Support for the Sun 4/100 164.Nm sw 165.Qq Tn SCSI Weird 166is not complete. 167.Tn DMA 168works, but interrupts (and, thus, reselection) don't for reasons unknown. 169Further progress has halted pending the availability of a machine for testing. 170.Pp 171.Tn DMA , 172.Tn DMA 173completion interrupts, and reselection work fine on a Sun 4/260 with modern 174.Tn SCSI-II 175disks attached. 176There have been reports of reselection failing on 177.Tn Sun 178Shoebox-type configurations where 179there are multiple non-SCSI devices behind 180.Tn Emulex 181or 182.Tn Adaptec 183bridges. 184These devices pre-date the 185.Tn SCSI-I 186spec, and might not behave the way the NCR5380 code expects. 187For this reason, only 188.Tn DMA 189is enabled by default in the 190.Tn sun4 191driver. 192