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
|
<table class="head">
<tr>
<td class="head-ltitle">IWX(4)</td>
<td class="head-vol">Device Drivers Manual (amd64)</td>
<td class="head-rtitle">IWX(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">iwx</code> — <span class="Nd">Intel WiFi 6
IEEE 802.11ax 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 iwx</code>
<br/>
<code class="Cd">device pci</code>
<br/>
<code class="Cd">device wlan</code></div>
<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_iwx_load="YES"</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">iwx</code> driver supports the Intel Wi-Fi 6
series of M.2 wireless network adapters. If the appropriate hardware is
detected, and <a class="Xr">iwlwifi(4)</a> is blacklisted in
<a class="Xr">rc.conf(5)</a>, the driver will be automatically loaded with
<a class="Xr">devmatch(8)</a>. The <code class="Nm">iwx</code> driver can be
configured at runtime with <a class="Xr">ifconfig(8)</a> or at boot with
<a class="Xr">rc.conf(5)</a>.</p>
<p class="Pp">These are the modes the <code class="Nm">iwx</code> driver can
operate in:</p>
<dl class="Bl-tag">
<dt>station mode</dt>
<dd>This is used when associating with an access point, through which all
traffic passes. Background scanning is supported in this mode, see
<a class="Xr">ifconfig(8)</a>. Station mode is the default.</dd>
<dt>monitor mode</dt>
<dd>In this mode the driver is able to receive packets without associating
with an access point. This disables the internal receive filter and
enables the card to capture packets from networks which it wouldn't
normally have access to, or to scan for access points.</dd>
</dl>
</section>
<section class="Sh">
<h1 class="Sh" id="HARDWARE"><a class="permalink" href="#HARDWARE">HARDWARE</a></h1>
<p class="Pp">The <code class="Nm">iwx</code> driver supports the following M.2
wireless network adapters:</p>
<p class="Pp"></p>
<ul class="Bl-bullet Bd-indent Bl-compact">
<li>Intel Wi-Fi 6 AX200</li>
<li>Intel Wi-Fi 6 AX201 CNVi</li>
<li>Intel Wi-Fi 6 AX210</li>
<li>Intel Wi-Fi 6 AX211 CNVi</li>
</ul>
</section>
<section class="Sh">
<h1 class="Sh" id="SYSCTL_VARIABLES"><a class="permalink" href="#SYSCTL_VARIABLES">SYSCTL
VARIABLES</a></h1>
<p class="Pp">The <code class="Nm">iwx</code> driver supports the following
<a class="Xr">sysctl(8)</a> variables:</p>
<dl class="Bl-tag">
<dt id="dev.iwx.?.debug"><var class="Va">dev.iwx.?.debug</var></dt>
<dd>Specify debug level as a bitmask. Default
‘<code class="Li">0</code>’.</dd>
</dl>
</section>
<section class="Sh">
<h1 class="Sh" id="FILES"><a class="permalink" href="#FILES">FILES</a></h1>
<p class="Pp">The <code class="Nm">iwx</code> driver requires firmware from
<span class="Pa">ports/net/wifi-firmware-iwlwifi-kmod</span>. This firmware
package will be installed automatically with <a class="Xr">fwget(8)</a> if
the appropriate hardware is detected at installation or runtime.</p>
</section>
<section class="Sh">
<h1 class="Sh" id="DIAGNOSTICS"><a class="permalink" href="#DIAGNOSTICS">DIAGNOSTICS</a></h1>
<dl class="Bl-diag">
<dt>iwx0: device timeout</dt>
<dd>A frame dispatched to the hardware for transmission did not complete in
time. The driver will reset the hardware. This should not happen.</dd>
<dt>iwx0: fatal firmware error</dt>
<dd>For some reason, the firmware crashed. The driver will reset the hardware.
This should not happen.</dd>
<dt>iwx0: radio is disabled by hardware switch</dt>
<dd>The radio transmitter is off and thus no packet can go out. The driver
will reset the hardware. Make sure the laptop radio switch is on.</dd>
<dt>iwx0: could not read firmware ... (error N)</dt>
<dd>For some reason, the driver was unable to read the firmware image from the
filesystem. The file might be missing or corrupted.</dd>
<dt>iwx0: firmware too short: N bytes</dt>
<dd>The firmware image is corrupted and can't be loaded into the adapter.</dd>
<dt>iwx0: could not load firmware</dt>
<dd>An attempt to load the firmware into the adapter failed. The driver will
reset the hardware.</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">intro(4)</a>, <a class="Xr">iwlwifi(4)</a>,
<a class="Xr">iwlwififw(4)</a>, <a class="Xr">wlan(4)</a>,
<a class="Xr">networking(7)</a>, <a class="Xr">fwget(8)</a>,
<a class="Xr">ifconfig(8)</a>, <a class="Xr">wpa_supplicant(8)</a></p>
</section>
<section class="Sh">
<h1 class="Sh" id="HISTORY"><a class="permalink" href="#HISTORY">HISTORY</a></h1>
<p class="Pp">The <code class="Nm">iwx</code> driver appeared in
<span class="Ux">FreeBSD 15.0</span>.</p>
</section>
<section class="Sh">
<h1 class="Sh" id="CAVEATS"><a class="permalink" href="#CAVEATS">CAVEATS</a></h1>
<p class="Pp">The <code class="Nm">iwx</code> driver does not support hardware
encryption offload.</p>
<p class="Pp">The <code class="Nm">iwx</code> driver does not support 802.11ax.
Additional work is required in <a class="Xr">ieee80211(9)</a> before those
features can be supported.</p>
</section>
</div>
<table class="foot">
<tr>
<td class="foot-date">November 14, 2025</td>
<td class="foot-os">FreeBSD 15.0</td>
</tr>
</table>
|
