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
|
<table class="head">
<tr>
<td class="head-ltitle">IWI(4)</td>
<td class="head-vol">Device Drivers Manual</td>
<td class="head-rtitle">IWI(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">iwi</code> — <span class="Nd">Intel
PRO/Wireless 2200BG/2225BG/2915ABG IEEE 802.11 network 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, include the following
lines in your kernel configuration file:</p>
<div class="Bd Pp Bd-indent"><code class="Cd">device iwi</code>
<br/>
<code class="Cd">device iwifw</code>
<br/>
<code class="Cd">device pci</code>
<br/>
<code class="Cd">device wlan</code>
<br/>
<code class="Cd">device firmware</code></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>if_iwi_load="YES"</pre>
</div>
<p class="Pp">In both cases, place the following line in
<a class="Xr">loader.conf(5)</a> to acknowledge the firmware license (see
below):</p>
<div class="Bd Pp Bd-indent Li">
<pre>legal.intel_iwi.license_ack=1</pre>
</div>
</section>
<section class="Sh">
<h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1>
<p class="Pp">The <code class="Nm">iwi</code> driver provides support for Intel
PRO/Wireless 2200BG/2225BG/2915ABG IEEE 802.11a/b/g wireless network devices
in <code class="Cm">station</code>, <code class="Cm">adhoc</code>, and
<code class="Cm">monitor</code> mode operation. Only one virtual interface
may be configured at any time.</p>
<p class="Pp">This driver requires the firmware built with the
<code class="Nm">iwifw</code> module to work. For the loaded firmware to be
enabled for use the license at
<span class="Pa">/usr/share/doc/legal/intel_iwi.LICENSE</span> must be
agreed by adding the following line to <a class="Xr">loader.conf(5)</a>:</p>
<p class="Pp"></p>
<div class="Bd
Bd-indent"><code class="Li">legal.intel_iwi.license_ack=1</code></div>
<p class="Pp">For more information on configuring this device, see
<a class="Xr">ifconfig(8)</a>.</p>
</section>
<section class="Sh">
<h1 class="Sh" id="HARDWARE"><a class="permalink" href="#HARDWARE">HARDWARE</a></h1>
<p class="Pp">The <code class="Nm">iwi</code> driver supports the following
wireless network devices:</p>
<p class="Pp"></p>
<ul class="Bl-bullet Bl-compact">
<li>Intel PRO/Wireless 2200BG MiniPCI Network Connection</li>
<li>Intel PRO/Wireless 2225BG PCI Network Connection</li>
<li>Intel PRO/Wireless 2915ABG MiniPCI Network Connection</li>
</ul>
</section>
<section class="Sh">
<h1 class="Sh" id="FILES"><a class="permalink" href="#FILES">FILES</a></h1>
<dl class="Bl-tag Bl-compact">
<dt><span class="Pa">/usr/share/doc/legal/intel_iwi.LICENSE</span></dt>
<dd><code class="Nm">iwi</code> firmware license</dd>
</dl>
</section>
<section class="Sh">
<h1 class="Sh" id="EXAMPLES"><a class="permalink" href="#EXAMPLES">EXAMPLES</a></h1>
<p class="Pp">Join an existing BSS network (i.e., connect to an access
point):</p>
<p class="Pp"></p>
<div class="Bd Bd-indent"><code class="Li">ifconfig wlan create wlandev iwi0
inet 192.0.2.20/24</code></div>
<p class="Pp">Join a specific BSS network with network name
<var class="Ar">my_net</var>:</p>
<p class="Pp"></p>
<div class="Bd Bd-indent"><code class="Li">ifconfig wlan create wlandev iwi0
ssid my_net up</code></div>
<p class="Pp">Join a specific BSS network with 64-bit WEP encryption:</p>
<div class="Bd Pp Bd-indent Li">
<pre>ifconfig wlan create wlandev iwi0 ssid my_net \
wepmode on wepkey 0x1234567890 weptxkey 1 up</pre>
</div>
<p class="Pp">Join a specific BSS network with 128-bit WEP encryption:</p>
<div class="Bd Pp Bd-indent Li">
<pre>ifconfig wlan create wlandev iwi0 wlanmode adhoc ssid my_net \
wepmode on wepkey 0x01020304050607080910111213 weptxkey 1</pre>
</div>
</section>
<section class="Sh">
<h1 class="Sh" id="DIAGNOSTICS"><a class="permalink" href="#DIAGNOSTICS">DIAGNOSTICS</a></h1>
<dl class="Bl-diag">
<dt>iwi%d: device timeout</dt>
<dd>The driver will reset the hardware. This should not happen.</dd>
<dt>iwi%d: firmware error</dt>
<dd>The onboard microcontroller crashed for some reason. The driver will reset
the hardware. This should not happen.</dd>
<dt>iwi%d: timeout waiting for firmware initialization to complete</dt>
<dd>The onboard microcontroller failed to initialize in time. This should not
happen.</dd>
<dt>iwi%d: could not load firmware image '%s'</dt>
<dd>The driver failed to load the firmware image using the
<a class="Xr">firmware(9)</a> subsystem. Verify the
<a class="Xr">iwifw(4)</a> firmware module is installed and the license
agreement <a class="Xr">loader(8)</a> tunable has been set.</dd>
<dt>iwi%d: could not load boot firmware</dt>
<dd>An attempt to upload the boot firmware image to the onboard
microcontroller failed. This should not happen.</dd>
<dt>iwi%d: could not load microcode</dt>
<dd>An attempt to upload the microcode image to the onboard microcontroller
failed. This should not happen.</dd>
<dt>iwi%d: could not load main firmware</dt>
<dd>An attempt to upload the main firmware image to the onboard
microcontroller failed. This should not happen.</dd>
</dl>
</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">iwifw(4)</a>, <a class="Xr">pci(4)</a>,
<a class="Xr">wlan(4)</a>, <a class="Xr">wlan_ccmp(4)</a>,
<a class="Xr">wlan_tkip(4)</a>, <a class="Xr">wlan_wep(4)</a>,
<a class="Xr">networking(7)</a>, <a class="Xr">ifconfig(8)</a>,
<a class="Xr">wpa_supplicant(8)</a></p>
</section>
<section class="Sh">
<h1 class="Sh" id="AUTHORS"><a class="permalink" href="#AUTHORS">AUTHORS</a></h1>
<p class="Pp">The original <code class="Nm">iwi</code> driver was written by
<span class="An">Damien Bergamini</span>
<<a class="Mt" href="mailto:damien.bergamini@free.fr">damien.bergamini@free.fr</a>>.</p>
</section>
</div>
<table class="foot">
<tr>
<td class="foot-date">November 10, 2024</td>
<td class="foot-os">FreeBSD 15.0</td>
</tr>
</table>
|
