xref: /freebsd/share/man/man4/ahc.4 (revision 5ebc7e6281887681c3a348a5a4c902e262ccd656)
1.\"
2.\" Copyright (c) 1995
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. Redistributions in binary form must reproduce the above copyright
11.\"    notice, this list of conditions and the following disclaimer in the
12.\"    documentation and/or other materials provided with the distribution.
13.\" 3. The name of the author may not be used to endorse or promote products
14.\"    derived from this software withough specific prior written permission.
15.\"
16.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
17.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
18.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
19.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
20.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
21.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
22.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
23.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
24.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
25.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
26.\"
27.\"
28.Dd April 15, 1995
29.Dt AHC 4 i386
30.Os FreeBSD
31.Sh NAME
32.Nm ahc
33.Nd
34Adaptec VL/EISA/PCI SCSI host adapter driver
35.Sh SYNOPSIS
36For VL/EISA cards:
37.Cd "controller ahc0 at isa? bio irq ? vector ahcintr
38.sp
39For PCI cards:
40.Cd "controller ahc0
41.sp
42For one or more SCSI busses:
43.Cd "controller scbus0
44.sp
45For one or more disk devices:
46.Cd "device sd0
47.sp
48For one or more tape devices:
49.Cd "device st0
50.sp
51For one or more cdroms:
52.Cd "device cd0
53.Sh DESCRIPTION
54This driver provides access to SCSI devices connected to an Adaptec
55274x, 284x, 294x, or motherboard based aic7770/aic7870 hostadapter.
56Features include twin and wide bus support, 2 commands per target in
57non-tagged queuing mode, and experimental tagged queuing support enabled
58with:
59.sp
60.Cd "option AHC_TAGENABLE
61.sp
62Per target configuration performed in the SCSI-Select menu, accesible at boot
63in non-EISA models or throught an EISA configuration utility for EISA models,
64is honored by this driver with the stipulation that the BIOS is enabled for
65EISA adaptors.  This includes syncronous/asyncronous transfers, disconnection,
66and maximum syncronous negotiation rate settings.
67.sp
68Note that I/O addresses are determined automatically by the probe routines,
69but care should be taken when using a 284x (VLB controller) in an EISA
70system.  Ensure that the jumpers setting the I/O area for the 284x match the
71EISA slot into which the card is inserted to prevent conflicts with other
72EISA cards.
73.Sh BUGS
74Some Quantum drives (at least the Empire 2100 and 1080s) will not run on an
75aic7870 in syncronous mode at 10MB/s.  It is speculated that the Adaptec
76runs slightly above 10MB/s causing the drive much confusion.  Setting a
77maximum syncronous negotiation rate of 8MB/s in the SCSI-Select utility
78will allow normal function.
79.sp
80The SCSI ID of aic7870 based controllers (AHA-294x) is hard coded to 7 by
81the driver.  The user configured ID can be obtained by querying the SEEPROM
82or NVRAM where these settings are stored, but there is no driver support for
83this as of yet.
84.Sh FILES
85.Bl -tag -width Pa -compact
86.It Pa /sys/i386/scsi/aic7xxx.c
87.It Pa /sys/i386/scsi/aic7xxx.h
88Bus independent driver source
89.It Pa /sys/i386/eisa/aic7770.c
90EISA device probe/attach routines
91.It Pa /sys/pci/aic7870.c
92PCI device probe/attach routines
93.It Pa /sys/dev/aic7xxx/aic7xxx.seq
94aic7xxx sequencer program
95.It Pa /sys/i386/conf/GENERIC
96sample generic kernel config file including Adaptec support
97.El
98.Sh SEE ALSO
99.Xr aha 4
100.Xr ahb 4
101.Xr aic7xxx_asm 1
102.Xr cd 4
103.Xr scsi 4
104.Xr sd 4
105.Xr st 4
106