1 .\" Copyright (c) 2004-2006
2 .\" Damien Bergamini <damien.bergamini@free.fr>. All rights reserved.
4 .\" Redistribution and use in source and binary forms, with or without
5 .\" modification, are permitted provided that the following conditions
7 .\" 1. Redistributions of source code must retain the above copyright
8 .\" notice unmodified, this list of conditions, and the following
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.
14 .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
15 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
16 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
17 .\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
18 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
19 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
20 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
21 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
22 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
23 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
26 .\" $FreeBSD: head/share/man/man4/iwm.4 354517 2019-11-07 23:39:33Z markj $
33 .Nd Intel IEEE 802.11ac wireless network driver
35 To compile this driver into the kernel,
36 include the following lines in your
37 kernel configuration file:
38 .Bd -ragged -offset indent
42 .\".Cd "device firmware"
45 You also need to select a firmware for your device.
47 .\".Bd -ragged -offset indent
48 .\".Cd "device iwm3160fw"
49 .\".Cd "device iwm3168fw"
50 .\".Cd "device iwm7260fw"
51 .\".Cd "device iwm7265fw"
52 .\".Cd "device iwm7265Dfw"
53 .\".Cd "device iwm8000Cfw"
54 .\".Cd "device iwm8265fw"
55 .\".Cd "device iwm9000fw"
56 .\".Cd "device iwm9260fw"
61 .Bd -ragged -offset indent
67 Alternatively, to load the driver as a
68 module at boot time, place the following lines in
70 .Bd -literal -offset indent
85 driver provides support for:
87 .Bl -tag -width Ds -offset indent -compact
88 .It Intel Dual Band Wireless AC 3160
89 .It Intel Dual Band Wireless AC 3165
90 .It Intel Dual Band Wireless AC 3168
91 .It Intel Dual Band Wireless AC 7260
92 .It Intel Dual Band Wireless AC 7265
93 .It Intel Dual Band Wireless AC 8260
94 .It Intel Dual Band Wireless AC 8265
95 .It Intel Dual Band Wireless AC 9260
96 .It Intel Dual Band Wireless AC 9270
97 .It Intel Dual Band Wireless AC 946X
98 .It Intel Dual Band Wireless AC 9560
105 Only one virtual interface may be configured at any time.
106 For more information on configuring this device, see
109 This driver requires the firmware built with the
113 .Bl -tag -width indent
114 .It Va hw.iwm.msi.enable
115 By default, the driver will use MSI if it is supported.
116 This behavior can be turned off by setting this tunable to 0.
117 .It Va hw.iwm.power_scheme
118 Power management scheme:
119 1 = active, 2 = balanced (default), 3 = low power
120 .It Va hw.iwm.lar.disable
121 Allows disabling LAR (Location Aware Regulatory) feature:
122 0 = LAR enabled if available (default), 1 = LAR disabled
125 Join an existing BSS network (i.e., connect to an access point):
126 .Bd -literal -offset indent
127 ifconfig wlan create wlandev iwm0 inet 192.168.0.20 \e
131 Join a specific BSS network with network name
134 .Dl "ifconfig wlan create wlandev iwm0 ssid my_net up"
136 Join a specific BSS network with 64-bit WEP encryption:
137 .Bd -literal -offset indent
138 ifconfig wlan create wlandev iwm0 ssid my_net \e
139 wepmode on wepkey 0x1234567890 weptxkey 1 up
142 Join a specific BSS network with 128-bit WEP encryption:
143 .Bd -literal -offset indent
144 ifconfig wlan create wlandev iwm0 wlanmode adhoc ssid my_net \e
145 wepmode on wepkey 0x01020304050607080910111213 weptxkey 1
149 .It "iwm%d: device timeout"
150 The driver will reset the hardware.
151 This should not happen.
152 .It "iwm%d: firmware error"
153 The onboard microcontroller crashed for some reason.
154 The driver will reset the hardware.
155 This should not happen.
156 .It "iwm%d: fw chunk addr 0x%x len %d failed to load"
157 Timed out waiting for a segment of the firmware to load.
158 This should not happen.
159 .It "iwm%d: could not read firmware %s (error %d)"
160 The driver failed to load the firmware image using the
165 firmware module is present.
166 .It "iwm%d: Failed to start INIT ucode: %d"
167 An attempt to upload the INIT firmware image to the onboard microcontroller
169 This should not happen.
170 .It "iwm%d: could not load firmware"
171 An attempt to upload the REGULAR firmware image to the onboard microcontroller
173 This should not happen.
187 device driver first appeared in