NAME

     wpi — Intel 3945ABG Wireless LAN IEEE 802.11 driver

SYNOPSIS

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

           device wpi
           device wpifw
           device pci
           device wlan
           device wlan_amrr
           device firmware

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

           if_wpi_load="YES"

DESCRIPTION

     The wpi driver provides support for the Intel 3945ABG Wireless network adapter.  wpi
     supports station, adhoc, and monitor mode operation.  Only one virtual interface may be
     configured at any time.  For more information on configuring this device, see ifconfig(8).

     This driver requires the firmware built with the wpifw module to work.

FILES

     /usr/share/doc/legal/intel_wpi/LICENSE  wpi firmware license

EXAMPLES

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

           ifconfig wlan0 create wlandev wpi0 inet 192.168.0.20 \
               netmask 0xffffff00

     Join a specific BSS network with network name “my_net”:

           ifconfig wlan0 create wlandev wpi0 ssid my_net up

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

           ifconfig wlan0 create wlandev wpi0 ssid my_net \
                   wepmode on wepkey 0x1234567890 weptxkey 1 up

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

           ifconfig wlan0 create wlandev wpi0 wlanmode adhoc ssid my_net \
               wepmode on wepkey 0x01020304050607080910111213 weptxkey 1

DIAGNOSTICS

     wpi%d: could not load firmware image '%s'  The driver failed to load the firmware image
     using the firmware(9) subsystem.  Verify the wpifw firmware module is installed.

     wpi%d: fatal firmware error  An unknown error has occurred in the uploaded firmware, you may
     have to unload/reload the driver to continue.

     wpi%d: Radio transmitter is switched off  The hardware switch controlling the radio is
     currently turned off.  Data transmission is not possible in this state.

SEE ALSO

     wpifw(4), pci(4), wlan(4), wlan_ccmp(4), wlan_tkip(4), wlan_wep(4), ifconfig(8),
     wpa_supplicant(8)

AUTHORS

     The original wpi driver was written for OpenBSD by Damien Bergamini
     <damien.bergamini@free.fr>.  Benjamin Close <benjsc@FreeBSD.org> ported wpi to FreeBSD.

BUGS

     Not all the error messages are documented here.

     Background scanning is not currently supported.