1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
|
<table class="head">
<tr>
<td class="head-ltitle">AHD(4)</td>
<td class="head-vol">Device Drivers Manual</td>
<td class="head-rtitle">AHD(4)</td>
</tr>
</table>
<div class="manual-text">
<section class="Sh">
<h1 class="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h1>
<p class="Pp"><code class="Nm">ahd</code> — <span class="Nd">Adaptec
PCI/PCI-X Ultra320 SCSI host adapter driver</span></p>
</section>
<section class="Sh">
<h1 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1>
<p class="Pp">To compile this driver into the kernel, place the following lines
in your kernel configuration file:</p>
<div class="Bd Pp Bd-indent"><code class="Cd">device pci</code>
<br/>
<code class="Cd">device scbus</code>
<br/>
<code class="Cd">device ahd</code>
<p class="Pp">To compile in debugging code:
<br/>
<code class="Cd">options AHD_DEBUG</code>
<br/>
<code class="Cd">options AHD_DEBUG_OPTS=<bitmask of options></code>
<br/>
<code class="Cd">options AHD_REG_PRETTY_PRINT</code></p>
</div>
<p class="Pp">Alternatively, to load the driver as a module at boot time, place
the following line in <a class="Xr">loader.conf(5)</a>:</p>
<div class="Bd Pp Bd-indent Li">
<pre>ahd_load="YES"</pre>
</div>
</section>
<section class="Sh">
<h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1>
<p class="Pp">This driver provides access to the SCSI bus(es) connected to
Adaptec AIC79xx host adapter chips.</p>
<p class="Pp">Driver features include support for narrow and wide busses, fast,
ultra, ultra2, ultra160, and ultra320 synchronous transfers, packetized
transfers, tagged queueing, 512 SCB's, and target mode.</p>
<p class="Pp">The <code class="Dv">AHD_DEBUG_OPTS</code> option is used to
control which diagnostic messages are printed to the console when
<code class="Dv">AHD_DEBUG</code> is enabled. Logically OR the following
bits together:</p>
<table class="Bl-column Bd-indent">
<tr id="Value">
<td><a class="permalink" href="#Value"><i class="Em">Value</i></a></td>
<td>Function</td>
</tr>
<tr>
<td>0x0001</td>
<td>Show miscellaneous information</td>
</tr>
<tr>
<td>0x0002</td>
<td>Show sense data</td>
</tr>
<tr>
<td>0x0004</td>
<td>Show Serial EEPROM contents</td>
</tr>
<tr>
<td>0x0008</td>
<td>Show bus termination settings</td>
</tr>
<tr>
<td>0x0010</td>
<td>Show host memory usage</td>
</tr>
<tr>
<td>0x0020</td>
<td>Show SCSI protocol messages</td>
</tr>
<tr>
<td>0x0040</td>
<td>Show mode pointer of the chip register window</td>
</tr>
<tr>
<td>0x0080</td>
<td>Show selection timeouts</td>
</tr>
<tr>
<td>0x0100</td>
<td>Show FIFO usage messages</td>
</tr>
<tr>
<td>0x0200</td>
<td>Show Queue Full status</td>
</tr>
<tr>
<td>0x0400</td>
<td>Show SCB queue status</td>
</tr>
<tr>
<td>0x0800</td>
<td>Show inbound packet information</td>
</tr>
<tr>
<td>0x1000</td>
<td>Show S/G list information</td>
</tr>
<tr>
<td>0x2000</td>
<td>Enable extra diagnostic code in the firmware</td>
</tr>
</table>
<p class="Pp">The <code class="Dv">AHD_REG_PRETTY_PRINT</code> option compiles
in support for human-readable bit definitions for each register that is
printed by the debugging code. However, it also bloats the compiled size of
the driver by approximately 215KB.</p>
<p class="Pp">Per target configuration performed in the SCSI-Select menu,
accessible at boot, is honored by this driver. This includes
synchronous/asynchronous transfers, maximum synchronous negotiation rate,
wide transfers, disconnection, and the host adapter's SCSI ID.</p>
</section>
<section class="Sh">
<h1 class="Sh" id="CONFIGURATION_OPTIONS"><a class="permalink" href="#CONFIGURATION_OPTIONS">CONFIGURATION
OPTIONS</a></h1>
<p class="Pp">To statically configure one or more controllers to assume the
target role:</p>
<p class="Pp"><code class="Cd">options AHD_TMODE_ENABLE <bitmask of
units></code></p>
<div class="Bd Pp Bd-indent">The value assigned to this option should be a
bitmap of all units where target mode is desired. For example, a value of
0x25, would enable target mode on units 0, 2, and 5. A value of 0x8a enables
it for units 1, 3, and 7.
<p class="Pp">Note that controllers can be dynamically configured through a
device hint documented below.</p>
<p class="Pp"></p>
</div>
</section>
<section class="Sh">
<h1 class="Sh" id="BOOT_OPTIONS"><a class="permalink" href="#BOOT_OPTIONS">BOOT
OPTIONS</a></h1>
<p class="Pp">The following options are switchable by setting values in
<span class="Pa">/boot/device.hints</span>.</p>
<p class="Pp">They are:</p>
<dl class="Bl-tag">
<dt id="hint.ahd."><var class="Va">hint.ahd.</var><var class="Ar">N</var><var class="Va">.tmode_enable</var></dt>
<dd>A hint to define whether the SCSI target mode is enabled (0 -- disabled, 1
-- enabled).</dd>
</dl>
</section>
<section class="Sh">
<h1 class="Sh" id="HARDWARE"><a class="permalink" href="#HARDWARE">HARDWARE</a></h1>
<p class="Pp">The <code class="Nm">ahd</code> driver supports the following
PCI/PCI-X parallel SCSI controllers:</p>
<p class="Pp"></p>
<ul class="Bl-bullet Bl-compact">
<li>Adaptec AIC7901 host adapter chip</li>
<li>Adaptec AIC7901A host adapter chip</li>
<li>Adaptec AIC7902 host adapter chip</li>
<li>Adaptec 29320 host adapter</li>
<li>Adaptec 39320 host adapter</li>
<li>Many motherboards with on-board SCSI support</li>
</ul>
</section>
<section class="Sh">
<h1 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE
ALSO</a></h1>
<p class="Pp"><a class="Xr">ahc(4)</a>, <a class="Xr">cd(4)</a>,
<a class="Xr">da(4)</a>, <a class="Xr">sa(4)</a>,
<a class="Xr">scsi(4)</a></p>
</section>
<section class="Sh">
<h1 class="Sh" id="HISTORY"><a class="permalink" href="#HISTORY">HISTORY</a></h1>
<p class="Pp">The <code class="Nm">ahd</code> driver first appeared in
<span class="Ux">FreeBSD 4.7</span>.</p>
</section>
<section class="Sh">
<h1 class="Sh" id="AUTHORS"><a class="permalink" href="#AUTHORS">AUTHORS</a></h1>
<p class="Pp">The <code class="Nm">ahd</code> driver, the AIC7xxx sequencer-code
assembler, and the firmware running on the aic79xx chips was written by
<span class="An">Justin T. Gibbs</span>. This manual page is based on the
<a class="Xr">ahc(4)</a> manual page.</p>
</section>
<section class="Sh">
<h1 class="Sh" id="BUGS"><a class="permalink" href="#BUGS">BUGS</a></h1>
<p class="Pp">The current generation of 79xx chips do not support target mode in
Ultra320 mode. Target mode in general has not been well tested in this
driver.</p>
</section>
</div>
<table class="foot">
<tr>
<td class="foot-date">September 29, 2025</td>
<td class="foot-os">FreeBSD 15.0</td>
</tr>
</table>
|
