share/man/man4/si.4

   1 .\"     $NetBSD: si.4,v 1.9 2003/02/14 15:20:19 grant 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
  27 The
  28 .Nm
  29 and
  30 .Nm sw
  31 .Qq Tn SCSI Weird
  32 drivers provide support for the
  33 .Tn NCR
  34 5380
  35 .Tn SCSI
  36 Bus Controller (SBC) chip found on various Sun Microsystems
  37 .Tn CPU
  38 motherboards (obio), and on the
  39 .Qq Sun-3 VME SCSI
  40 .Pq Sun part # 501-1236
  41 board used in systems with
  42 .Tn VME
  43 bus.
  44 .Ss sun3 and sun3x
  45 The
  46 .Tn sun3
  47 and
  48 .Tn sun3x
  49 version of this driver can be configured with a
  50 .Em flags
  51 directive in the
  52 .Xr config 1
  53 file.
  54 The values are bits in a bitfield, and are interpreted as follows:
  55 .Pp
  56 .Bl -tag -offset indent -compact -width 0x000ff
  57 .It 0x000ff
  58 Set bit (1\*[Lt]\*[Lt]target) to disable
  59 .Tn SCSI
  60 disconnect/reselect
  61 .It 0x0ff00
  62 Set bit (1\*[Lt]\*[Lt](target+8)) to disable
  63 .Tn SCSI
  64 parity checking
  65 .It 0x10000
  66 Set this bit to disable
  67 .Tn DMA
  68 interrupts (poll)
  69 .It 0x20000
  70 Set this bit to disable
  71 .Tn DMA
  72 entirely (use PIO)
  73 .El
  74 .Pp
  75 For example:
  76 .Qq flags 0x1000f
  77 would disable
  78 .Tn DMA
  79 interrupts, and disable disconnect/reselect for targets 0-3.
  80 The
  81 .Qq target
  82 is the
  83 .Tn SCSI
  84 ID number of a particular device on a particular
  85 .Tn SCSI
  86 bus.
  87 .Ss sun4
  88 The
  89 .Tn sun4
  90 version of this driver can also be configured with a
  91 .Em flags
  92 directive in the
  93 .Xr config 1
  94 file.
  95 The values are bits in a bitfield, and are interpreted as follows:
  96 .Pp
  97 .Bl -tag -offset indent -compact -width 0x01
  98 .It 0x01
  99 Use
 100 .Tn DMA
 101 .Pq may be polled
 102 .It 0x02
 103 Use
 104 .Tn DMA
 105 completion interrupts
 106 .It 0x04
 107 Allow
 108 .Tn SCSI
 109 disconnect/reselect
 110 .El
 111 .Pp
 112 For example:
 113 .Qq flags 0x07
 114 would enable
 115 .Tn DMA ,
 116 interrupts, and reselect.
 117 By default,
 118 .Tn DMA
 119 is enabled in the
 120 .Tn sun4
 121 driver.
 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
 130 David Jones,
 131 .An Gordon Ross
 132 .Aq gwr@NetBSD.org ,
 133 .An Adam Glass
 134 .Aq glass@NetBSD.org ,
 135 .An Jason R. Thorpe
 136 .Aq thorpej@NetBSD.org .
 137 .Sh BUGS
 138 The
 139 .Tn VME
 140 variant has a bit to enable or disable the
 141 .Tn DMA
 142 engine, but that bit also gates the interrupt line from the
 143 .Tn NCR5380
 144 .Pq !! .
 145 Therefore, in order to get any interrupt from the
 146 .Tn NCR5380 ,
 147 (i.e. for reselect) one must clear the
 148 .Tn DMA
 149 engine transfer count and then enable
 150 .Tn DMA .
 151 This has the further complication that you CAN NOT touch the
 152 .Tn NCR5380
 153 while the
 154 .Tn DMA
 155 enable bit is set, so we have to turn
 156 .Tn DMA
 157 back off before we even look at the
 158 .Tn NCR5380 .
 159 .Pp
 160 Support for the Sun 4/100
 161 .Nm sw
 162 .Qq Tn SCSI Weird
 163 is not complete.
 164 .Tn DMA
 165 works, but interrupts (and, thus, reselection) don't for reasons unknown.
 166 Further progress has halted pending the availability of a machine for testing.
 167 .Pp
 168 .Tn DMA ,
 169 .Tn DMA
 170 completion interrupts, and reselection work fine on a Sun 4/260 with modern
 171 .Tn SCSI-II
 172 disks attached.
 173 There have been reports of reselection failing on
 174 .Tn Sun
 175 Shoebox-type configurations where
 176 there are multiple non-SCSI devices behind
 177 .Tn Emulex
 178 or
 179 .Tn Adaptec
 180 bridges.
 181 These devices pre-date the
 182 .Tn SCSI-I
 183 spec, and might not behave the way the NCR5380 code expects.
 184 For this reason, only
 185 .Tn DMA
 186 is enabled by default in the
 187 .Tn sun4
 188 driver.