share/man/man4/adw.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: src/share/man/man4/adw.4,v 1.5.4.6 2001/10/01 13:07:22 dd Exp $
  25 .\" $DragonFly: src/share/man/man4/adw.4,v 1.5 2007/09/30 06:10:43 swildner Exp $
  26 .\"
  27 .Dd September 29, 2007
  28 .Dt ADW 4
  29 .Os
  30 .Sh NAME
  31 .Nm adw
  32 .Nd Advansys PCI 16bit SCSI Host adapter driver
  33 .Sh SYNOPSIS
  34 .Cd device pci
  35 .Cd device adw
  36 .Pp
  37 For one or more SCSI busses:
  38 .Cd device scbus0 at adw0
  39 .Pp
  40 To allow PCI adapters to use memory mapped I/O if enabled:
  41 .Cd options ADW_ALLOW_MEMIO
  42 .Sh DESCRIPTION
  43 This driver provides access to the 16bit
  44 .Tn SCSI
  45 bus connected to the Advanced Systems Products, Inc.
  46 .Tn ASC3550 Ultra ,
  47 and
  48 .Tn ASC38C0800 Ultra2 ,
  49 SCSI Host Adapter chips.
  50 AdvanSys products incorporating these chips include the
  51 .Tn ABP[3]940UW ,
  52 .Tn ABP950UW ,
  53 .Tn ABP970UW ,
  54 .Tn ABP3940U2W ,
  55 and
  56 .Tn ABP3950U2W .
  57 Both chips support, synchronous transfers
  58 (20MHz and 40MHz max respectively),
  59 16bit transfers, tagged queueing,
  60 and up to 253 concurrent SCSI transactions.
  61 .Pp
  62 Per target configuration performed in the
  63 .Tn AdvanceWare
  64 menu, which is accessible at boot,
  65 is honored by this driver.
  66 This includes synchronous/asynchronous transfers,
  67 maximum synchronous negotiation rate, wide transfers, disconnection,
  68 tagged queueing, and the host adapter's SCSI ID.
  69 The global setting for the maximum number of tagged transactions allowed
  70 per target is not honored as the CAM SCSI system will automatically determine
  71 the maximum number of tags a device can receive as well as guarantee fair
  72 resource allocation among devices.
  73 .Pp
  74 Memory mapped I/O can be enabled with the
  75 .Dq Dv ADW_ALLOW_MEMIO
  76 configuration option.
  77 Memory mapped I/O is more efficient than the alternative, programmed I/O.
  78 Most PCI BIOSes will map devices so that either technique for communicating
  79 with the card is available.
  80 .Sh SEE ALSO
  81 .Xr adv 4 ,
  82 .Xr cd 4 ,
  83 .Xr da 4 ,
  84 .Xr sa 4 ,
  85 .Xr scsi 4
  86 .Sh HISTORY
  87 The
  88 .Nm
  89 driver appeared in
  90 .Fx 3.0 .
  91 .Sh AUTHORS
  92 .An -nosplit
  93 The
  94 .Nm
  95 driver was ported by
  96 .An Justin T. Gibbs
  97 from the Linux driver written by
  98 .An Bob Frey
  99 of Advanced System Products, Inc.
 100 Many thanks to AdvanSys for providing the original driver
 101 under a suitable license for use in
 102 .Fx .