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