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
|
<table class="head">
<tr>
<td class="head-ltitle">IPW(4)</td>
<td class="head-vol">Device Drivers Manual</td>
<td class="head-rtitle">IPW(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">ipw</code> — <span class="Nd">Intel
PRO/Wireless 2100 IEEE 802.11a/b 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 ipw</code>
<br/>
<code class="Cd">device ipwfw</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_ipw_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_ipw.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">ipw</code> driver provides support for Intel
PRO/Wireless 2100 802.11a/b 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">ipwfw</code> module to work. For the loaded firmware to be
enabled for use the license at
<span class="Pa">/usr/share/doc/legal/intel_ipw.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_ipw.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">ipw</code> driver provides support for the
Intel PRO/Wireless 2100a/b MiniPCI network adapter.</p>
</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_ipw.LICENSE</span></dt>
<dd><code class="Nm">ipw</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 ipw0
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 ipw0
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 ipw0 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 ipw0 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>ipw%d: device timeout</dt>
<dd>The driver will reset the hardware. This should not happen.</dd>
<dt>ipw%d: firmware error</dt>
<dd>The onboard microcontroller crashes for some reason. The driver will reset
the hardware. This should not happen.</dd>
<dt>ipw%d: timeout waiting for firmware initialization to complete</dt>
<dd>The onboard microcontroller failed to initialize in time. This should not
happen.</dd>
<dt>ipw%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">ipwfw(4)</a> firmware module is installed and the license
agreement <a class="Xr">loader(8)</a> tunable has been set.</dd>
<dt>ipw%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>ipw%d: could not load firmware</dt>
<dd>An attempt to upload the 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">ipwfw(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">ipw</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>
|
