xref: /freebsd/share/man/man4/iwlwifi.4 (revision dc3509f1aafcd966f3dd9226115cf94b691ff3c7)
1.\"-
2.\" Copyright (c) 2021 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.\" $FreeBSD$
29.\"
30.Dd June 3, 2022
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 is derived from Intel's Linux iwlwifi driver and provides support for
60all chipsets supported by the
61.Em mvm
62part of that driver.
63.Pp
64.Bl -bullet -compact
65.% ---------------------------------------------------------------------
66.% This list is manually generated from a sysctl and post-processing.
67.% Edits will be overwritten on next update.
68.% ---------------------------------------------------------------------
69.It
70Intel(R) Dual Band Wireless AC 7260
71.It
72Intel(R) Dual Band Wireless N 7260
73.It
74Intel(R) Wireless N 7260
75.It
76Intel(R) Dual Band Wireless AC 3160
77.It
78Intel(R) Dual Band Wireless N 3160
79.It
80Intel(R) Wireless N 3160
81.It
82Intel(R) Dual Band Wireless AC 3165
83.It
84Intel(R) Dual Band Wireless AC 3168
85.It
86Intel(R) Dual Band Wireless AC 7265
87.It
88Intel(R) Wireless N 7265
89.It
90Intel(R) Dual Band Wireless N 7265
91.It
92Intel(R) Dual Band Wireless AC 8260
93.It
94Intel(R) Dual Band Wireless N 8260
95.It
96Intel(R) Dual Band Wireless AC 4165
97.It
98Intel(R) Dual Band Wireless AC 8265
99.It
100Intel(R) Dual Band Wireless AC 8275
101.It
102Killer (R) Wireless-AC 1550 Wireless Network Adapter (9260NGW) 160MHz
103.It
104Killer (R) Wireless-AC 1550s Wireless Network Adapter (9560NGW)
105.It
106Killer (R) Wireless-AC 1550i Wireless Network Adapter (9560NGW)
107.It
108Killer(R) Wireless-AC 1550s Wireless Network Adapter (9560D2W) 160MHz
109.It
110Killer(R) Wireless-AC 1550i Wireless Network Adapter (9560NGW) 160MHz
111.It
112Killer(R) Wi-Fi 6E AX1690s 160MHz Wireless Network Adapter (411D2W)
113.It
114Killer(R) Wi-Fi 6E AX1690i 160MHz Wireless Network Adapter (411NGW)
115.It
116Intel(R) Wireless-AC 9260-1
117.It
118Intel(R) Wi-Fi 6 AX200 160MHz
119.It
120Killer(R) Wi-Fi 6 AX1650w 160MHz Wireless Network Adapter (200D2W)
121.It
122Killer(R) Wi-Fi 6 AX1650x 160MHz Wireless Network Adapter (200NGW)
123.It
124Intel(R) Wi-Fi 6 AX201 160MHz
125.It
126Killer(R) Wi-Fi 6 AX1650s 160MHz Wireless Network Adapter (201D2W)
127.It
128Killer(R) Wi-Fi 6 AX1650i 160MHz Wireless Network Adapter (201NGW)
129.It
130Killer(R) Wi-Fi 6 AX1650s 160MHz Wireless Network Adapter (201NGW)
131.It
132Killer(R) Wi-Fi 6 AX1650i 160MHz Wireless Network Adapter (201D2W)
133.It
134Intel(R) Wi-Fi 6E AX211 160MHz
135.It
136Intel(R) Wi-Fi 6 AX210 160MHz
137.It
138Killer(R) Wi-Fi 6E AX1675w 160MHz Wireless Network Adapter (210D2W)
139.It
140Killer(R) Wi-Fi 6E AX1675x 160MHz Wireless Network Adapter (210NGW)
141.It
142Intel(R) Wi-Fi 6E AX411 160MHz
143.It
144Killer(R) Wi-Fi 6E AX1675s 160MHz Wireless Network Adapter (211NGW)
145.It
146Killer(R) Wi-Fi 6E AX1675i 160MHz Wireless Network Adapter (211NGW)
147.It
148Intel(R) Wireless-AC 9461 160MHz
149.It
150Intel(R) Wireless-AC 9461
151.It
152Intel(R) Wireless-AC 9462 160MHz
153.It
154Intel(R) Wireless-AC 9462
155.It
156Intel(R) Wireless-AC 9560 160MHz
157.It
158Intel(R) Wireless-AC 9560
159.It
160Intel(R) Wireless-AC 9270 160MHz
161.It
162Intel(R) Wireless-AC 9270
163.It
164Intel(R) Wireless-AC 9162 160MHz
165.It
166Intel(R) Wireless-AC 9162
167.It
168Intel(R) Wireless-AC 9260 160MHz
169.It
170Intel(R) Wireless-AC 9260
171.It
172Intel(R) Wi-Fi 6 AX101
173.It
174Intel(R) Wi-Fi 6 AX203
175.It
176Intel(R) Wi-Fi 6E AX221 160MHz
177.It
178Intel(R) Wi-Fi 6E AX231 160MHz
179.It
180Intel(R) TBD Bz device
181.It
182Intel(R) Wi-Fi 6 AX204 160MHz
183.% ---------------------------------------------------------------------
184.El
185.Pp
186.Nm
187will be a successor to
188.Xr iwm 4
189and may superseed that driver in the future.
190It still complements the
191.Xr iwn 4
192driver which supports older chipsets.
193.Pp
194The driver uses the
195.\" No LinuxKPI man pages so no .Xr here.
196.Em linuxkpi_wlan
197and
198.Em linuxkpi
199compat framework to bridge between the Linux and
200native FreeBSD driver code as well as to the native
201.Xr net80211 4
202wireless stack.
203.Pp
204While
205.Nm
206supports all 802.11 a/b/g/n/ac/ax
207the compatibility code currently only supports 802.11 a/b/g modes.
208Support for 802.11 n/ac is to come. 802.11ax and 6Ghz support are planned.
209.Sh BUGS
210Certainly.
211.Sh SEE ALSO
212.Xr iwlwififw 4 ,
213.Xr iwm 4 ,
214.Xr iwn 4 ,
215.Xr wlan 4 ,
216.Xr ifconfig 8 ,
217.Xr wpa_supplicant 8
218.Sh HISTORY
219The
220.Nm
221driver first appeared in
222.Fx 13.1 .
223