IWX(4)

NAME
iwx - Intel WiFi 6 IEEE 802.11ax wireless network driver

SYNOPSIS
To compile this driver into the kernel, include the following lines in your kernel configuration file:

device iwx
device pci
device wlan

Alternatively, to load the driver as a module at boot time, place the following lines in loader.conf(5):

    if_iwx_load="YES"

DESCRIPTION
The iwx driver supports the Intel Wi-Fi 6 series of M.2 wireless network adapters. If the appropriate hardware is detected, and iwlwifi(4) is blacklisted in rc.conf(5), the driver will be automatically loaded with devmatch(8). The iwx driver can be configured at runtime with ifconfig(8) or at boot with rc.conf(5).

These are the modes the iwx driver can operate in:

station mode
    This is used when associating with an access point, through which all traffic passes. Background scanning is supported in this mode, see ifconfig(8). Station mode is the default.

monitor mode
    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.

HARDWARE
The iwx driver supports the following M.2 wireless network adapters:

•   Intel Wi-Fi 6 AX200
•   Intel Wi-Fi 6 AX201 CNVi
•   Intel Wi-Fi 6 AX210
•   Intel Wi-Fi 6 AX211 CNVi

SYSCTL VARIABLES
The iwx driver supports the following sysctl(8) variables:

dev.iwx.?.debug
    Specify debug level as a bitmask. Default ‘0’.

FILES
The iwx driver requires firmware from ports/net/wifi-firmware-iwlwifi-kmod. This firmware package will be installed automatically with fwget(8) if the appropriate hardware is detected at installation or runtime.

DIAGNOSTICS

iwx0: device timeout A frame dispatched to the hardware for transmission did not complete in time. The driver will reset the hardware. This should not happen.

iwx0: fatal firmware error For some reason, the firmware crashed. The driver will reset the hardware. This should not happen.

iwx0: radio is disabled by hardware switch 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.

iwx0: could not read firmware ... (error N) For some reason, the driver was unable to read the firmware image from the filesystem. The file might be missing or corrupted.

iwx0: firmware too short: N bytes The firmware image is corrupted and can't be loaded into the adapter.

iwx0: could not load firmware An attempt to load the firmware into the adapter failed. The driver will reset the hardware.

SEE ALSO
intro(4), iwlwifi(4), iwlwififw(4), wlan(4), networking(7), fwget(8), ifconfig(8), wpa_supplicant(8)

HISTORY
The iwx driver appeared in FreeBSD 15.0.

CAVEATS
The iwx driver does not support hardware encryption offload.

The iwx driver does not support 802.11ax. Additional work is required in ieee80211(9) before those features can be supported.