home | help
WPI(4)			     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  possible  in
     this state.

SEE ALSO
     wpifw(4),	pci(4), wlan(4), wlan_ccmp(4), wlan_tkip(4), wlan_wep(4), ifcon-
     fig(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.

FreeBSD 9.1			 October 5, 2008			  WPI(4)

home | help