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

  
 
  

home | help
IWI(4)			     Kernel Interfaces Manual			  IWI(4)

NAME
     iwi -- Intel PRO/Wireless 2200BG/2225BG/2915ABG IEEE 802.11 network driver

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

	   device iwi
	   device iwifw
	   device pci
	   device wlan
	   device firmware

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

	   if_iwi_load="YES"

     In both cases, place the following line in loader.conf(5) to acknowledge
     the firmware license (see below):

	   legal.intel_iwi.license_ack=1

DESCRIPTION
     The    iwi    driver    provides	 support    for    Intel    PRO/Wireless
     2200BG/2225BG/2915ABG IEEE 802.11a/b/g wireless network devices in station,
     adhoc, and monitor mode operation.  Only one virtual interface may be  con-
     figured at any time.

     This driver requires the firmware built with the iwifw module to work.  For
     the   loaded   firmware   to   be	 enabled   for	 use   the   license  at
     /usr/share/doc/legal/intel_iwi.LICENSE must be agreed by adding the follow-
     ing line to loader.conf(5):

	   legal.intel_iwi.license_ack=1

     For more information on configuring this device, see ifconfig(8).

HARDWARE
     The iwi driver supports the following wireless network devices:

     *	 Intel PRO/Wireless 2200BG MiniPCI Network Connection
     *	 Intel PRO/Wireless 2225BG PCI Network Connection
     *	 Intel PRO/Wireless 2915ABG MiniPCI Network Connection

FILES
     /usr/share/doc/legal/intel_iwi.LICENSE  iwi firmware license

EXAMPLES
     Join an existing BSS network (i.e., connect to an access point):

	   ifconfig wlan create wlandev iwi0 inet 192.0.2.20/24

     Join a specific BSS network with network name my_net:

	   ifconfig wlan create wlandev iwi0 ssid my_net up

     Join a specific BSS network with 64-bit WEP encryption:

	   ifconfig wlan create wlandev iwi0 ssid my_net \
	       wepmode on wepkey 0x1234567890 weptxkey 1 up

     Join a specific BSS network with 128-bit WEP encryption:

	   ifconfig wlan create wlandev iwi0 wlanmode adhoc ssid my_net \
	       wepmode on wepkey 0x01020304050607080910111213 weptxkey 1

DIAGNOSTICS
     iwi%d: device timeout  The driver will reset the hardware.  This should not
     happen.

     iwi%d: firmware error  The onboard microcontroller crashed for some reason.
     The driver will reset the hardware.  This should not happen.

     iwi%d: timeout waiting for firmware initialization to complete  The onboard
     microcontroller failed to initialize in time.  This should not happen.

     iwi%d: could not load firmware image '%s'	The driver failed  to  load  the
     firmware  image  using  the  firmware(9)  subsystem.   Verify  the iwifw(4)
     firmware module is installed and the license  agreement  loader(8)  tunable
     has been set.

     iwi%d: could not load boot firmware  An attempt to upload the boot firmware
     image to the onboard microcontroller failed.  This should not happen.

     iwi%d:  could  not load microcode	An attempt to upload the microcode image
     to the onboard microcontroller failed.  This should not happen.

     iwi%d: could not load main firmware  An attempt to upload the main firmware
     image to the onboard microcontroller failed.  This should not happen.

SEE ALSO
     iwifw(4), pci(4), wlan(4), wlan_ccmp(4),  wlan_tkip(4),  wlan_wep(4),  net-
     working(7), ifconfig(8), wpa_supplicant(8)

AUTHORS
     The    original	iwi    driver	 was   written	 by   Damien   Bergamini
     <damien.bergamini@free.fr>.

FreeBSD 15.1			November 10, 2024			  IWI(4)

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

home | help