share/man/man4/adv.4

   1 .\"
   2 .\" Copyright (c) 1998, 2000
   3 .\"     Justin T. Gibbs.  All rights reserved.
   4 .\"
   5 .\" Redistribution and use in source and binary forms, with or without
   6 .\" modification, are permitted provided that the following conditions
   7 .\" are met:
   8 .\" 1. Redistributions of source code must retain the above copyright
   9 .\"    notice, this list of conditions and the following disclaimer.
  10 .\" 2. The name of the author may not be used to endorse or promote products
  11 .\"    derived from this software without specific prior written permission.
  12 .\"
  13 .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
  14 .\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
  15 .\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
  16 .\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
  17 .\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
  18 .\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
  19 .\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
  20 .\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  21 .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
  22 .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  23 .\"
  24 .\" $FreeBSD$
  25 .\"
  26 .Dd August 8, 2004
  27 .Dt ADV 4
  28 .Os
  29 .Sh NAME
  30 .Nm adv
  31 .Nd Advansys ISA/VL/EISA/PCI 8bit SCSI Host adapter driver
  32 .Sh SYNOPSIS
  33 To compile this driver into the kernel,
  34 place the following lines in your
  35 kernel configuration file:
  36 .Bd -ragged -offset indent
  37 .Cd "device scbus"
  38 .Cd "device adv"
  39 .Pp
  40 For one or more EISA cards:
  41 .Cd "device eisa"
  42 .Pp
  43 For one or more VL/ISA cards:
  44 .Cd "device isa"
  45 .Pp
  46 In
  47 .Pa /boot/device.hints :
  48 .Cd hint.adv.0.at="isa"
  49 .Pp
  50 For one or more PCI cards:
  51 .Cd "device pci"
  52 .Ed
  53 .Sh DESCRIPTION
  54 This driver provides access to the 8bit
  55 .Tn SCSI
  56 bus connected to the Advanced Systems Products, Inc.
  57 .Tn ASC900 ,
  58 .Tn ASC1000 ,
  59 .Tn ASC1090 ,
  60 .Tn ASC1200 ,
  61 .Tn ASC3030 ,
  62 .Tn ASC3050 ,
  63 and
  64 .Tn ASC3150
  65 host adapter chips.
  66 The following tables list the AdvanSys products using these chips,
  67 their bus attachment type, maximum sync rate, and the maximum number of
  68 commands that can be handled by the adapter concurrently.
  69 .Pp
  70 .Bd -ragged -offset indent
  71 .Bl -column "ABP510/5150 " "ISA PnP " "Yes " "10MHz " "Commands " Footnotes
  72 Connectivity Products:
  73 .Pp
  74 .Em "Adapter       Bus   Floppy      MaxSync   Commands  Footnotes"
  75 ABP510/5150   ISA     No         10MHz       240    1
  76 ABP5140     ISA PnP   No         10MHz       16     1, 3
  77 ABP5142     ISA PnP   Yes        10MHz       16     4
  78 ABP[3]902     PCI     No         10MHz       16
  79 ABP3905       PCI     No         10MHz       16
  80 ABP915        PCI     No         10MHz       16
  81 ABP920        PCI     No         10MHz       16
  82 ABP3922       PCI     No         10MHz       16
  83 ABP3925       PCI     No         10MHz       16
  84 ABP930        PCI     No         10MHz       16     5
  85 ABP930U       PCI     No         20MHz       16
  86 ABP930UA      PCI     No         20MHz       16
  87 ABP960        PCI     No         10MHz       16
  88 ABP960U       PCI     No         20MHz       16
  89 .El
  90 .Pp
  91 Footnotes:
  92 .Bl -enum -compact
  93 .It
  94 This board has been shipped by HP with the 4020i CD-R drive.
  95 The board has no BIOS so it cannot control a boot device, but
  96 it can control any secondary SCSI device.
  97 .It
  98 This board has been sold by Iomega as a Jaz Jet PCI adapter.
  99 .It
 100 This board has been sold by SIIG as the i540 SpeedMaster.
 101 .It
 102 This board has been sold by SIIG as the i542 SpeedMaster.
 103 .It
 104 This board has been sold by SIIG as the Fast SCSI Pro PCI.
 105 .El
 106 .Ed
 107 .Pp
 108 .Bd -ragged -offset indent
 109 .Bl -column "ABP510/5150 " "ISA PnP " "Yes " "10MHz " Commands
 110 Single Channel Products:
 111 .Pp
 112 .Em "Adapter       Bus   Floppy      MaxSync   Commands"
 113 ABP542        ISA     Yes        10MHz       240
 114 ABP742        EISA    Yes        10MHz       240
 115 ABP842        VL      Yes        10MHz       240
 116 ABP940        PCI     No         10MHz       240
 117 ABP[3]940UA   PCI     No         20MHz       240
 118 ABP940U       PCI     No         20MHz       240
 119 ABP3960UA     PCI     No         20MHz       240
 120 ABP970        PCI     No         10MHz       240
 121 ABP970U       PCI     No         20MHz       240
 122 .El
 123 .Ed
 124 .Pp
 125 .Bd -ragged -offset indent
 126 .Bl -column "ABP510/5150 " "ISA PnP " "Yes " "10MHz " "Commands " "Channels "
 127 Multi Channel Products (Commands are per-channel):
 128 .Pp
 129 .Em "Adapter       Bus   Floppy      MaxSync   Commands  Channels"
 130 ABP752       EISA     Yes        10MHz       240      2
 131 ABP852        VL      Yes        10MHz       240      2
 132 ABP950        PCI     No         10MHz       240      2
 133 ABP980        PCI     No         10MHz       240      4
 134 ABP980U       PCI     No         20MHz       240      4
 135 ABP[3]980UA   PCI     No         20MHz       16       4
 136 .El
 137 .Ed
 138 .Pp
 139 .\" For ISA or Vesa Local Bus adapters, one kernel config entry is required
 140 .\" for every card to be attached by the system.  Specific values for the port
 141 .\" address, irq, and drq may be specified.  If wildcard values are used, the
 142 .\" driver will query the device for its current settings and use those.  If
 143 .\" the port address is a wildcard, the driver consults an internal table of
 144 .\" possible port address locations and attaches to the first unattached card
 145 .\" it finds.  The possible port addresses for these card are 0x110, 0x130,
 146 .\" 0x150, 0x190, 0x210, 0x230, 0x250, and 0x330.
 147 .\" .Pp
 148 Per target configuration performed in the
 149 .Tn AdvanceWare
 150 menu, which is accessible at boot,
 151 is honored by this driver.
 152 This includes synchronous/asynchronous transfers,
 153 maximum synchronous negotiation rate, disconnection, tagged queueing,
 154 and the host adapter's SCSI ID.
 155 The global setting for the maximum number of tagged transactions allowed
 156 per target is not honored as the CAM SCSI system will automatically determine
 157 the maximum number of tags a device can receive as well as guarantee fair
 158 resource allocation among devices.
 159 .Sh HARDWARE
 160 The
 161 .Nm
 162 driver supports the following SCSI controllers:
 163 .Pp
 164 .Bl -bullet -compact
 165 .It
 166 AdvanSys ABP510/5150
 167 .It
 168 AdvanSys ABP5140
 169 .It
 170 AdvanSys ABP5142
 171 .It
 172 AdvanSys ABP902/3902
 173 .It
 174 AdvanSys ABP3905
 175 .It
 176 AdvanSys ABP915
 177 .It
 178 AdvanSys ABP920
 179 .It
 180 AdvanSys ABP3922
 181 .It
 182 AdvanSys ABP3925
 183 .It
 184 AdvanSys ABP930, ABP930U, ABP930UA
 185 .It
 186 AdvanSys ABP960, ABP960U
 187 .It
 188 AdvanSys ABP542
 189 .It
 190 AdvanSys ABP742
 191 .It
 192 AdvanSys ABP842
 193 .It
 194 AdvanSys ABP940
 195 .It
 196 AdvanSys ABP940UA/3940UA
 197 .It
 198 AdvanSys ABP940U
 199 .It
 200 AdvanSys ABP3960UA
 201 .It
 202 AdvanSys ABP970, ABP970U
 203 .It
 204 AdvanSys ABP752
 205 .It
 206 AdvanSys ABP852
 207 .It
 208 AdvanSys ABP950
 209 .It
 210 AdvanSys ABP980, ABP980U
 211 .It
 212 AdvanSys ABP980UA/3980UA
 213 .It
 214 MELCO IFC-USP (PC-98)
 215 .It
 216 RATOC REX-PCI30 (PC-98)
 217 .It
 218 @Nifty FNECHARD IFC-USUP-TX (PC-98)
 219 .El
 220 .Sh SEE ALSO
 221 .Xr adw 4 ,
 222 .Xr aha 4 ,
 223 .Xr ahb 4 ,
 224 .Xr ahc 4 ,
 225 .Xr cd 4 ,
 226 .Xr da 4 ,
 227 .Xr sa 4 ,
 228 .Xr scsi 4
 229 .Sh HISTORY
 230 The
 231 .Nm
 232 driver appeared in
 233 .Fx 3.0 .
 234 .Sh AUTHORS
 235 .An -nosplit
 236 The
 237 .Nm
 238 driver was ported by
 239 .An Justin T. Gibbs
 240 from the Linux driver
 241 written by
 242 .An Bob Frey
 243 of Advanced System Products, Inc.
 244 Many thanks to AdvanSys for providing the original driver under a suitable
 245 license for use in
 246 .Fx .