1.\" 2.\" SPDX-License-Identifier: ISC 3.\" 4.\" $OpenBSD: iwx.4,v 1.21 2025/03/27 15:12:14 jmc Exp $ 5.\" 6.\" Copyright (c) 2020 Stefan Sperling <stsp@openbsd.org> 7.\" 8.\" Permission to use, copy, modify, and distribute this software for any 9.\" purpose with or without fee is hereby granted, provided that the above 10.\" copyright notice and this permission notice appear in all copies. 11.\" 12.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES 13.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF 14.\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR 15.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES 16.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN 17.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF 18.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. 19.\" 20.Dd May 2, 2025 21.Dt IWX 4 amd64 22.Os 23.Sh NAME 24.Nm iwx 25.Nd Intel WiFi 6 IEEE 802.11ax wireless network driver 26.Sh SYNOPSIS 27.Cd device iwx 28.Cd device wlan 29.Pp 30In 31.Xr rc.conf 5 : 32.Cd devmatch_blocklist="if_iwlwifi" 33.Cd kld_list="if_iwx" 34.Pp 35In 36.Xr sysctl.conf 5 : 37.Cd dev.iwx.?.debug=0xffffffff 38.Sh DESCRIPTION 39The 40.Nm 41driver supports the Intel Wi-Fi 6 series of M.2 42wireless network adapters. 43If the appropriate hardware is detected, and 44.Xr iwlwifi 4 45is blacklisted in 46.Xr rc.conf 5 , 47the driver will be automatically loaded with 48.Xr devmatch 8 . 49The 50.Nm 51driver can be configured at runtime with 52.Xr ifconfig 8 53or at boot with 54.Xr rc.conf 5 . 55.Pp 56These are the modes the 57.Nm 58driver can operate in: 59.Bl -tag -width "monitor mode" 60.It station mode 61This is used when associating with an access point, 62through which all traffic passes. 63Background scanning is supported in this mode, see 64.Xr ifconfig 8 . 65Station mode is the default. 66.It monitor mode 67In this mode the driver is able to receive packets without 68associating with an access point. 69This disables the internal receive filter and enables the card to 70capture packets from networks which it wouldn't normally have access to, 71or to scan for access points. 72.El 73.Sh HARDWARE 74The 75.Nm 76driver supports the following M.2 wireless network adapters: 77.Pp 78.Bl -bullet -offset indent -compact 79.It 80Intel Wi-Fi 6 AX200 81.It 82Intel Wi-Fi 6 AX201 CNVi 83.It 84Intel Wi-Fi 6 AX210 85.It 86Intel Wi-Fi 6 AX211 CNVi 87.El 88.Sh SYSCTL VARIABLES 89The 90.Nm 91driver supports the following 92.Xr sysctl 8 93variables: 94.Bl -tag -width "hw.usb.mtw.debug" 95.It Va dev.iwx.?.debug 96Specify debug level as a bitmask. 97Default 98.Ql 0 . 99.El 100.Sh FILES 101The 102.Nm 103driver requires firmware from 104.Pa ports/net/wifi-firmware-iwlwifi-kmod . 105This firmware package will be installed automatically with 106.Xr fwget 8 107if the appropriate hardware is detected at installation or runtime. 108.Sh DIAGNOSTICS 109.Bl -diag 110.It "iwx0: device timeout" 111A frame dispatched to the hardware for transmission did not complete 112in time. 113The driver will reset the hardware. 114This should not happen. 115.It "iwx0: fatal firmware error" 116For some reason, the firmware crashed. 117The driver will reset the hardware. 118This should not happen. 119.It "iwx0: radio is disabled by hardware switch" 120The radio transmitter is off and thus no packet can go out. 121The driver will reset the hardware. 122Make sure the laptop radio switch is on. 123.It "iwx0: could not read firmware ... (error N)" 124For some reason, the driver was unable to read the firmware image from 125the filesystem. 126The file might be missing or corrupted. 127.It "iwx0: firmware too short: N bytes" 128The firmware image is corrupted and can't be loaded into the adapter. 129.It "iwx0: could not load firmware" 130An attempt to load the firmware into the adapter failed. 131The driver will reset the hardware. 132.El 133.Sh SEE ALSO 134.Xr intro 4 , 135.Xr iwlwifi 4 , 136.Xr iwlwififw 4 , 137.Xr wlan 4 , 138.Xr networking 7 , 139.Xr fwget 8 , 140.Xr ifconfig 8 , 141.Xr wpa_supplicant 8 142.Sh HISTORY 143The 144.Nm 145driver appeared in 146.Fx 15.0 . 147.Sh CAVEATS 148The 149.Nm 150driver does not support hardware encryption offload. 151.Pp 152The 153.Nm 154driver does not support 802.11ax. 155Additional work is required in 156.Xr ieee80211 9 157before those features can be supported. 158