Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
IWX(4)			 amd64 Kernel Interfaces Manual 		  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 de-
     vmatch(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), if-
     config(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.

FreeBSD ports 15.1		November 14, 2025			  IWX(4)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=iwx&sektion=4&manpath=FreeBSD+15.1-RELEASE+and+Ports>

home | help