static/freebsd/man4/iwm.4 4.html


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

<table class="head">
  <tr>
    <td class="head-ltitle">IWM(4)</td>
    <td class="head-vol">Device Drivers Manual</td>
    <td class="head-rtitle">IWM(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">iwm</code> &#x2014; <span class="Nd">Intel IEEE
    802.11ac wireless 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 iwm</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">You also need to select a firmware for your device. Choose one
    from:</p>
<div class="Bd Pp Bd-indent"><code class="Cd">device iwm3160fw</code>
<br/>
<code class="Cd">device iwm3168fw</code>
<br/>
<code class="Cd">device iwm7260fw</code>
<br/>
<code class="Cd">device iwm7265fw</code>
<br/>
<code class="Cd">device iwm7265Dfw</code>
<br/>
<code class="Cd">device iwm8000Cfw</code>
<br/>
<code class="Cd">device iwm8265fw</code>
<br/>
<code class="Cd">device iwm9000fw</code>
<br/>
<code class="Cd">device iwm9260fw</code></div>
<p class="Pp">Or you can use</p>
<div class="Bd Pp Bd-indent"><code class="Cd">device iwmfw</code></div>
<p class="Pp">to include them all.</p>
<p class="Pp">Alternatively, to load the driver as a module at boot time, place
    the following lines in <a class="Xr">loader.conf(5)</a>:</p>
<div class="Bd Pp Bd-indent Li">
<pre>if_iwm_load=&quot;YES&quot;
iwm3160fw_load=&quot;YES&quot;
iwm3168fw_load=&quot;YES&quot;
iwm7260fw_load=&quot;YES&quot;
iwm7265fw_load=&quot;YES&quot;
iwm7265Dfw_load=&quot;YES&quot;
iwm8000Cfw_load=&quot;YES&quot;
iwm8265fw_load=&quot;YES&quot;
iwm9000fw_load=&quot;YES&quot;
iwm9260fw_load=&quot;YES&quot;</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">iwm</code> driver supports running most Intel
    Wireless AC series network devices in <code class="Cm">station</code> mode
    operation. Only one virtual interface may be configured at any time. This
    driver requires the firmware built with the <a class="Xr">iwmfw(4)</a>
    module to work.</p>
<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">iwm</code> driver supports the following PCIe
    Wi-Fi devices:</p>
<p class="Pp"></p>
<ul class="Bl-bullet Bl-compact">
  <li>Intel Dual Band Wireless AC 3160</li>
  <li>Intel Dual Band Wireless AC 3165</li>
  <li>Intel Dual Band Wireless AC 3168</li>
  <li>Intel Dual Band Wireless AC 7260</li>
  <li>Intel Dual Band Wireless AC 7265</li>
  <li>Intel Dual Band Wireless AC 8260</li>
  <li>Intel Dual Band Wireless AC 8265</li>
  <li>Intel Dual Band Wireless AC 9260</li>
  <li>Intel Dual Band Wireless AC 9270</li>
  <li>Intel Dual Band Wireless AC 946X</li>
  <li>Intel Dual Band Wireless AC 9560</li>
</ul>
</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 iwm0
  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 iwm0
  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 iwm0 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 iwm0 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>iwm%d: device timeout</dt>
  <dd>The driver will reset the hardware. This should not happen.</dd>
  <dt>iwm%d: firmware error</dt>
  <dd>The onboard microcontroller crashed for some reason. The driver will reset
      the hardware. This should not happen.</dd>
  <dt>iwm%d: timeout waiting for firmware initialization to complete</dt>
  <dd>The onboard microcontroller failed to initialize in time. This should not
      happen.</dd>
  <dt>iwm%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">iwmfw(4)</a> firmware module is present.</dd>
  <dt>iwm%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>iwm%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>iwm%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">iwlwifi(4)</a>, <a class="Xr">iwmfw(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="BUGS"><a class="permalink" href="#BUGS">BUGS</a></h1>
<p class="Pp">Currently, <code class="Nm">iwm</code> only supports 802.11a/b/g
    modes. It will not associate to access points that are configured to operate
    only in 802.11n/ac modes.</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>