xref: /freebsd/share/man/man4/iwlwifi.4 (revision b64c5a0ace59af62eff52bfe110a521dc73c937b)
1.\"-
2.\" SPDX-License-Identifier: BSD-2-Clause
3.\"
4.\" Copyright (c) 2021-2024 The FreeBSD Foundation
5.\"
6.\" This documentation was written by Bj\xc3\xb6rn Zeeb under sponsorship from
7.\" the FreeBSD Foundation.
8.\"
9.\" Redistribution and use in source and binary forms, with or without
10.\" modification, are permitted provided that the following conditions
11.\" are met:
12.\" 1. Redistributions of source code must retain the above copyright
13.\"    notice, this list of conditions and the following disclaimer.
14.\" 2. Redistributions in binary form must reproduce the above copyright
15.\"    notice, this list of conditions and the following disclaimer in the
16.\"    documentation and/or other materials provided with the distribution.
17.\"
18.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
19.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
20.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
21.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
22.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
23.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
24.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
25.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
26.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
27.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
28.\" SUCH DAMAGE.
29.\"
30.Dd November 10, 2024
31.Dt IWLWIFI 4
32.Os
33.Sh NAME
34.Nm iwlwifi
35.Nd Intel IEEE 802.11a/b/g/n/ac/ax wireless network driver
36.Sh SYNOPSIS
37The driver will auto-load without any user interaction using
38.Xr devmatch 8
39if enabled in
40.Xr rc.conf 5 .
41.Pp
42Only if auto-loading is explicitly disabled, place the following
43lines in
44.Xr rc.conf 5
45to manually load the driver as a module at boot time:
46.Bd -literal -offset indent
47kld_list="${kld_list} if_iwlwifi"
48.Ed
49.Pp
50The driver should automatically load any
51.Xr iwlwififw 4
52firmware needed for the particular chipset.
53.Pp
54It is discouraged to load the driver from
55.Xr loader 8 .
56.Sh DESCRIPTION
57The
58.Nm
59driver provides support for Intel Wireless network devices.
60.Pp
61.Nm
62is derived from Intel's Linux iwlwifi driver, will be a successor to
63.Xr iwm 4 ,
64and may supersede that driver in the future.
65It still complements the
66.Xr iwn 4
67driver which supports older chipsets.
68.Pp
69The driver uses the
70.\" No LinuxKPI man pages so no .Xr here.
71.Sy linuxkpi_wlan
72and
73.Sy linuxkpi
74compat framework to bridge between the Linux and
75native
76.Fx
77driver code as well as to the native
78.Xr net80211 4
79wireless stack.
80.Sh HARDWARE
81The
82.Nm
83driver supports PCIe devices from the
84.Sy mvm
85sub-driver with the following chipset generations:
86.Pp
87.\" awk -F\\t '{ print $5 }' ~/tmp/iwlwifi_pci_ids_name.txt | \
88.\" grep -v undefined | sort -V | uniq | grep -v ^$ | \
89.\" awk '{ printf ".It\n%s\n", $0 }'
90.Bl -bullet -compact
91.It
927000
93.It
948000
95.It
969000
97.It
9822000
99.It
100AX210
101.It
102BZ
103.It
104SC
105.El
106.Pp
107These chipset generations match the following common device names:
108.Pp
109.Bl -bullet -compact
110.\" --------------------------------------------------------------------
111.\" This list is manually generated from a sysctl and post-processing.
112.\" Edits will be overwritten on next update.
113.\" awk -F\\t '{ if ($2 == "") { next; } if (seen[$2]) { next; } \
114.\" seen[$2]=1; printf ".It\n%s\n", $2; }' iwlwifi_pci_ids_name.txt
115.\" --------------------------------------------------------------------
116.It
117Intel(R) Dual Band Wireless AC 7260
118.It
119Intel(R) Dual Band Wireless N 7260
120.It
121Intel(R) Wireless N 7260
122.It
123Intel(R) Dual Band Wireless AC 3160
124.It
125Intel(R) Dual Band Wireless N 3160
126.It
127Intel(R) Wireless N 3160
128.It
129Intel(R) Dual Band Wireless AC 3165
130.It
131Intel(R) Dual Band Wireless AC 3168
132.It
133Intel(R) Dual Band Wireless AC 7265
134.It
135Intel(R) Wireless N 7265
136.It
137Intel(R) Dual Band Wireless N 7265
138.It
139Intel(R) Dual Band Wireless AC 8260
140.It
141Intel(R) Dual Band Wireless N 8260
142.It
143Intel(R) Dual Band Wireless AC 4165
144.It
145Intel(R) Dual Band Wireless AC 8265
146.It
147Intel(R) Dual Band Wireless AC 8275
148.It
149Killer (R) Wireless-AC 1550 Wireless Network Adapter (9260NGW) 160MHz
150.It
151Killer (R) Wireless-AC 1550s Wireless Network Adapter (9560NGW)
152.It
153Killer (R) Wireless-AC 1550i Wireless Network Adapter (9560NGW)
154.It
155Killer(R) Wireless-AC 1550s Wireless Network Adapter (9560D2W) 160MHz
156.It
157Killer(R) Wireless-AC 1550i Wireless Network Adapter (9560NGW) 160MHz
158.It
159Killer(R) Wi-Fi 6E AX1690s 160MHz Wireless Network Adapter (411D2W)
160.It
161Killer(R) Wi-Fi 6E AX1690i 160MHz Wireless Network Adapter (411NGW)
162.It
163Intel(R) Wireless-AC 9260-1
164.It
165Intel(R) Wi-Fi 6 AX200 160MHz
166.It
167Killer(R) Wi-Fi 6 AX1650w 160MHz Wireless Network Adapter (200D2W)
168.It
169Killer(R) Wi-Fi 6 AX1650x 160MHz Wireless Network Adapter (200NGW)
170.It
171Intel(R) Wi-Fi 6 AX201 160MHz
172.It
173Killer(R) Wi-Fi 6 AX1650s 160MHz Wireless Network Adapter (201D2W)
174.It
175Killer(R) Wi-Fi 6 AX1650i 160MHz Wireless Network Adapter (201NGW)
176.It
177Killer(R) Wi-Fi 6 AX1650s 160MHz Wireless Network Adapter (201NGW)
178.It
179Killer(R) Wi-Fi 6 AX1650i 160MHz Wireless Network Adapter (201D2W)
180.It
181Intel(R) Wi-Fi 6E AX211 160MHz
182.It
183Intel(R) Wi-Fi 6 AX210 160MHz
184.It
185Killer(R) Wi-Fi 6E AX1675w 160MHz Wireless Network Adapter (210D2W)
186.It
187Killer(R) Wi-Fi 6E AX1675x 160MHz Wireless Network Adapter (210NGW)
188.It
189Intel(R) Wi-Fi 6E AX411 160MHz
190.It
191Killer(R) Wi-Fi 6E AX1675s 160MHz Wireless Network Adapter (211NGW)
192.It
193Killer(R) Wi-Fi 6E AX1675i 160MHz Wireless Network Adapter (211NGW)
194.It
195Intel(R) Wireless-AC 9461 160MHz
196.It
197Intel(R) Wireless-AC 9461
198.It
199Intel(R) Wireless-AC 9462 160MHz
200.It
201Intel(R) Wireless-AC 9462
202.It
203Intel(R) Wireless-AC 9560 160MHz
204.It
205Intel(R) Wireless-AC 9560
206.It
207Intel(R) Wireless-AC 9270 160MHz
208.It
209Intel(R) Wireless-AC 9270
210.It
211Intel(R) Wireless-AC 9162 160MHz
212.It
213Intel(R) Wireless-AC 9162
214.It
215Intel(R) Wireless-AC 9260 160MHz
216.It
217Intel(R) Wireless-AC 9260
218.It
219Intel(R) Wi-Fi 6 AX101
220.It
221Intel(R) Wi-Fi 6 AX203
222.It
223Intel(R) Wi-Fi 6E AX231 160MHz
224.It
225Intel(R) Wi-Fi 7 BE201 320MHz
226.It
227Intel(R) Wi-Fi 7 BE200 320MHz
228.It
229Intel(R) Wi-Fi 7 BE202 160MHz
230.It
231Intel(R) TBD Sc device
232.It
233Intel(R) TBD Sc2 device
234.It
235Intel(R) TBD Sc2f device
236.\" --------------------------------------------------------------------
237.El
238.Sh SEE ALSO
239.Xr iwlwififw 4 ,
240.Xr iwm 4 ,
241.Xr iwn 4 ,
242.Xr wlan 4 ,
243.Xr networking 7 ,
244.Xr fwget 8 ,
245.Xr ifconfig 8 ,
246.Xr wpa_supplicant 8
247.Sh HISTORY
248The
249.Nm
250driver first appeared in
251.Fx 13.1 .
252.Sh BUGS
253Certainly.
254.Pp
255While
256.Nm
257supports 802.11a/b/g/n/ac/ax modes,
258the compatibility code currently only supports 802.11a/b/g modes.
259Support for 802.11n/ac/ax is yet to come.
260802.11ax and 6Ghz support are planned.
261