WPI(4)                                                     BSD Kernel Interfaces Manual                                                     WPI(4)

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 possi-
     ble in this state.

BUGS

     Not all the error messages are documented here.

     Background scanning is not currently supported.

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.

BSD                                                               October 5, 2008                                                              BSD